Command Types; Boolean Commands; Integer Commands - Polycom Vortex EF2241 Programming Manual

sent as the result of an RS-232 command or as the result of some other change in the Vortex device such as
front panel adjustments, logic inputs, etc.
Status messages can be turned off via the
since the term status message and acknowledgement are synonymous for our purposes.

6. Command Types

Many of the Vortex commands have similar formats. The main formats are described here in order to provide
a better understanding of the command set.

6.1. Boolean Commands

Boolean commands take one of the three following arguments.
'0' indicates that the parameter should be turned off.
'1' indicates that the parameter should be turned on.
'2' indicates that the parameter should be toggled (i.e., '0' becomes '1' and '1' becomes '0').
Parameters associated with boolean commands can be queried using the '?' character. For example, if input
A is muted, and you send ' B04MUTEIA? ', the EF2241 will respond with a status message of ' B04MUTEIA1
'. When a status message is generated for a boolean command, the command data will either be a '0' or '1',
since '2' is obviously not a valid state.

6.2. Integer Commands

Integer commands can take one of two types of arguments. The first argument type is absolute, meaning
that the parameter will be set to the specified number. For example, ' B04GAINIA10 ' means that the gain
on input A will be set to 10 dB. In this case, the device will respond with a status message of '
B04GAINIA10 '.
The second argument type is relative, meaning that the parameter will be incremented or decremented by
the specified amount. The increment character is '>' and the decrement character is '<'. For example, '
B04GAINIA>3 ' increments the gain on input A by 3 dB. If the input's gain was previously set to 6 dB, then
it would now be set to 9 dB. In this case the device would respond with a status message of ' B04GAINIA9
'.
The numeric part of both the absolute and relative arguments can contain a '+' or '-' to indicate the algebraic
sign of the argument. If no sign is given, '+' is assumed.
The parameters associated with integer commands have maximum and minimum values associated with
them. If you try to set a parameter above its maximum or below its minimum, the parameter will be set to
its maximum or minimum value, respectively.
Parameters associated with integer commands can be queried using the '?' character. For example, if input A
's gain is set to 12, and you send ' B04GAINIA? ', the device will respond with a status message of '
B04GAINIA12 '.
command.
ACKMOD ACKMOD
refers to acknowledgement mode