The communication between the Vortex and a host controller is conducted via the RS-232 port on the back panel of the Vortex. The Vortex's RS-232 port operates at the following settings:

●

Bit Rate (bps): 9600 (default), 19200, or 38400

●

Data Format: 8 data bits, no parity, 1 stop bit (8N1)

●

Flow Control: none (default) or hardware (RTS, CTS)

Note that although the flow control setting is user selectable to none or hardware, hardware flow control must be used when updating the firmware of the Vortex. This means that while a 3-wire RS-232 cable (RX,

TX, GND) is acceptable for control of the Vortex, the minimum cable for updating firmware should contain 5 wires (RX, TX, RTS, CTS, GND).

3. Programming Tips

3.1. Initialization

During power up of the Vortex device or initialization of the host program, electrical fluctuations on the RS-

232 lines may cause the Vortex to receive spurious data. After initialization, the host program should send a few carriage return characters (^M, ASCII 13) to the connected Vortex to flush out any spurious characters it may have received. Failure to do this could result in the Vortex ignoring the first command received after initialization.

As part of the host program initialization, the host will want to synchronize the status of its controls with the current status of the Vortex devices that are being controlled. The host could initialize its controls to default values and then send commands to the Vortexes to set them to the same state. This approach has significant disadvantages since initializing the host program could undo settings made by other host programs or by the front panel controls of one of the linked Vortex devices. A better approach is to query the linked Vortex devices for their status and set the host program controls based on the return values.

3.2. Wildcard Characters

The use of the wildcard character, '

', can make programming the host controller much easier. Be careful when using wildcards, however, since they can generate a lot of traffic on the digital bus.

3.3. Using Acknowledgements

It is a good idea for the host program or control system to make sure that all connected Vortex devices have

acknowledgment mode enabled (see the

ACKMOD

command). When acknowledgment mode is on, a Vortex

device will send an acknowledgment for each command it receives. Proper use of acknowledgments makes the host program more robust and makes supporting multiple hosts effortless. The rest of this section describes how to use acknowledgments to achieve these goals.

As a convenient example, let us imagine a host program with a graphical user interface (GUI). The user presses buttons on the GUI to enable or disable features of various linked Vortex devices. The buttons on the

GUI reflect the current status of the corresponding feature.

When the user presses a button on the GUI to enable or disable a feature, the host program should send the corresponding command to the selected Vortex device. It may be tempting to update the status of the GUI button at this point, but this can cause problems if there are transmission errors or if there are multiple host controllers. The proper way to handle this is to only update the GUI controls based on acknowledgments received from the Vortex device.

To implement this, organize your code so that the functions that send commands are totally separate from the functions that receive responses from the Vortex devices. This also enables your host program to support the presence of multiple host controllers. For example, consider the following sequence of events.

1. Another host sends a command to a Vortex device.

2. The Vortex device responds with an acknowledgment that is broadcast to all of the other hosts.

3. Your host program receives the acknowledgment and updates the status of the corresponding control.

The result of this programming model is that all hosts and linked Vortex devices will always be synchronized.

For simple on/off features, your host program can make use of the toggle arguments to some commands

(e.g., '

SSEN2

'). By sending a toggle command when a button is pressed, and updating the button based on acknowledgments, your host program will not have to keep track of the status of the button.

In a similar fashion, many of the integer commands (such as gains) can be controlled by incrementing or decrementing them by a specific amount. For example, the command '

GAINIA>1

' increments the input gain on channel A by 1 dB. The acknowledgment for this command will return the actual value that the gain was incremented to. Thus, to implement a volume control, your control program can send a command to increment the gain by 1 dB when the "up" button is pressed and decrement the gain by 1 dB when the

"down" button is pressed. The control can update its level indicator based on the acknowledgment that is received.

3.4. Macros and Presets

Although macros and presets are similar, there are times when using one is better than the other. Presets store the absolute values of all of the non-global settings of the device. This includes, but is not limited to, input and output gain settings, matrix settings, algorithm settings, parametric EQ settings, and automixer

settings. See Section 7 for a list showing all the commands and which are saved to presets.

Presets should be used when you really want to change all the settings in a device. One example would be when you want to have one unit be able to control different rooms. In this case, having a preset for each different room is the easiest solution.

Macros are like mini-presets. You can define them to change only the settings you are interested in. One advantage of macros over presets is that macros can make relative changes in addition to absolute changes.

An absolute change is something like "set the input gain to -3 dB". A relative change is something like "raise the input gain by 3 dB". One example of using macros for a relative change is stereo volume ramping. If you have two outputs setup to have left and right program audio, then you could build a macro that contains two commands: one to increment the left channel by 1 dB and the other to increment the right channel by 1 dB.

Then, by calling that macro, you can ramp the stereo outputs. A similar thing can be done with decreasing the volume.

Another thing to consider when using macros and presets is to use the

instead of the

and

versions execute the macro or preset, but the

versions produce acknowledgements for the settings that change, while the

versions don't. If your control system updates its status by looking at the acknowledgements that come back, then you'll probably want to use the

versions. Another option would be to use the

versions and then manually query the values you're interested in. If your control system does not need use acknowledgements, or if you are manually querying the values you're interested in, using the

versions is better since it doesn't generate acknowledgements and thus reduces RS-232 traffic.

3.5. Automixer Dependencies

The commands

have dependencies on each other

and can cause errors (

ERROR#040

through

ERROR#045

) if an assignment attempts to break one of these dependencies. See the descriptions of the above commands and the

ERROR

command for more information on these dependencies.

The dependencies in these commands can cause a problem when trying to build macros. For example, your macro may use the above commands to set the automixer to a certain configuration. The problem is that although your commands would put the automixer in a valid configuration, one of the intermediate configurations might be invalid. If this happens, the invalid command(s) will not execute and the automixer will not be in the configuration that you intended.

For example, assume that we start with all inputs assigned to automixer group "none" (

) is disabled for both automixers, chairman mic (

AMCHNUM

) is set to 1 for both automixers,

last mic mode (

AMLMM

) is set to off for both automixers, and last mic number (

AMLMN

) is set to 1 for both automixers. Now, suppose your macro executes the following commands in the order shown.

AMASGN*ààåå

(assign inputs 1-2 to automixer 1 and inputs 3-4 to automixer 2)

AMCHAIR11

AMCHAIR21

AMCHNUM11

AMCHNUM23

AMLMM11

AMLMM21

AMLMN23

In this case, the

AMCHAIR21

command and the

AMLMM21

would not get executed. They would produce

ERROR#044

and

ERROR#042

, respectively. The

AMCHAIR21

command causes an error because we try to turn on chairman mode for automixer 2, but automixer 2's chairman mic is set to 1, whic belongs to automixer 1. Similarly, the

AMLMM21

command causes an error because we try to set last mic on mode to manual for automixer 2, but automixer 2's last mic number is set to 1, which belongs to automixer 1.

There are many other ways that these dependencies can cause problems. Fortunately, there is a way to avoid them. In you command sequences and macros, follow the following sequence when dealing with the automixer paramters.

● turn off chairman mode (

AMCHAIR

) for both automixers

● set last mic mode (

AMLMM

) off for both automixers

●

ungate all matrix crosspoints (

MGATE

) that correspond to inputs that you will be changing

●

Now, execute your automixer commands in the following order:

4. Command Structure

A Vortex command consists of a series of ASCII characters with the following structure.

Description

Device Type

Device ID

Command Name

Command Data

Command Terminator

Number of Characters

1-7

0-64

Range of Values

0-9, A-Z, *

0-9, *

0-9, A-Z

ASCII characters

(ASCII 13)

4.1. Device Type

A single alphanumeric character is used to indicate the device type. The devices in Polycom's EchoFree family have the following device types.

Device

EF200

EF1210

EF2280

EF2241

EF2211

EF2210

EF2201

Device Type

Device type '

' can be used to send a command to all device types simultaneously.

4.2. Device ID

Two numeric characters are used to indicate the device ID. The Vortex can be configured for device IDs from

' to '

'. Note that even though the device ID is less than 10, the leading '

' must be included. Device ID

' can be used to send a command to all device IDs simultaneously. Some examples of using wildcard characters are given below.

●

B**

' broadcasts to all EF2241 devices that are linked together.

●

*07

' broadcasts to all devices with device ID 07 (this format is not commonly used).

●

***

' broadcasts to all devices that are linked together.

4.3. Command Name

The command name can be from 1 to 7 characters long. Command names will be specific to device types. In other words, the EF2280 has its own command set, which is different from the EF2241's, which is different from the EF1210's, etc. There are some commands, such as '

PING

', that are common among all the various command sets.

4.4. Command Data

The command data is a series of 0-64 characters containing payload data for the command. Obviously, the command data will be specific to the command type. note that the maximum number of payload characters for the EF200 and EF1210 is 32, but the Vortex devices support up to 64 characters in the payload. This increase was necessary to accommodate the matrix gain and macro/preset commands.

4.5. Command Terminator

The command terminator is a single character indicating the end of a command. ASCII 13 (

) was chosen as the terminator to allow manually typing commands using a simple text terminal.

4.6. Examples

In the following examples, Vortex commands are enclosed in single quotes, ' like this

'. Also, the terminator character is not explicitly shown, but its presence is implied.

Consider the command '

***PING

'. The device type and ID for this command are wildcards, thus the command will be sent to all devices. The command name in this case is '

PING

', and there are no data characters (payload). Note that the '

PING

' command is supported by all of the Vortex devices, thus broadcasting the command to all devices makes sense.

Consider the command '

B**GAINIA10

'. The device type for this command is '

' and the device ID is a wildcard, thus the command will be broadcast to all EF2241 devices linked together. The command name in this case is '

GAINIA

' and the command data (payload) is '

'. This command sets the gain on input A of all connected EF2241's to 10 dB.

Command

***PING

B**GAINIA10

Effects

Requests

PONG

response from all linked Vortex devices.

Sets the gain on input A of all connected EF2241 devices to 10 dB.

5. Status Messages

The Vortex sends status messages via RS-232 and EF Bus any time one of its internal parameters changes.

This means that the host program does not need to continually poll the Vortex in order to detect status changes. Status messages are in the same format as the commands used to set the corresponding parameter.

For example, suppose you send the command '

B**GAINIA10

' and there are two EF2241's linked together with device IDs 3 and 7. The EF2241's will respond with '

B03GAINIA10

' and '

B07GAINIA10

', respectively.

Now, someone uses the front panel of the EF2241 set to ID 7 to decrease input A's gain by 1 dB. When this happens, the EF2241 will respond with '

B07GAINIA9

'. This example illustrates that status messages can be

sent as the result of an RS-232 command or as the result of some other change in the Vortex device such as front panel adjustments, logic inputs, etc.

Status messages can be turned off via the

ACKMOD

command.

ACKMOD

refers to acknowledgement mode since the term status message and acknowledgement are synonymous for our purposes.

6. Command Types

Many of the Vortex commands have similar formats. The main formats are described here in order to provide a better understanding of the command set.

6.1. Boolean Commands

Boolean commands take one of the three following arguments.

●

' indicates that the parameter should be turned off.

●

' indicates that the parameter should be turned on.

●

' indicates that the parameter should be toggled (i.e., '

' becomes '

' and '

' becomes '

').

Parameters associated with boolean commands can be queried using the '

' character. For example, if input

A is muted, and you send '

B04MUTEIA?

', the EF2241 will respond with a status message of '

B04MUTEIA1

'. When a status message is generated for a boolean command, the command data will either be a '

' or '

', since '

' is obviously not a valid state.

6.2. Integer Commands

Integer commands can take one of two types of arguments. The first argument type is absolute, meaning that the parameter will be set to the specified number. For example, '

B04GAINIA10

' means that the gain on input A will be set to 10 dB. In this case, the device will respond with a status message of '

B04GAINIA10

The second argument type is relative, meaning that the parameter will be incremented or decremented by the specified amount. The increment character is '

' and the decrement character is '

'. For example, '

B04GAINIA>3

' increments the gain on input A by 3 dB. If the input's gain was previously set to 6 dB, then it would now be set to 9 dB. In this case the device would respond with a status message of '

B04GAINIA9

The numeric part of both the absolute and relative arguments can contain a '

' or '

' to indicate the algebraic sign of the argument. If no sign is given, '

' is assumed.

The parameters associated with integer commands have maximum and minimum values associated with them. If you try to set a parameter above its maximum or below its minimum, the parameter will be set to its maximum or minimum value, respectively.

Parameters associated with integer commands can be queried using the '

' character. For example, if input A

's gain is set to 12, and you send '

B04GAINIA?

', the device will respond with a status message of '

B04GAINIA12

6.3. Channel Commands

A command can be a channel command in addition to being one of the other types of commands (integer or boolean). A channel command means that the command applies to a specific input or output channel. The channel is specified by a single character (e.g., '1', '2', 'A', 'B', etc.) occurring before any other payload data.

An example of a boolean channel command is the '

AGC

' (Automatic Gain Control) command. '

B04AGC30

' disables the AEC on input channel 3 . After sending this command, the device will respond with a status message of '

B04AGC30

An example of an integer channel command is the '

GAINI

' command, which adjusts the gain on the input channels. '

B04GAINIA12

' sets the input gain of channel A to 12 dB. After sending this command, the device will respond with a status message of '

B04GAINIA12

A wildcard character ('

') can be used as the channel specifier for many of the channel commands. If this is the case, there are two options for specifying the values for the channels. The first method is to specify a single value that will be applied to all the channels.

Take the

MUTEI

command for example: '

B04MUTEI*1

' mutes input channels 1-4 and A-D After sending this command, the device will respond with a status message of '

B04MUTEI*11111111

'. In this status message, the device reports the status of all the channels. Since the

MUTEI

command applies to channels 1-

4 and A-D the status of all 8 channels. The first (left most) value corresponds to channel 1 and the last (right most) value corresponds to channel D .

This leads us to the second method of using a wildcard character: specifying the values for each of the channels. For example, '

B04MUTEI*10101010

' mutes channels 1, 3, A, C and unmutes channels 2, 4, B, D

. In this case, the device will respond with a status message of '

B04MUTEI*10101010

As an interesting example, consider sending '

B04MUTEI*2

' after the above example. The device will respond with a status message of '

B04MUTEI*01010101

'. Notice that all the states have been toggled.

Queries using the '

' character are straightforward. For example, '

B04MUTEI1?

' might return '

B04MUTEI11

', while '

B04MUTEI*?

' might return '

B04MUTEI*11110000

Using the wildcard character with integer channel commands is similar to using it with boolean commands, but there are some differences. If we sent '

B04GAINI*10

', the input gains on channels 1-4 and A-D will all be set to 10 dB. The device will respond with a status message of '

B04GAINI*ÄÄÄÄÄÄÄÄ

'. Those weird characters are the main difference between using wildcards with integer channel commands versus boolean channel commands. When reporting multiple integer values, the Vortex uses a binary format with one byte per integer value. This allows for more compact commands and reduces RS-232 and bus traffic. To convert from an integer value to a byte value, we add 132 to the integer value. In the above example, where the gain is set to 10 dB, we have: 10 + 132 = 142 = 0x8E (hex) = Ä (ASCII). The reason for adding 132 is to allow us to conveniently represent negative numbers as well as avoid the use of special characters that are normally used in RS-232 and EF Bus communications.

When using a wildcard character to specify separate values for each channel, you must also use the binary format. For example, '

B04GAINI*ÄÄÄÄääää

' sets the input gain of channels 1-4 to 10 dB and the input gain of channels A-D to 0 dB. (10 + 132 = 142 = 0x8E (hex) = Ä (ASCII), 0 + 132 = 132 = 0x84 (hex) = ä

(ASCII))

As an interesting example, consider sending '

B04GAINI*>3

' after the above example. This will result in all

the input gains being incremented by 3 dB so that channels 1-4 are at 13 dB and channels A-D are at 3 dB.

The Vortex will respond with a status message of '

B04GAINI*ææææçççç

'. (13 + 132 = 145 = 0x91 (hex)

= æ (ASCII), 3 + 132 = 135 = 0x87 (hex) = ç (ASCII))

Queries using the '

' character are straightforward. For example, '

B04GAINI1?

' might return '

B04GAINI110

', while '

B04GAINI*?

' might return '

B04GAINI*ÄÄÄÄäääää

6.4. Matrix Commands

Matrix commands are used for controlling parameters that exist at the crosspoints of the mixing matrices.

Typical parameters include gating (for automixed signals), gain and mute. Before describing the matrix commands, it is necessary to give a description of the matrices involved. During the following discussion, it will be helpful to refer to the figure below, which shows all the matrices with their input and output labels.

The EF2241 has eight analog outputs labeled 1-4 and A-D. These outputs are all at line level. There are two additional outputs: the output to the telephone interface, labeled T, and the output to the power amplifier, labeled L (for loudspeaker). This yields a total of ten physical outputs.

The EF2241 has eight analog inputs labeled 1-4 and A-D. Inputs 1-4 are mic/line selectable, and inputs A-D are line level only. Inputs 1-4 can also have phantom power enabled and contain channel processing, which includes the following DSP algorithms: Acoustic Echo Cancellation, Noise Cancellation, AGC, and Automatic

Microphone Mixing. An additional input, labeled T, comes from the telephone interface. The T input also has signal processing which includes the following algorithms: Line Echo Cancellation, Noise Cancellation, and

AGC. Inputs 1-4, A-D, and T yield a total of 9 physical inputs.

Vortex devices can be linked together so that they can share control information and digital audio signals.

The audio signals are shared on four digital busses labeled P, W, X, Y, and Z. All Vortex devices can receive signals from all of these busses. Only certain devices can transmit on the busses. This information is given in the following table.

EF2280 No

EF2241 Yes

EF2211 Yes

EF2210 No

EF2201 Yes

Yes

The P bus is meant for routing telephone audio between the devices. The W, X, Y, and Z busses are meant for routing microphone and auxiliary audio between the devices. The W, X, Y, and Z busses also carry NOM

(Number of Open Microphones) information from the automixer so that outputs created from these busses can be appropriately attenuated for the number of open microphones.

The digital inputs consist of all of the signals placed on the EF Bus by the other connected Vortex devices.

Each P, W, X, Y, and Z bus can carry channels from up to eight other devices, so we have the following digital inputs to each Vortex device: PB0-PB7, WB0-WB7, XB0-XB7, YB0-YB7, and ZB0-ZB7. The inputs are designated by three characters: the bus letter (P, W, X, Y, or Z), a B indicating that it is a bus input, and a number between 0 and 7 indicating the channel of the bus.

There is also an internal signal generator, labeled SG, that is capable of producing white or pink noise. this signal is fed into the matrix so that it can be routed to the appropriate outputs for calibration or testing.

The mixing capabilities of the Vortex devices can be broken down into two parts: the EF Bus submatrices and the main matrix.

For each of the W, X, Y, and Z signal busses, there is a 7 x 3 matrix that allows the user to define up to three mixes of each of the four signal busses. The reason the matrix is 7 x 3 instead of 8 x 3 is that since we can transmit on the W, X, Y, and Z busses, we do not need to mix our own channels in these matrices. The inputs and outputs for the 7 x 3 matrices are as follows.

W Submatrix

●

Inputs: WB0-WB7 (with one invalid)

●

Outputs: WM0-WM2

X Submatrix

●

Inputs: XB0-XB7 (with one invalid)

●

Outputs: XM0-XM2

Y Submatrix

●

Inputs: YB0-YB7 (with one invalid)

●

Outputs: YM0-YM2

Z Submatrix

●

Inputs: ZB0-ZB7 (with one invalid)

●

Outputs: ZM0-ZM2

For the P signal, bus there is a 7 x 2 matrix that allows the user to define up to two mixes of the P signal bus. The reason the matrix is 7 x 2 instead of 8 x 2 is that since we can transmit on the P bus, we do not need to mix our own channels in this matrix. The inputs and outputs for the 7 x 2 P bus matrix are as follows.

P Submatrix

●

Inputs: PB0-PB7 (with one invalid)

●

Outputs: PM0-PM1

The crosspoint gains on all outputs are user adjustable. The "M" in the output labels of the submatrices indicates that the signals are being fed into the Main Matrix.

The main matrix consists of the following inputs: analog inputs 1-4 and A-D, the telephone input T, the signal generator (SG), the outputs of the EF Bus submatrices PM0-PM1, WM0-WM2, XM0-XM2, YM0-YM2, and ZM0-ZM2. This is a total of 24 inputs.

The main matrix consists of the following outputs: analog outputs 1-4 and A-D, the output to the telephone interface T, the output to the power amplifier L, AEC reference signals R1 and R2, and the EF bus outputs P,

W, X, Y, and Z. This is a total of 17 outputs.

The matrix commands can adjust two types of parameters: integer and boolean. We will introduce the matrix commands by using the MGAIN command as an example. This is an integer matrix command that is used to set the gain (in dB) at any of the crosspoints in the main matrix or EF Bus submatrices.

Matrix commands are similar to channel commands except that instead of specifying a single channel, it is necessary to specify a crosspoint (or range of crosspoints). In order to specify a single crosspoint, you use the input and output labels discussed in this section. The first label always specifies the input to the matrix and the second label always specifies the output of the matrix. For example, to set the gain of the crosspoint

(1, A) to -3 dB, you would send '

B04MGAIN1,A,-3

' which sets the gain at the crosspoint to -3 dB. In this case, a status message will be generated similar to '

B04MGAIN1,A,-3

