Audio Commands - Cisco TelePresence SX80 Reference Manual

Cisco TelePresence SX80
Contents Introduction

Audio commands

xCommand Audio Equalizer List
Shows the current equalizer settings for the codec.
Requires user role: ADMIN
Parameters:
EqualizerId: <1..8>
Example:
xCommand Audio Equalizer List EqualizerId: 1
*r AudioEqualizerListResult Equalizer 1 Section 1 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 1 Frequency: "100"
*r AudioEqualizerListResult Equalizer 1 Section 1 Q: "4"
*r AudioEqualizerListResult Equalizer 1 Section 1 Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 2 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 2 Frequency: "200"
*r AudioEqualizerListResult Equalizer 1 Section 2 Q: "4"
*r AudioEqualizerListResult Equalizer 1 Section 2 Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 3 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 3 Frequency: "500"
*r AudioEqualizerListResult Equalizer 1 Section 3 Q: "4"
*r AudioEqualizerListResult Equalizer 1 Section 3 Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 4 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 4 Frequency: "1000"
*r AudioEqualizerListResult Equalizer 1 Section 4 Q: "4"
*r AudioEqualizerListResult Equalizer 1 Section 4 Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 5 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 5 Frequency: "2000"
*r AudioEqualizerListResult Equalizer 1 Section 5 Q: "4"
*r AudioEqualizerListResult Equalizer 1 Section 5 Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 6 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 6 Frequency: "5000"
*r AudioEqualizerListResult Equalizer 1 Section 6 Q: "0"
*r AudioEqualizerListResult Equalizer 1 Section 6 Gain: "0"
Codec SX80 API Reference Guide TC7.3, OCTOBER 2015.
D15107.05
About the API xConfiguration
xCommand Audio Equalizer Update
88
xCommand xCommand
The system has eight user defined equalizers, each made up of six second order IIR sections. Each
of the eight equalizers can be applied to one or more of the audio input and output connectors on
the codec. Each IIR section can be modified independently.
There are five filter types, and the frequency response variations dependent on some of the param-
eter variations. The Q-value for low pass, high pass, low shelf and high shelf filters should be set to
1/sqrt(2) in order to get maximally flat responses. The Q-value (or Q-factor) is defined as Q=f0/bw.
Where f0=resonance frequency in Hz; and bw=filter bandwidth in Hz.
To switch off one of the six equalizer sections; set the second order section to have a flat frequency
response. This can be done by setting the filter type to "none" or by setting the filter type to
"peaking" and the gain to "0" (zero).
We recommend using the TC Console tool, with the embedded equalizer GUI, to modify the equal-
izers. The TC Console software is found on the Developer Zone web page. Go to: http://developer.
cisco.com/web/telepresence-developer/tools/integrators/tc-console.
Requires user role: ADMIN
Parameters:
EqualizerId(r): <1..8>
Section(r): <1..6>
FilterType(r): <highpass/highshelf/lowpass/lowshelf/none/peaking>
Frequency(r): <S: 0, 32>
Q(r): <S: 0, 32>
Gain(r): <S: 0, 32>
Example:
xCommand Audio Equalizer List EqualizerId: 1 Section: 1 FilterType:
Peaking Frequency: "100" Q: "4" Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 1 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 1 Frequency: "100"
*r AudioEqualizerListResult Equalizer 1 Section 1 Q: "4"
*r AudioEqualizerListResult Equalizer 1 Section 1 Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 2 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 2 Frequency: "200"
*r AudioEqualizerListResult Equalizer 1 Section 2 Q: "4"
*r AudioEqualizerListResult Equalizer 1 Section 2 Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 3 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 3 Frequency: "500"
*r AudioEqualizerListResult Equalizer 1 Section 3 Q: "4"
*r AudioEqualizerListResult Equalizer 1 Section 3 Gain: "0"
*r AudioEqualizerListResult Equalizer 1 Section 4 FilterType: "Peaking"
*r AudioEqualizerListResult Equalizer 1 Section 4 Frequency: "1000"
API Reference Guide
xStatus Appendices
Copyright © 2015 Cisco Systems, Inc. All rights reserved.