Polycom SoundStructure C16 User Manual

Design Guide for the Polycom SoundStructure C16, C12, C8, and SR12
12 - 78
Using the SoundStructure API
This section presents some examples of using the SoundStructure API com-
mands. In this section, commands sent by the control system are in blue,
acknowledgements received by the control system are preceded by the word
‘val’ and are coded in green, and comments to explain the example are pref-
aced by the ‘#’ character.
Not all acknowledgements are shown in these examples. Only the acknowl-
edgements that are important for understanding how the systems works are
shown. These examples assume the names of the SoundStructure VoIP Inter-
face’s input and output channel are “VoIP In” and “VoIP Out” respectively.
Dialing a Call
This example shows how to make a phone call.
# Take the phone offhook.
set phone_connect “VoIP Out” 1
val phone_connect “VoIP Out” 1
# Dial the digits
set phone_dial “VoIP Out” “2029”
val phone_dial “VoIP Out” “2029”
# If the remote party answers at extension 2029 then the call
# is connected.
voip_reboot Reboots the SoundStructure VoIP Interface.
voip_resume Resumes a call that was on hold.
voip_send Causes a call to be placed with the digits dialed.
voip_split Splits all calls in a conference into individual calls.
voip_status Indicates the status LED state on the
SoundStructure VoIP Interface.
voip_transfer Used to transfer a call.
voip_uc_sw_ver Gets the SoundStructure VoIP Interface’s UC
Software version.

Polycom SoundStructure C16 Specifications

General

Audio Inputs	16
Audio Outputs	16
Power Supply	100-240 VAC, 50/60 Hz
Acoustic Echo Cancellation	Yes
Noise Reduction	Yes
Input Channels	16
Output Channels	16
Line Outputs	16
AEC Channels	16
Sampling Rate	48 kHz
Frequency Response	20 Hz - 20 kHz
Ethernet Ports	1
Processing Channels	16
Control Ports	RS-232
Microphone Inputs	16
Line Inputs	16
Control	RS-232, Ethernet
Operating Temperature	0° C to 40° C (32° F to 104° F)

Summary

Introduction

SoundStructure Product Family

SoundStructure Architecture Overview

Common architectural features and specific processing for C-series and SR-series products, including OBAM.

SoundStructure C-series Products

Details on C16, C12, and C8 devices for audio conferencing applications with echo cancellation.

SoundStructure SR-Series Products

Details on SR12 for commercial sound applications, without echo cancellation.

SoundStructure Design Concepts

Physical Channels

Defines physical channels as actual inputs/outputs of the SoundStructure system, extended sequentially across devices.

Virtual Channels

Represents physical channels with user-defined names for easier referencing and control, simplifying system wiring.

Virtual Channel Groups

Allows grouping of virtual channels for simultaneous control via a single command.

Creating Designs with SoundStructure Studio

Step 1 - Input Signals

Guides the user through selecting and defining input signals for the project, including category, type, and quantity.

Step 3 - Device Selection

Explains how to select the specific SoundStructure devices and cards required to implement the design.

Step 4 - Uploading Or Working Offline

Details the process of creating a file for offline configuration or sending it directly to devices.

Customizing SoundStructure Designs

Wiring Page

Allows reviewing and changing virtual channel to physical channel assignments for the system.

Channels Page

Primary area for customizing signal gains and processing for inputs, outputs, and submixes.

Feedback Elimination

Describes the use of adaptive filters to reduce feedback that may be picked up by the microphone.

Acoustic Echo Cancellation (AEC)

Explains how AEC removes remote audio from local room audio to prevent echoes.

Dynamics Processing

Details processors like compressor, limiter, expander, gate, and peak limiter for controlling dynamic range.

Connecting Over Conference Link2

Physical Connections

Details the RJ45 terminated CAT-5e cable and pin-out for Conference Link2 connections.

Polycom HDX Integration

Explains how to connect SoundStructure to Polycom HDX video conferencing systems using Conference Link2.

Digital Microphone Firmware Updates

How to update microphone firmware to ensure compatibility with SoundStructure devices.

Linking Multiple SoundStructure Devices with OBAM

Updating SoundStructure Device Firmware

Steps to update firmware to version 1.2 or higher for OBAM linking capability.

Linking SoundStructure Devices

Details the process of powering down and cabling OBAM connectors between devices.

Creating a Multi-Device Configuration File

Steps required to create a configuration file for a multi-device SoundStructure system.