It is also possible to use the wildcard character ('

') to specify ranges of crosspoints with the matrix commands. The only restriction is that you can only use a wildcard to specify the input or output, but not both simultaneously. Thus you could specify all the inputs going to a specific output (one column) or the value of an input to all of the outputs (one row), but not the entire matrix. One example of using a wildcard for an integer matrix command would be '

B04MGAINSG,*,0

'. This will set all the crosspoints in the signal generator row of the main matrix to 0 dB. Thus, the signal generator will be added to all of the outputs of the main matrix with a gain of 0 dB. In this case a status message will be generated that looks like '

B04MGAINSG,*,äääääääääääääääää

'. The binary representation used here is the same method described in

Section 6.3

You can also use the wildcard character to set the crosspoints of a row or column individually. For example,

B04MGAIN1,*,ääääzzzzzzxxxxxxx

' sets the crosspoints of input 1 to 0 dB for outputs 1-4, -10 dB for outputs A-D, T, and L, and -12 dB for outputs R1, R2, P, and W-Z. In this case, the EF2241 will respoind with a status message of '

B04MGAIN1,*,ääääzzzzzxxxxxxx

Queries using the '

' character work in the usual manner. For example, '

B04MGAIN3,A,?

' might return '

B04MGAIN3,A,-6

', while '

B04MGAIN2,*,?

' might return '

B04MGAIN2,*,äääääääääääääääää

Boolean matrix commands work as you would expect. They use the characters '

', '

', and '

' as described in

Section 6.1

. Here are some examples.

●

B04MMUTE2,3,1

' mutes crosspoint (2, 3) of the main matrix. In other words, the signal at input 2

● will not be heard on output 3 A status message will be generated of the form '

B04MMUTE2,3,1

B04MMUTEA,*,11110000000000000

' sets the mutes for input A of the main matrix. The signal path from input A to outputs 1-4 is muted, while the signal path from input A to outputs A-D, T, L, R1, R2,

P, and W-Z is unmuted. The EF2241 will respond with a status message of

●

B04MMUTEA,*,11110000000000000

B04MMUTEA,*,2

' toggles the mutes for input A of the main matrix. If this command follows after the command in the above example, the EF2241 will respond with a status message of

B04MMUTEA,*,00001111111111111

●

B04MMUTEA,*,?

' queries the status of the mutes for input A of the main matrix. If this command follows after the commands in the above examples, the EF2241 will respond with a status message of

B04MMUTEA,*,00001111111111111

6.5. Miscellaneous Commands

Miscellaneous commands are those that don't fall under any of the other categories. See the description of a given command for specific details on how it operates.

7. Command List

The following table is a list of the commands recognized by the EF2241 Detailed descriptions of each command are given in the next section.

The Storage column contains one of the following values indicating when and where the parameter is stored.

●

"Global"

●

"Preset"

●

"-" = not stored or not applicable

Globally stored parameters are not changed when a preset is executed. Only one copy of a global parameter is stored. Global parameters are written to non-volatile memory each time they are changed. Globally stored parameters retain their values when the power is cycled.

Parameters stored in presets are changed each time a new preset is restored/executed. Preset parameters

are not saved in non-volatile memory until a

PRESETW

command is executed. Parameters stored in the

power-on preset (see

PRESETP

) are restored when the power is cycled.

Command

Preset

Global

Preset

Storage Description

Preset Enable or Disable Auto Answer Mode

Global

Preset

Enable or Disable Acknowledgment Mode

Enable or Disable Acoustic Echo Cancellation

Set Amount of Double Talk Suppression used in the AEC.

Enable or Disable Mic/Line Input Automatic Gain Control

Set Maximum Allowed Mic/Line Input AGC Gain

Set Minimum Allowed Mic/Line Input AGC Gain

Set Ramp Rate of Mic/Line Input AGC

Enable or Disable Call Progress Based Auto Hangup

Enable or Disable Loop Drop Based Auto Hangup

Assign Inputs to an Automixer

Select Automatic or Manual Gating for each Automixer Input

Set Automixer Groupings for EF Bus

Enable Chairman Mode for Specified Automixer

Set Chairman Mic for Specified Automixer

Set Decay Time for Automixers

Set Automixer Gating Control Mode

Set Automixer Gate Ratio

Set Automixer Gate Threshold

Set Global Maximum Number of Open Mics for Bus Automixer

Set Automixer Hold Time

Set Last Mic On Mode for Specified Automixer

Set Microphone That Will Remain On in Manual Last Mic On Mode

Set Local Maximum Number of Open Mics for Automixer

Select NOM Attenuation on Each Output

Set Off Attenuation for the Specified Automixer

Set Gating Priority for the Specified Mic

Set Automixer Reference Bias for the Specified Automixer

Enable Automixer Reference for Specified Automixer

Set Baud Rate for RS-232 Port

Global

Preset

Global

Preset

Global

Preset

Enable Automatic

BLDATA

Messages

Request Level Information

Select Information to be Reported in

BLDATA

Broadcast Arbitrary Command Strings to RS-232 Port

Broadcast Commands to Other Connected Devices

Set Which AEC Reference is Placed on EF Bus

Query Camera Gating Status Information

Enable Automatic Camera Gating Messages

Set Camera Gating Hold Time

Specify Country Definitions for Phone Interface

Set Output Delay

Enable Output Delay

Send DTMF Digits to Phone Interface

Enable Automatic

DSPLOAD

Status Messages

Query Percentage of Variable DSP Resources Used

Enable or Disable Error Messages

Set Fader Gain of Line Inputs as a Group

Set Gain of Microphone Inputs as a Group

Set Input Gain Fader

Execute Hook Flash

Set Flow Control Mode for RS-232 Port

Lock/Unlock Front Panel

Change Front Panel Password

Set Phone Input Gain

Set Gain of Incoming DTMF Tones

Set Dial Tone Gain

Set Gain of Line Inputs as a Group

Set Gain of Microphone Inputs as a Group

Set Input Gain

Set Output Gain

Set Phone Output Gain

Set From Phone User Tone Gain

Set To Phone User Tone Gain

Query Gating Status Information

Enable Automatic Gating Messages

GMUTEO

Preset

Global

Global

Preset

Preset

Preset

Preset

Preset

Global

Preset

Global

Preset

Global

Global

Preset

Global

Preset

Global

Preset

Mute All Outputs

Set Device ID

Set or Query one of the Device Labels

Enable or Disable Line Input Automatic Gain Control

Enable or Disable Stereo AGC Linking on Inputs A and B

Enable or Disable Stereo AGC Linking on Inputs C and D

Set Maximum Allowed Line Input AGC Gain

Set Minimum Allowed Line Input AGC Gain

Set Ramp Rate of Line Input AGC

Enable or Disable LEC

Set Amount of Double Talk Suppression used in the LEC.

Query State of Logic Inputs

Assign Action for when Logic Input is Activated

Assign Action for when Logic Input is Deactivated

Assign Action for when Logic Input is Held

Enable Automatic Logic Input Status Messages

Configure Logic Input Pins Into a Group

Delete One or All Logic Input Pin Commands

Mask Logic Input Pins

Assign Command to Logic Input Group

Set Polarity for Logic Inputs

Query or Set Status of Logic Output Pins

Define Behavior for Logic Output Activated State

Define Behavior for Logic Output Deactivated Status

Enable Automatic Logic Output Status Messages

Delete One or All Logic Output Pin Commands

Mask Logic Output Pins

Set Polarity for Logic Outputs

Add Command to Current Macro

Delete One or All Macros

List All Commmands in a Macro

Execute Macro Quietly

Start a New Macro

Write Macro to Non-Volatile Memory

Execute Macro

Select which Signal is Displayed on the Front Panel LED Meter

Preset

Global

Preset

Global

Preset

Global

Set Crosspoint Gains in Main Matrix or Submatrix

Select Gated or Ungated Microphone Signal in Matrix

Enable Microphone Gain Stage on Inputs 1-4

Enable Modem Initialization String

Set Modem Initialization String

Mute Crosspoint in Main Matrix or Submatrix

Set Mute Status of Line Inputs as a Group

Set Mute Status of Microphone Inputs as a Group

Mute One or More Inputs

Mute One or More Outputs

Enable Noise Cancellation

Set Noise Cancellation Attenuation

Reinitialize Non-Volatile Memory

Lock/Unlock Non-Volatile Memory

Change Non-Volatile Memory Password

Set All Parameters for Specified Parametric EQ Input Stage

Set Bandwidth Parameter for Specified Parametric EQ Input Stage

Set Enabled Parameter for Specified Parametric EQ Input Stage

Set Frequency Parameter for Specified Parametric EQ Input Stage

Set Gain Parameter for Specified Parametric EQ Input Stage

Set Slope Parameter for Specified Parametric EQ Input Stage

Set Type Parameter for Specified Parametric EQ Input Stage

Set All Parameters for Specified Parametric EQ Output Stage

Set Bandwidth Parameter for Specified Parametric EQ Output Stage

Set Enabled Parameter for Specified Parametric EQ Output Stage

Set Frequency Parameter for Specified Parametric EQ Output Stage

Set Gain Parameter for Specified Parametric EQ Output Stage

Set Slope Parameter for Specified Parametric EQ Output Stage

Set Type Parameter for Specified Parametric EQ Output Stage

Enable Phantom Power on Inputs 1-4

Take Phone On-Hook or Off-Hook

See Which Devices Are Present

Delete One or All Presets

List All Commmands in a Preset

Set Which Preset Will Be Activated At Power-Up

Execute a Preset Quietly

Preset

Global

Preset

Save a Preset

Execute a Preset

Redial the Last Dialed Phone Number

Assign AEC Reference to Input Channel

Set Reference Output Gain

Enable or Disable Ring Messages

Set Gain of Signal Generator

Mute Signal Generator

Set Type of Signal Produced by Signal Generator

Play Sound Locally

Play Sound to Phone

Set Delay Between Screen Saver Screens

Enable or Disable Screen Saver

Set Idle Time Required for Screen Saver to Start

Set Text to be Displayed by Screen Saver

Perform Soft Reset of System

Query Software Version

Enable or Disable Entry and Exit Tones

Enable or Disable Ring Tones

Enable VTX Mode on Specified Inputs

8. Command Reference

8.1. AA

-- Enable or Disable Auto Answer Mode

This command sets or queries the status of the auto answer feature.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

This command is saved to non-volatile memory only as part of a preset. The state of this command will be restored after power-up only if a preset is saved and that preset is set to be the power-on preset.

Example Description

B01AA2

Toggle auto answer mode.

Status Message

B01AA1

Enable auto answer mode.

B01AA1

B01AA0

Disable auto answer mode.

B01AA0

B01AAx

, where x

depending on the current state of auto answer mode.

B01AA?

Query auto answer mode.

B01AAx

, where x

depending on the current state of auto answer mode.

8.2. ACKMOD

-- Enable or Disable Acknowledgment Mode

This command controls whether or not status messages are sent. See Section 5

for more information on status messages. This parameter is enabled by default, and it is rarely turned off by the host controller.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

This command is saved to global non-volatile memory and is not part of a preset. Its value is saved each time it is changed. It will retain its value after power-down. Since this command writes to non-volatile memory, there will be a delay before an acknowledgment is returned.

Example Description Status Message

B01ACKMOD1

Enable acknowledgement mode.

B01ACKMOD1

B01ACKMOD0

Disable acknowledgement mode.

B01ACKMOD0

B01ACKMOD2

B01ACKMOD?

Toggle acknowledgement mode.

Query acknowledgement mode.

B01ACKMODx

, where x

depending on the current state of acknowledgement mode.

B01ACKMODx

, where x

depending on the current state of acknowledgement mode.

8.3. AEC

-- Enable or Disable Acoustic Echo Cancellation

This command sets or queries the status of the Acoustic Echo Cancellation (AEC) algorithm on input channels

1-4 .

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example Description

B01AEC31

Enable AEC on input channel 3 .

B01AEC30

Disable AEC on input channel 3 .

Status Message

B01AEC31

B01AEC30

B01AEC32

B01AEC3?

Toggle AEC state on input channel 3 .

Query AEC state on input channel 3 .

B01AEC3x

, where x

depending on the current state of the AEC on input channel 3 .

B01AEC3x

, where x

depending on the current state of the AEC on input channel 3 .

B01AEC*1

Enable AEC on input channels 1-4.

B01AEC*0

Disable AEC on input channels 1-4.

B01AEC*1111

B01AEC*0000

B01AEC*2

Toggle AEC state on input channels 1-4.

B01AEC*abcd

, where a

are each

depending on the current state of the AEC for each of the four input channels.

B01AEC*?

Query AEC state on input channels 1-4.

B01AEC*abcd

, where a

are each

depending on the current state of the AEC for each of the four input channels.

8.4. AECMODE

-- Set Amount of Double Talk Suppression used in the AEC.

This command sets the amount of double talk suppression used in the AEC on input channels 1-4 . The values correspond to the following settings.

●

= No Suppression

●

= Light Suppression

●

= Heavy Suppression

●

= Half Duplex

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 4, respectively.

Example

B01AECMODE13

B01AECMODE1?

Description

Set AEC on input channel 1 to

Heavy Suppression.

Query AEC suppression level on input channel 1.

B01AECMODE1x

, where x

, or

4 depending on the current setting of the AEC suppression level on input channel 1.

B01AECMODE*1

B01AECMODE*ààêê

Set AEC on input channels 1-4 to No Suppression.

Set AEC on input channels 1-2 to No Suppression and AEC on input channels 3-4 to Half

Duplex.

Status Message

B01AECMODE13

B01AECMODE*àààà

B01AECMODE*ààêê

B01AECMODE*?

Query AEC suppression level on input channels 1-4.

B01AECMODE*abcd

, where a

are each

, or

depending on the the current setting of the AEC suppression levels on input channels 1-4.

8.5. AGC

-- Enable or Disable Mic/Line Input Automatic Gain

Control

This command sets or queries the status of the Automatic Gain Control (AGC) algorithm on input channels 1-

4 and T (the telephone input) .

When the wildcard character, '

', is used to specify the channel in this command, it only affects input channels 1-4. To set or query the telephone input channel, T, you must specify it explicitly (e.g.,

B01AGCT1

', '

B01AGCT?

').

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example Description

B01AGC31

Enable AGC on input channel 3 .

B01AGCT0

Disable AGC on input channel T .

Status Message

B01AGC31

B01AGCT0

B01AGC12

B01AGCT?

Toggle AGC state on input channel 1 .

Query AGC state on input channel T .

B01AGC1x

, where x

depending on the current state of the AGC on input channel 1 .

B01AGCTx

, where x

depending on the current state of the AGC on input channel T .

B01AGC*1

Enable AGC on input channels 1-4.

B01AGC*?

Query AGC state on input channels 1-4.

B01AGC*1111

B01AGC*0

Disable AGC on input channels 1-4.

B01AGC*0000

B01AGC*2

Toggle AGC state on input channels 1-4.

B01AGC*abcd

, where a

are each

depending on the current state of the AGC for each of the four input channels.

B01AGC*abcd

, where a

are each

depending on the current state of the AGC for each of the four input channels.

8.6. AGCMAX

-- Set Maximum Allowed Mic/Line Input AGC Gain

This command sets the maximum gain that the AGC can apply on input channels 1-4 . For example, if

AGCMAX

is set to

, then the AGC for that channel can apply a maximum of 10 dB of gain to the input signal.

When the wildcard character, '

', is used to specify the channel in this command, it only affects input channels 1-4. To set or query the telephone input channel, T, you must specify it explicitly (e.g.,

B01AGCMAXT10

', '

B01AGCMAXT?

').

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 15, respectively.

Example

B01AGCMAX13

B01AGCMAXT?

B01AGCMAX*6

Description

Set AGC maximum gain on input channel 1 to 3 dB.

Set AGC maximum gain on input channels 1-4 to 6 dB.

Status Message

B01AGCMAX13

Query the AGC maximum gain on input channel T .

B01AGCMAXTx

where x

is a number between 0 and

15, depending on the current setting of the AGC maximum gain on input channel T .

B01AGCMAX*èèèè

B01AGCMAX*ääìì

Set AGC maximum gain on input channels 1-2 to 0 dB and AGC maximum gain on input channels

3-4 to 9 dB.

B01AGCMAX*ääìì

B01AGCMAX*?

Query AGC maximum gain on input channels 1-4.

B01AGCMAX*abcd

, where a

are each between

ä and

, depending on the current setting of the AGC maximum gain for each of the four input channels.

8.7. AGCMIN

-- Set Minimum Allowed Mic/Line Input AGC Gain

This command sets the minimum gain that the AGC can apply on input channels 1-4 and T (the telephone input) . For example, if

AGCMIN

is set to

-10

, then the AGC for that channel can apply a minimum of -10 dB of gain to the input signal.

When the wildcard character, '

', is used to specify the channel in this command, it only affects input channels 1-4. To set or query the telephone input channel, T, you must specify it explicitly (e.g.,

B01AGCMINT10

', '

B01AGCMINT?

').

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are -15 and 0, respectively.

Example

B01AGCMIN1-3

B01AGCMINT?

B01AGCMIN*-6

B01AGCMIN*ääüü

B01AGCMIN*?

Description Status Message

Set AGC minimum gain on input channel 1 to -3 dB.

B01AGCMIN1-3

Query the AGC minimum gain on input channel T .

B01AGCMINTx

where x

is a number between -15 and 0, depending on the current setting of the AGC minimum gain on input channel T .

Set AGC minimum gain on input channels 1-4 to -6 dB.

Query AGC minimum gain on input channels 1-4.

B01AGCMIN*~~~~

Set AGC minimum gain on input channels 1-2 to 0 dB and AGC minimum gain on input channels 3-

4 to -3 dB.

B01AGCMIN*ääüü

B01AGCMIN*abcd

, where a

are each between u and

, depending on the current setting of the AGC minimum gain for each of the four input channels.

8.8. AGCRATE

-- Set Ramp Rate of Mic/Line Input AGC

This command sets or queries the maximum rate at which the AGC can increase or decrease the gain of the signals on input channels 1-4 and T (the telephone input) . The ramp rate is expressed in dB/sec.

When the wildcard character, '

', is used to specify the channel in this command, it only affects input channels 1-4. To set or query the telephone input channel, T, you must specify it explicitly (e.g.,

B01AGCRATET10

', '

B01AGCRATET?

').

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 5, respectively.

Example

B01AGCRATE13

B01AGCRATET?

Description

Set AGC ramp rate on input channel 1 to 3 dB/sec.

Query the AGC ramp rate on input channel T .

B01AGCRATE*5

B01AGCRATE*ààêê

Set AGC ramp rate on input channels 1-4 to 5 dB/sec.

Set AGC ramp rate on input channels 1-2 to 1 dB/sec and

AGC ramp rate on input channels 3-4 to 4 dB/sec.

B01AGCRATE*?

Query AGC ramp rate on input channels 1-4.

Status Message

B01AGCRATE13

B01AGCRATETx

where x

is a number between 1 and 5, depending on the current setting of the AGC ramp rate on input channel T .

B01AGCRATE*ëëëë

B01AGCRATE*ààêê

B01AGCRATE*abcd

, where a

are each between

à and

, depending on the current setting of the AGC ramp rate for each of the four input channels.

8.9. AHCP

-- Enable or Disable Call Progress Based Auto

Hangup

This command sets or queries the status of the call progress based auto hangup feature. There are two methods of auto hangup supported: call progress and loop drop. The call progress method listens for offhook or busy tones and hangs up the phone if they are detected. The loop drop method looks for a drop in loop current on the phone line and hangs up the phone if a loop current drop is detected. The

AHCP

command controls the call progress auto hangup feature. The

AHLD

command controls the loop drop auto

hangup feature. These two features are controlled and implemented independently.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01AHCP2

Toggle call progress based auto hangup mode.

Status Message

B01AHCP1

Enable call progress based auto hangup mode.

B01AHCP1

B01AHCP0

Disable call progress based auto hangup mode.

B01AHCP0

B01AHCPx

, where x

depending on the current state of the call progress based auto hangup mode.

B01AHCP?

Query auto hangup mode.

B01AHCPx

, where x

depending on the current state of the call progress based auto hangup mode.

8.10. AHLD

-- Enable or Disable Loop Drop Based Auto Hangup

This command sets or queries the status of the loop drop based auto hangup feature. There are two methods of auto hangup supported: call progress and loop drop. The call progress method listens for offhook or busy tones and hangs up the phone if they are detected. The loop drop method looks for a drop in loop current on the phone line and hangs up the phone if a loop current drop is detected. The

AHCP

command controls the call progress auto hangup feature. The

AHLD

command controls the loop drop auto hangup feature. These two features are controlled and implemented independently.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description Status Message

B01AHLD1

Enable loop drop based auto hangup mode.

B01AHLD1

B01AHLD0

Disable loop drop based auto hangup mode.

B01AHLD0

B01AHLD2

Toggle loop drop based auto hangup mode.

B01AHLDx

, where x

depending on the current state of the loop drop based auto hangup mode.

B01AHLD?

Query auto hangup mode.

B01AHLDx

, where x

depending on the current state of the loop drop based auto hangup mode.

8.11. AMASGN

-- Assign Inputs to an Automixer

This command is used to assign one of the mic/line inputs (1-4) to an internal automixers. Setting

AMASGN to

for a given input channel corresponds to no automixer,

corresponds to Automixer #1 , and

2 corresponds to automixer #2.

AMASGN

command usually removes a microphone from one automixer and adds it to another. If the microphone is removed from an automixer where it was assigned as the "Last Mic On" and list mic mode

(

AMLMM

)) is set to manual for that automixer, then the

AMASGN

command will fail and an

ERROR#040 message will be generated. If the microphone is removed from an automixer where it was a ssigned as the

"Chairman Mic" and chairman mode (

AMCHAIR

) is enabled for that automixer, then an

ERROR#041

message will be generated. See the

ERROR

command for more information on error messages. See Section 3.5

for

more information on dependencies within the automixer commands.

Although this command is a channel integer command, the increment and decrement operators (

and

) are not supported for this particular command.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 2, respectively.

Example

B01AMASGN31

B01AMASGN3?

B01AMASGN*0

B01AMASGN*ààåå

B01AMASGN*?

Description Status Message

Assign input 3 to automixer #1.

B01AMASGN31

Query current automixer assignment for channel 3 .

B01AMASGN3x

, where x

, or

depending on the current automixer assignment for channel 3

. If this command is issued after the example above, then the status message will be

B01AMASGN31

Assign all mic inputs to no automixer.

B01AMASGN*ääää

Assign inputs 1-2 to automixer #1 and inputs 3-4 to automixer #2.

B01AMASGN*ààåå

Query automixer assignment for all mic/line input channels.

B01AMASGN*abcd

, where each of the letters ( a

, b

, etc.) is either

, or

depending on the current automixer assignment for each channel. If this command is issued after the example above, then the status message will be

B01AMASGN*ààåå

8.12. AMAUTO

-- Select Automatic or Manual Gating for each

Automixer Input

This command selects or queries the state of automatic or manual automixer gating thresholds for the specified input channel. Automatic thresholds mean that the automixer adaptively determines the gating thresholds based on current speech and noise levels using the gating ratio specified by the

AMGATER

command. Manual thresholds mean that the automixer uses the absolute threshold set via the

AMGATET

command.

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01AMAUTO31

Description Status Message

Select automatic thresholds for automixer gating on input channel 3

B01AMAUTO31

B01AMAUTO30

B01AMAUTO32

Select manual thresholds for automixer gating on input channel 3

B01AMAUTO30

Toggle between automatic and manual thresholds for automixer gating on input channel 3 .

B01AMAUTO3x

, where x

depending on whether input channel 3 is currently set for manual or automatic thresholds.

B01AMAUTO3?

Query AMAUTO state on input channel 3 .

B01AMAUTO3x

, where x

depending on whether input channel 3 is currently set for manual or automatic thresholds.

B01AMAUTO*1

B01AMAUTO*0

Select automatic thresholds for automixer gating on input channels

1-4.

Select manual thresholds for automixer gating on input channels

1-4.

B01AMAUTO*2

Toggle between manual and automatic thresholds for automixer gating input channels 1-4.

B01AMAUTO*?

Query AMAUTO state on input channels 1-4.

B01AMAUTO*1111

B01AMAUTO*0000

B01AMAUTO*abcd

, where a

are each

1 depending on whether each input channel is currently set for manual or automatic thresholds.

B01AMAUTO*abcd

, where a

are each

1 depending on whether each input channel is currently set for manual or automatic thresholds.

8.13. AMBUSID

-- Set Automixer Groupings for EF Bus

This command is used to assign one of the two internal automixers to one of the EF Bus automixer groups.

For example, consider three EF2241's, each of which has two microphones assigned to Automixer 1 and two microphones assigned to Automixer 2. Now, if each of these EF2241's sets their Automixer 1 to have Bus ID

5, then the three automixers (one from each EF2241) will work as a single automixer containing 6 (3 x 2) microphones. Setting

AMBUSID

to 0 means that the specified automixer is not grouped on the bus.

The first argument in the

AMBUSID

command is the automixer number (1 or 2) and the second argument is the Bus ID (0 for none, or 1 through 8). Although this command is a channel integer command, use of the wildcard character for the automixer number is not supported.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 8, respectively.

Example

B01AMBUSID12

Description Status Message

Configure Automixer 1 to be part of the

Bus Automixer having Bus ID 2.

B01AMBUSID12

B01AMBUSID20

B01AMBUSID1?

Configure Automixer 2 to be part of the

Bus Automixer having Bus D 0. This means that the automixer is not part of any Bus Automixer.

B01AMBUSID20

Query the current Bus ID of Automixer

1 .

B01AMBUSID1x

, where x

is a number between

0 and 8 indicating the current Bus ID of

Automixer 1 .

8.14. AMCHAIR

-- Enable Chairman Mode for Specified

Automixer

This command enables, disables, or queries the chairman mode feature for the specified automixer. The first argument in the command specifies the automixer number (1 or 2) and the second argument specifies whether chairman mode should be enabled, disabled, toggled, or queried.

If an

AMCHAIR

command requests that chairman mode be enabled, but the chairman microphone

(

AMCHNUM

) does not belong to the specified automixer, the

AMCHAIR

command will fail and return

ERROR#044

. See the

ERROR

command for more information on error messages. See Section 3.5

for more

information on dependencies within the automixer commands.

Even though this is a channel boolean command, use of the wildcard character for the automixer number is not supported.

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01AMCHAIR10

B01AMCHAIR21

B01AMCHAIR2?

Description

Query current setting of chairman mode for Automixer 2 .

Status Message

Disable chairman mode for Automixer 1

B01AMCHAIR10

Enable chairman mode for Automixer 2

B01AMCHAIR21

B01AMCHAIR2x

, where x

depending on the current setting of chairman mode for

Automixer 2 .

8.15. AMCHNUM

-- Set Chairman Mic for Specified Automixer

This command sets the chairman microphone for the specified automixer. The first argument of the command specifies the automixer number (1 or 2). The second argument specifies which microphone should be the chairman microphone (1-4) for the automixer.

If chairman mode is enabled (

AMCHAIR

) and the

AMCHNUM

command tries to set a microphone number that does not belong to the specified automixer, the command will fail and generate an

ERROR#045

. See the

ERROR

command for more information on error messages. See

Section 3.5

for more information on dependencies within the automixer commands.

Even though this is a channel integer command, use of the wildcard character for the automixer number is not supported.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 4, respectively.

Example Description Status Message

B01AMCHNUM14

B01AMCHNUM21

Set microphone 4 as the chairman mic for automixer 1.

Set microphone 1 as the chairman mic for automixer 2.

B01AMCHNUM14

B01AMCHNUM21

B01AMCHNUM1?

Query the current chairman mic for automixer 1.

B01AMCHNUM1x

, where x

is between

and

8 depending on the current chairman mic setting for automixer 1.

8.16. AMDECAY

-- Set Decay Time for Automixers

This command sets or queries the decay time (in milliseconds) for both automixers. Note that the decay time is set globally for both automixers.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 0 and 5000, respectively.

Example

B01AMDECAY500

Description

Set automixer decay time to 500 ms.

Status Message

B01AMDECAY500

B01AMDECAY>500

Increase automixer decay time by

500 ms.

B01AMDECAY?

Query automixer decay time.

B01AMDECAYx

, where x

is between 0 and 5000 depending on the current

AMDECAY

setting. If this command is issued after the above example, then the status message will be

B01AMDECAY1000

B01AMDECAYx

, where x

is between 0 and 5000 depending on the current

AMDECAY

setting. If this command is issued after the above example, then the status message will be

B01AMDECAY1000

8.17. AMGATEC

-- Set Automixer Gating Control Mode

This command sets the automixer gating control mode for the specified input channel. The possible modes are:

●

- normal gating

●

- microphone forced on

●

- microphone forced off

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 2, respectively.

Example Description Status Message

B01AMGATEC10

B01AMGATEC21

B01AMGATEC32

B01AMGATEC3?

B01AMGATEC*0

B01AMGATEC*ääàå

B01AMGATEC*?

Configure microphone input 1 for normal gating.

B01AMGATEC10

Configure microphone input 2 to be forced on.

Configure microphone input 3 to be forced off.

B01AMGATEC21

B01AMGATEC32

Query current gating control mode for microphone input 3 .

B01AMGATEC3x

, where x

, or

depending on the current gating control mode setting for microphone input 3 .

Configure microphone inputs 1-4 for normal gating.

Configure microphone inputs 1-2 for normal gating, microphone input 3 to be forced on, and microphone input 4 to be forced off.

B01AMGATEC*ääää

B01AMGATEC*ääàå

Query gating control mode for all microphone inputs.

B01AMGATEC*abcd

, where a

are each

, or

depending on the current setting of the gating control mode for each channel. If this command is issued after the example above, then the status message will be

B01AMGATEC*ääàå

8.18. AMGATER

-- Set Automixer Gate Ratio

