Driver Details

Polycom SoundStructure

By: RTI
Updated: Nov. 5, 2018
Version: 2.0

Description:

This driver is for the Polycom SoundStructure series processors connected via Ethernet or RS-232.

PLEASE NOTE: This driver requires advanced knowledge of the Polycom SoundStructure installation and setup procedures. Please read the detailed driver "Get Info" for configuration and driver capabilities.

The 2.0 version of this driver changes the structure of many internal commands and variables. Becaue of this, the driver cannot be 'updated' with the update function of ID. You will have to add it as a new driver and reprogram the pages that use it.

Version History:

Version 2.0: Adds VOIP to the telephony functions and adds support for APEX

Polycom – SoundStructure Digital Signal Processor Family

This driver is for the Polycom SoundStructure Digital Signal Processor Family.

This Driver has been tested on a Polycom SoundStructure C16 with a single analog dialer running firmware version: 1.7.2

Revision History

The Initial Release of the driver

1.1 Fixed Virtual Fader Mute Off.

2.0 Added Extended VoIP Control, and compatibility with Apex Auto-Programming.

TCP Connection

The ETHERNET connection on the Polycom SoundStructure should be connected to the Network connection.

The Polycom SoundStructure processor should be set to a Static IP Address using port 52774.

RS-232 Connection

The RS232 connection on the Polycom SoundStructure should be connected with a standard patch cable to the XP Series Processor serial adapter.

The Polycom SoundStructure processor defaults to a baud rate of 9600 with no Handshaking. However when increasing the baud rate, Polycomm recommends enabling CTS/RTS Handshaking.

Configuration Info

This instruction guide is not a replacement for the Polycom SoundStructure Operating or RS-232 Control Manuals. Please be familiar with the Polycom SoundStructure prior to configuration of this driver.

This driver has been design to control the complete family of Polycom SoundStructure products. You can control multiple units with the same driver as long as the units are connected together.

Polycom SoundStructure Family

C16

C12

C8

SR12

In order to handle the highly programmable nature of the SoundStructure family of products, we created many configurable control points. It is very import to set the configuration information perfectly in order for the driver to work completely.

There are three types of control points in the system;” Virtual Fader / Mute”, “Virtual Crosspoint”, and “Telephone Dialer”. There are 50 configurable “Virtual Fader / Mute” and “Virtual Crosspoint”; and one “Telephone Dialer” control points.

Virtual Fader / Mute (Max 50)

The Virtual Fader / Mute control point is a mainstay control object for this driver. Many of the items you wish to control will fall into this category. With each Virtual Fader / Mute control point you must assign the Polycom programmed “Virtual Channel” that you would like to control with this control point. Using the Polycom SoundStructure studio software look up the “Virtual Channel” you need and assign it to this property, “Channel Name”. This value is case sensitive and must match that that is found in the Polycom DSP programming.

With the Virtual Fader / Mute control point, the driver queries for the Max/Min fader adjustment limits set inside the Polycom SoundStructure. The scaled volume will automatically adjust its range to match these limits. The Raise and Lower driver controls will keep the adjustments inside the limits as well. However, make sure when setting limits inside the Polycom SoundStructure you make your default gain value inside the range as well.

Virtual Crosspoint (Max 50)

The Virtual Crosspoint control point is a mainstay control object for this driver. Many of the items you wish to control will fall into this category. With a Virtual Crosspoint you will have to configure an “Input Channel Name” and an “Output Channel Name”. Using the Polycom SoundStructure studio software look up the input and output “Virtual Channels” you would like to control and assign it to these two properties, “Input Channel Name” and an “Output Channel Name”. These values are case sensitive and must match that that is found in the Polycom DSP programming.

With the Crosspoint control point, the driver queries for the Max/Min gain adjustment limits set inside the Polycom SoundStructure. The scaled volume will automatically adjust its range to match these limits. The Raise and Lower driver controls will keep the adjustments inside the limits as well. However, make sure when setting limits inside the Polycom SoundStructure you make your default gain value inside the range as well.

You will be able to control the gain settings and routing (mute) settings of this crosspoint.

Telephone Dialer

The Telephone Dialer control point can control any of the dialer cards available for the Polycom SoundStructure including the VoIP. However not all the VoIP features are available through this driver, basic dialing and call control have been provided as part of this control.

When configuring the Control Point you must enter both the input and output “Virtual Channels” that have been assigned inside the Polycom Sound Structure programming. Using the Polycom SoundStructure studio software look up the input and output “Virtual Channels” you would like to control and assign it to these two properties, “Input Channel Name” and an “Output Channel Name”. These values are case sensitive and must match that that is found in the Polycom DSP programming.

An “Incoming Call” system event has been provided to allow you to display that an incoming call is in progress, using driver commands, the user can answer, reject, or ignore the call.

Phonebook

The Polycom SoundStructure does not provide for a phonebook; however we have provided one as part of this driver to maintain symmetry and provide for the feature as part of our deliveries. The phonebook has a max of 20 entries available and is stored in persistent memory.