Overview

 

Nexia can be controlled via the control dialogs in the Nexia software, or via third-party controllers using RS-232 or 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) or Telnet via TCP/IP (see Telnet Control). A line feed needs to be sent after each command string sent.

 

The NTP string is structured in the following order:

Command DeviceNumber Attribute InstanceID Index1 Index2 Value <LF>

 

NTP strings require a space between each parameter; the last character in the string 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 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 Nexia software. Custom names (Instance ID Tags) may be assigned to DSP blocks, and used in lieu of Instance ID numbers within 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

SET

1

FDRLVL

2

1

None

9

<LF>

 

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

SET

3

SMMUTEOUT

5

None

5

1

<LF>

 

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

INC

2

MMLVLXP

4

3

2

1

<LF>

 

In this example Index1 and Index2 are both used, together they specify which Crosspoint to change.