User guide

External control user guide
March 27, 2015 Version 1.7.2.0 53
Getting and setting control values
Controls are set to a position using the cSETVALUE 'S' command. You can determine the
current setting of a control using the cGETVALUE 'G' command. The 256 values that a
control can be assigned correspond to 256 equidistant positions of a control in an NWare
project.
Note: It is not required or desirable to put a carriage return after the end-of-message (EOM)
character (.). PASHA will accept the command when it receives the EOM character. Shortly
thereafter it will return the value that the control has been set to.
To check what a control is set to, you can use the cGETVALUE 'G' command. For example, to
check the setting of a channel 1 parametric EQ center frequency control with an control alias
of tes, you send:
Gtes.
Since you are requesting a control value, you do not need to send one. If the control was set to
the midpoint of its rotation you will get a response:
Vtes80.
If you send a command using a user ID (alias) that does not exist in the project, PASHA will
respond with a cUNLISTEDUID 'U' message. For example if there was no alias eje in the
project, and you sent:
Seje48.
the response would be:
U.
Message protocol (boolean control)
If you want to control a button, such as a mute button, any value between 00 and 7F sent to the
control will result in a return value of 00. Any value between 80 and FF will result in a return
value of FF.
For example, if you send the following command to mute channel 2:
S2oM3E.
the channel mute button will be activated. Since the switch can only be on or off, it will be set
to off, and return:
V2oM00.
Message protocol (gain control)
The gain controls on most devices are non-linear. For those controls, tables are included at the
end of this section that map linear control values to dBs of gain, one for a gain control with
range of -100dB to +18dB, another for a gain control with a range of -100dB to 0dB. Also
included are tables that map control values to router channel selections (on page 62) for
various sized routers.
For example, to set the channel 2 input gain for a control with an ID of 2iG to fully
counter-clockwise (value -100), we could use:
S2iG00.