Control Blocks...........................................................................................................................................23
Meter Blocks.............................................................................................................................................24
Nexia can be controlled via the control dialogs in the Nexia software, or via third-party controllers using RS-232
Telnet.
For control of Nexia, Biamp created NTP (Nexia Text Protocol). This simply means that Nexia 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 Nexia products.
NTP strings can be sent via third-party controllers using RS-232 (see RS-232 Control
Telnet Control). A line feed needs to be sent after each command string sent.
) or Telnet via TCP/IP (see
or
The NTP string is structured in the following order:
Command
NTP strings require a space between each parameter; the last character in the st ring needs to be a line feed <LF>. 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 <CR><LF> 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 Nexia 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** Nexia software will assign an Instance ID number to each DSP block on the initial Compile
Subsequent compiles will not change the Instance ID numbers unless the "Reassign Instance IDs" check box is
selected in the ‘Compile
Custom names (Instance ID Tags
NTP command strings.
Example: A string to control a Fader Level might look like this: SET 1 FDRLVL 2 1 9 <LF>.
The individual components for this string are:
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
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 <LF>
The individual components for this string are:
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
Notice that Index1 is not used since there is nothing entered in this parameter.
Example: A string to turn up (increment) a Crosspoint on a Matrix Mixer: INC 2 MMLVLXP 4 3 2 1 <LF>
The individual components for this string are:
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
In this example Index1 and Index2 are both used, together they specify which Crosspoint to change.
’ tab of the ‘Options’ screen (located on the Tools pull-down menu) in the Nexia software.
) may be assigned to DSP blocks, and used in lieu of Instance ID numbers within
SET 1 FDRLVL 2 1 None 9 <LF>
SET 3 SMMUTEOUT 5 None 5 1 <LF>
INC 2 MMLVLXP 4 3 2 1 <LF>
5
Nexia-RS232
RS-232 Control
The RS-232 port on the back of an Nexia unit is set to a default baud rate of 38400, 8 data bits, no parity, 1 stop bit,
and no flow control. (38400:8:None:1). If multiple Nexias are connected together in a system then only one RS-232
port needs to be connected to a third-party control system; communication data is shared via Ethernet throu gh a
switch.
When controlling multiple Nexia units that are not part of the same NEX file, each Nexia unit will need to be addressed
via its own RS-232 port from a control system or PC. Nexia units cannot be linked together via RS-232, like some
other BIAMP products can.
(The RS-232 baud rate can be set to 9600, 19200, 38400, 57600, or 115200 – default is 384 00)
A straight through PC Serial Cable is used to communicate from an RS-232 port on a third-party controller (or PC*) to
the RS-232 port located on the back of an Nexia unit.
Since the Nexia's serial port does not implement flow control, waiting for a response from the Nexia is essential prio r
to sending the next command. After receiving the +OK response, the next command can be sent. By waiting for the
+OK response, the serial buffer will not be overloaded.
(* A PC can send/receive NTP Strings, using a terminal emulator program such as Hype rTerminal.)
Telnet Control
Nexia can be controlled using Telnet via TCP/IP. The same command strings that are used for RS-232 Control are
used for Telnet.
When controlling multiple Nexias that are not a part of the same NEX file, each Nexia device will need to be
addressed via its own Telnet session from a control system or PC.
Nexia supports standard Telnet Echo Negotiation. By default, the Telnet server will echo characters sent to it, one by
one.
SET – Tells
points
GET - Tells Nexia that a DSP attribute is to be read – the response may contain a decimal point and/or a negative
number
INC - Tells Nexia that a DSP attribute is to be incremented by a specific amount
DEC- Tells Nexia that a DSP attribute is to be decremented by a specific amount
RECALL – Tells Nexia that a preset is to be recalled.
DIAL – Tells the Nexia that a dial command is being sent
Nexia that a DSP attribute is to be set to a specific value – may contain negative numbers and/or decimal
(see Responses).
SETL and GETL can be used if negative numbers and/or decimals are not supported by a control system.
SETL – Tells Nexia that a DSP attribute is to be set to a specific value, no decimal places or negative numbers –To
convert a dB number: add 100 to the desired level and then multiply by 10.
Example: To set a level to –60.5dB, add 100 (-60.5 +100 = 39.5). Then multiply by 10 (39.5 X 10 = 395). Instead of
Value being –60.5, Value after this SETL command will equal 395.
GETL - Tells Nexia that a DSP attribute is to be read without negative numbers or decimals. To convert this number to
dB: divide the number by 10, then subtract 100.
Example: With a returned GETL response of 405, divide by 10 (405 / 10 = 40.5), and then subtract 100 (40.5 – 100 = -
59.5dB)
For your reference, the SETL/GETL Table on the following page shows .5dB increments converted into the
SETL/GETL format.
Some Attributes do not support all commands. The Attribute
GET/GETL, INC, or DEC functions. RECALL is only used on preset commands. DIAL is only used on telephone
dialing commands.
*When GET or GETL is used, a Value
must be specified in order for strings with SET/SETL, INC, DEC, and RECALL to work.
Note: SETD, GETD, INCD, DECD, SETLD, and GETLD commands may be used when a ‘full path’ serial response to
the command is desired (see Responses
the original command, and the resulting value or state.
will not need to be specified since GET/GETL is a request command. A Value
). A ‘full path’ serial response will provide identification of the target object,
section defines which commands support SET/SETL,
7
Nexia-RS232
Level Value Level Value Level Value Level Value Level Value
A Nexia Device Number represents the physical Nexia box’s defined address. The Nexia software automatically sets
this number when a system is Compiled
and loaded.
The Device number that a DSP block has been assigned to can be determined in 3 ways:
First Way
1. Right click on the DSP block and select ‘Properties’.
2. Click on DSP 1 attributes tab and scroll down. The device that the block is assigned to will be
:
displayed in the ‘Allocated To Unit’ field.
Index
Second Way
1. In the Display tab of the Options screen select "Display Device Assignment in DSP
Block info field". This will display the device that each DSP block is assigned to on the main screen.
Third Way
1. While connected an Nexia’s RS-232 port, type the string; GET 0 DEVID
Nexia will return the Device Number of the unit you are connected to.
:
:
9
Nexia-RS232
Attribute
The Attribute defines the portion of the DSP block to be controlled (fader level, crosspoint mute etc). The following
tables show whether each NTP Attribute supports SET/SETL, GET/GETL, INC, and DEC Commands
, as well as the
Value range that the Attribute will accept. Index1/Index2 determines whether Index1, Index2 or BOTH are needed for
a NTP String to be complete.
NTP Strings can address: (click on the links to view the tables in each topic)
Analog Inputs Attribute Commands Index Value Range
Input Gain INPGAIN SET, SETL, GET, GETL, INC,
DEC
Input Level INPLVL SET, SETL, GET, GETL, INC,
1 0, 6, 12, 18, 24, 30, 36,
42, 48, 54, 60, 66
1 -100 ~ 12 *
DEC
Phantom Power PHPWR SET, GET 1 0 = off
1 = on
Input Mute INPMUTE SET, GET 1 0 = unmuted
1 = muted
Invert Polarity INPINVRT SET, GET 1 0 =normal
1 = inverted
* Can contain a decimal number.
Note: Nexia SP Line Inputs only support input gain values of 0, 6, 12, & 18 (dB).
Example: Set Device 1 Input Level at Instance ID 6, Input 3 to –10dB.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 INPLVL 6 3 None -10 <LF>
Result: SET 1 INPLVL 6 3 –10 <LF>
The following table of Attributes is valid for all Nexia output blocks except
Note: PM Output faders can be ganged as pairs: 1 & 2, 3 & 4, and 5 & 6.
Index2 is used to indicate either one of the Outputs in the pair to be ganged (not both).
Example: Set Device 1 PM Output Gang at Instance 5 Output 2 to ganged (Outputs 1 & 2 ganged).
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
Example: Set Device 1 AEC NLP Strength at Instance ID 24, Input 3 to aggressive.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 AECNLP 24 3 None 3 <LF>
Result: SET 1 AECNLP 24 3 3 <LF>
12
Index
TC Dialer Attribute Commands Index Value Range
Caller ID TICID GET None None
Full User Caller ID TICIDUSER GET None None
Hook-Flash TILINE FLASH None None
Hook-Switch
State
Speed Dial
Tel. Number
Speed Dial
TIHOOKSTATE SET, GET None 0 = off-hook
1 = on-hook
TISDENTRY SET, GET 1 enter the phone
number
TISDLABEL SET, GET 1 enter the name
Name
Last Number
TILASTNUM GET None None
Dialed
Speed Dial
TISPEEDDIAL DIAL None 1 ~ 16
Entry to Dial
Phone Number
to Dial
TIPHONENUM DIAL None enter the phone
number
Redial TILASTDIALED DIAL None none
Note: The TC can insert delay while dialing a phone number by inserting commas where desired (each comma
provides 1 second of delay). Most PBX systems require delay after acquiring an outside line. Also, multiple
TIPHONENUM commands can be used to dial the individual digits of a phone number. The TIPHONENUM command
has a character limit of 32 characters for the "value" field.
Example: Get Device 1 TC Caller ID Information at Instance 23
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
GET 1 TICID 23 None None None <LF>
Result: GET 1 TICIDUSER 23 <LF>
Note: GET 1 TICID 23 will return: "" if there is no caller ID information available. If there is CID information available,
it will return in the format "MMDDHHmmXXXXXXXXXX" where the "X's" represent the ten digit phone number. For
example "040211235035551212".
Example: Get Device 1 TC Full User Caller ID Information at Instance 23
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
GET 1 TICIDUSER 23 None None None <LF>
Result: GET 1 TICIDUSER 23 <LF>
Note: GET 1 TICIDUSER 23 will return: "" "" "" if there is no caller ID information available. The first set of quotes
contains the date and time in the format MMDDHHmm. The second set of quotes represents the incoming phone
number in the format 5036417287. The third set of quotes contains the name of the caller. If there are quotes
contained within the name, there will be a backslash preceding the quotes within the name, i.e. "David \"Dawg\" Grisman".
Example: Set Device 1 TC Speed Dial Entry at Instance 23 Speed Dial 16 to 1-800-826-1457.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
FLASH 1 TILINE 23 None None None <LF>
Result: FLASH 1 TILINE 23 <LF> (dashes in phone number are optional)
Example: Set Device 1 TC Speed Dial Entry at Instance 23 Speed Dial 16 to 1-800-826-1457.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 TISDENTRY 23 16 None 18008261457 <LF>
Result: SET 1 TISDENTRY 23 16 18008261457<LF> (dashes in phone number are optional)
13
Nexia-RS232
Example: Dial Device 1 TC Phone Number To Dial at Instance 23 of 1-800-826-1457.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
Example: Mute the TC Transmit Block at Instance ID 21
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 TITXMUTE 21 None None 1 <LF>
None -100 ~ 0 *
1 = muted
* Can contain a decimal number.
Result: SET 1 TITXMUTE 21 1 <LF>
14
Index
Mixer Blocks
Automixer Attribute Commands Index Value Range
Input Level AMLVLIN SET, SETL, GET, GETL, INC,
1 -100 ~ 12 *
DEC
Output Level AMLVLOUT SET, SETL, GET, GETL, INC,
2 -100 ~ 12 *
DEC
Input Mute AMMUTEIN SET, GET 1 0 = unmuted
1 = muted
Output Mute AMMUTEOUT SET, GET None 0 = unmuted
1 = muted
Crosspoint Mute AMMUTEXP SET, GET 1 1 =unmuted
0 = muted
Logic Output AMLOGOUT GET 2 0 = off
1 = on
* Can contain a decimal number.
Note: Typically, Index1 represents the input/row, and Index2 represents the output/column. However, Automixers
have only a single output and, therefore, Index2 is not used to specify an output/column.
Example: Set Device 1 Automixer Crosspoint Mute at Instance 3 Crosspoint 1 to muted.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 AMMUTEXP 3 1 None 0 <LF>
Result: SET 1 AMMUTEXP 3 1 0 <LF> (Automixers have only 1 output, so Index2 is not required)
Note: For attributes with 2 Index fields, Index1 is the input/row, and Index2 is the output/column.
15
Nexia-RS232
Room Combiner Attribute Commands Index Value Range
Wall State RMCMBWALL SET, GET 1 0 = down
1 = up
Output Level RMCMBLVL SET, SETL, GET, GETL, INC,
DEC
Output Mute RMCMBMUTE SET, GET 2 0 = unmuted
Group State RMCMBGROUP SET, GET 1 0 ~ 16
+ Note: The behavior of RMCMBGROUP is the same as that of the "Set Selected Group" commands in the right-clickcontext menus of the Room Combiner dialog screen in Nexia Software: the specified room is either separate (group 0)
or combined with other rooms of the selected group (1~16). All other rooms maintain their p re viou s group
assignments. Index1 represents the room being addressed. As rooms are com bined, room levels become ganged, so
only one output level needs to be addressed.
Note: For Wall State, Index1 indicates the wall to be affected and Value indicates the actual wall state
(down=open=combined; up=closed=separated).
Example: Set Device 1 Room Combiner Wall State at Instance 4 Wall 2 to up (close/separate).
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 RMCMBWALL 4 2 None 1 <LF>
Result: SET 1 RMCMBWALL 4 2 1 <LF>
Auto-Mixer
Combiner
Group State MCMBGROUP SET, GET 1 0 ~ 32
Attribute Commands Index Value Range
2 -100 ~ 12 *
1 = muted
* Can contain a decimal number.
Note: Index1 is the input being addressed. Value is the group; this is represented by a letter in Nexia software, but
addressed as a number in ATP commands. (Example: ungroup=0, A=1, B=2, C=3….)
Note: The Auto-Mixer Combiner was previously the Mix-Minus Combiner. The above command will continue to work
with a Mix-Minus Combiner block in a previously created Nexia file with a Mix-Minus Combiner.
16
Equalizer Blocks
Graphic EQ Attribute Commands Index Value Range
EQ Band Level GEQLVLBND SET, SETL, GET, GETL, INC,
DEC
Bypass All Bands GEQBYPALL SET, GET None 0 = active
Note:
Index1 represents the filter to be controlled. Graphic EQ filters are numbered from left to right, and the selected
band is displayed in the upper left hand
Index1 for Graphic EQ strings.
Example: Set Device 2 Graphic EQ Bypass All Bands at Instance 9 to bypass.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 2 GEQBYPALL 9 None None 1 <LF>
Result: SET 2 GEQBYPALL 9 1 <LF>
Parametric EQ Attribute Commands Index Value Range
EQ Bandwidth PEQBWBND SET, SETL, GET, GETL 1 0.010 ~ 4.000 *
Bypass EQ Band PEQBYPBND SET, GET 1 0 = active
Center Freq. PEQFCBND SET, SETL, GET, GETL, INC,
EQ Band Level PEQLVLBND SET, SETL, GET, GETL, INC,
Bypass All Bands PEQBYPALL SET, GET None 0 = active
Note:
Index1 represents the filter to be controlled. Parametric EQ filters are initially numbered from left to right, and
the selected band is displayed in the upper left hand
Use this number as
Example: Increment Device 1 Parametric EQ Band Level at Instance 11 Band 2 by 2dB.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
INC 1 PEQLVLBND 11 2 None 2 <LF>
Result: INC 1 PEQLVLBND 11 2 2 <LF>
Feedback
Suppressor
Reset All Filters FBSRESET SET None None
Fix All Filters FBSFIXALL SET, GET None 0 = not fixed
Example: Set Device 1 Feedback Suppressor Reset All Filters at Instance 4.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 FBSRESET 4 None None None <LF>
Result: SET 1 FBSRESET 4 <LF>
Index1 for Parametric EQ strings.
Attribute Commands Index Value Range
corner of the Graphic EQ dialog screen in Nexia software. Use this number as
DEC
DEC
corner of the Parametric EQ dialog screen in Nexia software.
1 -30 ~ 15 *
1 = bypassed
* Can contain a decimal number.
1 = bypassed
1 20 ~ 20000
1 -30 ~ 15 *
1 = bypassed
* Can contain a decimal number.
1 = fix all
Index
17
Nexia-RS232
Filter Blocks
HPF Attribute Commands Index Value Range
Cut-Off Freq. HPFLTFC SET, SETL, GET, GETL, INC,
DEC
Filter Bypass HPFLTBYP SET, GET None 0 = active
LPF Attribute Commands Index Value Range
Cut-Off Freq. LPFLTFC SET, SETL, GET, GETL, INC,
DEC
Filter Bypass LPFLTBYP SET, GET None 0 = active
High Shelf Attribute Commands Index Value Range
Cut-Off Freq. HSFLTFC SET, SETL, GET, GETL, INC,
DEC
Gain HSFLTGAIN SET, SETL, GET, GETL None -27 ~ 9 *
Filter Bypass HSFLTBYP SET, GET None 0 = active
Low Shelf Attribute Commands Index Value Range
Cut-Off Freq. LSFLTFC SET, SETL, GET, GETL, INC,
DEC
Gain LSFLTGAIN SET, SETL, GET, GETL None -27 ~ 9 *
Filter Bypass LSFLTBYP SET, GET None 0 = active
Example: Set Device 1 High Shelf Filter Gain at Instance 100 to -10dB.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 HSFLTGAIN 100 None None -10 <LF>
Result: SET 1 HSFLTGAIN 100 –10 <LF>
All-Pass Shelf Attribute Commands Index Value Range
Index1 = 1 is the low-pass filter cut-off frequency
Index1 = 2 is the high-pass filter cut-off frequency
3-Way crossover
:
Index1 = 1 is low-pass filter cut-off frequency
Index1 = 2 is the lower slope of the mid filter cut-off frequency
Index1 = 3 is the higher slope of the mid filter cut-off frequency
Index1 = 4 is the high-pass filter cut-off frequency
4-way crossover
:
Index1 = 1 is the low-pass filter cut-off frequency
Index1 = 2 is the lower slope of the low-mid filter cut-off frequency
Index1 = 3 is the higher slope of the low-mid filter cut-off frequency
Index1 = 4 is the lower slope of the mid-high filter cut-off frequency
Index1 = 5 is the higher slope of the mid-high filter cut-off frequency
Index1 = 6 is the high-pass filter cut-off frequency
Example: Get Device 2 Crossover 3-Way Cut-Off Frequency at Instance 40 Low-Pass filter.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
Example: Set Device 1 Source Selection Source at Instance 99 Source 2 selected.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 SRCSELSRC 99 1 None 2 <LF>
Result: SET 1 SRCSELSRC 99 1 2 <LF>
Example: Set Device 1 Source Selection Volume at Instance 99 to -54 dB for source input 3.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 SRCSELLVL 99 3 None -54 <LF>
Result: SET 1 SRCSELLVL 99 3 -54<LF>
In this example, Index 1 represents the input source, where in the previous example, Index 1 represents the output
Value Range is from 0 to the maximum value for the specific delay block. For example, a 50mSec delay has a
maximum setting of 1717 centimeters, 17 meters, 676 inches, or 56 feet.
Example: Set Device 1 Delay In Centimeters at Instance 24 to 40 centimeters.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
SET 1 DLYCM 24 None None 40 <LF>
Result: SET 1 DLYCM 24 40<LF>
22
Index
Control Blocks
Level Faders Attribute Commands Index Value Range
Fader Levels FDRLVL SET, SETL, GET, GETL, INC,
1 -100 ~ 12 *
DEC
Mute Fader FDRMUTE SET, GET 1 0 = unmuted
1 = muted
* Can contain a decimal number.
Mute Button Attribute Commands Index Value Range
Mute MBMUTE SET, GET 1 0 = unmuted
1 = muted
Logic State Attribute Commands Index Value Range
Logic State LGSTATE SET, GET 1 0 = off
1 = on
Presets Attribute Commands Index Value Range
Preset PRESET RECALL 1 1001 ~ maximum
preset number
Note: Instead of SET, SETL, GET, GETL, INC, or DEC; the Preset attribute uses RECALL as the command. Preset
numbers begin at 1001. Regardless of preset name, the first preset defined is 1001, the second is 1002, an d so forth.
However, the numbers of any deleted Presets will not be available. Since Presets apply to entire systems, the Device
Number will always be 0 for Preset strings.
Example: Recall Device 0 Preset number 1001.
Command Dev # Attribute Inst ID Index 1 Index 2 Value Line Feed
Nexia uses an Instance ID number to specify the exact DSP block to be controlled. Custom names (Instance ID Tags)
may be assigned to DSP blocks, and used in lieu of Instance ID numbers within NTP command strings. Instance ID
Tags may be up to 32 characters, but may not start with a number or contain the following characters: <&>'".. If the
Instance ID Tag includes spaces, it must be double-quote delimited ("Instance ID Tag") when used in a command
string. The Instance ID number (and Instance ID Tag) can be found by right-clicking the DSP block and selecting
"Properties". Both identifiers are available on the DSP Attributes 1 tab.
The property sheet can only be accessed in an off-line screen.
**Note** Nexia software assigns an Instance ID number to each DSP block on the initial system Compile
. 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 menu) in Nexia software.
If one or more DSP block is disconnected from the audio path (when connections are not made to at least one input or
output) Instance ID numbers will be unassigned. Instance ID numbers will be reassigned once the DSP blocks are
properly connected again. The use of Instance ID Tags (in lieu of Instance ID numbers) may help prevent command
string conflicts caused by reassignment of Instance ID numbers.
26
Index
Index
Index refers to inputs, outputs, or cross points of an Attribute
. Some Attributes will need an Index1 (Input or Row)
and/or an Index2 (Output or Column). The tables in the Attribute section will define which, if any, indexes are required
for the string.
Example: INC 1 AMLVLIN 4 1 1 <LF>
In an Auto Mixer on Device 1 we are increasing the level of input 1 on instance ID 4 by 1dB. Index1 is used to
represent the input number.
Example: DEC 2 AMLVLOUT 6 1 2 <LF>
In an Auto Mixer on Device 2 we are decreasing the level of output 1 on instance ID 6 by 2dB. Index2 is used to
represent the output number.
Example: SET 1 MMLXP 5 1 2 –5 <LF>
In a Matrix Mixer on Device 1 we are setting crosspoint 1:2 (Input/Row 1, Output/Column 2) level to –5dB on instance
ID 5.
Note: For commands with 2 Index fields, Index1 is the Input/Row, and Index2 is the Output/Column.
27
Nexia-RS232
Value
Value determines what a DSP block is being set to, incremented by, or decremented by. The Attribute
section will
define which type of value the string will need in order to execute the NTP string.
Example: INC 1 AMLVLIN 4 1 1 <LF>
In an Automatic mixer input level string, the Value equal to 1 states that the fader is to be incremented by 1 dB.
Example: SET 2 MMLVLIN 5 2 –100 <LF>
In a matrix mixer input level string, the value is set to –100dB.
Example: RECALL 1 PRESET 1004 <LF>
For a preset recall we are telling device 1 to recall the fourth preset.
*When GET is used, a Value will not need to be specified since GET is a request command. A Value must be set in
order for SET, INC, DEC, and RECALL command strings to work.
Example: GET 4 MMLVLOUT 5 <LF>
We are asking the level of a matrix mixer’s output. There is no Value required for this string.
28
Index
Responses
When a successful SET, SETL, INC, DEC, or RECALL command is sent to an Nexia device via RS-232 or Telnet,
Nexia will respond with: ‘+OK’ followed by a carriage return and line feed.
Example: Sending the string: SET 2 AMLVLIN 4 2 1 < LF> will result in an: +OK<CR><LF> response.
A successful GET or GETL command will result in a numerical response to the command string followed by
<CR><LF>.
The response from an NTP string with a GET command may contain a decimal point (with 4 numbers after the
decimal) and/or negative numbers, depending on type of Attribute addressed. If the control system does not support
negative numbers or decimal places a GETL command may be used instead (see page 6).
Example: After sending the above example to an Nexia device the string:
GET 2 AMLVLIN 4 2<LF> would result in the response: 1.0000 <CR><LF> this tells us that the level is currently set to
1dB.
If an incorrect command string is sent, an Nexia will respond with: -ERR<CR><LF>
A space normally proceeds the carriage return/line feed <CR><LF> in a response to a GET command, but this space
is not present in the standard ‘+OK’ or ‘-ERR’ responses.
Note: SETD, GETD, INCD, DECD, SETLD, and GETLD commands may be used when a ‘full path’ serial response to
the command is desired. A ‘full path’ serial response will provide identification of the target object, the original
command, and the resulting Value. A ‘full path’ response to a valid command will always begin with a poun d sign (#)
and end normally (as described above).
It should be noted that, unlike SETD commands/responses, INCD or DECD co mmands and responses will most often
contain different Values. This is because SETD commands specify an exact Value (which will be the same in the
response), whereas, INCD and DECD commands specify a ‘change’ in Value.
29
Nexia-RS232
Control Dialog - Overview
Nexia software can be used to control Nexia units real time via a network. After connecting to a Nexia device, users,
technicians, and designers (as determined by passwords) can ac cess their appropriate level of control of the system.
Depending on the authorized access level of control Levels, Meters, Presets, and layers can be accessed and
changed.
Level Control, Invert, Meter, and Preset block control dialog screens can be minimized and arranged to provide a
simple, and intuitive, user interface for the system. Connecting Nexia’s Ethernet port, through a switch, to network
jacks in various locations can provide control to the system from different locations via a Lapto p or Desktop computer.
Note: Nexia’s control network can be easily shared on an existing network without compromising network bandwidth.
This includes Ethernet connections, but not NexLink which remains separate.
30
Control Dialog - Levels, Presets, & Meters
Levels
Once Level Controls are placed in a signal path audio levels can be increased, decreased or muted as needed.
Index
Presets
Once Presets are created, Preset buttons can be placed on screen and used to easily recall different scenarios.
Meters
If meters are placed on screen, users can view real time Signal Present, RMS, Peak, and Logic indications.
31
Nexia-RS232
HyperTerminal
HyperTerminal is a useful tool that comes with Windows® and can be used for RS-232 purposes. Simply open a
HyperTerminal session by going to: Start> Programs> Accessories> Communications> HyperTerminal. En ter a name
for your connection and click ‘OK’. Under the pull-down menu labeled ‘Connect Using’ select the location of your RS232 Comm. port.
Under the Comm. port properties set it to 38400, 8, None, 1, and None as shown below. Now HyperTerminal is ready
to use. Nexia does not echo characters typed, so if you want to view what is being typed into Nexia, click on "echo
typed characters locally" in the ASCII setup screen.
Windows® is a registered trademark of Microsoft Corporation.
IP Address Commands
Audia has some useful IP and reset tools that may be useful when returning to older systems for service work.
32
Index
Audia will automatically output its IP Address through the RS-232 port when it is powered up and functioning. Simply
have a straight through RS-232 cable connected to Audia and a PC with HyperTerminal running. Wh en Audia is
powered up it will print the data in the HyperTerminal screen.
Get Device ID
By typing "GET 0 DEVID <LF>" in HyperTerminal, Audia will reveal the device number that is assigned to that
particular device within the system. If an Audia does not have a system loaded into it, the device ID will always be "0".
Device ID "0" is always used for network related ATP commands and reset related commands.
Get/Set IP Address
By typing "GET 0 IPADDR <LF>" in HyperTerminal Audia will reveal the IP Address it is set to. Substituting the "0" for
a 1, 2, 3, etc will tell Audia to reveal the IP Address for the device who’s number is 1, 2, 3 etc. A "0" asks for the IP
Address of the Audia you are currently connected to. Note: You can only use a 1, 2, 3 etc if there is a system loaded
into the Audia's. If it is a single device system, the only device number will be 1.
If an Audia does not have a system loaded into it, you can set the IP Address via the RS-232 port. Example: "SET 0 IPADDR 192.168.1.101 <LF>". If there is no DAP file in the Audia, and the command is typed correctly, Audia will
send back a "+OK" response. You will need to power cycle the Aud ia for the new IP Address to take effect. As stated
above, Audia will output the IP Address when powered up, or you can use the GET IPADDR command mentioned
above.
Get/Set Subnet Mask
By typing "GET 0 SUBNETMASK <LF>" in HyperTerminal, Audia will reveal the Subnet Mask it is set to use.
Substituting the "0" for a 1, 2, 3, etc will tell Audia to reveal the IP Address for the device who's number is 1, 2, 3 etc. A
"0" asks for the IP Address of the Audia you are currently connected to. Note: You can only use a 1, 2, 3 etc if there is
a system loaded into the Audia's. If it is a single device system, the only device number will be 1. By default, the
subnet mask is set to 255.255.255.0
If an Audia does not have a system loaded into it, you can set the Subnet Mask via the RS-232 port. Example: "SET 0 SUBNETMASK 255.255.255.0 <LF>". If there is no DAP file in the Audia, and the command is typed correctly, Audia
will send back a "+OK" response. You will need to power cycle the Audia for the new subnet mask to take effect. As
stated above, Audia will output the default gateway IP Address when powered up, or you can use the GET
SUBNETMASK command mentioned above.
Get/Set Default Gateway Address
By typing "GET 0 DEFAULTGW <LF>" in HyperTerminal Audia will reveal the Default Gateway IP Address it is set to
use. Substituting the "0" for a 1, 2, 3, etc will tell Audia to reveal the IP Address for the device who's number is 1, 2, 3
etc. A "0" asks for the IP Address of the Audia you are currently connected to. Note: You can only use a 1, 2, 3 etc if
there is a system loaded into the Audia’s. If it is a single device system, the only device number will be 1.
If an Audia does not have a system loaded into it, you can set the Default Gateway IP Address via the RS-232 port.
Example: "SET 0 DEFAULTGW 192.168.1.1 <LF>". If there is no DAP file in the Audia, and the command is typed
correctly, Audia will send back a +OK response. You will need to power cycle the Audia for the new default gateway
IP Address to take effect. As stated above, Audia will output the default gateway IP Address when powered up, or you
can use the GET DEFAULTGW command mentioned above.
Get MAC Address
By typing "GET 0 MACADDRESS <LF>" in HyperTerminal Audia will reveal the MAC Address of the Audia’s network
interface. Substituting the ‘0’ for a 1, 2, 3, etc will tell Audia to reveal the MAC Address for the device who's number is
1, 2, 3 etc. A "0" asks for the MAC Address of the Audia you are currently connected to. Note: You can only use a 1,
2, 3 etc if there is a system loaded into the Audia's. If it is a single device system, the only device number will be 1.
33
Nexia-RS232
Reset
In rare instances it may become necessary to reset the Audia device. A reset can be accomplished through the device
maintenance screen, and this is the desired method for a reset. However, there is a reset command availab le via the
RS-232 port. Simply type: "CLEAR 0 DEVCONFIG <LF>"
Reboot Device
When needed, the Audia can be restarted without suspending audio. Simply type: "REBOOT 0 DEVICE". This will
restart a single Audia device without suspending audio.