Disable and deactivate a specified external device.

Arguments:

ReceiverName device

The name of the external device that the command should be sent to. If this device isn't currently connected to the control program, then the command will be discarded.

Example:

The following example disables and deactivates a receiver called "ku". Note that after this command, the ku receiver remains connected to the control program, such that an enable command can subsequently be sent to wake it up.

 disable ku

Context:

When an external device, such as a receiver, is turned on, it connects to the control program, but remains in a disabled state in which its hardware remains inactive. It remains in this state until an enable command is sent to it via the control program, to reset and activate it. It can subsequently be returned to an inactive state by the disable command.

Note that after a disable command has been run, the device remains connected to the control program, so that it can be reactivated if another enable command is sent to it.

When a schedule that contains disable commands is queued, there is no way for the control program to know which devices will be connected when the disable command is actually run. It also doesn't know what devices potentially exist. So device names are not checked when the schedule is queued.