(Csq) Controller Set Quick; (Cc) Change Controller; (Gs) Get Controller - Symetrix Composer v7.0 Manual

(CSQ) Controller Set Quick

Use this command to move a controller position to a new
absolute value quicker than using the CS command. The
CS command may take up to 40ms before responding
with an ACK because the unit is verifying that the specified
<CONTROLLER NUMBER> exists in the site. The CSQ
response will be sent with 5-10ms for a single operation and
within 2ms each for single burst operations. The command
must specify the controller number and the new controller
position. The trade off is that the CSQ command will not
check to see if the specified <CONTROLLER NUMBER>
exists in the site. Note: It will always respond with an ACK
even if it does not. If your control system does not need to
check that the controller number was correctly set, the CSQ
command may be used without any downside.
The syntax of the command is:
CSQ <CONTROLLER NUMBER> <CONTROLLER POSITION><CR>
Where <CONTROLLER NUMBER> is the decimal
controller number (1-10000) assigned in Composer, and
<CONTROLLER POSITION> is a 16-bit number in decimal
(0-65535).
The device will respond with the string whether it recognizes
the controller number or not:

(CC) Change Controller

Use this command to move a controller to a new relative
value. This command will increment or decrement a
controller by a specified amount. The command must
specify the controller number, whether it should be
incremented or decremented, and the amount to change by.
The syntax of the command is:
CC <CONTROLLER NUMBER>
<DEC/INC> <AMOUNT><CR>
Where <CONTROLLER NUMBER> is the decimal controller
number (1-10000) assigned in Composer, <DEC/INC> is
0 to decrement and 1 to increment, and <AMOUNT> is
the amount to increment or decrement (a decimal number,
0-65535). If the amount to be decremented or incremented
causes the parameter to exceed its minimum or maximum
value, the value will be limited to its minimum or maximum
value. For example, if you increment a parameter by 10 and
its current value is 65530, the new value will be limited to
65535.
If the command is accepted, the unit will respond with the
string:
If the command is interpreted but fails for any reason the unit
will respond with the string:
A typical reason for failure is that the specified controller
number does not exist.
www.symetrix.co | T +1.425.778.7728
ACK<CR>
ACK<CR>
NAK<CR>

(GS) Get Controller

This command will return the controller position (value)
associated with a specific controller number. The command
must specify the controller number. The syntax of the
command is:
GS <CONTROLLER NUMBER><CR>
Where <CONTROLLER NUMBER> is the decimal controller
number (1-10000) assigned in Composer.
If the command is accepted, the unit will respond with the
string:
<CONTROLLER POSITION><CR>
Where controller position is a 16-bit number in decimal (0-
65535)
If the command is interpreted but fails for any reason the unit
will respond with the string:
A typical reason for failure is that the specified controller
number does not exist.
If the value being requested is a button that only has
two states, the returned values will be either 0 or 65535,
regardless of the actual value sent to the controller. For
example, assume controller number 1 controls a mute
button. If you send
CS 1 754 <CR>
and then
GS 1 <CR>
the response will be
0<CR>
not
754<CR>.
More generally, if the parameter you are controlling has
granularity coarser than the 16-bit values used, the returned
values will be quantized to the granularity of the parameter.
Controls where you might observe this effect are buttons as
mentioned above and input selectors.
If the same controller number is controlling multiple
parameters in Composer, only one acknowledgement value
is returned from the system.
8 of 25
Control Commands
NAK<CR>