Biamp LTR - Manual (Page 203)

System Control
For control of Audia, Biamp created ATP (Audia Text Protocol). This simply means that Audia will
accept strings of ASCII characters to control and read settings of gain, mute, logic state,
frequency, audio levels, and other parameters of DSP Blocks in Audia products.
ATP strings can be sent via third-party controllers using RS-232 (see RS-232 Control ) or Telnet
via TCP/IP (see Telnet Control ). A line feed needs to be sent after each command string sent.
The ATP string is structured in the following order:
Command DeviceNumber Attribute InstanceID Index1 Index2 Value
ATP strings require a space between each parameter; the last character in the string needs to be
a line feed . A space is not required before a line feed, but is acceptable and is used in
examples shown in this manual (for legibility only). A space normally proceeds the carriage
return/line feed in a response to a GET command (see Command and Responses).
For each control string a few components will need to be derived from the Audia software: Device
Number , InstanceID , and Index . Command and Attribute are derived from this document. In a
SET command, Value is used to specify what the DSP block attribute is to be set to. In an
increment or decrement (INC or DEC) command Value is used to specify how much the DSP
block attribute is to be changed by.
**Note** Audia software will assign an Instance ID number to each DSP block on the initial
Compile of the system. Subsequent Compiles will not change the Instance ID numbers unless the
"Reassign Instance IDs" check box is selected in the ‘ Compile' tab of the ‘ Options' screen
(located on the Tools pull-down menu) in the Audia software. Custom names ( Instance ID Tags )
may be assigned to DSP blocks, and used in lieu of Instance ID numbers within ATP command
strings.
Example: A string to control a Fader Level might look like this: SET 1 FDRLVL 2 1 9 .
The individual components for this string are:
Notice that Index2 is not used since there is nothing entered in this parameter.
Example: A string to Mute a Standard Mixer Output: SET 3 SMMUTEOUT 5 5 1
The individual components for this string are:
Notice that Index1 is not used since there is nothing entered in this parameter.
183