Polycom SoundStructure C16 Design Manual page 539

connection is device 1, the device connected to that device is device 2, and so on until the last device. Up
to 8 devices may be connected over OBAM.
Understanding Virtual Channel Parameters
Virtual channel parameters are defined for a given virtual channel. Examples of virtual channel parameters
include gain, AEC enable, and telephone dialing. These parameters are addressed by the virtual channel
name that identifies the virtual channel to be controlled.
Understinading Matrix Parameters
Matrix parameters are defined at crosspoints of the SoundStructure matrix mixer. Since a matrix crosspoint
is defined by an input and an output, matrix parameters are addressed by two virtual channel names that
identify the input and output virtual channels that define the crosspoint to be controlled.
Parameters can have access modes of read/write, read-only, or write-only. Some parameters can also
support user-definable minimum and maximum limits such as volume control commands.
All parameter control commands operate on a specific type of parameter. The parameter types supported
by the SoundStructure control protocol are:
void
Void commands take no argument, and must be write-only. For example, the sys_reboot parameter is a
write-only void parameter that reboots the SoundStructure device when the command is executed.
boolean
Boolean parameters take one of two values: 0 or 1.
integer
Integer parameters represent an integer value. When incremented or decremented beyond their range,
they saturate to their maximum or minimum value, respectively. Integer parameters can support a
user-defined minimum and maximum.
float
Float parameters represent a floating-point value. When incremented or decremented beyond their range,
they saturate to their maximum or minimum value, respectively. Float parameters can support a
user-defined minimum and maximum.
sequence
Sequence parameters represent unsigned integer values. When incremented or decremented beyond their
range, they wrap around to their minimum or maximum value, respectively. Sequence parameters do not
support a user-defined minimum or maximum.
string
String parameters represent a string value.
list
List parameters represent a sequence of string values. For example, the pstn country parameter is a list
parameter that sets the country code for the PSTN telephony interface. Some possible values for the pstn
country parameter might be: north america, europe, and china. Even though list parameters are represented
Polycom, Inc. 539