Installing SoundStructure Devices

Wiring The Devices

Ensuring physical cabling exactly matches how the virtual channels are defined.

Uploading A Configuration File

Steps for uploading a configuration file from SoundStructure Studio to the devices.

Updating Firmware

Instructions on updating SoundStructure device firmware using SoundStructure Studio.

Presets

Information on saving settings to full and partial presets for power cycle survival.

Using Events, Logic, And IR

Events

Introduces Events, built from sources, triggers, and actions for controlling system behavior.

Logic Inputs

How to connect push-to-talk buttons and dry contact closures to the rear-panel.

HDX IR Remote

Using the HDX IR remote to control SoundStructure devices and map key presses to functions.

Network Management

Dynamic IP Addresses

How to determine IP addresses using SoundStructure Studio's discovery method.

Static IP Addresses

How to assign static IP addresses directly from SoundStructure Studio or via API.

SoundStructure Device Discovery

Mechanism for SoundStructure Studio to identify devices on the network.

Integrating The Polycom Touch Control with SoundStructure Systems

Pairing the Polycom Touch Control with SoundStructure

Step-by-step guide for pairing the Polycom Touch Control device with the SoundStructure system.

Updating Polycom Touch Control Software

Instructions for installing software updates from a server or USB storage device.

Validating Polycom Touch Control and SoundStructure integration

Steps to verify proper pairing and configuration of Touch Control and SoundStructure.

The SoundStructure VoIP Interface

SoundStructure VoIP Interface Overview

Details the capabilities of the VoIP Interface, including line support and audio codecs.

Upgrading a Project to the SoundStructure VoIP Interface

How to upgrade an existing project with PSTN interface to use the VoIP Interface.

Configuring the SoundStructure VoIP Interface

Steps for configuring the VoIP Interface for call management environment.

Advanced Applications

1 Microphone And Mono Video Conferencing

A basic example of designing with one microphone and a Polycom VSX8000.

8 Microphones, Video, And Telephony Application

A mono conferencing system with eight table mics, program audio, video codec, and amplifier.

16 Mics With 6-Zone Sound Reinforcement

Sets up a system with 16 table mics, lectern, wireless mic, and six zones for reinforcement.

Room combining application with two rooms

Demonstrates using SoundStructure products for room combining applications.

Troubleshooting

Audio Troubleshooting

Addresses common audio problems like wiring, routing, mute, and gain structure issues.

Echo Troubleshooting

Identifies common echo issues and provides steps to resolve them.

Hardware Troubleshooting

Isolates issues by checking front-panel LED status and built-in diagnostics.

OBAM Troubleshooting

Troubleshooting OBAM link status LEDs on input and output connections.

Specifications

Technical Specifications

Details physical dimensions, weight, connectors, and power requirements.

Inputs

Lists specifications for analog and digital inputs, including phantom power and gain.

Outputs

Details output specifications, including gain, amplitude, impedance, and EMI filter.

System

Lists system-level specifications such as frequency response, idle channel noise, and cross talk.

Using SoundStructure Studio Controls

Adjusting Knobs

Explains the three methods for changing knob control values using mouse and keyboard.

Adjusting Matrix Crosspoints

How to adjust individual and multiple matrix crosspoints for gain, mute, and input signal selection.

Command Protocol Reference Guide

SoundStructure Control Interfaces

Details the available interfaces for controlling SoundStructure devices.

Virtual Channels

Explains virtual channels as representations of physical inputs/outputs for simplified control.

SoundStructure Command Syntax

Describes the control protocol syntax, including action, data, and termination characters.

Gain and Mute Parameters

Describes fader, gain, and mute parameters for telephony and matrix sections.

Address Book

Using the Address Book

Makes it easy to connect over IP to SoundStructure systems and organize collections.

Creating Address Book Entries

Steps to create a new address book entry by editing system name, IP address, and comment.

Removing Entries from the Address Book

Instructions on deleting entries from folders or entirely from the address book.

Designing Audio Conferencing Systems

Large Room Environments

Discusses ambient noise, reflections, and microphone/loudspeaker placement in large rooms.

Microphone Selection And Placement

Explains microphone types, fundamentals, phantom power, and directional vs omnidirectional patterns.

Acoustic Echo Cancellation (AEC)

Explains how AEC prevents remote talkers' audio from echoing back from local room loudspeakers.

Noise Cancellation

Details techniques for reducing background noise picked up by microphones.