This command sets the automixer gate ratio (in dB) for the specified input channel. The gate ratio is the ratio of the speech power to noise power required to gate the microphone on. This value is only used if the input is set to automatic gating via the

AMAUTO

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 100, respectively.

Example

B01AMGATER312

B01AMGATER3>3

B01AMGATER3?

Description

Set gate ratio for automatic gating threshold to 12 dB for input channel 3 .

Status Message

B01AMGATER312

Increase gate ratio for automatic gating threshold by 3 dB for input channel 3 .

B01AMGATER3x

, where x

is between

and

100 depending on the current setting of the gate ratio for input channel 3 . If this command is issued after the example above, then the status message will be

B01AMGATER315

Query gate ratio for automatic gating threshold for input channel 3 .

B01AMGATER3x

, where x

is between

and

100 depending on the current setting of the gate ratio for input channel 3 . If this command is issued after the example above, then the status message will be

B01AMGATER315

B01AMGATER*12

B01AMGATER*ÉÉôô

B01AMGATER*<3

B01AMGATER*?

Set gate ratio for automatic gating threshold to 12 dB for all input channels.

B01AMGATER*ÉÉÉÉ

Set gate ratio for automatic gating threshold to 12 dB for inputs 1-2 and 15 dB for inputs 3-

B01AMGATER*ÉÉôô

Decrease gate ratio for automatic gating threshold by 3 dB for all input channels.

B01AMGATER*abcd

, where a

will each be between

and Φ depending on the setting of the gate ratio for each input channel. If this command is issued after the example above, the status message will be

B01AMGATER*ììÉÉ

Query gate ratio for automatic gating threshold for all input channels.

B01AMGATER*abcd

, where a

will each be between

and Φ depending on the setting of the gate ratio for each input channel. If this command is issued after the example above, the status message will be

B01AMGATER*ììÉÉ

8.19. AMGATET

-- Set Automixer Gate Threshold

This command sets the automixer gate threshold (in dB) for the specified input channel. The gate threshold is the level that the input signal must reach in order to gate the microphone on. This value us only used if the input is set to manual gating via the

AMAUTO

command.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 100, respectively.

Example

B01AMGATET312

B01AMGATET3>3

B01AMGATET3?

B01AMGATET*12

Description

Set gate threshold for manual gating threshold to 12 dB for input channel 3 .

Status Message

B01AMGATET312

Increase gate threshold for manual gating threshold by 3 dB for input channel 3 .

B01AMGATET3x

, where x

is between

and

100 depending on the current setting of the gate threshold for input channel 3 . If this command is issued after the example above, then the status message will be

B01AMGATET315

Query gate threshold for manual gating threshold for input channel 3 .

B01AMGATET3x

, where x

is between

and

100 depending on the current setting of the gate threshold for input channel 3 . If this command is issued after the example above, then the status message will be

B01AMGATET315

Set gate threshold for manual gating threshold to 12 dB for all input channels.

B01AMGATET*ÉÉÉÉ

B01AMGATET*ÉÉôô

B01AMGATET*<3

B01AMGATET*?

Set gate threshold for manual gating threshold to 12 dB for inputs 1-2 and 15 dB for inputs 3-

B01AMGATET*ÉÉôô

Decrease gate threshold for manual gating threshold by 3 dB for all input channels.

B01AMGATET*abcd

, where a

will each be between

and Φ depending on the setting of the gate threshold for each input channel. If this command is issued after the example above, the status message will be

B01AMGATET*ììÉÉ

Query gate threshold for manual gating threshold for all input channels.

B01AMGATET*abcd

, where a

will each be between

and Φ depending on the setting of the gate threshold for each input channel. If this command is issued after the example above, the status message will be

B01AMGATET*ììÉÉ

8.20. AMGNOM

-- Set Global Maximum Number of Open Mics for

Bus Automixer

This command sets the global maximum number of open mics (NOM) allowed for the specified bus automixer. The NOM limit is a global limit, meaning that this applies to all bus automixers with the same

AMBUSID

. In contrast, the

AMNOM

command is a local limit that applies to the two local automixers in the

EF2241.

The first argument of this command specifies the automixer number (1-2) to adjust. The second argument specifies the NOM limit (1-64). Even though this is a channel integer command, use of the wildcard for specifying the automixer number is not supported.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 64, respectively.

Example

B01AMGNOM13

Description

Set global NOM for automixer 1 to a maximum of 3 mics.

B01AMGNOM2?

Query current global NOM limit for automixer 2 .

Status Message

B01AMGNOM13

B01AMGNOM2x

, where x

is between

and

64 depending on the current setting of the global

NOM limit for automixer 2 .

8.21. AMHOLD

-- Set Automixer Hold Time

This command sets or queries the hold time (in milliseconds) for both automixers. Note that the hold time is set globally for both automixers.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 0 and 5000, respectively.

Example Description Status Message

B01AMHOLD500

Set automixer hold time to 500 ms.

B01AMHOLD500

B01AMHOLD>500

B01AMHOLD?

Increase automixer hold time by 500 ms.

B01AMHOLDx

, where x

is between 0 and 5000 depending on the current

AMHOLD

setting. If this command is issued after the above example, then the status message will be

B01AMHOLD1000

Query automixer hold time.

B01AMHOLDx

, where x

is between 0 and 5000 depending on the current

AMHOLD

setting. If this command is issued after the above example, then the status message will be

B01AMHOLD1000

8.22. AMLMM

-- Set Last Mic On Mode for Specified Automixer

This command sets "last mic on" mode for the specified automixer. The first argument specifies which automixer (1-2) The second parameter specifies the operation of "last mic on" mode and can be one of the following:

●

- last mic mode is off

●

- manual (use a specific mic)

●

- automatic (the last gated mic remains on)

If the

AMLMM

command sets "last mic on" mode to manual, but the last mic number (

AMLMN

) is set to a

microphone that does not belong to the specified automixer, then the

AMLMM

command will fail and

ERROR#042

will be generated. See the

ERROR

command for more information on error messages. See

Section 3.5

for more information on dependencies within the automixer commands.

Even though this is a channel integer command, use of the wildcard character for specifying the automixer number is not supported.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 2, respectively.

Example Description Status Message

B01AMLMM10

Disable "last mic on" mode for automixer 1.

B01AMLMM10

B01AMLMM21

Set "last mic on" mode to manual for automixer 2 .

B01AMLMM21

B01AMLMM12

Set "last mic on" mode to automatic for automixer 1.

B01AMLMM12

B01AMLMM1?

Query the current setting of "last mic on" mode for automixer 1.

B01AMLMM1x

, where x

, or

2 depending on the current setting of "last mic on" mode for automixer 1. If this command is issued after the example above, then the status message will be

B01AMLMM12

8.23. AMLMN

-- Set Microphone That Will Remain On in Manual

Last Mic On Mode

This command sets the microphone number that will remain on when "last mic on" mode is set to manual

(see the

AMLMM

command). The first argument to this command is the number of the automixer (1-2) that

will be adjusted. The second argument is the microphone number (1-4) that should be gated on if no other

mics are gated on and

AMLMM

is set to manual. The value of the

AMLMN

command is only valid when

AMLMM

is set to manual.

If "last mic on" moce is set to manual for the specified automixer and the

AMLMN

command attempts to specify a microphone that does not belong to the automixer, then the

AMLMN

command will fail and an

ERROR#043

will be generated. See the

ERROR

command for more information on error messages. See

Section 3.5

for more information on dependencies within the automixer commands.

Even though this is a channel integer command, use of the wildcard character for the automixer number is not supported.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 8, respectively.

Example

B01AMLMN14

Description

Set microphone 4 as the manual last mic on for automixer 1.

B01AMLMN21

Set microphone 1 as the manual last mic on for automixer 2.

Status Message

B01AMLMN14

B01AMLMN21

B01AMLMN1?

Query the current manual last mic on number mic for automixer 1.

B01AMLMN1x

, where x

is between

and

4 depending on the

AMLMN

setting for automixer

8.24. AMNOM

-- Set Local Maximum Number of Open Mics for

Automixer

This command sets the local maximum number of open mics (NOM) allowed for the specified automixer. The

NOM limit is a local limit, meaning that this limit applies only to the specific Vortex that is is set on. In contrast, the

AMGNOM

command is a global limit that applies to all linked Vortex automixers with the same

AMBUSID

The first argument of this command specifies the automixer number (1-2) to adjust. The second argument specifies the NOM limit (1-4) . Even though this is a channel integer command, use of the wildcard for specifying the automixer number is not supported.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 64, respectively.

Example

B01AMNOM13

B01AMNOM2?

Description Status Message

Set local NOM for automixer 1 to a maximum of 3 mics.

B01AMNOM13

Query current local NOM limit for automixer

2 .

B01AMNOM2x

, where x

is between

and

4 depending on the current setting of the local

NOM limit for automixer 2.

8.25. AMNOMAT

-- Select NOM Attenuation on Each Output

This command enables, disables, or queries NOM attenuation for the specified output (1-4, A-D, T, L) . .

NOM attenuation is calculated as 10*log(Number of Open Microphones).

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01AMNOMAT41

B01AMNOMATA0

B01AMNOMATL2

B01AMNOMATB?

B01AMNOMAT*1

B01AMNOMAT*0

Description

Disable NOM attenuation on output

Status Message

Enable NOM attenuation on output 4 .

B01AMNOMAT41

B01AMNOMATA0

Toggle NOM attenuation status on output L

(power amplifier) .

B01AMNOMATLx

, where x

is either

1 depending on the current mute status of NOM attenuation on the ouptut.

Query NOM attenuation status of output B.

B01AMNOMATBx

, where x

is either

1 depending on the current NOM attenuation status of the output.

Enable NOM attenuation on all outputs (1-4, A-D,

T, L) .

B01AMNOMAT*1111111111

Disable NOM attenuation on all outputs (1-4, A-D, T, L)

B01AMNOMAT*0000000000

B01AMNOMAT*1111000010

B01AMNOMAT*2

Enable NOM attenuation on outputs 1-4 and T, and disable NOM attenuation on outputs

A-D and L.

B01AMNOMAT*1111000010

Toggle status of NOM attenuation on all outputs.

B01AMNOMAT*abcdefghij

, where each of the letters (a, b, etc.) is either

depending of the current status of NOM attenuation on the corresponding output. If this command was sent after the example above, then the status message would be

B01AMNOMAT*0000111101

B01AMNOMAT*?

Query NOM attenuation status of all outputs.

B01AMNOMAT*abcdefghij

, where each of the letters (a, b, etc.) is either

depending of the current status of the NOM attenuation on the corresponding output. If this command was sent after the example above, then the status message would be

B01AMNOMAT*0000111101

8.26. AMOFFAT

-- Set Off Attenuation for the Specified

Automixer

This command sets the off attenuation (in dB) for the specified automixer. Setting this value to 18 would result in the microphone signals being attenuated by 18 dB when gated off. This value is set independently for each of the automixers. The first argument of this command specifies the automixer number (1-2) to adjust. The second argument specifies the off attenuation.

Even though this is a channel integer command, use of the wildcard for specifying the automixer number is not supported.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 100, respectively.

Example

B01AMOFFAT118

B01AMOFFAT2?

Description Status Message

Set off attenuation for automixer 1 to

18 dB.

B01AMOFFAT118

Query current off attenuation for automixer 2 .

B01AMOFFAT2x

, where x

is between

and

100 depending on the current setting of the off attenuation for automixer 2 .

8.27. AMPRIOR

-- Set Gating Priority for the Specified Mic

This command sets the automixer gating priority for the specified input channel. Priority levels of 1-4 are allowed with 1 being the highest priority and 4 being the lowest.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 4, respectively.

Example

B01AMPRIOR11

B01AMPRIOR24

B01AMPRIOR3?

B01AMPRIOR*2

B01AMPRIOR*àåçê

B01AMPRIOR*?

Description

Set gating priority of input 1 to

1, 2 to 2, 3 to 3, and 4 to 4.

Status Message

Set microphone input 1 to gating priority 1.

B01AMPRIOR11

Set microphone input 2 to gating priority 4.

B01AMPRIOR24

Query current gating priority for microphone input 3. .

B01AMPRIOR3x

, where x

is between

and

4 depending on the current gating priority setting for microphone input 3. .

Set microphone inputs 1-4 to gating priority 2.

B01AMPRIOR*åååå

B01AMPRIOR*àåçê

Query gating priorities for all microphone inputs.

B01AMPRIOR*abcd

, where a

are each between

and

depending on the current setting of the gating priority for each channel. If this command is issued after the example above, then the status message will be

B01AMPRIOR*àåçê

8.28. AMREFB

-- Set Automixer Reference Bias for the Specified

Automixer

This command sets or queries the reference bias for the automixer reference mode feature of the specified automixer. When enabled, the automixer reference feature uses the AEC reference to prevent local

microphones from gating on audio from the remote side. The

AMREFE

command controls the enabled status

of this feature. The

AMREFB

command can be used to bias the AEC reference signal to make the automixer even less likely to gate on remote audio.

The first argument in this command specifies the automixer number (1-2) and the second argument specifies the reference bias in dB.

Even though this is a channel integer command, use of the wildcard character for the automixer number is not supported.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 20, respectively.

Example Description Status Message

B01AMREFB16

Set reference bias for automixer 1 to 6 dB.

B01AMREFB2?

Query current reference bias for automixer 2 .

B01AMREFB16

B01AMREFB2x

, where x

is between

and

20 depending on the current setting of the reference bias for automixer 2 .

8.29. AMREFE

-- Enable Automixer Reference for Specified

Automixer

This command enables, disables, or queries the automixer referece feature for the specified automixer.

When enabled, the automixer reference feature uses the AEC reference to prevent local microphones from gating on audio from the remote side. The

AMREFE

command controls the enabled status of this feature. The

AMREFB

command can be used to bias the AEC reference signal to make the automixer even less likely to

gate on remote audio.

The first argument in the command specifies the automixer number (1-2) and the second argument specifies whether automixer reference mode should be enabled, disabled, toggled, or queried.

Even though this is a channel boolean command, use of the wildcard character for the automixer number is not supported.

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01AMREFE10

B01AMREFE21

Description

Disable automixer reference mode for

Automixer 1.

Enable automixer reference mode for

Automixer 2 .

B01AMREFE2?

Query current setting of automixer reference mode for Automixer 2 .

Status Message

B01AMREFE10

B01AMREFE21

B01AMREFE2x

, where x

depending on the current setting of automixer reference mode for Automixer 2 .

8.30. BAUD

-- Set Baud Rate for RS-232 Port

This command sets the baud rate for the rear panel RS-232 port. The baud rate is specified in bits per second (bps). Valid baud rates are 9600, 19200, and 38400. Although, this command returns an acknowledgement, it is likely that you will not receive it, since it is sent at the new baud rate. If you setup your control system to quickly change its RS-232 baud rate after you send this command, then you can probably receive the acknowledgement at the new baud rate.

Example

B01BAUD38400

B01BAUD?

Description Status Message

Set baud rate of rear panel RS-232 port to 38400 bps.

B01BAUD38400

Query current baud rate of rear panel

RS-232 port.

B01BAUDx

, where x

is 9600, 19200, or 38400 depending on the current baud rate setting.

8.31. BLAUTO

-- Enable Automatic

BLDATA

Messages

This command sets whether or not

BLDATA

messages are automatically generated by the Vortex. See the

BLDATA

command for more information.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example

B01BLAUTO0

Description

Disable automatic

BLDATA

messages.

B01BLAUTO1

Enable automatic

BLDATA

messages.

B01BLAUTO2

B01BLAUTO?

Toggle enabled status of automatic

BLDATA

messages.

Query enabled status of automatic

BLDATA

messages.

Status Message

B01BLAUTO0

B01BLAUTO1

B01BLAUTOx

, where x

depending on the current setting of

BLAUTO

B01BLAUTOx

, where x

depending on the current setting of

BLAUTO

8.32. BLDATA

-- Request Level Information

This command is used to request "blinking light" data from the EF2241. Blinking light data consists of signal levels for the 9 inputs (1-4, A-D, T), 10 outputs (1-4, A-D, T, L), and 2 AEC references (R1, R2) as well as room gain levels for inputs 1-4, AGC gain levels for inputs 1-4, and AEC state information for inputs 1-4.

The blinking light data can be received in two ways. The first way is by polling the Vortex by sending a

BLDATA?

command. The second way is to have the Vortex automatically send

BLDATA

responses via the

BLAUTO

command.

The most general format of the

BLDATA

responses generated by the Vortex is as follows.

B01BLDATAiiiiiiiiioooooooooorrggggaaaassss

Each of the i

, o

, r

, g

, a

and s

characters above represents a single byte of data as shown in the table below.

BLDATA

Bytes iiiiiiiii oooooooooo

Meaning input levels 1-4, A-D, T output levels 1-4, A-D, T, L

rr gggg aaaa ssss

AEC reference levels R1, R2 room gain 1-4

AGC gain 1-4

AEC state 1-4

Each of the i

bytes correspond to signal levels on the 9 inputs. The first, eighth, and ninth i

bytes indicate the signal levels on input 1, input D, and input T, respectively. The o

bytes correspond to signal levels on the

10 outputs. The first, eighth, ninth, and tenth o

bytes indicate the signal levels on output 1, output D, output

T, and output L, respectively. The first and second r

bytes indicate the signal levels for AEC references R1 and R2, respectively. The first and last g

bytes indicate the room gain for inputs 1 and 4, respectively. The first and last a

bytes indicate the AGC gain on inputs 1 and 4, respectively. The first and last s

bytes indicate the AEC state for inputs 1 and 4, respectively.

The formats of the i

, o

, r

, g

, and a

bytes are the same as for the binary gain commands (binary values offset by 132). See

Section 6.3

and

Section 6.4

for more information on the binary format.

The range for the i

and o

bytes is -100 dB to +20 dB, which corresponds to byte values of 32 to 152. For reference, the LEDs on the front panel signal meter correspond to teh following dB levels (left to right): -20, -

12, -7, -3, 0, 3, 9, 20.

The format of the s

bytes are also the same as the binary gain commands. The bytes are integers (offset by

132) that represent the current AEC state. The following table shows how the byte values translate to AEC states.

Byte Value

132

133

134

135

AEC State Value (Byte Value - 132)

AEC State Description

Idle

Transmit

Receive

Double Talk

Here's an example

BLDATA

message to clear things up.

B01BLDATAppppèppppppçpppppppppppppèèèèäàåç

The first nine bytes (ppppèpppp) consist of only two values. p

= 0x70 = 112 → 112 - 132 = -20

= 0x8A = 138 → 138 - 132 = 6

So, the signal at input A is at 6 dB, while the signals at the rest of the inputs are at -20 dB.

The next ten bytes (ppçppppppp) consist of only two values. p

= 0x70 = 112 → 112 - 132 = -20

= 0x87 = 135 → 135 - 132 = 3

So, the signal at output 3 is at 3 dB, while the signals at the rest of the outputs are at -20 dB.

The next two bytes (pp) consist of only one value. p

= 0x70 = 112 → 112 - 132 = -20

So, the signal level of both AEC references is -20 dB.

The next four bytes (pppp) consist of only one value. p

= 0x70 = 112 → 112 - 132 = -20

So, we know that the room gain for inputs 1-4 is -20 dB.

The next four bytes (èèèè) consist of only one value.

= 0x8A = 138 → 138 - 132 = 6

So, we know that the AGC gain for inputs 1-4 is 6 dB.

The last four bytes (äàåç) consist of four different values.

= 0x84 = 132 → 132 - 132 = 0 = Idle

= 0x85 = 133 → 133 - 132 = 1 = Transmit

= 0x86 = 134 → 134 - 132 = 2 = Receive

= 0x87 = 135 → 135 - 132 = 3 = Double Talk

So, we know that the AEC on input 1 is in idle, input 2 is in transmit, input 3 is in receive, and input 4 is in double talk.

In the above description, the data in the

BLDATA

command consists of 33 bytes (9 input levels + 10 output levels + 2 AEC reference levels + 4 room gain levels + 4 AGC gain levels + 4 AEC states). It is possible to tell the EF2241 to only send a subset of this information. There are two reasons you might want to do this. First, it makes parsing the data easier since you can ask for only the data that you are interested in. Second, when you decrease the amount of data being sent, the EF2241 can send the messages faster. This means that if you are trying to implement a signal level meter, you can get faster refresh rates by asking the EF2241 to only send the data you're interested in.

Suppose you were only interested in signal levels on inputs A-D. You could send the following command.

B01BLINFO000011110000000000000000000000000

In the above

BLINFO

command, there are 1's in the positions of the data that we want and 0's in the

positions of the data that we don't want. Now, when we send a

BLDATA?

command or enable

BLAUTO

, the

Vortex sends messages of the form:

B01BLDATAiiii

Where the iiii

bytes are the signal levels for inputs A-D. Looking at the

BLDATA

response above, we see that it consists of 14 bytes (

F01BLDATA

= 9 bytes, iiii

= 4 bytes, carriage return = 1 byte). If all of the

BLINFO

bits were set to 1, the command would take a total of 43 bytes (

F01BLDATA

= 9 bytes, data = 33

bytes, carriage return = 1 byte). In automatic mode (

BLAUTO

), the Vortex sends

BLDATA

commands at a constant bitrate, so this truncated command would be sent 43/14 = 3.07 times more often than the full version. This results in a much faster refresh rate.

8.33. BLINFO

-- Select Information to be Reported in

BLDATA

This command controls which bytes are sent in the

BLDATA

command. See the description of the

BLDATA

command for more information on the

BLINFO

command.

8.34. BROAD2

-- Broadcast Arbitrary Command Strings to RS-

232 Port

This command is used to broadcast arbitrary commands to the RS-232 port for controlling other devices (not necessarily other Vortex devices). For example, '

B01BROAD2:ATDT4048921180

' ' ' ' ' would cause the

Vortex to send out '

ATDT4048921180

' via its RS-232 port. If a modem was connected to the RS-232 port, this command would cause the modem to dial the Polycom Installed Voice Business Group in Atlanta.

Example

B01BROAD2:ATDT4048921180

Description

Sends the string

ATDT4048921180

out the RS-232 port.

Status Message

B01BROAD2

8.35. BROADA

-- Broadcast Commands to Other Connected

Devices

This command is used to broadcast commands to other connected Polycom devices via the EF Bus and/or

ASPI Bus. For example, the command '

B01BROADA:B02PHONE1

' would cause device ID 1 to send a command to the EF2241 at device ID 2 to tell it to take its phone off-hook. The EF2241 at device ID 2 would respond by taking its device off-hook and sending an acknowledgement.

This command is usually used in macros when one needs to have a macro on one device trigger an action on another device.

Example Description Status Message

B01BROADA

B01BROADA:B02PHONE1

Sends the command

B02PHONE2

over the digital bus.

B02PHONE1

, this second status message is from the EF2241 at device

ID 2 when it takes its phone off hook.

8.36. BUSREF

-- Set Which AEC Reference is Placed on EF Bus

This command sets or queries whic AEC reference (if any) is placed on the EF Bus. Setting

BUSREF

to '

' means that no reference is placed on the EF Bus. Setting

BUSREF

to '

' means that AEC reference 1 (R1) is placed on the bus. Setting

BUSREF

to '

' means that AEC reference 2 (R2) is placed on the bus.

The AEC references are created in the main matrix via outputs R1 and R2.

Only one Vortex can put a reference on the EF Bus at a time. If more than one Vortex places its reference on the EF Bus, then an '

ERROR#093

' will occur.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 0 and 2, respectively.

Example Description

B01BUSREF2

Put AEC Reference 2 (R2) on the EF Bus.

B01BUSREF0

Set Vortex to not place any AEC reference on the EF Bus.

B01BUSREF?

Query which AEC reference this Vortex is placing on the EF Bus.

Status Message

B01BUSREF2

B01BUSREF0

B01BUSREFx

, where x

, or

2 depending on which AEC reference (if any) is currently being placed on EF Bus.

8.37. CGATE

-- Query Camera Gating Status Information

This command is used to query the gating status of the microphone inputs . It is identical to the

GATE

command except that any given microphone must be gated on for a specified hold time in order for it to be considered "on" by the

CGATE

command. The command can be used to query the status of individual microphones, or the wildcard character can be used to query the status of all the microphone inputs. A typical use for this command is to control camera pointing based on microphone activity. The added hold time prevents the camera from jumping too quickly between positions when there are short amounts of signal present.

The

CGATET

specifies the hold time used for the gating decisions in this command. The

CGATEEN

can be

used to have gating information sent automatically instead of having to poll this command.

Example Description

B01CGATE3?

Query camera gating status of microphone input 3 .

B01CGATE*?

Query camera gating status of all microphone inputs.

Status Message

B01CGATE3x

, , where x

depending on whether the input is gated off or gated on, respectively.

B01CGATE*abcd

, where each letter ( a

, b

, etc.) is either

depending on whether the corresponding microphone input is gated off or gated on, respectively.

8.38. CGATEEN

-- Enable Automatic Camera Gating Messages

This command controls whether or not camera gating information messages are sent automatically. If

CGATEEN

is enabled, then a

CGATE*?

query is performed each time the camera gating status of any microphone changes.

For example, if no microphones are currently gated on and

CGATEEN

is enabled, then if microphone input 3 gates on, the following status message will be automatically generated:

B01CGATE*0010

See the

CGATE

command for more information.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example

B01CGATEEN0

B01CGATEEN1

B01CGATEEN2

B01CGATEEN?

Description Status Message

Disable automatic camera gating messages.

Enable automatic camera gating messages.

B01CGATEEN0

B01CGATEEN1

Toggle enabled state of automatic camera gating messages.

B01CGATEENx

, where x

