User`s manual

GENERIC PROTOCOL
31
two digits for the input number, and a switcher with less than 10 levels would use one digit for the
level number.
“C”: Clear Matrix
Use command C to request that the switcher matrix be cleared so that all outputs are
disconnected from inputs (in switchers where this is possible) or else all outputs at all levels have
input 1 as their source. This command can take several seconds to execute (depending on the
size of the switcher matrix). In order to help ensure that this command isn’t accidentally executed,
it requires four additional characters following the “C” character, to spell out the word “CLEAR” in
full. For example, the command:
**CLEAR!!
Would clear the matrix and when finished — the following response would be generated:
**OK!!<CR>
“K”: Set Password
The command “K” is followed by a password, which may be 0 to cancel the previous password,
thus causing no password to be specified, or, it may be a value between 1 and 9999 to supply a
password, which remains in effect until another password (or password 0) is supplied in another
“K” command. The password is stored by the router under the remote address specified using an
“M” command, or under the control portís remote address if an “M” command was not specified
before the “K” command in the same command string as the “K” command. The password that is
set remains in effect until another “K” command is received from the same remote address.
It would be used to establish a password for a remote address, to be used for such things as
locking and unlocking outputs and modifying the router configuration. When the router receives a
protected command (one which requires use of a password) from a remote address, it compares
the current password for that remote address with the password required to execute the protected
command. Protected commands consist of many of the “G” commands that change router
configuration, as well as take and salvo trigger commands when the output to be taken is locked.
In the former case, the administrator password is the one that must be sent in the “K” command
to permit the router configuration to be changed, while in the latter case the password that was
used to lock the output is the one that must be sent in the “K” command to permit the take to
occur.
Refer to the “B” command and the “G ADMIN_PASSWORD” command (in a separate document)
for more information.
For example, the command:
** M197 K1777 !!
requests that password 1777 be stored as the current password for remote address 197. The
command:
** M197 Y7,9 !!
requests that output 7 be connected to input 9, using the password stored for remote address 197
as the output lockout override password. The take will succeed if output 9 is either not locked or
is locked with password 1777. Otherwise, the take will fail.
“M”: Set Remote Address
The command “M” is followed by a remote address value, and it sets the remote address to be
used by all remaining commands in the current command string. This command is supported on
larger routers. It would be used when a client/server software system on a router control port
permits multiple remote users to send commands to the router through that control port. In such a
system, the server software that talks to the control port can insert an “M” command at the
beginning of each command string it sends to the router on behalf of its clients. The server would
assign a different address to each of its clients. The router uses the address to control access to