Control Array Virtual Channels - Polycom SoundStructure C16 Design Manual

SoundStructure Design Concepts
Logic pins can be defined via the command line interface from SoundStructure
Studio or a control terminal with the following syntax to define a logic input
on logic input pin 1:
vcdef "Logic Input Example" control digital_gpio_in 1
which will return the acknowledgement
vcdef "Logic Input Example" control digital_gpio_in 1
A logic output pin definition using output pin 1 can be created with the
command:
vcdef "Logic Output Example" control digital_gpio_out 1
which will return the acknowledgement
vcdef "Logic Output Example" control digital_gpio_out 1
Once defined, the designer can refer to those control virtual channels by their
name. As with the example above, the designer created a control input virtual
channel "Logic Input Example". The SoundStructure device can be queried
with a control system to determine the value of the logic pin and when it is
active, it could be used to change the status of the device. When the "Logic
Input Example" input is inactive, it could, for example, be used with an exter-
nal control system to unmute the microphones. In version 1.0 of the firmware
logic pins must be queried by an external control system and then the control
system can execute commands or a series of commands on the device.
The value of control virtual channels may be queried by the control system by
using the command digital_gpio_state. An example of this is shown below.
get digital_gpio_state "Logic Input Example"
The state of digital logic output may also be set active using the
digital_gpio_state command as follows for the control virtual channel "Logic
Output Example" that would be created with the vcdef command.
set digital_gpio_state "Logic Output Example" 1
Additional information about using logic pins may be found in Appendix A.

Control Array Virtual Channels

Multiple logic pins may be associated together with a control array virtual
channel. Control array virtual channels are created by one or more logic input
or logic output pins. Once a control array channel is defined, the value of the
group of pins can be queried or set using the digital_gpio_value command.
3 - 21