is either

1 depending on whether automatic camera gating messages are currently disabled or enabled.

Query enabled state of automatic camera gating messages.

B01CGATEENx

, where x

is either

1 depending on whether automatic camera gating messages are currently disabled or enabled.

8.39. CGATET

-- Set Camera Gating Hold Time

This command sets the hold time (in milliseconds) for the camera gating (

CGATE

) feature.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 100 and 5000, respectively.

Example

B01CGATET500

Description

Set camera gating hold time to 500 ms.

Status Message

B01CGATET500

B01CGATET>500

Increase camera gating hold time by

500 ms.

B01CGATETx

, where x

is between

100

and

5000 depending on the current setting of

CGATET

. If this command is issued after the example above, the status message will be

B01CGATET1000

B01CGATET?

Query camera gating hold.

B01CGATETx

, where x

is between

100

and

5000 depending on the current setting of

CGATET

. If this command is issued after the example above, the status message will be

B01CGATET1000

8.40. COUNTRY

-- Specify Country Definitions for Phone

Interface

This command is used to set or query the country that the Vortex is configured for operation in. The country setting affects parameters associated with the phone interface including transmit and receive impedances, flash hook timing, timing thresholds for detecting hangup based on loop current drop, timing thresholds for detecting incoming rings, and outgoing DTMF levels.

The following table lists the numeric values for this command and the associated countries.

Command Value

Country

Undefined

USA

More countries will be added as the Vortex is approved for operation in other countries.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 0 and 1, respectively.

Example Description Status Message

B01COUNTRY1

Set country definition to USA.

B01COUNTRY1

B01COUNTRY?

Query current country setting.

B01COUNTRYx

, where x

is one of the numbers in the above table that corresponds to the current country setting.

8.41. DELAYO

-- Set Output Delay

This command sets the amount of output delay (in tenths of milliseconds) on each of the ten output channels (1-4, A-D, T, L) . Use of the wildcard character (

) for specifying the channel is not supported for

this command. The output delay can be separately enabled or disabled via the

DELAYOE

command.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 0 and 3400, respectively.

Example Description Status Message

B01DELAYO21500

B01DELAYO2>1700

B01DELAYO2?

Set output delay on output channel

2 to 150 ms (1500 tenths of milliseconds).

B01DELAYO21500

Increase output delay on output channel 2 by 170 ms (1700 tenths of milliseconds.)

B01DELAYO2x

, where x

is between

and

3400 depending on the current output delay setting for output channel 2 . If this command is issued after the above example, then the status message will be

B01DELAYO23200

Query current output delay on output channel 2 .

B01DELAYO2x

, where x

is between

and

3400 depending on the current output delay setting for output channel 2. If this command is issued after the above example, then the status message will be

B01DELAYO23200

8.42. DELAYOE

-- Enable Output Delay

This command sets or queries the enabled state of the output delay for each of the ten output channels (1-4,

A-D, T, L) .

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01DELAYOE41

B01DELAYOEA0

B01DELAYOEL2

B01DELAYOEC?

B01DELAYOE*1

B01DELAYOE*0

Description

Enable output delay on output 4 .

B01DELAYOE*1111000010

Enable output delay on outputs 1-4 and T, and disable output delay on outputs A-D and L.

Status Message

B01DELAYOE41

Disable output delay on output A .

B01DELAYOEA0

Toggle enabled status of output delay on output L .

Query enabled status of output delay on output

C .

B01DELAYOETx

, where x

is either

1 depending on the current enabled status of the output delay on the output.

B01DELAYOECx

, where x

is either

1 depending on the current enabled status of the output delay on the output.

Enable output delay on all outputs (1-4, A-D, T,

L) .

B01DELAYOE*1111111111

Disable output delay on all outputs (1-4, A-D, T,

L) .

B01DELAYOE*0000000000

B01DELAYOE*1111000010

B01DELAYOE*2

B01DELAYOE*?

Toggle enabled status of output delay on all outputs.

B01DELAYOE*abcdefghij

, where each of the letters (a, b, etc.) is either

depending of the current enabled status of the output delay on the corresponding output. If this command was sent after the example above, then the status message would be

B01DELAYOE*0000111101

Query enabled status of output delay on all outputs.

B01DELAYOE*abcdefghij

, where each of the letters (a, b, etc.) is either

depending of the current enabled status of the output delay on the corresponding output. If this command was sent after the example above, then the status message would be

B01DELAYOE*0000111101

8.43. DIAL

-- Send DTMF Digits to Phone Interface

This command dials the specified string of digits by sending the equivalent DTMF tones to the phone interface. Valid digits are '0'-'9', '*', '#', and ',' (delay). If the phone is not off-hook when this command is executed, it will automatically be taken off-hook.

Example

B01DIAL9,,,4048921180

Description

Dial 9 (to get an outside line), then pause (the three commas), then dial 4048921180.

Status Message

B10DIAL

8.44. DSPAUTO

-- Enable Automatic

DSPLOAD

Status Messages

This command sets or queries whether or not

DSPLOAD

messages will be automatically generated whenever

the DSP utilization changes.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01DSPAUTO1

Enable automatic

DSPLOAD

messages.

B01DSPAUTO0

Disable automatic

DSPLOAD

messages.

B01DSPAUTO2

Toggle automatic

DSPLOAD

messages.

B01DSPAUTO?

Query the value of the

DSPAUTO parameter.

Status Message

B01DSPAUTO1

B01DSPAUTO0

B01DSPAUTOx

, where x

depending on the current setting of the

DSPAUTO paramter.

B01DSPAUTOx

, where x

depending on the current setting of the

DSPAUTO paramter.

8.45. DSPLOAD

-- Query Percentage of Variable DSP Resources

Used

This command queries the current percentage used of the available variable DSP resources. When this number reaches 100 percent, no more variable DSP veatures may ben enabled. An '

ERROR#060

' will be

generated if a command attempts to exceend 100 percent utilization.

If the

DSPAUTO

feature is enabled, then a

DSPLOAD

status message will be generated automatically any time the percent utilization changes.

Example Description

B01DSPLOAD?

Query percentage of variable DSP resources used.

Status Message

B01DSPLOADx

, where x

is between 0 and 99 and indicates the percentage of the variable

DSP resources being used.

8.46. ERROR

-- Enable or Disable Error Messages

This command sets or queries whether or not error messages for non-fatal errors are reported via RS-232 and the digital bus.

If an error is generated and error messages are enabled, a status message will be automatically generated of the form '

B01ERROR#xxx

', where xxx

is a three digit number indicating the error code. The following table lists the non-fatal error messages that can be generated by the Vortex.

Error Number Description

ERROR#001

ERROR#002

ERROR#004

Unrecognized command.

Syntax error in command.

Attempt to change parameter that is locked via

ERROR#005

, but invalid password given.

ERROR#040

ERROR#041

ERROR#042

ERROR#043

ERROR#044

ERROR#045

This error occurs as the result of an

AMASGN

command. It happens when the command

would remove a microphone from an automixer where it is assigned as the "last mic on" and the automixer is set to manual "last mic on" mode.

This error occurs as the result of an

AMASGN

command. It happens when the command

would remove a microphone from an automixer where it assigned as the chairman imcrophone and the automixer has chairman mode enabled.

This error occurs as the result of an

AMLMM

command. It happens when the command

attempts to set "last mic on" mode to manual, but the last mic number is set to a microphone that does not belong to the specified automixer.

This error occurs as the result of an

AMLMN

command. It happens when the command

attempts to set a "last mic on" number that does not belong to the specified automixer while "last mic on" mode is set to manual.

This error occurs as the result of an

AMCHAIR

command. It happens when the command

tries to enable chairman mode, but the chairman microphone is set to a microphone that does not belong to the specified automixer.

This error occurs as the result of an

AMCHAIR

command. It happens when the command

tries to set the chairman microphone to a microphone that does not belong to the specified automixer while chairman mode is enabled.

ERROR#060

ERROR#070

ERROR#071

ERROR#072

ERROR#073

ERROR#074

ERROR#075

ERROR#076

ERROR#077

ERROR#090

ERROR#091

ERROR#092

ERROR#093

This error occurs when the user has attempted to utilize more variable DSP resources than are available. This may occur if too many matrix crosspoints are unmuted or too many

parametric EQ filters are enabled. The

DSPLOAD

command can query the current

percentage utilization of DSP resources.

This error occurs as a result of a macro or preset execution command (

). It indicates that the macro or preset requested was empty.

This error occurs as a result of a

PRESETW

PRESETK

command. In the case of

PRESETW

it indicates that an attempt was made to write to a factory preset, which is not

allowed. In the case of

PRESETK

, it indicates that an attempt was made to delete a factory preset, which is not allowed.

This error occurs as a result of a

PRESETQ

command. It indicates that one or more

commands in the preset had errors during execution.

This error occurs as a result of a

MACROA

command when there are already too many commands in the macro. The limit is 256 commands per macro.

This error occurs in response to a

, etc.) command. If the command written to the macro or logic pin is illegal, then this error occurs.

This error occurs when a command attempts to write non-volatile memory, but non-volatile memory is password protected via

NVLOCK

This error occurs when attempting to add a macro command (either during an upload or while writing a single macro) and the Vortex runs out of room in non-volatile memory. As a result, the entire macro is discarded. If this occurs during an upload, all previous macros

(before the one that caused the error) are written successfully.

This error occurs when attempting to add a command to a macro, but the Vortex is not in the process of writing a macro. This may happen if you forget to do a MACROS or

UMACROS command, or if you had an

ERROR#076

and continued trying to add commands.

This error indicates an EF Bus hardware handshaking error. This could happen if bussed units are not powered on simultaneously. Powering the units up simultaneously should remove the error.

This error indicates an EF Bus software handshaking error. This could happen if bussed units are not powered on simultaneously. Powering the units up simultaneously should remove the error.

This error indicates an EF Bus ID conflict. See the Vortex user manual for information on valid device IDs.

This error indicates an EF Bus reference conflict. This error occurs when more than one

Vortex is placing its AEC reference on the bus. Use the

BUSREF

command to remove the extra reference(s) in order to resolve the conflict.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01ERROR1

Enable error messages.

Status Message

B01ERROR1

B01ERROR0

Disable error messages mode.

B01ERROR0

B01ERROR2

Toggle error message mode.

B01ERRORx

, where x

depending on the current state of error mode.

B01ERROR?

Query the state of error mode.

B01ERRORx

, where x

depending on the current state of error mode.

8.47. FADERGIL

-- Set Fader Gain of Line Inputs as a Group

This command sets the fader gains of all the line inputs simultaneously. This is different from using a wildcard,

with the

FADERI

command because that command sets all the mic and line inputs together,

while the

FADERGIL

sets only the line inputs.

This command will generate acknowledgements from each of the line inputs separately.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example Description Status Message

B01FADERIA7

B01FADERGIL7

Set fader gain of all line inputs to 7 dB.

B01FADERIB7

B01FADERIC7

B01FADERID7

B01FADERGIL>3

Increase fader gains on all line inputs by 3 dB.

B01FADERGIL?

Query fader gains on all line inputs.

B01FADERIAa

B01FADERIBb

B01FADERICc

B01FADERIDd

, where a

, b

, c

, and d

are the new values of the fader gains for each of the line inputs. If this command was issued after the example above, then the status messages would be:

B01FADERIA10

B01FADERIB10

B01FADERIC10

B01FADERID10

B01FADERIAa

B01FADERIBb

B01FADERICc

B01FADERIDd

, where a

, b

, c

, and d

are the new values of the fader gains for each of the line inputs. If this command was issued after the example above, then the status messages would be:

B01FADERIA10

B01FADERIB10

B01FADERIC10

B01FADERID10

8.48. FADERGIM

-- Set Gain of Microphone Inputs as a Group

This command sets the fader gains of all the microphone inputs simultaneously. This is different from using a wildcard,

with the

FADERI

command because that command sets all the mic and line inputs together,

while the

FADERGIM

sets only the mic inputs.

This command will generate acknowledgements from each of the mic inputs separately.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example Description Status Message

B01FADERI17

B01FADERGIM7

Set fader gain of all mic inputs to 7 dB.

B01FADERI27

B01FADERI37

B01FADERI47

B01FADERGIM>3

B01FADERGIM?

Increase fader gain on all mic inputs by 3 dB.

Query fader gains on all mic inputs.

B01FADERI1a

B01FADERI2b

B01FADERI3c

B01FADERI4d

, where a

, b

, c

, and d

are the new values of the fader gains for each of the mic inputs. If this command was issued after the example above, then the status messages would be:

B01FADERI110

B01FADERI210

B01FADERI310

B01FADERI410

B01FADERI1a

B01FADERI2b

B01FADERI3c

B01FADERI4d

, where a

, b

, c

, and d

are the new values of the fader gains for each of the mic inputs. If this command was issued after the example above, then the status messages would be:

B01FADERI110

B01FADERI210

B01FADERI310

B01FADERI410

8.49. FADERI

-- Set Input Gain Fader

The input channels of the Vortex pass through an analog gain stage before reaching the analog to digital

converter. The gain of this stage is adjustable via a the

GAINI

command. Once in the digital domain, there

is an additional gain stage, referred to as a fader. The fader gain is adjustable by the

FADERI

command. The

GAINI

setting should be used for calilbration in order to maximize the resolution and quality of the signal at

the analog to digital converter. The

FADERI

command is provided as a way to do volume control on the inputs without affecting the calibration.

This command also adjusts the fader gain of the input signal coming from the telephone interface.

This command was introduced in firmware version 2.5.0.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example

B01FADERIT10

B01FADERIT?

Description

Set fader gain on input T to 10 dB.

Status Message

B01FADERIT10

Query the fader gain on input T .

B01FADERITx

, where x

is a number between 0 and

30, depending on the current setting of the fader gain on input channel T .

B01FADERI*6

B01FADERI*ääääììììä

Set fader gain on all inputs (1-4, A-D, T) to 6 dB.

Set fader gain on input channels 1-4 and T to 0 dB and gain on input channels A-D to 9 dB.

B01FADERI*èèèèèèèèè

B01FADERI*ääääììììä

B01FADERI*?

Query fader gain on all inputs (1-4, A-D, T) .

B01FADERI*abcdefghi

, where a

are each between

and

, depending on the current setting of the fader gains for each of the nine input channels.

8.50. FLASH

-- Execute Hook Flash

This command puts the phone on-hook and then takes it back off-hook after a delay. The amount of time between on-hook and off-hook is controlled by the

COUNTRY

setting and has be set for each country to meet each country's specific compliance requirements. If the phone is on-hook when this command is given, then no action is performed.

Example Description Status Message

If the phone is on-hook, no action is performed, and the response will be

B01FLASH

If the phone is off-hook, the response will be

B01FLASH

Execute hook flash.

B01FLASH

B01PHONE0

B01PHONE1

The

PHONE

status messagges occur when the phone goes on-hook and back off-hook.

8.51. FLOW

-- Set Flow Control Mode for RS-232 Port

This command sets the flow control mode for the rear panel RS-232 port. The valid settings are:

Command Value

Description

No flow control.

Hardware flow control.

Auto-detect hardware flow control or no flow control.

We recommend using hardware flow control whenever possible, especially when using higher baud rates.

Example Description

B01FLOW1

Set rear panel RS-232 port to use hardware flow control.

B01FLOW?

Query flow control setting of rear panel RS-232 port.

Status Message

B01FLOW1

B01FLOWx

, where x

, or

2 depending on the current flow control setting.

8.52. FPLOCK

-- Lock/Unlock Front Panel

This command controls the front panel lock feature. When

FPLOCK

is enabled, the user may not make any changes to the system via the front panel. The system settings will still be viewable on the LCD, but the user will get an error message if he tries to change them. When

FPLOCK

is disabled, the user has full access to the system settings via the front panel.

Usage of this command is similar to other boolean commands (see

Section 6.1

) except that when disabling

this feature, the password must be supplied for the command to work. If an incorrect password is supplied,

ERROR#005

' will be generated. The examples below illustrate the correct usage. The examples assume that the password has been set to ' aspi

' (the default). The front panel password can be changed via the

FPPSWD

command.

This command is saved to global non-volatile memory and is not part of a preset. Its value is saved each

time it is changed. It will retain its value after power-down. Since this command writes to non-volatile memory, there will be a delay before an acknowledgment is returned.

Example

B01FPLOCK1

Description

Lock the front panel to prevent users from changing the settings.

Status Message

B01FPLOCK1

B01FPLOCK0,yumyum

B01FPLOCK0,aspi

Attempt to unlock the front panel by using an invalid password

(yumyum).

B01ERROR#005

-- since an invalid password was given, an error message was generated.

If error messages have been disabled (via the

ERROR

command), then no status message

will be generated.

Unlock the front panel by using the correct password.

B01FPLOCK0

B01FPLOCK?

Query the locked status of the front panel.

B01FPLOCKx

, where x

depending on whether the front panel is unlocked or locked, respectively.

8.53. FPPSWD

-- Change Front Panel Password

This command sets or queries the front panel password. This password is used in conjunction with the

FPLOCK

