Command Protocol Reference Guide
A - 27
Acknowledgements are generated when either a parameter command is
issued or a parameter changes value for some other reason. When a parameter
command is executed with the get action, the acknowledgement is only sent to
the control interface that the parameter command was received from.
When a parameter command is executed with the set, inc, dec, or tog actions,
then if the action results in the parameter changing value, the acknowledge-
ment is sent to all control interfaces on all devices, otherwise (if the action
doesn’t change the value of the parameter) the acknowledgement is sent only
to the control interface that the parameter command was received on. When a
parameter changes state for any reason (for example, command execution,
logic pin operations, etc.) an acknowledgement is sent to all interfaces on all
devices.
As an example, consider the fader command, and assume a Mic Input mono
virtual channel has been defined with the label “Microphone 1”. Also assume
the current value of the fader parameter for that channel is 3. If a control pro-
gram connected to any control interface of the SoundStructure device sends
the following command:
set fader "Microphone 1" 6.0
then the following acknowledgement will be generated,
val fader "Microphone 1" 6.0
This acknowledgement will be sent to all control interfaces on all SoundStruc-
ture devices. Now, if the control program sends this command:
get fader "Microphone 1"
then the following acknowledgement will be generated,
val fader "Microphone 1" 6.0
but this acknowledgement will only be sent to the specific device and control
interface that the control program is communicating through.
This implementation of the command protocol has been designed with these
frugal acknowledgments because some control systems have limited buffer
sizes that are susceptible to buffer overflows when large amounts of data traf-
fic are generated that the particular control port didn’t request.
When a parameter command is executed with the get action, the acknowledgement
is only sent to the control interface that the parameter command was received from.