command. The front panel must be unlocked ('

FPLOCK0

') in order to use this command to set or query the front panel password. If the front panel is locked, then this command will result in '

ERROR#004

The examples below assume that the front panel is unlocked.

Example

B01FPPSWDmonkey

B01FPPSWD?

Description

Set front panel password to ' monkey

Query the current front panel password.

Status Message

B01FPPSWDmonkey

8.54. GAINA

-- Set Phone Input Gain

This command sets the gain of the incoming signal from the phone interface. This command is an alias for

the

GAINIT

command. It is provided for backwards compatibility with and ease of migration from the EF200.

When possible, the

GAINIT

command should be used instead of this command.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example Description Status Message

B01GAINA6

Set phone input gain to 6 dB.

B01GAINA6

B01GAINA>3

Increase phone input gain by 3 dB.

B01GAINAx

, where x

is the new value of the phone input gain. If this command was issued after the example above, then the status message would be

B01GAINA9

B01GAINA?

Query phone input gain.

B01GAINAx

, where x

is the new value of the phone input gain. If this command was issued after the example above, then the status message would be

B01GAINA9

8.55. GAIND

-- Set Gain of Incoming DTMF Tones

This command sets the gain of the incoming DTMF tones. The gain of the outgoing DTMF depends on the

country that the Vortex is configured for (see the

COUNTRY

) command. This command is an alias for the

GAINDIT

command. It is provided for backwards compatibility with and ease of migration from the EF200.

When possible, the

GAINDIT

command should be used instead of this command.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -20 and 20, respectively.

Example Description

B01GAIND6

Set incoming DTMF gain to 6 dB.

Status Message

B01GAIND6

B01GAIND>3

Increase incoming DTMF gain by 3 dB.

B01GAINDx

, where x

is the new value of the incoming DTMF gain. If this command was issued after the example above, then the status message would be

B01GAIND9

B01GAIND?

Query incoming DTMF gain.

B01GAINDx

, where x

is the new value of the incoming DTMF gain. If this command was issued after the example above, then the status message would be

B01GAIND9

8.56. GAINDIT

-- Set Gain of Incoming DTMF Tones

This command sets the gain of the incoming DTMF tones. The gain of the outgoing DTMF depends on the

country that the Vortex is configured for (see the

COUNTRY

) command.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -20 and 20, respectively.

Example Description Status Message

B01GAINDIT6

Set incoming DTMF tone gain to 6 dB.

B01GAINDIT6

B01GAINDIT>3

Increase incoming DTMF tone gain by 3 dB.

B01GAINDITx

, where x

is the new value of the incoming DTMF tone gain. If this command was issued after the example above, then the status message would be

B01GAINDIT9

B01GAINDIT?

Query incoming DTMF tone gain.

B01GAINDITx

, where x

is the new value of the incoming DTMF tone gain. If this command was issued after the example above, then the status message would be

B01GAINDIT9

8.57. GAINDT

-- Set Dial Tone Gain

This command sets the gain of the dial tone received from the phone interface.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -20 and 20, respectively.

Example Description

B01GAINDT6

Set dial tone gain to 6 dB.

Status Message

B01GAINDT6

B01GAINDT>3

Increase dial tone gain by 3 dB.

B01GAINDTx

, where x

is the new value of the dial tone gain. If this command was issued after the example above, then the status message would be

B01GAINDT9

B01GAINDT?

Query dial tone gain.

B01GAINDTx

, where x

is the new value of the dial tone gain. If this command was issued after the example above, then the status message would be

B01GAINDT9

8.58. GAINGIL

-- Set Gain of Line Inputs as a Group

This command sets the gains of all the line inputs simultaneously. This is different from using a wildcard,

* with the

GAINI

command because that command sets all the mic and line inputs together, while the

GAINGIL

sets only the line inputs.

This command will generate acknowledgements from each of the line inputs separately.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 0 and 20, respectively.

Example Description

B01GAINGIL7

Set gain of all line inputs to 7 dB.

Status Message

B01GAINIA7

B01GAINIB7

B01GAINIC7

B01GAINID7

B01GAINGIL>3

Increase incoming gain on all line inputs by 3 dB.

B01GAINIAa

B01GAINIBb

B01GAINICc

B01GAINIDd

, where a

, b

, c

, and d

are the new values of each of the line inputs. If this command was issued after the example above, then the status messages would be:

B01GAINIA10

B01GAINIB10

B01GAINIC10

B01GAINID10

B01GAINGIL?

Query gains on all line inputs.

B01GAINIAa

B01GAINIBb

B01GAINICc

B01GAINIDd

, where a

, b

, c

, and d

are the new values of each of the line inputs. If this command was issued after the example above, then the status messages would be:

B01GAINIA10

B01GAINIB10

B01GAINIC10

B01GAINID10

8.59. GAINGIM

-- Set Gain of Microphone Inputs as a Group

This command sets the gains of all the microphone inputs simultaneously. This is different from using a wildcard,

with the

GAINI

command because that command sets all the mic and line inputs together, while

the

GAINGIM

sets only the mic inputs.

This command will generate acknowledgements from each of the mic inputs separately.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 0 and 30, respectively.

Example Description

B01GAINGIM7

Set gain of all mic inputs to 7 dB.

Status Message

B01GAINI17

B01GAINI27

B01GAINI37

B01GAINI47

B01GAINGIM>3

Increase incoming gain on all mic inputs by 3 dB.

B01GAINGIM?

Query gains on all mic inputs.

B01GAINI1a

B01GAINI2b

B01GAINI3c

B01GAINI4d

, where a

, b

, c

, and d

are the new values of each of the mic inputs. If this command was issued after the example above, then the status messages would be:

B01GAINI110

B01GAINI210

B01GAINI310

B01GAINI410

B01GAINI1a

B01GAINI2b

B01GAINI3c

B01GAINI4d

, where a

, b

, c

, and d

are the new values of each of the mic inputs. If this command was issued after the example above, then the status messages would be:

B01GAINI110

B01GAINI210

B01GAINI310

B01GAINI410

8.60. GAINI

-- Set Input Gain

The input channels of the Vortex pass through an analog gain stage before reaching the analog to digital converter. The gain of this stage is adjustable via a digitally controlled analog trim pot. It is important that this gain is set correctly in order to maximize the resolution and quality of the signal at the analog to digital converter. This command lets you adjust the gain of these input gain stages. For volume control, the

FADERI

command can be used to adjust the signal level in the digital domain without affecting the

calibration.

This command also adjusts the gain of the input signal coming from the telephone interface.

The following table shows the relationship between the input gain settings (via

GAINI

and

MIC

) and the

nominal level expected at each of the inputs.

Input Channel

1-4

A-D

MIC

Setting

1 (mic level)

0 (line level)

N/A (line level)

GAINI

Setting (dB)

0 to 30

0 to 20

Expected level at Input (dBu)

0 to -30

33 to 3

0 to -20

The

GAINIT

command has a range of -100 to +20.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 20 or 30, respectively.

Example

B01GAINIT10

B01GAINIT?

B01GAINI*6

B01GAINI*ääääììììä

B01GAINI*?

Description Status Message

Set gain on input T to 10 dB.

B01GAINIT10

Query the gain on input T .

F01GAINI2xB01GAINITxS01GAINIAxQ01GAINIAxT01GAINITx

, where x

is a number between 0 and 30, depending on the current setting of the gain on input channel T .

Set gain on all inputs (1-

4, A-D, T) to

6 dB.

B01GAINI*èèèèèèèèè

Set gain on input channels 1-4 and T to 0 dB and gain on input channels A-

D to 9 dB.

B01GAINI*ääääììììä

Query gain on all inputs

(1-4, A-D, T)

B01GAINI*abcdefghi

, where a

are each between

and

, depending on the current setting of the gains for each of the nine input channels.

8.61. GAINO

-- Set Output Gain

This command sets or queries the gain (in dB) of the ten output channels (1-4, A-D, T, L) .

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example

B01GAINO210

B01GAINO2?

B01GAINO*6

Description

Set gain on output channel 2 to 10 dB.

Status Message

B01GAINO210

Query the gain on output channel 2 .

B01GAINO2x

, , where x

is a number between -100 and 20, depending on the current setting of the gain on output channel 2 .

Set the gain on all output channels (1-4, A-D, T, L) to 6 dB.

B01GAINO*èèèèèèèèèè

B01GAINO*ääääììììçç

B01GAINO*?

Set gain on output channels 1-4 to 0 dB, gain on output channels A-D to

9 dB, and gain on telephone output T and power amplifier L to 3 dB.

B01GAINO*ääääììììçç

Query gain settings on all output channels (1-4, A-

D, T, L) .

B01GAINO*abcdefghij

, where a

are each between

<space>

and

, depending on the current setting of the gains for each of the ten output channels (1-4, A-D, T, L).

8.62. GAINP

-- Set Phone Output Gain

This command sets the gain of the output to the phone interface. This command is an alias for the

GAINOT

It is provided for backwards compatibility with and ease of migration from the EF200. When possible, the

GAINOT

command should be used instead of this command.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example

B01GAINP?

Description

Query phone output gain.

Status Message

B01GAINP6

Set phone output gain to 6 dB.

B01GAINP6

B01GAINP>3

Increase phone output gain by 3 dB.

B01GAINPx

, where x

is the new value of the phone output gain. If this command was issued after the example above, then the status message would be

B01GAINP9

B01GAINPx

, where x

is the new value of the phone output gain. If this command was issued after the example above, then the status message would be

B01GAINP9

8.63. GAINSIT

-- Set From Phone User Tone Gain

This command sets the gain of the user tones coming from the phone DSP. User tones include entry and exit tones (see

TONEE

) and custom tones (see the

SOUNDP

and

SOUNDL

commands). In most cases, the tones

are played out "locally" and their gains are adjusted by the

GAINSIT

command. Sometimes, the tones are

played out to the phone, and the gain is adjusted by the

GAINSOT

command.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -20 and 20, respectively.

Example Description

B01GAINSIT6

Set tone output gain to 6 dB.

Status Message

B01GAINSIT6

B01GAINSIT>3

Increase tone output gain by 3 dB.

B01GAINSITx

where x

is the new value of the tone output gain. If this command was issued after the example above, then the status message would be

B01GAINSIT9

B01GAINSIT?

Query tone output gain.

B01GAINSITx

, where x

is the new value of the tone output gain. If this command was issued after the example above, then the status message would be

B01GAINSIT9

8.64. GAINSOT

-- Set To Phone User Tone Gain

This command sets the gain of the user tones coming from the phone DSP. User tones include entry and exit tones (see

TONEE

) and custom tones (see the

SOUNDP

and

SOUNDL

commands). In most cases, the tones

are played out "locally" and their gains are adjusted by the

GAINSIT

command. Sometimes, the tones are played out to the phone, and the gain is adjusted by the

GAINSOT

command.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -20 and 20, respectively.

Example

B01GAINSOT?

Description

Query tone output gain.

Status Message

B01GAINSOT6

Set tone output gain to 6 dB.

B01GAINSOT6

B01GAINSOT>3

Increase tone output gain by 3 dB.

B01GAINSOTx

, where x

is the new value of the tone output gain. If this command was issued after the example above, then the status message would be

B01GAINSOT9

B01GAINSOTx

, where x

is the new value of the tone output gain. If this command was issued after the example above, then the status message would be

B01GAINSOT9

8.65. GATE

-- Query Gating Status Information

This command is used to query the gating status of the microphone inputs. The command can be used to query the status of individual microphones, or the wildcard character can be used to query the status of all the microphone inputs.

The

GATEEN

can be used to have gating information sent automatically instead of having to poll this command.

Also see the

CGATE

command, which only reports microphones that have been gated on for a specified hold time.

Example

B01GATE3?

Query gating status of microphone input

3 .

B01GATE*?

Description

Query gating status of all microphone inputs.

Status Message

B01GATE3x

, where x

depending on whether the input is gated off or gated on, respectively.

B01GATE*abcd

, where each letter ( a

, b

, etc.) is either

depending on whether the corresponding microphone input is gated off or gated on, respectively.

8.66. GATEEN

-- Enable Automatic Gating Messages

This command controls whether or not gating information messages are sent automatically. If

GATEEN

is enabled, then a

GATE*?

query is performed each time the gating status of any microphone changes. For example, if no microphones are currently gated on and

GATEEN

is enabled, then if microphone input 3 gates on, the following status message will be automatically generated:

B01GATE*0010

See the

GATE

command for more information.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01GATEEN0

Disable automatic gating messages.

B01GATEEN1

Enable automatic gating messages.

B01GATEEN2

Toggle enabled state of automatic gating messages.

B01GATEEN?

Query enabled state of automatic gating messages.

Status Message

B01GATEEN0

B01GATEEN1

B01GATEENx

, where x

is either

1 depending on whether automatic gating messages are currently disabled or enabled.

B01GATEENx

, where x

is either

1 depending on whether automatic gating messages are currently disabled or enabled.

8.67. GMUTEO

-- Mute All Outputs

The name of this command is an abbreviation of "Global Mute Outputs." Enabling this option causes all of the physical outputs to be muted (outputs 1-4, A-D, T, L) . This muting is independent of the normal output

mute command,

MUTEO

. This command is provided so that the control program can implement a "saftey

mute" feature. The idea is that if the user accidentally misconfigures the Vortex and feedback begins to occur, they can press the saftey mute to instantly mute all outputs before they damage their equipment or ears.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

This command is saved to non-volatile memory only as part of a preset. The state of this command will be

restored after power-up only if a preset is saved and that preset is set to be the power-on preset.

Example Description

B01GMUTEO1

Enable global output mute.

B01GMUTEO0

Disable global output mute.

Status Message

B01GMUTEO1

B01GMUTEO0

B01GMUTEO2

Toggle global output mute.

B01GMUTEO?

Query acknowledgement mode.

B01GMUTEOx

, where x

depending on the current state of the global output mute.

B01GMUTEOx

, where x

depending on the current state of the global output mute.

8.68. ID

-- Set Device ID

This command sets or queries the Device ID for the Vortex. Typically, the device ID is set from the front panel of the Vortex, so this command is not normally used. There are restrictions involving having devices with the same ID linked on EF Bus -- see the Vortex Reference Manual for more details.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 0 and 7, respectively.

Example

B01ID3

B01ID?

Description

Change the device ID from 1 to 3

Query current device ID.

Status Message

B03ID3

B01ID1

8.69. LABEL

-- Set or Query one of the Device Labels

This command sets or queries one of the many labels stored in the device. The

LABEL

command has the following syntax: iLABELx,y where i

is the device type and ID, x

is the label specifier, and y

is the label text (to set the label) or a

character (to query the label). The label specifiers are as follows:

Label Specifier

I1-I4, IA-ID, IT

O1-O4, OA-OD, OL, OT

P, W, X, Y, Z

PB0-PB7, WB0-WB7, XB0-XB7, YB0-YB7, ZB0-

ZB7

Description

A label for the device itself.

A label for the signal generator.

Labels for the input channels.

Labels for the output channels.

Labels for matrix outputs to EF Bus.

Labels for inputs from EF Bus to submatrices.

PM0-PM1, WM0-WM2, XM0-XM2, YM0-YM2,

ZM0-ZM2

R1, R2

G0-G3

LI1-LI24

LO1-LO20

P0-P47

M0-M255

Labels for outputs from EF Bus submatrices to main matrix.

Labels for AEC references.

Labels for logic input groups.

Labels for logic input pins

Labels for logic output pins

Labels for user presets.

Labels for user macros.

The text of each label can be up to 16 characters long. Labels for presets 0-15 are read-only.

Example

B01LABELOB,Zone 2 Speaker

B01LABELOB,?

Description

Set label of output B to

"Zone 2 Speaker".

Status Message

B01LABELOB,Zone 2 Speaker

Query label for output B

B01LABELOB,<string>

, where

<string> is the current label assigned to output B .

8.70. LAGC

-- Enable or Disable Line Input Automatic Gain

Control

This command sets or queries the status of the Automatic Gain Control (AGC) algorithm on input channels A-

D .

This command was introduced in firmware version 2.5.0.

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example Description

B01LAGCB1

Enable AGC on input channel B.

B01LAGCA0

Disable AGC on input channel A.

B01LAGCC2

Toggle AGC state on input channel C .

B01LAGCD?

Query AGC state on input channel D .

B01LAGC*1

Enable AGC on input channels A-D.

B01LAGC*0

Disable AGC on input channels A-D.

Status Message

B01LAGCB1

B01LAGCA0

B01LAGCCx

, where x

depending on the current state of the AGC on input channel C .

B01LAGCDx

, where x

depending on the current state of the AGC on input channel D .

B01LAGC*1111

B01LAGC*0000

B01LAGC*2

Toggle AGC state on input channels A-D.

B01LAGC*abcd

, where a

are each

1 depending on the current state of the AGC for each of the four line input channels.

B01LAGC*?

Query AGC state on input channels A-D.

B01LAGC*abcd

, where a

are each

1 depending on the current state of the AGC for each of the four line input channels.

8.71. LAGCLINKAB

-- Enable or Disable Stereo AGC Linking on

Inputs A and B

This command links the line input AGC of inputs A and B into a stereo pair. The overall volume level of the stereo signal will be analyzed, and the same gain will be applied to both channels.

This command has some side effects on the way the other line input AGC commands work. When

LAGCLINKAB

is first enabled, the settings for

be copied to channel B. The original settings for channel B will not be restored after

LAGCLINKAB

is disabled. Acknowledgements will be sent for any changes to channel B. From then on, any changes for these commands for either channel A or B will be set for both channels, and acknowledgements will be sent for both channels.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example

B01LAGCLINKAB1

B01LAGCLINKAB0

Description

Enable stereo AGC linking on inputs A and B.

Disable stereo AGC linking on inputs A and B.

Status Message

B01LAGCLINKAB1

B01LAGCLINKAB0

B01LAGCLINKAB2

Toggle stereo AGC linking on inputs A and B.

B01LAGCLINKAB?

Query status of stereo AGC linking on inputs A and B.

B01LAGCLINKABx

, where x

depending on the current state of stereo AGC linking on inputs

A and B.

B01LAGCLINKABx

, where x

depending on the current state of stereo AGC linking on inputs

A and B.

8.72. LAGCLINKCD

-- Enable or Disable Stereo AGC Linking on

Inputs C and D

This command links the line input AGC of inputs C and D into a stereo pair. The overall volume level of the stereo signal will be analyzed, and the same gain will be applied to both channels.

This command has some side effects on the way the other line input AGC commands work. When

LAGCLINKCD

is first enabled, the settings for

be copied to channel D. The original settings for channel D will not be restored after

LAGCLINKCD

disabled. Acknowledgements will be sent for any changes to channel D. From then on, any changes for these commands for either channel C or D will be set for both channels, and acknowledgements will be sent for both channels.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example

B01LAGCLINKCD1

B01LAGCLINKCD0

Description

Enable stereo AGC linking on inputs C and D.

Disable stereo AGC linking on inputs C and D.

Status Message

B01LAGCLINKCD1

B01LAGCLINKCD0

B01LAGCLINKCD2

Toggle stereo AGC linking on inputs C and D.

B01LAGCLINKCD?

Query status of stereo AGC linking on inputs C and D.

B01LAGCLINKCDx

, where x

depending on the current state of stereo AGC linking on inputs

C and D.

B01LAGCLINKCDx

, where x

depending on the current state of stereo AGC linking on inputs

C and D.

8.73. LAGCMAX

-- Set Maximum Allowed Line Input AGC Gain

This command sets the maximum gain that the AGC can apply on input channels A-D . For example, if

LAGCMAX

is set to

, then the AGC for that channel can apply a maximum of 10 dB of gain to the input signal.

This command was introduced in firmware version 2.5.0.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 15, respectively.

Example

B01LAGCMAXA3

B01LAGCMAXB?

B01LAGCMAX*6

B01LAGCMAX*ääìì

Description

Set AGC maximum gain on input channel A to 3 dB.

Status Message

B01LAGCMAXA3

Query the AGC maximum gain on input channel B.

B01LAGCMAXBx

, where x

is a number between 0 and 15, depending on the current setting of the

AGC maximum gain on input channel B.

Set AGC maximum gain on input channels A-D to 6 dB.

B01LAGCMAX*èèèè

Set AGC maximum gain on input channels A-B to 0 dB and AGC maximum gain on input channels

C-D to 9 dB.

B01LAGCMAX*ääìì

B01LAGCMAX*?

Query AGC maximum gain on input channels A-D.

B01LAGCMAX*abcd

, where a

are each between

and

, depending on the current setting of the

AGC maximum gain for each of the four line input channels.

8.74. LAGCMIN

-- Set Minimum Allowed Line Input AGC Gain

This command sets the minimum gain that the AGC can apply on input channels A-D . For example, if

LAGCMIN

is set to

-10

, then the AGC for that channel can apply a minimum of -10 dB of gain to the input signal.

This command was introduced in firmware version 2.5.0.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are -15 and 0, respectively.

Example

B01LAGCMINA-3

B01LAGCMINB?

B01LAGCMIN*-6

B01LAGCMIN*ääüü

B01LAGCMIN*?

Description

Set AGC minimum gain on input channel A to -3 dB.

Status Message

B01LAGCMINA-3

Query the AGC minimum gain on input channel B.

B01LAGCMINBx

, where x

is a number between -

15 and 0, depending on the current setting of the

AGC minimum gain on input channel B.

Set AGC minimum gain in input channels A-D to -6 dB.

Set AGC minimum gain on input channels A-B to 0 dB and AGC minimum gain on input channels

C-D to -3 dB.

B01LAGCMIN*~~~~

B01LAGCMIN*ääüü

Query AGC minimum gain on input channels A-D.

B01LAGCMIN*abcd

, where a

are each between u

and

, depending on the current setting of the

AGC minimum gain for each of the line input channels.

8.75. LAGCRATE

-- Set Ramp Rate of Line Input AGC

This command sets or queries the maximum rate at which the AGC can increase or decrease the gain of the signals on input channels A-D . The ramp rate is expressed in dB/sec.

This command was introduced in firmware version 2.5.0.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 5, respectively.

Example

B01LAGCRATEA3

Description

Set AGC ramp rate on input channel A to 3 dB/sec.

Status Message

B01LAGCRATEA3

B01LAGCRATEB?

Query the AGC ramp rate on input channel B.

B01LAGCRATEBx

, where x

is a number between 1 and 5, depending on the current setting of the AGC ramp rate on input channel B.

B01LAGCRATE*5

B01LAGCRATE*ààêê

Set AGC ramp rate on input channels A-D to 5 dB/sec.

Set AGC ramp rate on input channels A-B to 1 dB/sec and

AGC ramp rate on input channels C-D to 4 dB/sec.

B01LAGCRATE*?

B01LAGCRATE*ëëëë

B01LAGCRATE*ààêê

Query AGC ramp rate on input channels A-D.

B01LAGCRATE*abcd

, where a

are each between

and

, depending on the current setting of the AGC ramp rate for each of the line input channels.

8.76. LEC

-- Enable or Disable LEC

This command sets or queries the status of the line echo canceller (LEC).

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01LEC1

Enable LEC.

Status Message

B01LEC1

B01LEC0

Disable LEC.

B01LEC0

B01LEC2

Toggle LEC state.

B01LECx

, where x

depending on the current state of the LEC.

B01LEC?

Query LEC state.

B01LECx

, where x

depending on the current state of the LEC.

8.77. LECMODE

-- Set Amount of Double Talk Suppression used in the LEC.

This command sets the amount of double talk suppression used in the LEC on the telephone input (T). The values correspond to the following settings.

●

= No Suppression

●

= Light Suppression

●

= Heavy Suppression

●

= Half Duplex

This command is an integer command. See

Section 6.2

for more information on this type of command. The

minimum and maximum values for this command are 1 and 4, respectively.

Example Description Status Message

B01LECMODE3

Set LEC to Heavy Suppression.

B01LECMODE3

B01LECMODE?

Query LEC suppression level.

B01LECMODEx

where x

, or

depending on the current setting of the LEC suppression level.

8.78. LI

-- Query State of Logic Inputs

This command returns the current state of the logic inputs. There are 24 logic inputs, so an array of 24 boolean values is returned with the first value indicating the state of the first logic input, the second value indicating the state of the second logic input, and so on.

Example Description

B01LI*?

Query current state of logic inputs.

Status Message

B01LI*111010100010111100001110

, this is an exapmle response, the actual values will depend on the actual states on the logic inputs.

8.79. LIA

-- Assign Action for when Logic Input is Activated

This function assigns a single command to be executed when a given logic input changes from the inactive state to the active state. Typically, the inactive state is logic high ('1') and the active state is logic low ('0').

This is commonly referred to as active low. Acitve low is considered normal because a closed switch would ground the input and a closed switch would normally be considered active. This polarity setting can be changed via the

LIP

command.

A single command can be assigned to each of three conditions occurring on the logic pin: a change to the active state, a change to the inactive state, and a repeating command when the pin is held in the active state. The

LIA

command assigns a single command to the logic pin that is executed when the logic pin changes to the active state.

Although only one command can be assigned to the state change, the command may be a

MACROX

MACROQ

command. Since up to 256 commands can be stored in each macro, this gives the effect of having

up to 256 commands execute when the logic pin changes state. The command associated with the state

change can also be a

PRESETX

PRESETQ

. This makes it easy to reconfigure the device for different rooms based on external logic settings.

The

BROADA

is also useful in logic pin assignments. The

BROADA

command transmits a command to another

device on the EF Bus, so you can effectively make a logic pin state change on one device cause an action to occur on another device.

ERROR#074

will be generated if the assigned command is one that writes non-volatile memory, and the pin

will not actually be assigned.

Example

B01LIA4,MUTEI11

B01LIA5,MACROX23

B01LIA6,BROADA:B02MUTEI11

B01LIA7,

B01LIA4,?

Description

Assign the command

MUTEI11

to occur when logic input pin 4 changes from the inactive to active state. The

MUTEI11

mutes input channel

Status Message

B01LIA4,MUTEI11

Assign the command

MACROX23

to occur when logic input pin 5 changes from the inactive state to the active state. The

MACROX23 command executes macro

23, which can contain up to

256 other commands.

B01LIA5,MACROX23

Assign the command

BROADA:B02MUTEI11

to occur when logic input pin 6 changes from the inactive state to the active state. This command causes the

EF2241 at ID 2 to mute its input channel

when logic pin 6 on the EF2241 at ID 1 changes from the inactive to active state.

B01LIA6,BROADA:B02MUTEI11

Assign a blank command to occur when logic input pin 7 changes from the inactive state to the active state.

Assigning a blank command means no action will take place as a result of this state change.

B01LIA7,

Query the command associated with the active state of logic pin 4.

B01LIA4,<string>

, where

<string> is the command string that will be executed when logic input 4 is activated.

If this query was given after the example for logic input 4 above, the response would be

B01LIA4,MUTEI11

8.80. LID

-- Assign Action for when Logic Input is Deactivated

This function assigns a single command to be executed when a given logic input changes from the active

state to the inactive state. Typically, the inactive state is logic high ('1') and the active state is logic low ('0').

LIP

command.

LID

command assigns a single command to the logic pin that is executed when the logic pin changes to the inactive state.

Although only one command can be assigned to the state change, the command may be a

MACROX

MACROQ

command. Since up to 256 commands can be stored in each macro, this gives the effect of having

up to 256 commands execute when the logic pin changes state. The command associated with the state

change can also be a

PRESETX

PRESETQ

. This makes it easy to reconfigure the device for different rooms based on external logic settings.

The

BROADA

is also useful in logic pin assignments. The

BROADA

command transmits a command to another

device on the EF Bus, so you can effectively make a logic pin state change on one device cause an action to occur on another device.

ERROR#074

will be generated if the assigned command is one that writes non-volatile memory, and the pin will not actually be assigned.

See the description of the

LIA

for examples on how to use the

LID

command. The syntax for this command is exactly the same.

8.81. LIH

-- Assign Action for when Logic Input is Held

This function assigns a single command to be executed repeatedly when a given logic input is held in the active state. Typically, the inactive state is logic high ('1') and the active state is logic low ('0'). This is commonly referred to as active low. Acitve low is considered normal because a closed switch would ground the input and a closed switch would normally be considered active. This polarity setting can be changed via

the

LIP

command.

LIH

command assigns a single command to the logic pin that is executed repeatedly when the logic pin is held in the active state. This command is useful for volume ramping controls, especially when combined with the relative operators (

and

) of integer commands (see

Section 6.2

Although only one command can be assigned to the state change, the command may be a

MACROX

MACROQ

command. Since up to 256 commands can be stored in each macro, this gives the effect of having

up to 256 commands execute when the logic pin changes state. The command associated with the state

change can also be a

PRESETX

PRESETQ

. This makes it easy to reconfigure the device for different rooms based on external logic settings.

The

BROADA

is also useful in logic pin assignments. The

BROADA

command transmits a command to another

device on the EF Bus, so you can effectively make a logic pin state change on one device cause an action to occur on another device.

ERROR#074

will be generated if the assigned command is one that writes non-volatile memory, and the pin will not actually be assigned.

See the description of the

LIA

for examples on how to use the

LIH

command. The syntax for this command is exactly the same. One additional example is given here: using the

LIH

command for volume control.

Example

B01LIH8,GAINIA>3

Description Status Message

Assign the command

GAINIA>3

to occur repeatedly when logic pin 8 is held in the active state. The

GAINIA>3 command causes the gain on input channel

to increase by 3 dB each time the command is executed.

B01LIH8,GAINIA>3

8.82. LIEN

-- Enable Automatic Logic Input Status Messages

This command controls whether or not logic input status messages are sent automatically. If

LIEN

is enabled, then a logic input query (

LI*?

) is performed any time any of the states change on the logic input pins. For example, if all logic inputs are currently in the low state ('0') and

LIEN

is enabled, then if logic input 12 changes state to '1', the following status message will be generated:

B01LI*000000000001000000000000

A status message is only generated if there is a state change. This helps keep data traffic to a minimum.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01LIEN?

Query automatic logic input status messages.

Status Message

B01LIEN1

Enable automatic logic input status messages.

B01LIEN1

B01LIEN0

Disable automatic logic input status messages.

B01LIEN0

B01LIEN2

Toggle automatic logic input status messages.

B01LIENx

, where x

depending on the current setting of

LIEN

B01LIENx

, where x

depending on the current setting of

LIEN

8.83. LIG

-- Configure Logic Input Pins Into a Group

This conmmand configures which logic input pins are in a group. Logic groups allow events to happen when

certain combinations of inputs are present on the logic pins. For example, if a logic group was defined that consisted of three logic input pins (pin 1, pin 2, and pin 3), then a total of eight combinations (2 3 ) are possible, and a command or macro can be assigned to each combination. This feature is particularly useful in room-combining applications. It can also be used to make controls based on rotary switches that output binary, BCD, or Gray codes.

Commands can be assigned to the configurations of a logic group via the

LIN

command.

Example

B01LIG2,000011110000000000000000

B01LIG2,01101001000010000000000

B01LIG2,?

Description Status Message

Configure

Logic Group 2 to contain logic input pins 5-8.

B01LIG2,000011110000000000000000

Configure

Logic Group 2 to contain logic input pins 2, 3, 5,

8, and 13.

Note that the pins in a logic group do not have to be contiguous.

B01LIG2,01101001000010000000000

Query which pins are in logic group 2.

B01LIG2,abcdefghijklmnopqrstuvwx

, where a

are each

depending on which logic input pins are assigned to logic group 2.

8.84. LIK

-- Delete One or All Logic Input Pin Commands

This command "kills" or deletes all commands for a given logic input pin. In other words, the commands

will be deleted for the specified logic input. A wildcard character can also

be specified for the logic input pin, in which case the commands for all logic input pins will be deleted.

Using this command is more efficient than deleting one command or pin at a time since this command deletes them all at once and requires fewer writes to non-volatile memory.

Example Description Status Message

B01LIK5

B01LIK*

Delete all the commands associated with logic input pin 5. This one command is equivalent to executing the commands '

B01LIA5,

', '

B01LID5,

', and '

B01LIH5,

' except that this command is more efficient.

B01LIK5

Delete all the commands associated with all logic input pins. This one command is equivalent to executing the commands '

B01LIA1,

B01LID1,

', and '

B01LIH1,

' for each logic input, except that this command is much more efficient.

B01LIK*

8.85. LIM

-- Mask Logic Input Pins

This command is used to mask (i.e., disable) logic input pins. The mask consists of 24 fields (one for each logic input) that can each be set to

. If the mask bit for a given logic input is set to

, then the logic input pin works normally. If the mask bit for a given logic input is set to

, then the logic input is disabled.

When a logic input is disabled, any commands assigned to the logic pin via

will not be executed.

If a logic pin is disabled and then re-enabled at some later time and the logic input has changed state from when it was disabled, the command associated with the state change will be executed. For example, if a logic input pin is high when it is disabled, and it is low when it is re-enabled, the command defined via

LID

(or

LIA

if the polarity is changed via

LIP

) will be executed. However, if the pin changes state multiple times

while it is disabled, multiple commands will not be executed; only the difference in state when the logic input is re-enabled is considered.

Example

B01LIM100101101111011111111111

B01LIM?

Description Status Message

Mask (disable) logic inputs 2,

3, 5, 8, and 13.

B01LIM100101101111011111111111

Query current logic input mask.

B01LIMabcdefghijklmnopqrstuvwx

where a

are each

depending on the current state of the logic input mask.

8.86. LIN

-- Assign Command to Logic Input Group

This command assigns a command to be executed when a group of logic input pins is in a certain configuration. Logic groups are defined via the

LIG

command.

As an example, assume that the command

B01LIG2,000001111100000000000000

has been sent to the device. This command configures logic input pins 6-10 to be part of logic group 2. Now, we send the command

B01LIN2,10,MACROX25

. This command configures logic input group 2 to execute the command

MACROX25

when logic inputs 7 and 9 are active ('1') and logic inputs 6, 8, and 10 are inactive ('0'). The first number in the

LIN

command specifies which logic group to be affected. The second number specifies the configuraion. In this case, the number '10' translates to '01010' in binary. There are zeros in the positions for the first, third, and last bits -- these correspond to logic inputs 6, 8, and 10 for our case. Similarly, the ones in the second and fourth positions correspond to bits 7 and 9. The last part of the command specifies the command to be executed with the pins enter this configuration.

Example

B01LIN2,10,MACROX25

B01LIN1,7,?

Description Status Message

Configure logic input group

2 to execute

MACROX25 when the pins in logic input group 2 correspond to the decimal value 10.

B01LIN2,10,MACROX25

Query the command associated with decimal configuration 7 on logic input group 1.

B01LIN1,7,<string>

, where <string> corresponds to the command that is associated with decimal configuration 7 on logic input group 1.

8.87. LIP

-- Set Polarity for Logic Inputs

This command sets the polarity for the 24 logic input pins. Setting the polarity for a given pin to

indicates that the polarity should be normal (active low). Setting the polarity for a given pin to

indicates that the polarity should be inverted (active high). Active low is considered normal because a closed switch would ground the input, and a closed switch would normally be considered active.

This command affects the operation of the

commands. If a logic input pin's polarity is reversed, the operation of these commands is reversed.

By default, the polarity for all pins is set to normal (active low).

Example

B01LIP000000000000000000001111

Description

Set logic inputs 1-20 to normal (active low) and logic inputs 21-24 to inverted (active high).

Status Message

B01LIP000000000000000000001111

8.88. LO

-- Query or Set Status of Logic Output Pins

This command sets or queries the current state of the logic outputs. There are 20 logic outputs, so an array of 20 boolean values is required or returned, with the first value indicating the state of the first logic output, the second value indicating the state of the second logic output, and so on.

If a logic output pin has conditions driving it (via the

LOA

and

LOD

commands), those conditions will override

any settings imposed by the

command.

If a logic pin is masked via the

LOM

command, its status will still be affected by the

command.

Example

B01LO*00000000000000000000

B01LO*10101010101010101010

B01LO*?

Description

Query current state of logic outputs

Status Message

Set all logic outputs low.

B01LO*00000000000000000000

Set even numbered logic output pins low and odd numbered logic output pins high.

B01LO*10101010101010101010

F01LO*abcdefghijklmnopqrst

, where a

t are each

depending on the current state of the corresponding logic output.

8.89. LOA

-- Define Behavior for Logic Output Activated State

This command is used to define the conditions under which a given logic output pin goes into the active state. By default the logic output pins are active high. Active high is the default because it would light an LED connected to the output when the output was in the active state. The polarity of the logic output pins can be changed with the

LOP

command.

The syntax of this command allows one to use one of the boolean channel commands to determine the state of the logic output pin. The commands that are valid for use with

LOA

are

, and

. Each command must be specified using the wildcard character,

, for the channel number.

Each character in the array string is compared to the status of the channels in the Vortex. A

or a

in the string means that the status for the corresponding channel must match that character for the condition to be true. A period character,

, in the string is a don't care, meaning that the condition will be true no matter what the status for that channel is. A

character works as an OR function, with

corresponding to a

1 in the channel status and

corresponding to a

. If any

characters are in the string, at least one channel's status must match for the condition to be true.

Consider the following example. In this example, we also use the

LOD

command, which is just like the

LOA command except that it sets the condition for the logic output to be in the deactivated state. Normally, you must set both the

LOA

and

LOD

commands in order to make use of a logic output pin. In our example, we

issue the following commands:

H01LOA10,MUTEI*10++--..

H01LOD10,MUTEI*0...00++

These two commands set the conditions for activation and deactivation of logic output 10. Under these conditions, logic output 10 will be activated if:

●

(input 1 is muted) AND

●

(input 2 is unmuted) AND

●

(input 3 is muted OR input 4 is muted OR input A is unmuted OR input B is unmuted)

Logic output 10 will be deactivated if:

●

(input1, input A, and input B are unmuted) AND

●

(input C OR input D is muted)

An error condition of

ERROR#074

will be generated if the assigned command is invalid.

Example

B01LOA10,MUTEI*10++--..

B01LOA7,

Description

Configure the conditions for activation of logic output 10 as described in the example above.

Delete conditions for activation of logic output 7.

Status Message

B01LOA10,MUTEI*10++--..

B01LOA7,

8.90. LOD

-- Define Behavior for Logic Output Deactivated

Status

This command is used to define the conditions under which a given logic output pin goes into the deactive state. The syntax and behavior of this command is identical to that of the

LOA

command. Please refer to the

description of the

LOA

command for more information, including examples.

8.91. LOEN

-- Enable Automatic Logic Output Status Messages

This command controls whether or not logic output status messages are sent automatically. If

LOEN

is enabled, then a logic output query (

LO*?

) is performed any time any of the states change on the logic output pins. For example, if all logic outputs are currently in the low state ('0') and

LOEN

is enabled, then if logic output 12 changes state to '1', the following status message will be generated:

B01LO*00000000000100000000

A status message is only generated if there is a state change. This helps keep data traffic to a minimum.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description Status Message

B01LOEN1

Enable automatic logic output status messages.

B01LOEN1

B01LOEN0

Disable automatic logic output status messages.

B01LOEN0

B01LOEN2

Toggle automatic logic output status messages.

B01LOEN?

Query automatic logic output status messages.

B01LOENx

, where x

depending on the current setting of

LOEN

B01LOENx

, where x

depending on the current setting of

LOEN

8.92. LOK

-- Delete One or All Logic Output Pin Commands

This command "kills" or deletes all commands for a given logic output pin. In other words, the commands

associated with

LOA

and

LOD

will be deleted for the specified logic output. A wildcard character can also be

specified for the logic output pin, in which case the commands for all logic output pins will be deleted.

Using this command is more efficient than deleting one command or pin at a time since this command deletes them all at once and requires fewer writes to non-volatile memory.

Example Description

B01LOK5

Delete all the commands associated with logic output pin 5. This one command is equivalent to executing the commands '

B01LOA5,

' and '

B01LOD5,

' except that this command is more efficient.

B01LOK*

Delete all the commands associated with all logic output pins. This one command is equivalent to executing the commands '

B01LOA1,

' and '

B01LOD1,

' for each logic output, except that this command is much more efficient.

Status Message

B01LOK5

B01LOK*

8.93. LOM

-- Mask Logic Output Pins

This command is used to mask (i.e., disable) logic output pins. The mask consists of 20 fields (one for each logic output) that can each be set to

. If the mask bit for a given logic output is set to

, then the logic output pin works normally. If the mask bit for a given logic output is set to

, then the logic output is disabled. When a a logic output is disabled, it is "frozen" in whatever state it is in when it is disabled. The output pin's state will not change when the condition that drives it (via

LOA

and

LOD

) changes. However, any changes to that pin caused by setting the values with an

command will affect the output pin value. For instance, you could disable (mask) a pin and then explicitly set its value to low with the

command.

When a logic output pin is re-enabled, it will be updated to the current status of whatever condition drives it

Example

B01LOM10010110111101111111

Description

Mask (disable) logic outputs 2, 3,

5, 8, and 13.

Status Message

B01LOM10010110111101111111

B01LOM?

Query current logic output mask.

B01LOMabcdefghijklmnopqrst

, where a

t are each

depending on the current state of the logic output mask.

8.94. LOP

-- Set Polarity for Logic Outputs

This command sets the polarity for the 20 logic input pins. Setting the polarity for a given pin to

indicates that the polarity should be normal (active high). Setting the polarity for a given pin to

indicates that the polarity should be inverted (active low). Active high is considered normal because it would light an LED connected to an output pin if the output pin was in the active state.

This command affects the operation of the

LOA

and

LOD

commands. If a logic input pin's polarity is reversed,

the operation of these commands is reversed.

By default, the polarity for all pins is set to normal (active high).

Example

B01LOP11111111111111110000

B01LOP?

Description Status Message

Set logic outputs 1-

16 to normal

(active high) and logic outputs 17-

20 to inverted

(active low).

B01LOP11111111111111110000

Query current polarity settings for logic outputs.

B01LOPabcdefghijklmnopqrst

, where a

t are each

depending on the current state of the logic output polarity for the corresponding logic output pin.

8.95. MACROA

-- Add Command to Current Macro

This command adds a command to the macro currently in progress. This is used in conjunction with the

MACROS

and

MACROW

commands to create a new macro.

The syntax of this command specifies a macro number, a comma, and then the command to be added to the macro. The command to be added to the macro can be any valid command except the following:

● any

PRESET

command

● any

MACRO

command

● any logic input or output command

If an attempt to assign an invalid command to a macro is made (via

MACROA

), then the error condition

ERROR#074

will be generated.

An error will be generated if the specified command is not a valid command. However, an error will not be

generated if the specified command is valid, but its data is invalid. For example:

B01MACROA25,LAYDOWNTHEBOOGIE

Would return an error because it does not contain a valid command. However:

B01MACROA62,MUTEOMYMOTHERINLAW

Would not return an error because it contains a

MUTEO

command. An error would be returned when the macro is executed with a

MACROX

MACROQ

command and it tries to execute the

MUTEO

command with strange data.

The proper sequence for creating a macro (macro number 112 in this example) is as follows.

B01MACROS112

B01MACROA112,MUTEI*0

B01MACROA112,GAINI*0

B01MACROA112,MUTEO*0

B01MACROW112

This defines macro number 112 to unmute all inputs, set all input gains to 0 dB, and unmute all outputs. It is acceptable if another command is sent in between these commands (such as

B01NC*?

) as long as it isn't another non-volatile memory command which could interfere with the storage of the macro.

8.96. MACROK

-- Delete One or All Macros

This command kills (deletes) the specified macro. If the wildcard character (

) is used the specify the macro number, then all macros are deleted. Deleting all macros via

MACROK*

is more efficient than deleting them all individually since it requires less writes to non-volatile memory.

Example Description

B01MACROK25

Delete all the commands associated with macro number 25.

B01MACROK*

Delete all the commands associated with all 255 macros.

Status Message

B01MACROK25

B01MACROK*

8.97. MACROL

-- List All Commmands in a Macro

This command lists all the commands in a given macro. For example, assume that a macro has been defined via the following command sequence.

B01MACROS112

B01MACROA112,MUTEI*0

B01MACROA112,GAINI*0

B01MACROA112,MUTEO*0

B01MACROW112

Once this macro has been defined, issuing the command:

B01MACROL112?

Will result in the following status messages:

B01MACROL112,MUTEI*0

B01MACROL112,GAINI*0

B01MACROL112,MUTEO*0

B01MACROL112

8.98. MACROQ

-- Execute Macro Quietly

This command executes the macro corresponding to the specified number. The macro must have been

previously defined and stored in non-volatile memory via the

the specified macro is empty, then an error condition of

ERROR#070

will be generated.

When the

MACROQ

command executes, status messages for all of the commands in the macro will not be generated. The

MACROQ

is provided so that a control system can execute a macro and not generate heavy data traffic from the resulting status messages. Of course, this assumes that the control system is not interested in any of the acknowledgements. The

MACROX

command can be used to execute the macro

without suppressing status messages.

Example Description Status Message

B01MACROQ125

Execute macro number 125 without generating any status messages.

B01MACROQ125

8.99. MACROS

-- Start a New Macro

This command is used to start writing a new macro with a specified macro number. This command is used in conjunction with the

MACROA

and

MACROW

commands to create a new macro. If this command is sent while

another macro is in the process of being written (before the

MACROW

command is sent), then the macro in progress will be deleted and the new one will be started.

See the description of the

MACROA

command for detailed information on creating macros.

8.100. MACROW

-- Write Macro to Non-Volatile Memory

This command writes the macro that is currently being defined to non-volatile memory. This command is

used in conjunction with

MACROA

and

MACROS

to create a new macro. If this command is sent when no

macro is in progress (i.e., if a

MACROS

command has not been sent) or if the macro number sent with this command does not match the number of the macro in progress, then an error will be returned.

See the description of the

MACROA

command for detailed information on creating macros.

8.101. MACROX

-- Execute Macro

This command executes the macro corresponding to the specified number. The macro must have been

previously defined and stored in non-volatile memory via the

the specified macro is empty, then an error condition of

ERROR#070

will be generated.

When the

MACROX

executes, status messages for all of the commands in the macro will be generated (unless

acknowledgement mode is turned off). The status messages can be suppressed by using the

MACROQ

command, which is exactly the same as

MACROX

except that status messages are suppressed.

Example Description

B01MACROX125

Execute macro number 125.

Status Message

Status messages for all the commands in the macro will be generated first, followed by the message:

B01MACROX125

8.102. METER

-- Select which Signal is Displayed on the Front

Panel LED Meter

This command selects which signal is displayed on the front panel LED meter. The options correspond to any of the 8 inputs, the telephone input, 8 outputs, the telephone output, the power amplifier output, or the two

AEC references. The inputs are specified by the labels

, and

(for the telephone input).

The outputs are specified by the labels

(telephone), and

(power amplifier). The AEC references are specified by the labels

and

Example

B01METERI1

Description

Set front panel LED meter to display the signal on input 1 .

B01METER?

Query which signal the front panel LED meter is currently set to monitor.

Status Message

B01METERI1

B01METERx

, where x

is the label corresponding to the signal currently being monitored. If this command was sent after the first example given above, the response would be

B01METERI1

8.103. MGAIN

-- Set Crosspoint Gains in Main Matrix or

Submatrix

This command sets or queries one or more crosspoint gains in either the main matrix or one of the EF Bus submatrices.

This command is a matrix integer command. See Section 6.4

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example

B01MGAINB,R1,-3

B01MGAIN1,B,>6

B01MGAINA,W,?

Description

Set gain from input B to AEC reference 1 to -

3 dB.

Status Message

B01MGAINB,R1,-3

Increase gain from input 1 to output B by 6 dB.

B01MGAIN1,B,x

where x

is the new value of the crosspoint gain. If the crosspoint gain was set to -3 dB before this command, then the status message would be

B01MGAIN1,B,3

Query gain from input A to W

Bus output.

B01MGAINA,W,x

, where x

is the current value of the crosspoint gain. If the crosspoint gain was set to -12 dB before this command, then the status message would be

B01MGAINA,W,-12

B01MGAINWB0,WM0,-3

B01MGAIN1,*,ääää{{{{èÉääÇÇÇÇÇ

Set crosspoint gain in EF Bus submatrix on crosspoint that routes the W bus signal from the device at

ID0 (WB0) to W submatrix output 0

(WM0).

B01MGAINWB0,WM0,-3

Set all crosspoint gains for input channel 1. Set the gain to outputs 1-4 to 0 dB (

), the gain to outputs A-D to -9 dB (

{

), the gain to the telephone output to 6 dB

(

), the gain to the power amplifier output to 12 dB (

), the gain to AEC reference 1 and

2 to 0 dB (

), and the gain to

B01MGAIN1,*,ääää{{{{èÉääÇÇÇÇÇ

B01MGAINB,*,-3

B01MGAINB,*,>12

B01MGAINB,*,?

8.104. MGATE

-- Select Gated or Ungated Microphone Signal in

Matrix

For each crosspoint of the microphone input channels of the main matrix, the microphone signals can be taken before the automixer (ungated) or after the automixer (gated). This command selects the gated or ungated microphone signal. If

MGATE

is set to 1 for a given crosspoint, then the signal will be gated (taken after the automixer). If

MGATE

is set to 0 for a given crosspoint, then the signal will be ungated (taken before the automixer).

This command is a matrix boolean command. See

Section 6.4

and

Section 6.1

for more information on this type of command.

Example

B01MGATE3,A,1

B01MGATE3,A,0

B01MGATE3,A,2 bus outputs P,

W, X, Y, and Z to -3 dB (

Set all crosspoint gains for input channel B to -3 dB.

B01MGAINB,*,ÇÇÇÇÇÇÇÇÇÇÇÇÇÇÇÇÇ

Increase the gain for all crosspoints of input channel B by 12 dB.

Query the gains for all crosspoints of input channel B

B01MGAINB,*,abcdefghijklmnopq

, where the value of each of letters (a, b, etc.) depends on the current state of each of the crosspoint gains. If this command was issued after the example above, then the status message would be

B01MGAINB,*,èèèèèèèèèèèèèèèèè

B01MGAINB,*,abcdefghijklmnopq

, where the value of each of letters (a, b, etc.) depends on the current state of each of the crosspoint gains. If this command was issued after the example above, then the status message would be

B01MGAINB,*,èèèèèèèèèèèèèèèèè

Description

Select the gated version of microphone input 3 to be sent to output A.

Select the ungated version of microphone input 3 to be sent to output A.

Toggle the gated status of the crosspoint that routes microphone input 3 to output

Status Message

B01MGATE3,A,1

B01MGATE3,A,0

B01MGATE3,A,x

, where x

depending on the current gated status of the crosspoint.

B01MGATE3,A,?

B01MGATE*,A,1

B01MGATE*,A,0

B01MGATE*,A,1100

B01MGATE*,A,?

Query the gated status of the crosspoint that routes microphone input 3 to output

B01MGATE3,A,x

, where x

depending on the current gated status of the crosspoint.

Select the gated version of all microphone inputs to be sent to output A.

Select the ungated version of all microphone inputs to be sent to output A.

B01MGATE*,A,1111

-- note that there are only four values returned, since only the four microphone inputs can be gated. The other inputs do not pass through the automixer.

B01MGATE*,A,0000

-- note that there are only four values returned, since only the four microphone inputs can be gated. The other inputs do not pass through the automixer.

Select the gated version of microphone inputs 1-2 to be sent to output A and the ungated version of microphone inputs 3-4 to be sent to output

B01MGATE*,A,1100

Query the gated status of all microphone inputs routed to output A.

B01MGATE*,A,abcd

, where a

are each

1 depending on the current gated status of each crosspoint.

8.105. MIC

-- Enable Microphone Gain Stage on Inputs 1-4

This command sets or queries the enabled state of the microphone gain stages on each of the microphone inputs . Enabling the gain stage adds an extra 33 dB of gain in the input signal path. See the description of

the

GAINI

command for information on how the

MIC

and

GAINI

commands relate to nominal input levels.

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01MIC21

B01MIC20

B01MIC22

B01MIC2?

B01MIC*0

Description

Enable microphone gain stage for input channel 2 .

Disable microphone gain stage for input channel 2 .

Disable microphone gain stage for input channels 1-4.

Status Message

B01MIC21

B01MIC20

Toggle microphone gain stage for input channel 2 .

Query enabled status of microphone gain stage for input channel 2 .

B01MIC2x

, where x

depending on the current enabled state of the microphone gain stage on input channel 2 .

B01MIC2x

, where x

depending on the current enabled state of the microphone gain stage on input channel 2 .

B01MIC*0000

B01MIC*1

Enable microphone gain stage for input channels 1-4.

B01MIC*1111

B01MIC*2

B01MIC*?

Toggle enabled status microphone gain stage for input channels 1-4.

Query enabled status of microphone gain stage for input channels 1-4.

B01MIC*abcd

where a

are each

1 depending on the current enabled state of the microphone gain stage for the corresponding input channel.

B01MIC*abcd

where a

are each

1 depending on the current enabled state of the microphone gain stage for the corresponding input channel.

B01MIC*1100

Enable microphone gain stages for inputs

1-2 and disable microphone gain stages for inputs 3-4.

B01MIC*1100

8.106. MINI

-- Enable Modem Initialization String

This command controls whether or not the modem initialization string is sent at power-up. If

MINI

, then the modem initialization string is not sent. If

MINI

, then the modem initialization string is sent. The text of the modem initialization string is set via the

MINISTR

command.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01MINI1

Enable modem initialization string.

B01MINI0

Disable modem initialization string.

B01MINI2

Toggle enabled state of modem initialization string.

B01MINI?

Query enabled state of modem initialization string.

Status Message

B01MINI1

B01MINI0

B01MINIx

, where x

depending on the current enabled state of the modem initialization string.

B01MINIx

, where x

depending on the current enabled state of the modem initialization string.

8.107. MINISTR

-- Set Modem Initialization String

This command is used to set or query the modem initialization string. The string can be a maximum of 32 characters long. The recommended modem initialization string for the Vortex is:

ATF1E0&B1S0=2

This can be set via the following command.

B01MINISTRATF1E0&B1S0=2

Whether or not the modem initialization string is sent at power-up is controlled via the

MINI

command.

Example

B01MINISTRATF1E0&B1S0=2

B01MINISTR?

Description Status Message

Set modem initialization string to

ATF1E0&B1S0=2

B01MINISTRATF1E0&B1S0=2

Query current modem initialization string.

B01MINISTR<string>

, where

is the current modem initialization string. If this command was sent after the above example, then the status message would be

B01MINISTRATF1E0&B1S0=2

8.108. MMUTE

-- Mute Crosspoint in Main Matrix or Submatrix

This command sets or queries the mute status of one or more crosspoints in either the main matrix or one of the EF Bus submatrices.

This command is a matrix boolean command. See

Section 6.4

and

Section 6.1

for more information on this type of command.

Example

B01MMUTEB,R1,1

B01MMUTEWB0,WM0,0

B01MMUTE1,B,2

Description Status Message

Mute signal path

(in main matrix) from input B to

AEC reference 1

B01MMUTEB,R1,1

Mute signal path

(in EF Bus W submatrix) from

W bus signal at device ID0

(WB0) to W submatrix output 0

(WM0).

B01MMUTEWB0,WM0,0

Toggle mute status of signal path (in main matrix) from input 1 to output B .

B01MMUTE1,B,x

, where x

is either

1 depending on the current mute status of the crosspoint.

B01MMUTEA,W,?

B01MMUTE1,*,11110000000000000

B01MMUTE2,*,0

Query mute status of signal path (in main matrix) from input A to W-

Bus output .

Set all crosspoint mutes for input channel 1. Mute the paths from input 1 to outputs 1-4 and unmute the paths from input 1 to outputs A-D,

R1, R2, T, L, P,

W, X, Y, and Z.

Unmute all crosspoints for input channel 2

B01MMUTEA,W,x

, where x

is either

1 depending on the current mute status of the crosspoint.

B01MMUTE1,*,11110000000000000

B01MMUTE2,*,00000000000000000

B01MMUTE2,*,2

Toggle all crosspoint mutes for input channel 2 .

B01MMUTE2,*,abcdefghijklmnopq

, where the value of each of letters (a, b, etc.) is either

0 or

depending on the current state of each of the crosspoint mutes. If this command was issued after the example above, then the status message would be

B01MMUTE2,*,00000000000000000

B01MMUTE2,*,?

Query all crosspoint mutes for input channel 2 .

B01MMUTE2,*,abcdefghijklmnopq

, where the value of each of letters (a, b, etc.) is either

0 or

depending on the current state of each of the crosspoint mutes. If this command was issued after the example above, then the status message would be

B01MMUTE2,*,00000000000000000

8.109. MUTEGIL

-- Set Mute Status of Line Inputs as a Group

This command sets the mute status of all the line inputs simultaneously. This is different from using a wildcard,

with the

MUTEI

command because that command sets all the mic and line inputs together, while

the

MUTEGIL

sets only the line inputs.

This command will generate acknowledgements from each of the line inputs separately.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example

B01MUTEGIL1

Description

Mute all line inputs.

Status Message

B01MUTEIA1

B01MUTEIB1

B01MUTEIC1

B01MUTEID1

B01MUTEGIL2

Toggle mute status of all line inputs.

B01MUTEIAa

B01MUTEIBb

B01MUTEICc

B01MUTEIDd

, where a

, b

, c

, and d

reflect the mute status (

0 or

) of each of the line inputs. If this command was issued after the example above, then the status messages would be:

B01MUTEIA0

B01MUTEIB0

B01MUTEIC0

B01MUTEID0

B01MUTEIAa

B01MUTEIBb

B01MUTEGIL?

Query the mute status of all the line inputs.

B01MUTEICc

B01MUTEIDd

, where a

, b

, c

, and d

reflect the mute status (

0 or

) of each of the line inputs. If this command was issued after the example above, then the status messages would be:

B01MUTEIA0

B01MUTEIB0

B01MUTEIC0

B01MUTEID0

8.110. MUTEGIM

-- Set Mute Status of Microphone Inputs as a

Group

This command sets the mute status of all the microphone inputs simultaneously. This is different from using a wildcard,

with the

MUTEI

command because that command sets all the mic and line inputs together,

while the

MUTEGIM

sets only the mic inputs.

This command will generate acknowledgements from each of the mic inputs separately.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description Status Message

B01MUTEGIM1

Mute all mic inputs.

B01MUTEI11

B01MUTEI21

B01MUTEI31

B01MUTEI41

B01MUTEI1a

B01MUTEI2b

B01MUTEGIM2

Toggle mute status of all mic inputs.

B01MUTEI3c

B01MUTEI4d

, where a

, b

, c

, and d

reflect the mute status (

) of each of the mic inputs. If this command was issued after the example above, then the status messages would be:

B01MUTEI10

B01MUTEI20

B01MUTEI30

B01MUTEI40

B01MUTEGIM?

Query mute status of all mic inputs.

B01MUTEI1a

B01MUTEI2b

B01MUTEI3c

B01MUTEI4d

, where a

, b

, c

, and d

reflect the mute status (

) of each of the mic inputs. If this command was issued after the example above, then the status messages would be:

B01MUTEI10

B01MUTEI20

B01MUTEI30

B01MUTEI40

8.111. MUTEI

-- Mute One or More Inputs

This command sets or queries the mute status of the analog inputs (1-4, A-D, T) .

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01MUTEI41

B01MUTEIA0

B01MUTEIT2

B01MUTEIC?

B01MUTEI*1

Description

Mute input 4 .

Unmute input A .

Status Message

B01MUTEI41

B01MUTEIA0

Toggle mute status of input

T .

Query mute status of input

C .

B01MUTEITx

, where x

is either

depending on the current mute status of the input.

B01MUTEICx

, where x

is either

depending on the current mute status of the input.

Mute all inputs (1-4, A-D, T)

B01MUTEI*111111111

B01MUTEI*0

Unmute all inputs (1-4, A-D,

T) .

B01MUTEI*000000000

B01MUTEI*111100000

B01MUTEI*2

Mute inputs 1-4 and unmute inputs T and A-D. Mute input 1 and unmute inputs

A and B.

B01MUTEI*111100000

Toggle mute status of all inputs.

B01MUTEI*abcdefghi

, where each of the letters

(a, b, etc.) is either

depending of the current status of the mute on the corresponding input. If this command was sent after the example above, then the status message would be

B01MUTEI*111100000

B01MUTEI*?

Query mute status of all inputs.

B01MUTEI*abcdefghi

where each of the letters

(a, b, etc.) is either

depending of the current status of the mute on the corresponding input. If this command was sent after the example above, then the status message would be

B01MUTEI*111100000

8.112. MUTEO

-- Mute One or More Outputs

This command sets or queries the mute status of the analog outputs (1-4, A-D, T, L) .

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01MUTEO41

B01MUTEOA0

B01MUTEOL2

B01MUTEOC?

B01MUTEO*1

Description

Mute output 4 .

Unmute output A .

Status Message

B01MUTEO41

B01MUTEOA0

Query mute status of output C .

B01MUTEOTx

, where x

is either

depending on the current mute status of the output.

B01MUTEOCx

, where x

is either

depending on the current mute status of the output.

Mute all outputs (1-4, A-D,

T, L) .

B01MUTEO*1111111111

B01MUTEO*0

B01MUTEO*1111000010

Unmute all outputs (1-4, A-

D, T, L) .

B01MUTEO*0000000000

Mute outputs 1-4 and T, and unmute outputs A-D and L.

B01MUTEO*1111000010

B01MUTEO*2

B01MUTEO*?

Toggle mute status of all outputs.

Query mute status of all outputs.

B01MUTEO*abcdefghij

where each of the letters

(a, b, etc.) is either

depending of the current status of the mute on the corresponding output. If this command was sent after the example above, then the status message would be

B01MUTEO*0000111101

B01MUTEO*abcdefghij

, where each of the letters

(a, b, etc.) is either

depending of the current status of the mute on the corresponding output. If this command was sent after the example above, then the status message would be

B01MUTEO*0000111101

8.113. NC

-- Enable Noise Cancellation

This command sets or queries the status of the Noise Cancellation (NC) algorithm on input channels 1-4 and

T .

When the wildcard character, '

', is used to specify the channel in this command, it only affects input channels 1-4 . To set or query the telephone input channel, T, you must specify it explicitly (e.g., '

B01NCT1

'' '', '

B01NCT?

' '' '').

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example Description

B01NC31

Enable NC on input channel 3 .

B01NCT0

Disable NC on input channel T.

Status Message

B01NC31

B01NC12

B01NCT?

Toggle NC state on input channel 1 .

Query NC state on input channel 1 .

B01NCT0

B01NC1x

, where x

depending on the current state of NC on input channel 1 .

B01NCTx

, where x

depending on the current state of NC on the input channel.

B01NC*1111 B01NC*1

Enable NC on input channels 1-4 and T .

B01NC*0

Disable NC on all microphone input channels

(1-4) .

B01NC*0000

B01NC*2

B01NC*?

Toggle NC state on all microphone input channels (1-4) .

Query NC state on all microphone input channels (1-4) .

B01NC*abcd

, where the letters ( a

, b

, etc.) are each

depending on the current state of NC for each of the corresponding input.

B01NC*abcd

, where the letters ( a

, b

, etc.) are each

depending on the current state of NC for each of the corresponding input.

8.114. NCL

-- Set Noise Cancellation Attenuation

This command sets or queries the attenuation level of the Noise Cancellation algorithm on input channels 1-4 and T . For example, if

NCL

is set to

, then the Noise Cancellation for that channel will cancel 10 dB of noise. Higher numbers mean more cancellation will be applied, but may result in slight artifacts depending on the characteristics of the noise. Typical settings are 10 dB for normal cancellation and 6 dB for light cancellation.

When the wildcard character, '

', is used to specify the channel in this command, it only affects input channels 1-4 . To set or query the telephone input channel, T, you must specify it explicitly (e.g.,

B01NCLT6

' '' '', '

B01NCLT?

' '' '').

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 0 and 20, respectively.

Example

B01NCL13

B01NCLT?

Description

Set NC attenuation level on input channel

1 to 3 dB.

Status Message

B01NCL13

Query the NC attenuation level on input channel 1 .

B01NCLTx

, where x

is a number between 0 and 20, depending on the current setting of the

NC attenuation level on input channel 1 .

B01NCL*6

B01NCL*ääìì

B01NCL*?

Set NC attenuation level on all microphone input channels (1-4) to 6 dB.

Set NC attenuation level on input channels 1-2 to 0 dB and NC attenuation level on input channels 3-4 to 9 dB.

Query NC attenuation level on all microphone input channels (1-4) .

B01NCL*èèèè

B01NCL*ääìì

8.115. NVINIT

-- Reinitialize Non-Volatile Memory

This command reinitializes (or formats) all non-volatile memory settings. This will effectively erase settings for global settings, user presets, macros, labels, and logic I/O configurations. This will basically reset the unit to a "fresh-out-of-the-box" state.

When this command is issued, it writes to non-volatile memory in order to format the contents back to the factory default state. The writing process results in a short delay. After the non-volatile memory has been reformatted, the Vortex will perform a software reset, which is equivalent to a power cycle.

Example Description

B01NVINIT

Reinitialize non-volatile memory and perform a software reset.

Status Message

No status message will be generated.

There will be a short delay and then the

Vortex will reset.

8.116. NVLOCK

-- Lock/Unlock Non-Volatile Memory

This command controls the non-volatile memory lock feature. When

NVLOCK

is enabled, the user may not save any system settings to non-volatile memory. This includes global parameters, presets, macros, labels, and logic assignments. The lock applies whether the user tries to make the changes via RS-232, front panel, logic inputs, or any other method. The user will still be able to query all the features of the device, but will get an error message if an attempt is made to change them. When

NVLOCK

is disabled, the user has full access to the system settings.

Usage of this command is similar to other boolean commands (see

Section 6.1

) except that when disabling

this feature, the password must be supplied for the command to work. If an incorrect password is supplied,

ERROR#005

' will be generated. The examples below illustrate the correct usage. The examples assume that the password has been set to ' aspi

' (the default). The

NVLOCK

password can be changed via the

NVPSWD

command.

Example

B01NVLOCK1

Description

Lock the non-volatile memory to prevent users from changing the settings.

Status Message

B01NVLOCK1

B01NVLOCK0,yumyum

B01NVLOCK0,aspi

B01NVLOCK?

Attempt to unlock the non-volatile memory by using an invalid password.

Query the locked status of the nonvolatile memory.

B01ERROR#005

-- since an invalid password was given, an error message was generated.

If error messages have been disabled (via the

ERROR

command), then no status message

will be generated.

Unlock the non-volatile memory by using the correct password.

B01NVLOCK0

B01NVLOCKx

, where x

depending on whether the non-volatile memory is unlocked or locked, respectively.

8.117. NVPSWD

-- Change Non-Volatile Memory Password

This command sets or queries the non-volatile memory password. This password is used in conjunction with

the

NVLOCK

command. The non-volatile memory must be unlocked ('

NVLOCK0

') in order to use this command to set or query the non-volatile memory password. If the non-volatile memory is locked, then this command will result in '

ERROR#004

'. The examples below assume that the non-volatile memory is unlocked.

Example

B01NVPSWDlemur

B01NVPSWD?

Description

Set non-volatile memory password to ' lemur

Query the current non-volatile memory password.

Status Message

B01NVPSWDlemur

8.118. PEQIA

-- Set All Parameters for Specified Parametric EQ

Input Stage

This command sets or queries all of the parameters for the parametric equalizer (EQ) filters on input channels 1-4, A-D, and T . Each channel has five bands of parametric EQ that can be independently controlled.

The input parametric EQ filter parameters can be set individually via the

commands. The output parametric EQ filter parameters can be set simultaneously via the

PEQOA

command or individually with the

, and

commands.

When using this command, you must specify all of the following parameters.

Description Value Range

Channel

Band

Filter Type

1-4, A-D, T

1-5

Frequency 20 - 20000

Bandwidth 5 - 200

Gain

Slope

Enable

-20 - 20

1 - 1.2 * Gain for shelving filters, 12 or 24 for Linkwitz-Riley filters

0 - 1

Units

N/A

1 = parametric filter

2 = low shelf

3 = high shelf

4 = lowpass

5 = highpass

6 = Linkwitz-Riley lowpass

7 = Linkwitz-Riley highpass

1/100th octave dB dB per octave

0 = filter disabled

1 = filter enabled

The paramters are specified in the order shown and are separated by commas. The wildcard character,

, may not be used for any of the parameters listed above. If an attempt is made to set one of the parameters outside the valid range, the command will fail and return an error message of

ERROR#002

Not all of the parameters are valid for each of the filter types. The following table shows which parameters are used in each of the filter types.

Filter Type

Parametric (1)

Low Shelf (2)

High Shelf (3)

Lowpass (4)

Highpass (5)

Linkwitz-Riley Lowpass (6)

Linkwitz-Riley Highpass (7)

Bandwidth

Yes

Frequency

Yes

Gain

Yes

Slope

Yes

provided mainly as guidelines for programmers writing control software for the Vortex. If a parameter is not valid for a specific filter type, then the control for editing that parameter should be disabled or removed when that filter type is selected.

Example

B01PEQIA3,2,1,1250,40,-20,1,1

B01PEQIAB,1,?

Description

Query the current parameter settings for the parametric eq filter on input B

, band 1.

Status Message

Set the parametric

EQ on input 3 , band 2 to the following parameters: type = parametric filter, frequency = 1250

Hz, bandwidth =

40 1/100th octaves, gain = -20 dB, enabled = yes, slope = 1 dB per octave. The value of the slope parameter is irrelevant for this type of filter, we could have set it to anything.

B01PEQIA3,2,1,1250,40,-20,1,1

B01PEQIAB,1,t,f,b,g,s,e

, where the parameters t

, f

, b

, g

, s

, and e

correspond to the current settings of the type, frequency, bandwidth, gain, slope, and enabled parameters, respectively. If this filter was set to the same parameters as given in the above example, the status message would be

B01PEQIAB,1,1,1250,40,-20,1,1

8.119. PEQIB

-- Set Bandwidth Parameter for Specified

Parametric EQ Input Stage

This command sets or queries the bandwidth parameter (in 1/100th octaves) for the parametric equalizer

(EQ) filters on input channels 1-4, A-D, and T . Each channel has five bands of parametric EQ that can be independently controlled.

The minimum and maximum values for the bandwidth parameter are 5 and 200, respectively.

This command has the same format and restrictions as the

PEQIA

command except that only one

parameter, the bandwidth, is specified instead of all the parameters. See the

PEQIA

command for more information. To set the bandwidth parameter for an output parametric EQ filter, use the

PEQOB

command.

To set all the parameters for an output parametric EQ filter, use the

PEQOA

command.

Example

B01PEQIB3,2,40

B01PEQIBB,1,?

Description Status Message

Set bandwidth of parametric EQ on input 3 , band 2 to 40 1/100th octaves.

B01PEQIB3,2,40

Query current bandwidth setting of parametric EQ on input B , band 1.

B01PEQIBB,1,b

, where b

is the current setting of the bandwidth parameter for the parametric EQ on input B , band 1. If the bandwidth parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQIBB,1,40

8.120. PEQIE

-- Set Enabled Parameter for Specified

Parametric EQ Input Stage

This command sets or queries the enabled parameter (0 = filter is disabled, 1 = filter is enabled) for the parametric equalizer (EQ) filters on input channels 1-4, A-D, and T . Each channel has five bands of parametric EQ that can be independently controlled.

This command has the same format and restrictions as the

PEQIA

command except that only one parameter, the enabled status, is specified instead of all the parameters. See the

PEQIA

command for more

information. To set the enabled parameter for an output parametric EQ filter, use the

PEQOE

command. To set all the parameters for an output parametric EQ filter, use the

PEQOA

command.

Example

B01PEQIE3,2,1

Description

Enable parametric EQ on input 3 , band 2.

Status Message

B01PEQIE3,2,1

B01PEQIEB,1,?

Query enabled status of parametric

EQ on input B , band 1.

B01PEQIEB,1,e

, where e

is the current setting of the enabled parameter for the parametric EQ on input B , band 1. If the enabled parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQIEB,1,1

8.121. PEQIF

-- Set Frequency Parameter for Specified

Parametric EQ Input Stage

This command sets or queries the frequency parameter (in Hz) for the parametric equalizer (EQ) filters on input channels 1-4, A-D, and T . Each channel has five bands of parametric EQ that can be independently controlled.

The minimum and maximum values for the frequency parameter are 20 and 20000, respectively.

For filter types that have a center frequency (e.g., parametric), this parameter specifies the center frequency. For filter types that have a cutoff frequency (e.g, highpass, lowpass, etc.), this parameter specifies the cutoff frequency.

This command has the same format and restrictions as the

PEQIA

command except that only one

parameter, the frequency, is specified instead of all the parameters. See the

PEQIA

command for more information. To set the frequency parameter for an output parametric EQ filter, use the

PEQOF

command. To set all the parameters for an output parametric EQ filter, use the

PEQOA

command.

Example

B01PEQIF3,2,1250

B01PEQIFB,1,?

Description Status Message

Set frequency of parametric EQ on input 3 , band 2 to 1250 Hz.

B01PEQIF3,2,1250

Query current frequency setting of parametric EQ on input B , band 1.

B01PEQIFB,1,f

, where f

is the current setting of the frequency parameter for the parametric EQ on input B , band 1. If the frequency parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQIFB,1,1250

8.122. PEQIG

-- Set Gain Parameter for Specified Parametric

EQ Input Stage

This command sets or queries the gain parameter (in dB) for the parametric equalizer (EQ) filters on input channels 1-4, A-D, and T . Each channel has five bands of parametric EQ that can be independently controlled.

The minimum and maximum values for the gain parameter are -20 and 20, respectively.

This command has the same format and restrictions as the

PEQIA

command except that only one

parameter, the gain, is specified instead of all the parameters. See the

PEQIA

command for more information. To set the gain parameter for an output parametric EQ filter, use the

PEQOG

command. To set all the parameters for an output parametric EQ filter, use the

PEQOA

command.

Example

B01PEQIG3,2,-20

Description

Set the gain of the parametric EQ on input 3 , band 2 to -20 dB.

Status Message

B01PEQIG3,2,-20

B01PEQIGB,1,?

Query current gain setting of parametric EQ on input B , band 1.

B01PEQIGB,1,g

, where g

is the current setting of the gain parameter for the parametric

EQ on input B , band 1. If the gain parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQIGB,1,-20

8.123. PEQIS

-- Set Slope Parameter for Specified Parametric

EQ Input Stage

This command sets or queries the slope parameter (in dB per octave) for the parametric equalizer (EQ) filters on input channels 1-4, A-D, and T . Each channel has five bands of parametric EQ that can be independently controlled.

For the Linkwitz-Riley filters, the slope can either be 12 or 24 (dB/Octave).For the low shelf and high shelf filters, the minimum value for the slope parameter is 1, and the maximum value is 1.2 times the current value of the gain parameter. See the

PEQIG

command for information on the gain parameter.

This command has the same format and restrictions as the

PEQIA

command except that only one

parameter, the slope, is specified instead of all the parameters. See the

PEQIA

command for more information. To set the slope parameter for an output parametric EQ filter, use the

PEQOS

command. To set all the parameters for an output parametric EQ filter, use the

PEQOA

command.

Example

B01PEQIS3,2,1

Description

Set the slope of the parametric EQ on input 3 , band 2 to 1 dB per octave.

Status Message

B01PEQIS3,2,1

B01PEQISB,1,?

Query current slope setting of parametric EQ on input B , band 1.

B01PEQISB,1,s

, where s

is the current setting of the slope parameter for the parametric EQ on input B , band 1. If the slope parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQISB,1,1

8.124. PEQIT

-- Set Type Parameter for Specified Parametric

EQ Input Stage

The type parameter specifies what type of filter is executed for the specified band of the specified input channel. The different filter types and their corresponding values are shown in the table below.

Filter Type

Parametric

Low Shelf

Value of Type Parameter

High Shelf

Lowpass

Highpass

Linkwitz-Riley Lowpass

Linkwitz-Riley Highpass

This command has the same format and restrictions as the

PEQIA

command except that only one parameter, the filter type, is specified instead of all the parameters. See the

PEQIA

command for more

information. To set the slope parameter for an output parametric EQ filter, use the

PEQOT

command. To set all the parameters for an output parametric EQ filter, use the

PEQOA

command.

Example

B01PEQIT3,2,1

B01PEQITB,1,?

Description

Set the type of the parametric EQ on input 3 , band 2 to parametric.

Status Message

B01PEQIT3,2,1

Query current type setting of parametric EQ on input B , band 1.

B01PEQITB,1,t

, where t

is the current setting of the type parameter for the parametric EQ on input B , band 1. If the type parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQITB,1,1

8.125. PEQOA

-- Set All Parameters for Specified Parametric EQ

Output Stage

This command sets or queries all of the parameters for the parametric equalizer (EQ) filters on output channels 1-4, A-D, T, and L . Each channel has five bands of parametric EQ that can be independently controlled.

The output parametric EQ filter parameters can be set individually via the

commands. The input parametric EQ filter parameters can be set simultaneously via the

PEQIA

command or individually with the

, and

commands.

When using this command, you must specify all of the following parameters.

Description Value Range

Channel 1-4, A-D, T, L

Band 1-5

Units

N/A

Filter Type

Frequency

1-5

Bandwidth 5 - 200

Gain

Slope

Enable

20 - 20000

-20 - 20

1 - 1.2 * Gain for shelving filters, 12 or 24 for Linkwitz-Riley filters

0 - 1

1 = parametric filter

2 = low shelf

3 = high shelf

4 = lowpass

5 = highpass

6 = Linkwitz-Riley lowpass

7 = Linkwitz-Riley highpass

1/100th octave dB dB per octave

0 = filter disabled

1 = filter enabled

The paramters are specified in the order shown and are separated by commas. The wildcard character,

, may not be used for any of the parameters listed above. If an attempt is made to set one of the parameters outside the valid range, the command will fail and return an error message of

ERROR#002

Not all of the parameters are valid for each of the filter types. The following table shows which parameters are used in each of the filter types.

Filter Type

Parametric (1)

Low Shelf (2)

High Shelf (3)

Lowpass (4)

Highpass (5)

Linkwitz-Riley Lowpass (6)

Linkwitz-Riley Highpass (7)

Bandwidth

Yes

Frequency

Yes

When a parameter is invalid for a given filter type, the parametric EQ commands will still set that parameter, however its value will not be used for filter computations. This valid/invalid parameter information above is provided mainly as guidelines for programmers writing control software for the Vortex. If a parameter is not valid for a specific filter type, then the control for editing that parameter should be disabled or removed when that filter type is selected.

Example Description Status Message

Gain

Yes

Slope

Yes

B01PEQOA3,2,1,1250,40,-20,1,1

B01PEQOAB,1,?

Set the parametric

EQ on output 3 , band 2 to the following parameters: type = parametric filter, frequency = 1250

Hz, bandwidth =

40 1/100th octaves, gain = -20 dB, enabled = yes, slope = 1 dB per octave. The value of the slope parameter is irrelevant for this type of filter, we could have set it to anything.

B01PEQOA3,2,1,1250,40,-20,1,1

Query the current parameter settings for the parametric eq filter on output

B , band 1.

B01PEQOAB,1,t,f,b,g,s,e

, where the parameters t

, f

, b

, g

, s

, and e

B01PEQOAB,1,1,1250,40,-20,1,1

8.126. PEQOB

-- Set Bandwidth Parameter for Specified

Parametric EQ Output Stage

This command sets or queries the bandwidth parameter (in 1/100th octaves) for the parametric equalizer

(EQ) filters on output channels 1-4, A-D, T, and L . Each channel has five bands of parametric EQ that can be independently controlled.

The minimum and maximum values for the bandwidth parameter are 5 and 200, respectively.

This command has the same format and restrictions as the

PEQOA

command except that only one

parameter, the bandwidth, is specified instead of all the parameters. See the

PEQOA

command for more information. To set the bandwidth parameter for an input parametric EQ filter, use the

PEQIB

command. To

set all the parameters for an input parametric EQ filter, use the

PEQIA

command.

Example

B01PEQOB3,2,40

Description Status Message

Set bandwidth of parametric EQ on output 3 , band 2 to 40 1/100th octaves.

B01PEQOB3,2,40

B01PEQOBB,1,?

Query current bandwidth setting of parametric EQ on output B , band

B01PEQOBB,1,b

, where b

is the current setting of the bandwidth parameter for the parametric EQ on output B , band 1. If the bandwidth parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQOBB,1,40

8.127. PEQOE

-- Set Enabled Parameter for Specified

Parametric EQ Output Stage

This command sets or queries the enabled parameter (0 = filter is disabled, 1 = filter is enabled) for the parametric equalizer (EQ) filters on output channels 1-4, A-D, T, and L . Each channel has five bands of parametric EQ that can be independently controlled.

This command has the same format and restrictions as the

PEQOA

command except that only one parameter, the enabled status, is specified instead of all the parameters. See the

PEQOA

command for more

information. To set the enabled parameter for an input parametric EQ filter, use the

PEQIE

command. To set

all the parameters for an intput parametric EQ filter, use the

PEQIA

command.

Example

B01PEQOE3,2,1

Description

Enable parametric EQ on output 3 , band 2.

Status Message

B01PEQOE3,2,1

B01PEQOEB,1,?

Query enabled status of parametric

EQ on output B , band 1.

B01PEQOEB,1,e

, where e

is the current setting of the enabled parameter for the parametric EQ on output B , band 1. If the enabled parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQOEB,1,1

8.128. PEQOF

-- Set Frequency Parameter for Specified

Parametric EQ Output Stage

This command sets or queries the frequency parameter (in Hz) for the parametric equalizer (EQ) filters on output channels 1-4, A-D, T, and L . Each channel has five bands of parametric EQ that can be independently controlled.

The minimum and maximum values for the frequency parameter are 20 and 20000, respectively.

This command has the same format and restrictions as the

PEQOA

command except that only one

parameter, the frequency, is specified instead of all the parameters. See the

PEQOA

command for more

information. To set the frequency parameter for an input parametric EQ filter, use the

PEQIF

command. To

set all the parameters for an input parametric EQ filter, use the

PEQIA

command.

Example

B01PEQOF3,2,1250

B01PEQOFB,1,?

Description Status Message

Set frequency of parametric EQ on output 3 , band 2 to 1250

Hz.

B01PEQOF3,2,1250

Query current frequency setting of parametric EQ on output B , band 1.

B01PEQOFB,1,f

, where f

is the current setting of the frequency parameter for the parametric EQ on output B , band 1. If the frequency parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQOFB,1,1250

8.129. PEQOG

-- Set Gain Parameter for Specified Parametric

EQ Output Stage

This command sets or queries the gain parameter (in dB) for the parametric equalizer (EQ) filters on output channels 1-4, A-D, T, and L . Each channel has five bands of parametric EQ that can be independently controlled.

The minimum and maximum values for the gain parameter are -20 and 20, respectively.

This command has the same format and restrictions as the

PEQOA

command except that only one

parameter, the gain, is specified instead of all the parameters. See the

PEQOA

command for more information. To set the gain parameter for an input parametric EQ filter, use the

PEQIG

command. To set all the parameters for an input parametric EQ filter, use the

PEQIA

command.

Example

B01PEQOG3,2,-20

B01PEQOGB,1,?

Description Status Message

Set the gain of the parametric EQ on output 3 , band 2 to -20 dB.

B01PEQOG3,2,-20

Query current gain setting of parametric EQ on output B , band 1.

B01PEQOGB,1,g

, where g

is the current setting of the gain parameter for the parametric

EQ on output B , band 1. If the gain parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQOGB,1,-20

8.130. PEQOS

-- Set Slope Parameter for Specified Parametric

EQ Output Stage

This command sets or queries the slope parameter (in dB per octave) for the parametric equalizer (EQ) filters on output channels 1-4, A-D, T and L . Each channel has five bands of parametric EQ that can be independently controlled.

PEQIG

command for information on the gain parameter.

This command has the same format and restrictions as the

PEQOA

command except that only one

parameter, the slope, is specified instead of all the parameters. See the

PEQOA

command for more

information. To set the slope parameter for an input parametric EQ filter, use the

PEQIS

command. To set

all the parameters for an input parametric EQ filter, use the

PEQIA

command.

Example

B01PEQOS3,2,1

Description

Set the slope of the parametric EQ on output 3 , band 2 to 1 dB per octave.

Status Message

B01PEQOS3,2,1

B01PEQOSB,1,?

Query current slope setting of parametric EQ on output B , band 1.

B01PEQOSB,1,s

, where s

is the current setting of the slope parameter for the parametric EQ on output B , band 1. If the slope parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQOSB,1,1

8.131. PEQOT

-- Set Type Parameter for Specified Parametric

EQ Output Stage

This command sets or queries the type parameter for the parametric equalizer (EQ) filters on output channels 1-4, A-D, T, and L . Each channel has five bands of parametric EQ that can be independently controlled.

The type parameter specifies what type of filter is executed for the specified band of the specified output channel. The different filter types and their corresponding values are shown in the table below.

Filter Type

Parametric

Low Shelf

High Shelf

Lowpass

Highpass

Linkwitz-Riley Lowpass

Linkwitz-Riley Highpass

Value of Type Parameter

This command has the same format and restrictions as the

PEQOA

command except that only one parameter, the filter type, is specified instead of all the parameters. See the

PEQOA

command for more

information. To set the slope parameter for an input parametric EQ filter, use the

PEQIT

command. To set

all the parameters for an input parametric EQ filter, use the

PEQIA

command.

Example

B01PEQOT3,2,1

B01PEQOTB,1,?

Description

Query current type setting of parametric EQ on output B , band 1.

Status Message

Set the type of the parametric EQ on output 3 , band 2 to parametric.

B01PEQOT3,2,1

B01PEQOTB,1,t

, where t

is the current setting of the type parameter for the parametric EQ on output B , band 1. If the type parameter of this filter is set to the same value given in the example above, then the status message will be

B01PEQOTB,1,1

8.132. PHANTOM

-- Enable Phantom Power on Inputs 1-4

This command sets or queries the status of phantom power on each of the microphone inputs.

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01PHANTOM21

B01PHANTOM20

B01PHANTOM22

B01PHANTOM2?

B01PHANTOM*0

B01PHANTOM*1

B01PHANTOM*2

Description Status Message

Enable phantom power for input channel 2 .

Disable phantom power for input channel 2 .

B01PHANTOM21

B01PHANTOM20

Toggle phantom power state for input channel 2 .

Query state of phantom power for input channel 2 .

B01PHANTOM2x

, where x

depending on the current state of phantom power on input channel 2 .

B01PHANTOM2x

, where x

depending on the current state of phantom power on input channel 2 .

Disable phantom power for input channels 1-4.

B01PHANTOM*0000

Enable phantom power for input channels 1-4.

B01PHANTOM*1111

Toggle phantom power for input channels 1-4.

B01PHANTOM*abcd

where a

are each

1 depending on the current state of phantom power for the corresponding input channel.

B01PHANTOM*?

B01PHANTOM*1100

Query status of phantom power for input channels 1-4.

B01PHANTOM*abcd

where a

are each

1 depending on the current state of phantom power for the corresponding input channel.

Enable phantom power for inputs

1-2 and disable phantom power for inputs 3-4.

B01PHANTOM*1100

8.133. PHONE

-- Take Phone On-Hook or Off-Hook

This command sets or queries the on-hook status of the phone interface.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01PHONE0

B01PHONE1

Put phone interface on-hook (hang up phone interface).

Take phone interface off-hook (pick up phone interface).

B01PHONE2

Toggle hook status of phone interface. If the phone was off-hook, then this command puts it on-hook. If the phone was on-hook, then this command takes it off-hook.

Status Message

B01PHONE0

B01PHONE1

B01PHONEx

, where x

is either

1 depending on the current hook status of the phone interface.

B01PHONE?

Query the hook status of phone interface.

B01PHONEx

, where x

is either

1 depending on the current hook status of the phone interface.

8.134. PING

-- See Which Devices Are Present

When any Vortex device receives this command, it responds with a

PONG

status message. This is typically used by the host program to determine the types and IDs of all linked devices. When used in this manner, wildcard characters are usually given for the device type and ID so that all connected devices will respond.

In the following example, it is assumed that there are two EF2280's (device IDs 0 and 1), two EF2241's

(device IDs 2 and 3), two EF2211's (device IDs 4 and 5), two EF2210's (device ID's 6 and 7), and two

EF2201's (device ID's 0 and 1) linked together via EF Bus.

Example Description Status Message

***PING

Ping all connected device to determine the number, type, and ID of the connected devices.

F00PONG

F01PONG

B02PONG

B03PONG

S04PONG

S05PONG

Q06PONG

Q07PONG

T00PONG

T01PONG

8.135. PRESETK

-- Delete One or All Presets

This command kills (deletes) the specified preset. If a wildcard character (

) is used to specify the preset, then all presets are deleted.

If an attempt is made to delete one of the factory presets (in the range 0-15), the

PRESETK

command will fail and generate an

ERROR#071

. This is because the factory presets are read-only, thus the cannot be changed or deleted.

Example

B01PRESETK18

B01PRESETK*

Description

Delete preset number 18.

Delete all presets.

Status Message

B01PRESETK18

B01PRESETK*

8.136. PRESETL

-- List All Commmands in a Preset

This command lists all the commands in a given preset. For example, assume that user preset 18 has been defined previously by the following command.

B01PRESETW18

Now, issuing the command:

B01PRESETL18?

Will result in a long sequence of status mesages reflecting all the data stored in the preset. At the end of the status messages, a final message of

B01PRESETL18 will be displayed.

8.137. PRESETP

-- Set Which Preset Will Be Activated At Power-

Up

This command sets or queries the power-up preset, which is executed each time the device powers up. The power-up preset must be one of the factory presets (0-15) or one of the user presets (16-47).

Example

B01PRESETP16

Description

Set the power-up preset to be user preset 16.

B01PRESETP?

Query the current power-up preset.

Status Message

B01PRESETP16

B01PRESETPx

, where x

is between

and

47 depending on which preset is currently set to be the power-on preset.

8.138. PRESETQ

-- Execute a Preset Quietly

This command executes the preset corresponding to the specified number, which must be between 0 and 47.

The preset must either be a pre-defined factory preset (0 - 15) or a user preset (16 - 47) that has been previously defined via the

PRESETW

command. If the specified preset is empty, then an error condition of

ERROR#070

will be returned. If one or more of the commands in the preset generated errors, then an error condition of

ERROR#072

will be returned.

When the

PRESETQ

command executes, status messages for all of the commands in the preset will not be generated. The

PRESETQ

command is provided so that a control system can execute a preset and not generated heavy data traffic from the resulting status messages. Of course, this assumes that the control

system is not interested in any of the acknowledgements. The

PRESETX

command can be used to execute

the preset without suppressing the status messages.

Example Description Status Message

B01PRESETQ18

Execute preset number 18 without generating any status messages.

B01PRESETQ18

8.139. PRESETW

-- Save a Preset

This command writes the current settings of the device into the user preset with the specified number. Since the factory presets (0 - 15) are read-only, an

ERROR#071

will be generated if they are specified in the

PRESETW

command.

Once a preset it saved, it can be recalled via the

PRESETX

and

PRESETQ

commands. The preset can also be

set to be executed automatically at power-up via the

PRESETP

command.

memory, there will be a delay before an acknowledgment is returned.

Example

B01PRESETW18

Description

Save the current device settings as preset 18.

Status Message

B01PRESETW18

8.140. PRESETX

-- Execute a Preset

This command executes the preset corresponding to the specified number, which must be between 0 and 47.

The preset must either be a pre-defined factory preset (0 - 15) or a user preset (16 - 47) that has been previously defined via the

PRESETW

command. If the specified preset is empty, then an error condition of

ERROR#070

will be returned. If one or more of the commands in the preset generated errors, then an error condition of

ERROR#072

will be returned.

When the

PRESETX

command executes, status messages for all of the commands in the preset will be generated (unless

acknowledgement mode is turned off). The status messages can be suppressed by using

the

PRESETQ

command, which is exactly the same as the

PRESETX

command except that status messages are suppressed.

Example Description Status Message

B01PRESETX18

Execute preset number 18.

Status messages for all the commands in the preset will be generated first, followed by the message:

B01PRESETX18

8.141. REDIAL

-- Redial the Last Dialed Phone Number

Executing this command causes the Vortex to redial the last number. The last number is defined as all the

digits that were dialed since the phone was last taken off-hook. Like the

DIAL

command, if the phone is not

already off-hook, this command will take it off-hook automatically.

Example

B01REDIAL

Description

Redial the last dialed phone number.

Status Message

B01REDIAL

8.142. REFASGN

-- Assign AEC Reference to Input Channel

This command assigns an AEC reference signal (R1, R2, or EF Bus) to an input channel. Only inputs 1-4 have echo cancellation, so the command is only valid for those channels. Assigning

to an input channel selects

AEC Reference 1 (R1). Assigning

to an input channel selects AEC Reference 2 (R2). Assigning

to an input channel selects the EF Bus Reference. The EF Bus reference is an AEC reference that is placed on the EF Bus

by one (and only one) of the linked Vortexes. See the

BUSREF

command for more information about the EF

Bus reference.

Although this command is a channel integer command, the increment and decrement operators (

and

) are not supported for this particular command.

This command is a channel integer command. See

Section 6.3

and Section 6.2

for more information on this

type of command. The minimum and maximum values for this command are 1 and 3, respectively.

Example

B01REFASGN31

Description

Configure the AEC on input channel 3 to use AEC Reference 1

(R1).

Status Message

B01REFASGN31

B01REFASGN2?

Query which AEC reference is currently being used for the AEC on input channel 2 .

B01REFASGN2x

, where x

is either

, or

3 depending on which AEC reference is currently being used.

B01REFASGN*3

Configure the AEC on all input channels (1-4) to use the EF Bus reference.

B01REFASGN*çççç

B01REFASGN*?

Query which AEC reference is currently being used for the AEC on each of the input channels.

B01REFASGN*abcd

, where a

are each either

, or ccedil;

depending on which AEC reference is currently being used on each of the input channels.

8.143. REFGAIN

-- Set Reference Output Gain

This command sets the effective output gain of the corresponding AEC reference. When doing volume control of room speakers, it is a good idea to adjust this reference gain along with the speaker output gain so that the AEC is aware of any volume changes. This will help prevent short echoes when volume changes are made.

There are two AEC references on the EF2280, EF2241, and EF2241, so there are two separate commands,

REFGAINR1

and

REFGAINR2

, for controlling the effective output gain of R1 and R2, respectively.

There is only one AEC reference on the EF2211 and EF2210, so there is only one command,

REFGAINR1

for controlling the effective output gain of R1.

This command was introduced in firmware version 2.5.0.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example

B01REFGAINR16

B01GAINP>3

Description

Set effective output gain of AEC reference 1 (R1) to 6 dB.

Status Message

B01REFGAINR16

Increase phone output gain by 3 dB.

B01GAINPx

, where x

is the new value of the phone output gain. If this command was issued after the example above, then the status message would be

B01GAINP9

B01GAINP?

Query phone output gain.

B01GAINPx

, where x

is the new value of the phone output gain. If this command was issued after the example above, then the status message would be

B01GAINP9

8.144. RING

-- Enable or Disable Ring Messages

This command sets or queries the enabled status of the ring message feature. If ring messages are enabled, a

RING

status message will be generated each time the connected phone line rings.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description Status Message

B01RING1

Enable auto answer mode.

B01RING1

B01RING0

Disable auto answer mode.

B01RING0

B01RING2

Toggle auto answer mode.

B01RINGx

, where x

depending on the current state of auto answer mode.

B01RING?

Query auto answer mode.

B01RINGx

, where x

depending on the current state of auto answer mode.

8.145. SGGAIN

-- Set Gain of Signal Generator

This command sets the gain of the internal signal generator. The value of

SGGAIN

specifies the gain in dB applied to signal generator. A gain of 0 dB produces a signal at nominal level (-20 dB full scale).

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are -100 and 20, respectively.

Example Description

B01SGGAIN6

Set signal generator gain to 6 dB.

Status Message

B01SGGAIN6

B01SGGAIN>3

Increase signal generator gain by 3 dB.

B01SGGAINx

, where x

is the new value of the signal generator gain. If this command was issued after the example above, then the status message would be

B01SGGAIN9

B01SGGAIN?

Query signal generator gain.

B01SGGAINx

, where x

is the new value of the signal generator gain. If this command was issued after the example above, then the status message would be

B01SGGAIN9

8.146. SGMUTE

-- Mute Signal Generator

This command controls the muting of the signal generator.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01SGMUTE1

Mute signal generator.

B01SGMUTE?

Query signal generator mute.

Status Message

B01SGMUTE1

B01SGMUTE0

Unmute signal generator.

B01SGMUTE0

B01SGMUTE2

Toggle mute on signal generator.

B01SGMUTEx

, where x

depending on the current state of the signal generator mute.

B01SGMUTEx

, where x

depending on the current state of the signal generator mute.

8.147. SGTYPE

-- Set Type of Signal Produced by Signal

Generator

This command sets the type of signal produced by the internal signal generator. Setting the type to

0 produces white noise, while setting the type to

produces pink noise.

Example

B01SGTYPE0

B01SGTYPE1

Description

Configure signal generator to produce white noise.

Configure signal generator to produce pink noise.

Status Message

B01SGTYPE0

B01SGTYPE1

B01SGTYPE?

Query current signal generator type.

B01SGTYPEx

, where x

is either

1 depending on whether the signal generator is currently configured to generate white or pink noise, respectively.

8.148. SOUNDL

-- Play Sound Locally

This command can be used to play sounds from the telephone interface to serve as audio cues. The

SOUNDP

command plays sounds out to the phone output. The

SOUNDL

command plays sounds through the input from the telephone interface (so they will be heard locally). The same sound generator is also used for playing entry and exit tones for the auto answer and auto hangup features.

This command takes a single argument that indicates the sound to be played. The following table lists the sound numbers and a description of the generated sound.

Sound Number

Sound Description ascending thirds descending thirds ascending chorus descending chorus ascending doorbell descending doorbell quick double buzz long single buzz

The

SOUNDL

and

SOUNDP

were originally implemented to allow users to implement custom passcode

systems that require users calling in via phone to enter a passcode before entering the conference. The sound commands could be used to provide feedback to the caller as well as the conference.

Example Description

B01SOUNDL0

Play "ascending thirds" sound (same as entry tone) locally.

Status Message

B01SOUNDL0

8.149. SOUNDP

-- Play Sound to Phone

This command can be used to play sounds from the telephone interface to serve as audio cues. The

SOUNDP command plays sounds out to the phone output. The

SOUNDL

This command takes a single argument that indicates the sound to be played. The following table lists the sound numbers and a description of the generated sound.

Sound Number

Sound Description ascending thirds descending thirds ascending chorus descending chorus ascending doorbell descending doorbell quick double buzz long single buzz

The

SOUNDL

and

SOUNDP

were originally implemented to allow users to implement custom passcode systems that require users calling in via phone to enter a passcode before entering the conference. The sound commands could be used to provide feedback to the caller as well as the conference.

Example Description Status Message

B01SOUNDP1

Play "descending thirds" sound (same as exit tone) to phone output.

B01SOUNDP1

8.150. SSDELAY

-- Set Delay Between Screen Saver Screens

This command sets or queries the amount of time (in milliseconds) between each new screen of the LCD screen saver.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 500 and 600000, respectively.

Example

B01SSDELAY2000

B01SSDELAY>500

B01SSDELAY?

Description

Set screen saver delay to 2 seconds (2000 ms).

Status Message

B01SSDELAY2000

Increase screen saver delay by 0.5 seconds (500 ms).

B01SSDELAYx

, where x

is the new value of the screen saver delay. If this command was issued after the example above, then the status message would be

B01SSDELAY2500

Query screen saver delay.

B01SSDELAYx

, where x

is the new value of the screen saver delay. If this command was issued after the example above, then the status message would be

B01SSDELAY2500

8.151. SSEN

-- Enable or Disable Screen Saver

This command controls whether or not the LCD screen saver is enabled.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01SSEN1

Enable screen saver.

B01SSEN0

Disable screen saver.

Status Message

B01SSEN1

B01SSEN0

B01SSEN2

Toggle screen saver enabled state.

B01SSEN?

Query screen saver enabled state.

B01SSENx

, where x

depending on the current enabled state of the scrren saver.

B01SSENx

, where x

depending on the current enabled state of the scrren saver.

8.152. SSSTART

-- Set Idle Time Required for Screen Saver to

Start

This command sets or queries the amount of time (in milliseconds) that the front panel buttons must be idle before the screen saver starts.

This command is an integer command. See

Section 6.2

for more information on this type of command. The minimum and maximum values for this command are 500 and 600000, respectively.

Example

B01SSSTART2000

B01SSSTART>500

B01SSSTART?

Description Status Message

Set screen saver start time to 2 seconds (2000 ms).

B01SSSTART2000

Increase screen saver start time by

0.5 seconds (500 ms).

B01SSSTARTx

, where x

is the new value of the screen saver start time. If this command was issued after the example above, then the status message would be

B01SSSTART2500

Query screen saver start time.

B01SSSTARTx

, where x

is the new value of the screen saver start time. If this command was issued after the example above, then the status message would be

B01SSSTART2500

8.153. SSTEXT

-- Set Text to be Displayed by Screen Saver

This command sets or queries the text messages displayed by the screen saver. The arguments of this command are the screen number, the line number, and the text to be displayed. The screen number must be between 0 and 3. It indicates which message screen we are trying to set or query. Each message screen consists of two lines of text that can be up to 16 characters long. The second number indicates which line of the message we are tring to set or query. The line number must be 0 or 1 corresponding to the first and second line, respectively. Finally, the text argument is the actual text that will be displayed on the LCD. If the text is '

', then a query will be performed. If the text empty, then the message will be cleared. If both message lines are cleared for a given screen, then that screen will not be displayed by the screen saver. If all screens have been cleared, then the screen saver will never start (although it is easier just to use the

SSEN

command for this).

Example

B01SSTEXT0,0,Play that

B01SSTEXT0,1,funky music

Description

Set the first line of the first screen to read

"Play that".

Status Message

B01SSTEXT0,0,Play that

Set the second line of the first screen to read

"funky music".

B01SSTEXT0,1,funky music

B01SSTEXT0,1,?

Query the text of the second line of the first screen.

B01SSTEXT0,1,<string>

, where

<string> is the text of the second line of the first screen. If this command was issued after the example above, then the status message would be

B01SSTEXT0,1,funky music

8.154. SWRESET

-- Perform Soft Reset of System

Executing this command causes the Vortex to perform a software reset. The effect of the software reset is similar to cycling the power.

Example Description Status Message

B01SWRESET

Perform a software reset. No status message will be received. The Vortex will reset within a

8.155. SWVER

-- Query Software Version

This command is used to query the firmware version of the Vortex.

Example Description Status Message

B01SWVER?

Query current software version.

B01SWVER<string>

, where

is the current sofware version. If the software version was 2.5.0, then the status message would be

B01SWVER2.5.0

8.156. TONEE

-- Enable or Disable Entry and Exit Tones

This command sets or queries the enabled status of the entry and exit tone feature. If entry and exit tones are enabled, a specific tone is played whenever the auto-answer feature takes the phone off-hook. A different tone is played whenever the auto-hangup feature puts the phone on-hook. This feature is typically enabled to prevent a caller from entering or exiting a conference unannounced.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01TONEE1

Enable auto entry and exit tones.

B01TONEE0

Disable entry and exit tones.

Status Message

B01TONEE1

B01TONEE0

B01TONEE2

Toggle enabled status of entry and exit tones.

B01TONEEx

, where x

depending on the current enabled state of entry and exit tones.

B01TONEE?

Query enabled state of entry and exit tones.

B01TONEEx

, where x

depending on the current enabled state of entry and exit tones.

8.157. TONER

-- Enable or Disable Ring Tones

This command sets or queries the enabled status of the ring tone feature. If ring tones are enabled, a ring tone is played whenever there is an incoming ring signal on the connected phone line.

This command is a boolean command. See

Section 6.1

for more information on this type of command.

Example Description

B01TONER1

Enable auto ring tones.

B01TONER0

Disable ring tones.

Status Message

B01TONER1

B01TONER2

Toggle enabled status of ring tones.

B01TONER?

Query enabled state of ring tones.

B01TONER0

B01TONERx

, where x

depending on the current enabled state of ring tones.

B01TONERx

, where x

depending on the current enabled state of ring tones.

8.158. VTXMODI

-- Enable VTX Mode on Specified Inputs

Vortex devices can be connected to a Polycom VTX 1000 in order to use the wideband capabilities of that device. When connecting to a VTX 1000, special proccessing is done on the Vortex in order to guarantee compatibility with the VTX 1000. This command enables processing for the VTX 1000 on the specified line input or inputs. Note that VTX 1000 mode can only be enabled on the line inputs (A-D) .

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01VTXMODIA1

B01VTXMODIB0

B01VTXMODIB2

B01VTXMODIA?

B01VTXMODI*1

B01VTXMODI*0

Description Status Message

Enable VTX mode on input A.

B01VTXMODIA1

Disable VTX mode on input B.

B01VTXMODIB0

Toggle status VTX mode on input

B01VTXMODIBx

, where x

is either

1 depending on the current status of VTX mode on input B.

Query status of VTX mode on input A.

B01VTXMODIAx

, where x

is either

1 depending on the current status of VTX mode on input A.

Enable VTX mode on inputs A-D .

B01VTXMODI*1111

Disable VTX mode on inputs A-D

B01VTXMODI*0000

B01VTXMODI*1100

Enable VTX mode on inputs A-B and disable VTX mode on inputs

C-D .

B01VTXMODI*1100

B01VTXMODI*2

B01VTXMODI*?

Toggle status of VTX mode on inputs A-D .

Query status of VTX mode on inputs A-D .

B01VTXMODI*abcd

, where each of the letters (a, b, etc.) is either

depending of the current status VTX mode on the corresponding input. If this command was sent after the example above, then the status message would be

B01VTXMODI*0011

B01VTXMODI*abcd

, where each of the letters (a, b, etc.) is either

depending of the current status VTX mode on the corresponding input. If this command was sent after the example above, then the status message would be

B01VTXMODI*0011

8.159. VTXMODO

-- Enable VTX Mode on Specified Inputs

This command is a channel boolean command. See

Section 6.3

and Section 6.1

for more information on this type of command.

Example

B01VTXMODO11

B01VTXMODOA0

B01VTXMODO12

B01VTXMODOA?

Description

Enable VTX mode on output 1.

Disable VTX mode on output A.

Status Message

B01VTXMODO11

B01VTXMODOA0

Toggle status VTX mode on output 1.

Query status of VTX mode on output A.

B01VTXMODO1x

, where x

is either

1 depending on the current status of VTX mode on output 1.

B01VTXMODOAx

, where x

is either

1 depending on the current status of VTX mode on output A.

B01VTXMODO*1

B01VTXMODO*0

B01VTXMODO*11100100

Enable VTX mode on outputs 1-4, A-D .

Disable VTX mode on outputs 1-4, A-D .

Enable VTX mode on outputs 1-4 and disable

VTX mode on outputs A-D

B01VTXMODO*11111111

B01VTXMODO*00000000

B01VTXMODO*11110000

B01VTXMODO*2

B01VTXMODO*?

Toggle status of VTX mode on outputs 1-4, A-D

Query status of VTX mode on outputs 1-4, A-D .

B01VTXMODO*abcdefgh

, where each of the letters

(a, b, etc.) is either

depending of the current status VTX mode on the corresponding output. If this command was sent after the example above, then the status message would be

B01VTXMODO*00001111

B01VTXMODO*abcdefgh

, where each of the letters

(a, b, etc.) is either

depending of the current status VTX mode on the corresponding output. If this command was sent after the example above, then the status message would be

B01VTXMODO*00001111

Hello! I am an AI chatbot specifically trained to assist you with the Polycom Vortex EF2241 Programming Guide. I have thoroughly reviewed the document and can help you locate the exact information you need or explain the content in clear and simple terms. Whether you’re looking for guidance on specific features, troubleshooting steps, or general usage, feel free to ask your questions. The more details you provide about your concerns or needs, the more accurately and effectively I can assist you!

Assistant typing

Assistant is out of keyboard. Please, try again later.

Installed Voice Business Group

RS-232 Command Set:

Vortex EF2241 Programming Guide

Copyright © 2003 Polycom, Inc.

Polycom  and the Polycom logo are registered trademarks of Polycom, Inc.

ASPI, Vortex, VS4000, Viewstation, and iPower are registered trademarks of Polycom, Inc.

All other brand names, product names, and trademarks are the sole property of their respective owners

Vortex EF2241 Programming Guide

Table of Contents

1. Introduction

2. RS-232 Hardware

3. Programming Tips

3.1. Initialization

3.2. Wildcard Characters

3.3. Using Acknowledgements

3.4. Macros and Presets

3.5. Automixer Dependencies

4. Command Structure

4.1. Device Type

4.2. Device ID

4.3. Command Name

4.4. Command Data

4.5. Command Terminator

4.6. Examples

5. Status Messages

6. Command Types

6.1. Boolean Commands

6.2. Integer Commands

6.3. Channel Commands

6.4. Matrix Commands

6.5. Miscellaneous Commands

7. Command List

8. Command Reference

8.1.

AA

-- Enable or Disable Auto Answer Mode

8.2.

ACKMOD

-- Enable or Disable Acknowledgment Mode

8.3.

AEC

-- Enable or Disable Acoustic Echo Cancellation

8.4.

AECMODE

-- Set Amount of Double Talk Suppression used in the AEC.

8.5.

AGC

-- Enable or Disable Mic/Line Input Automatic Gain

Control

8.6.

AGCMAX

-- Set Maximum Allowed Mic/Line Input AGC Gain

8.7.

AGCMIN

-- Set Minimum Allowed Mic/Line Input AGC Gain

8.8.

AGCRATE

-- Set Ramp Rate of Mic/Line Input AGC

8.9.

AHCP

-- Enable or Disable Call Progress Based Auto

Hangup

8.10.

AHLD

-- Enable or Disable Loop Drop Based Auto Hangup

8.11.

AMASGN

-- Assign Inputs to an Automixer

8.12.

AMAUTO

-- Select Automatic or Manual Gating for each

Automixer Input

8.13.

AMBUSID

-- Set Automixer Groupings for EF Bus

8.14.

AMCHAIR

-- Enable Chairman Mode for Specified

Automixer

8.15.