Integrator's Reference Manual For Polycom RealPresence Group Series Systems, Version 4.1.1 C8 RPG IR M 4 0 1

User Manual: C8

Open the PDF directly: View PDF PDF.
Page Count: 294

DownloadIntegrator's Reference Manual For Polycom RealPresence Group Series Systems, Version 4.1.1 C8 RPG IR M 4 0 1
Open PDF In BrowserView PDF
[Type the document title]




4.1.1 | July 2013 | 3725-69984-002/A

Integrator’s Reference
Manual for the Polycom®

RealPresence® Group Series

Polycom Document Title

1

Integrator’s Reference Manual for the Polycom RealPresence Group Series

ii

Polycom, Inc.

Trademark Information
POLYCOM® and the names and marks associated with Polycom's products are trademarks and/or service
marks of Polycom, Inc., and are registered and/or common law marks in the United States and various other
countries.
All other trademarks are the property of their respective owners.
Patent Information
The accompanying product may be protected by one or more U.S. and foreign patents and/or pending patent
applications held by Polycom, Inc.

© 2013 Polycom, Inc. All rights reserved.
Polycom, Inc.
6001 America Center Drive
San Jose CA 95002
USA
No part of this document may be reproduced or transmitted in any form or by any means, electronic or
mechanical, for any purpose, without the express written permission of Polycom, Inc. Under the law,
reproducing includes translating into another language or format.
As between the parties, Polycom, Inc., retains title to and ownership of all proprietary rights with respect to
the software contained within its products. The software is protected by United States copyright laws and
international treaty provision. Therefore, you must treat the software like any other copyrighted material (e.g.,
a book or sound recording).
Every effort has been made to ensure that the information in this manual is accurate. Polycom, Inc., is not
responsible for printing or clerical errors. Information in this document is subject to change without notice.

iii

Integrator’s Reference Manual for the Polycom RealPresence Group Series

iv

Polycom, Inc.

About This Guide

The Integrator’s Reference Manual for Polycom® RealPresence® Group Series
is for system integrators who need to configure, customize, manage, and
troubleshoot Polycom RealPresence Group systems. The API commands in
this guide are applicable to the Polycom RealPresence Group 300, Polycom
RealPresence Group 500, Polycom RealPresence Group 550, and Polycom
RealPresence Group 700 systems.

Polycom, Inc.

v

Integrator’s Reference Manual for the Polycom RealPresence Group Series

vi

About This Guide

Polycom, Inc.

Contents
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
1

Room Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Setting Up a Room for Video Conferencing . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Room Layout Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Integrating Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Connecting Polycom Cameras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Integrating Audio and Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Connecting a Polycom RealPresence Group Microphone Array to a
Polycom RealPresence Group System . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Connecting a Computer to a Polycom RealPresence GroupSystem . . 19

2

Cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Network Cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
CAT 5e LAN Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
LAN Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Polycom Touch Control LAN Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Keyed Peripheral Link LAN Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Polycom Touch Control Power Adapter . . . . . . . . . . . . . . . . . . . . . . . . . 26
Video and Camera Cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
HDMI Monitor Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
HDCI Analog Camera Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
HDCI Polycom EagleEye Director Cable . . . . . . . . . . . . . . . . . . . . . . . . 31
Polycom HDX Tracker Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
HDCI Camera Break-Out Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
HDCI Polycom EagleEye 1080 Camera Cable . . . . . . . . . . . . . . . . . . . . 36
HDCI Polycom EagleEye View Camera Cable . . . . . . . . . . . . . . . . . . . 37
VGA Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Audio Cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
RealPresence Group Microphone Array Cable . . . . . . . . . . . . . . . . . . . 39
Custom Cabling for Polycom RealPresence Group Microphone Arrays
41

Polycom, Inc.

vii

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Audio Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
3.5 mm Stereo Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Polycom EagleEye Director Audio Feedback Phoenix to
RCA Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Serial Cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Polycom RealPresence Group Series Serial cable . . . . . . . . . . . . . . . . . 47
Straight-Through Serial Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Null Modem Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

3

Using the API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Using the API with an RS-232 Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Configuring the RS-232 Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Understanding the RealPresence Group Series RS-232 Interfaces . . . 53
Starting an API Session using an RS-232 Interface . . . . . . . . . . . . . . . . 54
Using the API with the Maximum Security Profile Enabled . . . . . . . . 56
Using the API with a LAN Connection . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Using the API Controller Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Additional API Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Technical Support Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . 56
Feature Enhancement Request Web Site . . . . . . . . . . . . . . . . . . . . . . . . . 57
Video Test Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Knowledge Base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

4

System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
About the API Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Syntax Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Availability of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Command Response Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Commands that Restart the System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Additional Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
addrbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
advnetstats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
all register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
all unregister . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
amxdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
answer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
audiotransmitlevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
autoanswer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
autoshowcontent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
basicmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

viii

Polycom, Inc.

Contents

calendardomain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
calendarmeetings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
calendarpassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
calendarplaytone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
calendarregisterwithserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
calendarremindertime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
calendarresource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
calendarserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
calendarshowpvtmeetings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
calendarstatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
calendaruser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
callinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
callstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
camerainput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
configdisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
configparam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
contentauto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
daylightsavings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
defaultgateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
dhcp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
dial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
dns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
dynamicbandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
e164ext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
echocanceller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
echoreply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
enablefirewalltraversal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
enablekeyboardnoisereduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
enablelivemusicmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
enablepvec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
enablersvp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
enablesnmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
farcontrolnearcamera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
gaddrbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
gatekeeperip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
gendial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
getcallstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Polycom, Inc.

ix

Integrator’s Reference Manual for the Polycom RealPresence Group Series

getconfiguredipaddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
h239enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
h323name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
hangup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
hostname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
ipaddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
lanport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
ldapauthenticationtype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
ldapbasedn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
ldapbinddn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
ldapdirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
ldapntlmdomain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
ldappassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
ldapserveraddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
ldapserverport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
ldapsslenabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
ldapusername . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
maxtimeincall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
mpautoanswer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
mpmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
mute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
muteautoanswer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
natconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
nath323compatible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
netstats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
nonotify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
notify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
oobcomplete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
preset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
remotemonenable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
resetsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
rs232 baud . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
rs232 mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
serialnum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
setpassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
sleep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
x

Polycom, Inc.

Contents

sleeptime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
snmpadmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
snmpcommunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
snmpconsoleip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
snmplocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
snmpsystemdescription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
snmptrapversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
speeddial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
subnetmask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
systemname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
systemsetting 323gatewayenable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
systemsetting cameracontent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
systemsetting cameracontent1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
systemsetting cameracontent2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
systemsetting cameracontent3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
systemsetting connectionpreference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
systemsetting dialingmethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
systemsetting displayiconsincall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
systemsetting enablepolycommics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
systemsetting iph323enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
systemsetting lineinlevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
systemsetting lineoutmode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
systemsetting maxrxbandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
systemsetting maxtxbandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
systemsetting mediainlevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
systemsetting model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
systemsetting primarycamera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
systemsetting remotechannelid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
systemsetting sipaccountname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
systemsetting sipdebug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
systemsetting sipenable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
systemsetting sippassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
systemsetting sipproxyserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
systemsetting sipregistrarserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
systemsetting siptransportprotocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
systemsetting sipusername . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
systemsetting stereoenable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
systemsetting telnetenabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
systemsetting transcodingenabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
systemsetting uspairingenabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Polycom, Inc.

xi

Integrator’s Reference Manual for the Polycom RealPresence Group Series

systemsetting webenabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
systemsetting whitebalancemode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
systemsetting whitebalancemode1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
usegatekeeper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
vcbutton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
vgaqualitypreference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
videocallorder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
wake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
wanipaddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
webmonitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
whoami . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

A

Room Design and Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Room Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Walls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Ceiling Tiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Air Conditioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Interior Design and Finishes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Furniture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Acoustics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Room Lighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Light Fixtures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Room Preparation Conclusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Audio Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Audio Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Audio Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Direction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Range/Frequency Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Video Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Video Projection for Use in Videoconference . . . . . . . . . . . . . . . . . . . . 256
Cameras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Room Control Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

B

Polycom RealPresence Group Series Specifications . . . . 259
Back Panel Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Inputs/Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

xii

Polycom, Inc.

Contents

Audio Specifications for Polycom RealPresence Group 500 and 550
systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Audio Specifications for Polycom RealPresence Group 700 systems 260
DTMF Dialing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Remote Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
RS-232 Serial Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

C

Categorical List of API Commands . . . . . . . . . . . . . . . . . . . 265
Directory Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
LDAP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Call Function Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Calling Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Call Status Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Call Setting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Conference Setting Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Conference Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Global Services Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Calendar Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
LDAP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
SNMP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
LAN, WAN, and IP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
H323 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
LAN and WAN Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
SIP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Video and Audio Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Audio Adjustment Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Audio Setting Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Content Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Content Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Content Setting Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Camera Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Camera Setting Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
Monitor Video Output Setting Commands . . . . . . . . . . . . . . . . . . . . . 271
Registration Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
System Query Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
System Setting Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Diagnostic Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

Polycom, Inc.

xiii

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

xiv

Polycom, Inc.

1
Room Integration
Setting Up a Room for Video Conferencing
For detailed information about setting up a room for video conferencing, refer
to Room Design and Layout on page 245.

Room Layout Examples
Use the following diagrams as examples for setting up a conference room with
Polycom RealPresence Group systems. Polycom recommends that you
contract an experienced contractor to ensure all the components operate as a
single cohesive system.

Small Conference Room

Acoustic Panels

Whiteboard

Flat Panel
Monitor 1

Polycom RealPresence
Group System
Media Center
with 42” Displays and
Polycom EagleEye
Director

Polycom RealPresence
Group Microphone Array

Polycom
Touch
Control

Flat Panel
Monitor 2
Acoustic Quality
Drapes

Polycom, Inc.

1

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Large Conference Room: Option 1

Acoustic Panels

Polycom SoundStation®
IP 7000 Phone

Ceiling
Microphone

Polycom Touch Control

Ceiling
Microphone
Polycom EagleEye
Director
50”
Monitor 1

50”
Monitor 2

Polycom RealPresence
Group System

Network Outlets

2

Power Outlets

Polycom, Inc.

Room Integration

Large Conference Room: Option 2
Acoustic Panels

Document Camera
Polycom SoundStation®
IP 7000 Phone

Ceiling
Microphone

Polycom Touch
Control

Ceiling
Microphone

Projector

50”
Single Display

Polycom EagleEye
Director

Polycom RealPresence
Group Media Center

Network Outlets

Polycom, Inc.

Power Outlets

3

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Classroom

Teacher’s Podium
Polycom
Touch
Control
Computer
Document
Camera

Monitor 1
Camera 2
Polycom
RealPresence
Group System
with EagleEye
Director with
Dynamic Speaker
Locating Technology
and Polycom
SoundStructure™

Monitor for
VGA Out

Monitor 2

Wall-mounted Display
with EagleEye camera
= Ceiling Microphone

4

Polycom, Inc.

Room Integration

Integrating Video
The following sections describe how to connect cameras to Polycom
RealPresence Group systems. After you connect a camera to a Polycom
RealPresence Group system, refer to the Administrator’s Guide for the Polycom
RealPresence Group Series for information about configuring the camera options
in the user interface.

Connecting Polycom Cameras
You can connect Polycom RealPresence Group systems to a Polycom EagleEye
Acoustic, Polycom EagleEye III, Polycom EagleEye Director, Polycom
EagleEye HD, Polycom EagleEye 1080, Polycom EagleEye View, or Polycom
EagleEye II camera from Polycom. Refer to the release notes for the software
release installed on the Polycom RealPresence Groupsystem for a list of
supported PTZ cameras.

Polycom EagleEye Acoustic Camera as the Main Camera
You can connect a Polycom EagleEye Acoustic camera (part number
2624-65058-001) to a Polycom RealPresence Group system as the main camera.
Connecting a Polycom EagleEye Acoustic Camera to a RealPresence Group
300 system:

1

2

1725-27441-006/A
12V 6.25A

art of com

munication

O
ART F C

A
ER
AM

Polycom, Inc.

NP
TZ
-C

120
008
02

PO
LY
CO
M

UNICATION
MM
O

1

1

5

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Connecting a Polycom EagleEye Acoustic Camera to a RealPresence Group
500 system:

art of com
munication
O
ART F C

NP
TZ
-C

A
ER
AM

120
008
02

PO
LY
CO
M

UNICATION
MM
O

1

1

Connecting a Polycom EagleEye Acoustic Camera to a Polycom
RealPresence Group 550 system:

munication

art of com
O
ART F C

NP
TZ
-C

A
ER
AM

120
008
02

PO
LY
CO
M

UNICATION
MM
O

1

1

Connecting a Polycom EagleEye Acoustic Camera to a RealPresence Group
700 system:

6

Polycom, Inc.

Room Integration

1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

munication

art of com
O
ART F C

NP
TZ
-C

A
ER
AM

120
008
02

PO
LY
CO
M

UNICATION
MM
O

1

1

Polycom EagleEye III Camera as the Main Camera
You can connect a Polycom EagleEye III camera (part number 1624-08283-002,
8200-63730-xxx, or 8200-63740-xxx) to a Polycom RealPresence Group system
as the main camera using:
Option 1
•

HDCI Analog Camera Cable on page 29.

•

Power supply. Power supply is only required if you want to use the IR
remote to wake the system when it is in sleep mode on RealPresence
Group 700 systems. Use only the approved power supply from Polycom
(part number 1465-52748-040). Do not exceed 12 Volts at 3 Amps. Verify
the polarity of the power supply as shown on the Polycom camera next to
the power supply input.

Connecting a Polycom EagleEye III Camera to a Polycom RealPresence
Group 300 system:
1

2

1725-27441-006/A
12V 6.25A

1
1

Polycom, Inc.

7

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Connecting a Polycom EagleEye III Camera to a Polycom RealPresence
Group 500 system:

1
1

Connecting a Polycom EagleEye III Camera to a Polycom RealPresence
Group 550 system:

1
1

8

Polycom, Inc.

Room Integration

Connecting a Polycom EagleEye III Camera to a Polycom RealPresence
Group 700 system:
1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

1

2

DC IN 12V

Use Polycom Power Supply Only

Part Number: 1465-52748-040

Option 2
•

A—Two Polycom HDX Tracker Cable on page 33.

•

B—Coaxial analog video cables.

•

C—DB-9 serial cable.

•

Power supply. Power supply is only required if you want to use the IR
remote to wake the system when it is in sleep mode on RealPresence
Group 700 systems. Use only the approved power supply from Polycom
(part number 1465-52748-040). Do not exceed 12 Volts at 3 Amps. Verify
the polarity of the power supply as shown on the Polycom camera next to
the power supply input.

Polycom recommends this configuration when a custom cable length is
required. The BNC and serial cables can be built to custom lengths.

Polycom, Inc.

9

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Connecting a Polycom EagleEye III Camera to a Polycom RealPresence
Group 300 system:
1

2

1725-27441-006/A
12V 6.25A

A

A
C
B
Optional, up to 100 ft

Connecting a Polycom EagleEye III Camera to a Polycom RealPresence 500
system:

A

A
C
B
Optional, up to 100 ft

10

Polycom, Inc.

Room Integration

Connecting a Polycom EagleEye III Camera to a Polycom RealPresence Group
550 system:

A

A
C
B
Optional, up to 100 ft

Connecting a Polycom EagleEye III Camera to a Polycom RealPresence 700
system:
1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

A

A

DC IN 12V

C
Use Polycom Power Supply Only

B
Optional, up to 100 ft

Polycom, Inc.

11

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Polycom EagleEye III Camera as the Second Camera
You can connect a Polycom EagleEye III camera (part number 1624-08283-002,
8200-63730-xxx, or 8200-63740-xxx) to a Polycom RealPresence Group 700
system as the second camera.
Option 1
•

HDCI Analog Camera Cable on page 29

•

Power supply. Power supply is only required if you want to use the IR
remote to wake the system when it is in sleep mode on RealPresence
Group 700 systems. Use only the approved power supply from Polycom
(part number 1465-52748-040). Do not exceed 12 Volts at 3 Amps. Verify
the polarity of the power supply as shown on the Polycom camera next to
the power supply input

Connecting to a Polycom EagleEye III Camera to a Polycom RealPresence
Group 700 system:
1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

2

2

DC IN 12V

Use Polycom Power Supply Only

Part Number: 1465-52748-040

Option 2

12

•

A—Two Polycom HDX Tracker Cable on page 33.

•

B—Coaxial analog video cables.

•

C—DB-9 serial cable.

•

Power supply. Power supply is only required if you want to use the IR
remote to wake the system when it is in sleep mode on RealPresence
Group 700 systems. Use only the approved power supply from Polycom

Polycom, Inc.

Room Integration

(part number 1465-52748-040). Do not exceed 12 Volts at 3 Amps. Verify
the polarity of the power supply as shown on the Polycom camera next to
the power supply input.
Connecting to a Polycom EagleEye III Camera to a Polycom RealPresence
Group 700 system:
1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

A

A

DC IN 12V

C
Use Polycom Power Supply Only

B
Optional, up to 100 ft

Part Number: 1465-52748-040

Polycom EagleEye Director as the Main Camera or Second
Camera
EagleEye Director can be connected to Polycom RealPresence Group 300, 500,
and 550 systems as the main camera. Polcyom EagleEye Director can be
connected to a Polycom RealPresence Group 700 system as the main camera or
second camera.
Connect a Polycom EagleEye Director (part number 7200-82632-xxx,
7200-82631-xxx, or 2200-82559-xxx) to Polycom RealPresence Group
system as the main camera using:

Polycom, Inc.

•

A—HDCI Analog Camera Cable on page 29.

•

B—Polycom EagleEye Director Audio Feedback Phoenix to RCA Cable on
page 46.

13

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Connecting a Polycom EagleEye Director to a Polycom RealPresence Group
300 system:

A

B

1

2

1725-27441-006/A
12V 6.25A

Connecting a Polycom EagleEye Director to a Polycom RealPresence Group
500 system:

A

14

B

Polycom, Inc.

Room Integration

Connecting a Polycom EagleEye Director to a Polycom RealPresence Group
550 system:

A
B

Connecting a Polycom EagleEye Director to a Polycom RealPresence Group
700 system:

B
A

1

1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

Polycom, Inc.

15

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Third-Party Camera as the Main or Second Camera
You can connect a third-party camera to the SDI interface of Polycom
RealPresence Group 550 systems as either the main or second camera.
Connecting a Third-Party SDI camera to a Polycom RealPresence Group 550
system:

Integrating Audio and Content
Connecting a Polycom RealPresence Group Microphone Array to a
Polycom RealPresence Group System
You can connect a Polycom RealPresence Group Series microphone array to a
Polycom RealPresence Group system using the RealPresence Group
Microphone Array Cable on page 39.
When connecting a Polycom RealPresence Group Series microphone array to
a Polycom RealPresence Group system, ensure that the cable is inserted
correctly. When connecting the cable to a microphone, the icon must be facing
up. When connecting the cable to a RealPresence Group system or Polycom
SoundStation IP 7000 phone, the icon must be facing up.

16

Polycom, Inc.

Room Integration

Connect a RealPresence Group Series microphone array to a RealPresence
Group 300system:

C

1

Connect a RealPresence Group Series microphone array to a RealPresence
Group 500system:
C

1

Connect a RealPresence Group Series microphone array to a RealPresence
Group 550 system:

Connect a RealPresence Group Series microphone array to a RealPresence
Group 700system:

Polycom, Inc.

17

Integrator’s Reference Manual for the Polycom RealPresence Group Series

1

2

3

4
C

1

2

3

100-240VAC 50/60Hz 2.3A

1

18

Polycom, Inc.

Room Integration

Connecting a Computer to a Polycom RealPresence GroupSystem
You can connect Polycom RealPresence Group series 500, 550, and 700 systems
to a computer using the HDMI Monitor Cable on page 28.
Connect a computer to a RealPresence Group 500system:

A

C

1

Connect a computer to a Polycom RealPresence Group 550 system:

A
Option 2: VGA

Option 1: HDMI
C

To connect a computer to a RealPresence Group 700 system:

A

1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

Polycom, Inc.

19

Integrator’s Reference Manual for the Polycom RealPresence Group Series

20

Polycom, Inc.

2
Cables

This section includes information about cables that can be used with a
RealPresence Group system. Please note that drawings and part numbers are
provided for reference only. Compliance information is provided for the
Restriction of certain Hazardous Substances Directive (RoHS).

Network Cables
CAT 5e LAN Cable
This cable connects a RealPresence Group system to the LAN. It has orange
RJ-45 connectors on both ends. It meets category 5e requirements and is wired
according to EIA/TIA-568B. The maximum approved length for this cable is
100 ft (30 m) on an 802 network.
Length

Part Number

RoHS Compliant

12 ft (3.6 m)

2457-23537-001

Yes

T568B Pair

Polycom, Inc.

21

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

22

Polycom, Inc.

Cables

LAN Cable
This cable connects a RealPresence Group to the LAN. It has orange RJ-45
connectors on both ends and is used with all systems. The maximum approved
length for this cable is 100 ft (30 m).
Length

Part Number

RoHS Compliant

12 ft (3.6 m)

2457-08343-001

Yes

CONN. RJ-45
( x2 )
P1

P2

PIN
#

PIN
#

1

1

2

2

3

3

4

4

5

5

6

6

7

7

8

8

PIN 8

PIN 8

P2

P1

12 FEET +/- 3"

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

Polycom, Inc.

23

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Polycom Touch Control LAN Cable
This cable connects a Polycom Touch Control device to the LAN.
Length

Part Number

RoHS Compliant

25 ft (7.62 m)

2457-26994-001

Yes

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

24

Polycom, Inc.

Cables

Keyed Peripheral Link LAN Cable
This cable connects a Polycom HDX 4000, Polycom HDX 7000, or Polycom
HDX 8000 system to its external ISDN module. This cable has light blue keyed
RJ-45 connectors on both ends.
Length

Part Number

RoHS Compliant

10 ft (3 m)

2457-09153-001

Yes

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

Polycom, Inc.

25

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Polycom Touch Control Power Adapter
This adapter connects the Polycom Touch Control device to the LAN and a
power supply (part number 2200-42740-XXX) for rooms that do not have
Power over Ethernet (PoE)

Length

Part Number

RoHS Compliant

2.1 ft (.61 m)

2457-40054-001

Yes

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

26

Polycom, Inc.

Cables

Video and Camera Cables

Polycom, Inc.

27

Integrator’s Reference Manual for the Polycom RealPresence Group Series

HDMI Monitor Cable
This cable connects the RealPresence Group system HDMI output to an HDMI
monitor. It is HDMI to male HDMI.

Length

Part Number

RoHS Compliant

6 ft (1.8 m)

2457-28808-004

Yes

1829.5±50

P2

P1
2

1

18

19
7.0 REF
SEE NOTE 7

19

WIRING LIST
SIGNAL

P1

P2

TMDS Data2+

1

1

TMDS Data2 Shield

2

2

TMDS Data2-

3

3

TMDS Data1+

4

4

TMDS Data1 Shield

5

5

TMDS Data1-

6

6

TMDS Data0+

7

7

TMDS Data0 Shield

8

8

TMDS Data0-

9

9

TMDS Clock+

10

10

TMDS Clock Shield

11

11

TMDS Clock-

12

CABLE
UNIT

TIP
D1

DRAIN

D2

DRAIN

RING
TIP
RING
TIP
D3

DRAIN

D4

DRAIN

RING
TIP

12

13

13

E1

14

14

E2

SCL

15

15

SDA

16

16

DDC/CEC GROUND

17

17

E3

18

E4

19

E5

18

Hot Plug Detect
Cable Shield

19
SHELL

SHELL

1

2
DETAIL A
SCALE 3.000

RING

CEC
RESERVED

+5 Volts

18

CONDUCTOR

F

TIP
RING

B

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

28

Polycom, Inc.

Cables

HDCI Analog Camera Cable
This cable connects a system to a Polycom EagleEye HD, Polycom EagleEye II,
Polycom EagleEye III, or Polycom EagleEye Director. This cable can be
connected to the EagleEye View camera, but does not support audio. It has
male HDCI connectors on both ends. Note that this cable is not compatible
with the Polycom HDX Tracker camera.The over-mold connectors of the
2457-27453-001 and 2457-27454-001 cables are black.

Polycom, Inc.

Length

Part Number

RoHS Compliant

3 ft 7 in (1.1 m)

2457-27453-001

Yes

6 ft 3 in (1.9 m)

2457-27454-001

Yes

9 ft 10 in (3 m)

2457-23180-003

Yes

9 ft 10 in (3 m)

2457-65015-003

Yes

33 ft (10 m)

2457-65015-010

Yes

33 ft (10 m)

2457-23180-010

Yes

50 ft (15 m)

2457-23180-015

Yes

100 ft (30 m)

2457-23180-030

Yes

29

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

30

Polycom, Inc.

Cables

HDCI Polycom EagleEye Director Cable
This cable connects a Polycom EagleEye II or Polycom EagleEye III camera to
the Polycom EagleEye Director base. It has male HDCI connectors on both
ends.

Length

Part Number

RoHS Compliant

1 ft (0.3 m)

2457-26122-001

Yes

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

Polycom, Inc.

31

Integrator’s Reference Manual for the Polycom RealPresence Group Series

As shown in the following figure, the EagleEye Director has seven
microphones embedded in the base.
Vertical Mic Top

Vertical Mic Center

Horizontal Mic Left
Horizontal Mic Right
Horizontal Mic Left Center
Horizontal Mic Right Center
Horizontal Mic Center

32

Polycom, Inc.

Cables

Polycom HDX Tracker Cable
This cable connects a Polycom HDX system to a Polycom HDX Tracker
camera. It has gray overmolds and male HDCI connectors on both ends.
Note that this cable is also compatible with the Polycom EagleEye camera.

Polycom, Inc.

Length

Part Number

RoHS Compliant

9 ft 10 in (3 m)

2457-25642-001

Yes

33 ft (10 m)

2457-26453-001

Yes

33

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

34

Polycom, Inc.

Cables

HDCI Camera Break-Out Cable
This cable breaks out the HDCI camera cable video and control signals to
standard interfaces. This cable can be connected to the EagleEye View camera,
but does not support audio. The five BNC connectors can be used to carry
composite and digital video composite video, S-Video, or analog component
YPbPr video. The DB-9 connector is used to connect to PTZ camera control
interfaces. It is male HDCI to five female BNC and one female DB-9.

Length

Part Number

RoHS Compliant

1ft (0.3 m)

2457-23521-001

Yes

Universal Breakout Cable

3 x BNC

Composite
Red
Green
Blue

Video Output
Svideo
Component
C

C

Y

Pr
Y
Pb

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

Polycom, Inc.

35

Integrator’s Reference Manual for the Polycom RealPresence Group Series

HDCI Polycom EagleEye 1080 Camera Cable
This cable connects a Polycom system HDCI video input to the Polycom
EagleEye 1080 camera. It is HDCI to 8-pin mini-DIN and HD-15. The
maximum approved length for this cable is 100 ft (30 m).
Length

Part Number

RoHS Compliant

1 ft (0.3 m)

2457-23548-001

Yes

9 ft 10 in (3 m)

2457-28153-001

Yes

33 ft (10 m)

2457-28154-001

Yes

50 ft (15m)

2457-28154-050

Yes

100 ft (30m)

2457-28154-100

Yes

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.
36

Polycom, Inc.

Cables

HDCI Polycom EagleEye View Camera Cable
This cable connects a RealPresence Group system HDCI video input to a
Polycom EagleEye View camera. It has male HDCI connectors on both ends.
The over-mold connectors of the 2457-09729-001 cable are brown.

Length

Part Number

RoHS Compliant

1.5 ft (457 mm)

2457-09729-001

Yes

9 ft 10 in (3 m)

2457-29759-001

Yes

33 ft (10 m)

2457-29759-010

Yes

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

Polycom, Inc.

37

Integrator’s Reference Manual for the Polycom RealPresence Group Series

VGA Cable
This cable connects a RealPresence Group 550 system VGA video input to a
VGA camera.
Length

Part Number

RoHS Compliant

5000mm

2457-32613-003

Yes

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

38

Polycom, Inc.

Cables

Audio Cables
RealPresence Group Microphone Array Cable
This cable connects two RealPresence Group microphone arrays. This cable
can also be used to connect a RealPresence Group system to a RealPresence
Group microphone array or to a SoundStation IP 7000 phone.

Length

Part Number

RoHS Compliant

25 ft (7.6 m)

2457-23216-002

Yes

10 ft (3 m)

—

Yes

6 ft (1.8 m)

—

Yes

7600±50

P1

P2

BROWN HEAT-SHRINK TUBING
A

B

5.5
SEE NOTE 6

WIRING LIST
P1

P2

10

2

14

6

2

10

CABLE
UNIT

CONDUCTOR

TWISTED
PAIR #1

2
2

1
1

6

14

TWISTED
PAIR #2

13

13

CONDUCTOR #1

9

9

CONDUCTOR #2

-

3

3

DRAIN

-

SHIELD

SHIELD

SHIELD

-

P1

P1

CABLE
UNIT

-

4

13

JUMPER #1

-

P2

P2

CABLE
UNIT

-

4

13

JUMPER #2

-

-

PINS 1, 5, 7, 8, 11 AND 12 OF
P1 & P2 ARE NOT USED AND SHALL BE
LEFT OPEN.

Polycom, Inc.

39

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

40

Polycom, Inc.

Cables

Custom Cabling for Polycom RealPresence Group Microphone Arrays
You can create a custom-length cable that connects a RealPresence Group
system to a RealPresence Group microphone array or SoundStation IP 7000
phone. Start with the microphone cable (part number 2457-23216-002), and cut
off the P1 end. Using the wiring tables shown, create a custom cable from the
microphone to a wall plate or other interfacing device. Next, from the wall
plate or other interfacing device, run shielded CAT5 or better cable to the
RealPresence Group system, terminating with a shielded RJ-45 plug
connector.
The total length from the RealPresence Group system to the first Polycom
microphone array or SoundStation IP 7000 phone can vary between 18 in and
100 ft. The maximum length between subsequent microphone arrays is 25 ft.
The following diagram shows an example of longer custom cabling from a
RealPresence Group system to a Polycom microphone array or a Polycom
SoundStation IP 7000 Phone.
.

CAT5 Shielded Cable

RealPre

sence

Group

Interfacing Device
such as a Wall Plate

500

Cut and Re-terminated
Polycom RealPresence
Microphone Array Cable

Polycom RealPresence
Microphone Array Cable

The following steps explain how to wire this custom cable configuration.
Refer to Connecting a Polycom RealPresence Group Microphone Array to a
Polycom RealPresence Group System on page 16 for instructions on how to use
the icons on the RealPresence Microphone Array Cable to ensure the cable is
connected correctly.

1

Polycom, Inc.

Identify the P1 connector on the Polycom RealPresence microphone cable
according to the location of the brown heat-shrink tubing as shown on
RealPresence Group Microphone Array Cable on page 39. Remove the P1
connector and skip to step 4. Note that two separate vendors manufacture

41

Integrator’s Reference Manual for the Polycom RealPresence Group Series

these cables, which are electrically equivalent but have different color
coding. If you cannot identify the P1 connector, remove either connector
from the cable and continue with step 2.
The following tables show the color coding for the cable wiring.
VENDOR 1
AWG P1
COLOR
28
RED
10
28
ORANGE
14
28
YELLOW
2
28
GREEN
6
24
WHITE
13
24
BLACK
9
DRAIN WIRE
3
SHIELD
SHELL

VENDOR 2
P2
2
6
10
14
13
9
3
SHELL

P1, P2 - Walta Electronics, M30-558-0051

P1, P2 - Walta Electronics, M30-558-0051

2

If you are not sure which connector you need to cut off, use the following
tables to perform a continuity check between the connector and the cable
colors. If you cut off P1, skip to step 4. If you cut off P2, continue with step
3.
VENDOR 1, P1

VENDOR 2, P1

AWG P1
COLOR
10
28
RED
14
28
ORANGE
2
28
YELLOW
28
6
GREEN
24
13
WHITE
9
24
BLACK
3
DRAIN WIRE
SHELL
SHIELD

P1
AWG
COLOR
10
28
BLUE
14
28
YELLOW
2
28
ORANGE
6
28
GREEN
13
24
BLACK
9
24
WHITE
3
DRAIN WIRE
SHELL
SHIELD

P1 - Walta Electronics, M30-558-0051

P1 - Walta Electronics, M30-558-0051

VENDOR 1, P2

VENDOR 2, P2
P2
AWG
COLOR
2
28
BLUE
6
28
YELLOW
10
28
ORANGE
14
28
GREEN
13
24
BLACK
9
24
WHITE
3
DRAIN WIRE
SHELL
SHIELD

P2
AWG
COLOR
2
28
RED
6
28
ORANGE
10
28
YELLOW
14
28
GREEN
13
24
WHITE
9
24
BLACK
3
DRAIN WIRE
SHELL
SHIELD
P2 - Walta Electronics, M30-558-0051

3

P2 - Walta Electronics, M30-558-0051

If you cut off P2, re-terminate the cable with a shielded RJ-45 connector
using the following tables, then skip to step 5.
VENDOR 2, P1

VENDOR 1, P1
AWG P1
COLOR
10
28
RED
14
28
ORANGE
2
28
YELLOW
6
28
GREEN
13
24
WHITE
9
24
BLACK
3
DRAIN WIRE
SHELL
SHIELD
P1 - Walta Electronics, M30-558-0051
P2 - RJ-45 shielded plug, Tyco 5-569552 or equivalent

42

P2
2
6
10
14
13
9
3
SHELL

COLOR
AWG P1
BLUE
10
28
YELLOW
14
28
ORANGE
2
28
GREEN
6
28
BLACK
13
24
WHITE
9
24
DRAIN WIRE
3
SHIELD
SHELL

P2
5
6
1
2
7
8
3
SHELL

P1
AWG
COLOR
10
28
BLUE
14
28
YELLOW
2
28
ORANGE
6
28
GREEN
13
24
BLACK
9
24
WHITE
3
DRAIN WIRE
SHELL
SHIELD

P2
5
6
1
2
7
8
3
SHELL

P1 - Walta Electronics, M30-558-0051
P2 - RJ-45 shielded plug, Tyco 5-569552 or equivalent

Polycom, Inc.

Cables

4

If you cut off P1, re-terminate the cable with an RJ-45 8-pin plug using the
following tables, then continue with step 5.
VENDOR 1
AWG P1
COLOR
28
RED
1
28
ORANGE
2
28
YELLOW
5
28
GREEN
6
24
WHITE
7
24
BLACK
8
DRAIN WIRE
3
SHIELD
SHELL
P1- RJ-45 shielded plug, Tyco 5-569552 or equivalent
P2 - Walta Electronics, M30-558-0051

VENDOR 2
P2
2
6
10
14
13
9
3
SHELL

AWG P1
COLOR
28
BLUE
1
28
YELLOW
2
28
ORANGE
5
28
GREEN
6
24
BLACK
7
24
WHITE
8
DRAIN WIRE
3
SHIELD
SHELL

P2
2
6
10
14
13
9
3
SHELL

P1- RJ-45 shielded plug, Tyco 5-569552 or equivalent
P2 - Walta Electronics, M30-558-0051

Whether you re-terminated the P1 or P2 end of the cable, at this point the cable
can be connected directly to the system and to the first microphone. If it is
necessary to install an extension to the system’s RJ-45 connection on a wall
plate or panel, create a custom pinout cable using shielded CAT5 cable. The
cable is terminated on one end to either a shielded CAT5 keystone jack or, if
using a shielded panel coupler, a shielded RJ-45 plug connector. The other end
terminates to a shielded RJ-45 plug that connects to the RealPresence Group
system.
The Polycom RJ-45 connector pinout is custom. For best performance, follow
the wiring tables shown in this document. If standard Ethernet cables are used,
signal integrity cannot be guaranteed and degraded performance may occur,
especially at longer lengths.

Polycom, Inc.

43

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Audio Cable
This cable connects a system to an external audio system. It has dual RCA
connectors (red/white) on both ends. The maximum approved length for this
cable is 100 ft (30 m).

Length

Part Number

RoHS Compliant

25 ft (7.6 m)

2457-09212-002

Yes

9 ft 10 in (3 m)

2457-09212-010

Yes

RED INSULATION (2X)
WHITE INSULATION (2X)

RED

RED

WHT

WHT

6 IN. ± 0.5 IN.
(2X)

OVER MOLD "RCA" CONNECTORS

25 FEET +/- 3"

RED

RED

WHT

WHT

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

44

Polycom, Inc.

Cables

3.5 mm Stereo Cable
This cable connects a Polycom HDX 4000 system to computer audio.It has
3.5 mm stereo jack connectors on both ends.

Length

Part Number

RoHS Compliant

4 ft 6 in (1.5 m)

2457-24648-002

Yes

1500.0 +/- 25.0
SLEEVE

3.5 mm
STEREO PLUG
2X
Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

Polycom, Inc.

45

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Polycom EagleEye Director Audio Feedback Phoenix to
RCA Cable
This cable connects a RealPresence Group system to the Polycom EagleEye
Director and the room audio playback system. It is dual male Phoenix
connectors (for RealPresence Group systems) to dual male RCA connectors
(for the EagleEye Director) with dual female RCA connectors (for the room
audio playback system).

Length

Part Number

RoHS Compliant

9.10 ft (3 m)

2457-82587-001

Yes

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

46

Polycom, Inc.

Cables

Serial Cables
Polycom RealPresence Group Series Serial cable
This cable connects a Polycom RealPresence Group system to a serial device.
It is 8-pin mini-DIN to DB-9.

Polycom, Inc.

•

The 8-pin mini-DIN RS232 connection is wired per Polycom RS232 and does
not follow VISCA pinout convention. Do NOT try to use a cable meant to
support VISCA in this application as it will not work correctly.

•

Do not use this adapter DIRECTLY CONNECTED to multi-purpose AMX serial
ports. AMX systems support both RS-232 and RS-422. Therefore, for the most
reliable RS-232 support with this adapter, use an additional null modem
cross-over cable in-line that only carries only pins 2, 3, and 5, with pins 2 and
3 crossed.

Length

Part Number

RoHS Compliant

10 ft (3 m)

2457-63542-001

Yes

47

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Straight-Through Serial Cable
Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

This cable connects a RealPresence Group system to a serial device. It has a
DB-9 connector on each end. The maximum approved length for this cable is
100 ft (30 m).
Polycom does not recommend using this straight-through serial cable for
RS-232 communication from a computer, Crestron system, or AMX device.
Instead, for RS-232 communication, Polycom recommends using a cross-over
cable with pin 2 wired to pin 3, pin 3 wired to pin 2, and pin 5 wired to pin 5. The
other pins are not used.
If you choose to use this straight-through serial cable for RS-232 communication
from a computer or Crestron system, the Null Modem Adapter on page 50 is
required. However, the null modem adapter does not work for RS-232
communication from AMX devices and causes problems if you try to use it.

48

Length

Part Number

RoHS Compliant

25 ft (7.6 m)

2457-09172-001

—

Polycom, Inc.

Cables

Polycom, Inc.

49

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Null Modem Adapter
This adapter is used when connecting RealPresence Group 700 system to a
serial device that transmits on pin 3 such as Crestron Pro2 processor. It is a
male to female DB-9 adapter plug.
Do not use this adapter with an AMX device. AMX systems support both RS-232
and RS-422. Therefore, for RS-232 support, use a null modem cross-over cable
that carries only pins 2, 3, and 5, with pins 2 and 3 crossed.

Length

Part Number

RoHS Compliant

—

1517-61577-001

Yes

DB9F
PIN 1&6
PIN 2
PIN 3
PIN 4
PIN 5
PIN 7
PIN 8
PIN 9

DB9M
PIN 4
PIN 3
PIN 2
PIN 1&6
PIN 5
PIN 8
PIN 7
N/C

Drawings and part numbers are provided for reference only. Polycom claims no
responsibility or liability for the quality, performance, or reliability of cables
based on these reference drawings, other than cables provided by Polycom.
Contact your Polycom distributor or Polycom Custom/Vertical Products to order
cables that meet the appropriate manufacturing tolerances, quality, and
performance parameters for your application.

50

Polycom, Inc.

3
Using the API

The Application Programming Interface (API) is a set of commands for
advanced users who want to automate a Polycom RealPresence Group system.
You can use the API by connecting a control system or computer RS-232 serial
port to a Polycom RealPresence Group system. You can also use Telnet over
the LAN to use the API with Polycom RealPresence Group systems.
For this release of the Polycom RealPresence Group 550 systems, you can only
use Telnet over the LAN to use the API commands. The RS-232 port of the
Polycom RealPresence Group 550 systems is intended for SDI camera control
only.

Using the API with an RS-232 Interface
If you use an RS-232 interface to send API commands, you must connect and
configure the control system or computer and the Polycom RealPresence
Group system for serial communication.
This feature is not available to this release of the Polycom RealPresence Group
550 systems.

Configuring the RS-232 Interface
If you use the API with a serial connection, make sure that the RS-232
interfaces of the Polycom RealPresence Group 300, 500, and 700 system and
your computer are configured appropriately.
To access the RS-232 settings on your system, go to Admin Settings > General
Settings > Serial Port from the web interface.

Polycom, Inc.

51

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Configure the Baud Rate and RS-232 Mode options as follows:
Configure this way on the
Polycom RealPresence
Group system

Option

Configure this way on your
computer

Baud Rate

Must be the same rate for both devices. Available rates are:

RS-232 Mode

•

9600

•

14400

•

19200

•

38400

•

57600

•

115200

—

Control
Camera control

The RS-232 port on the Polycom RealPresence Group 300, 500, and 700 system
supports Control mode. In Control Mode, a device (for example, a computer)
connected to the RS-232 port can control the system using the API.

52

Polycom, Inc.

Using the API

Understanding the RealPresence Group Series RS-232 Interfaces
The serial ports on Polycom RealPresence Group 300 and Real Presence Group
500 systems are mini-DIN-8 connectors.

1

2

1725-27441-006/A
12V 6.25A

Use an 8-pin mini-DIN to DB-9 cable such as the Polycom RealPresence Group
Series Serial cable on page 47 to connect to the RS-232 interface. The pinouts
for this type of cable are listed in the following table:

The serial port on a Polycom RealPresence Group 700 system is a DB-9
connector:

1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

Polycom, Inc.

53

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Use a DB-9 to DB-9 cable such as the Straight-Through Serial Cable on page 48
to connect to the RS-232 interface. The pinouts for this type of cable are listed
in the following table:

Starting an API Session using an RS-232 Interface
Polycom RealPresence Group 300, 500, and 700 systems can run API sessions
from the RS-232 interface.
After you have verified that the Polycom RealPresence Group system and
your computer or control system are both configured appropriately, set up
both devices as follows:
1

54

Power off the computer or control system and the Polycom RealPresence
Group system.

Polycom, Inc.

Using the API

2

Use an RS-232 cable to connect the computer or control system RS-232
port to an RS-232 port on the Polycom RealPresence Group 300, 500, or
700 systemas shown in the following illustrations. This connection may
require the Null Modem Adapter on page 50.
To connect a computer to a Polycom RealPresence Group 300 system:

1

2

1725-27441-006/A
12V 6.25A

To connect a computer to a Polycom RealPresence Group 500 system:

1

2

1725-27441-006/A
12V 6.25A

To connect a control system to a Polycom RealPresence Group 700 system:

IOIOIO
1

2

3

4

1

2

3

100-240VAC 50/60Hz 2.3A

Polycom, Inc.

3

Power on the computer or control system and the Polycom RealPresence
Group system.

4

From the computer or control system, start a serial session using
HyperTerminal or another appropriate utility.

55

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Using the API with the Maximum Security Profile Enabled
You must log in with a password to start an RS-232 session if the system is
configured with the Security Profile set to Maximum. You can log in with
either the Admin ID and Admin Remote Password or the User ID and User
Remote Password of the Polycom RealPresence Group system. In software
version 4.1.1, you must be logged in using the Admin ID in order to use the
API commands.
For more information about the Security Profile, refer to the Security
Deployment Guide for Polycom RealPresence Group Systems.

Using the API with a LAN Connection
If you have a computer connected to the LAN, you can send API commands
to the Polycom RealPresence Group system through telnet port 24.
If your computer is running the Windows 7 operating system, you might need to
install the telnet client before starting a telnet session. The telnet client is not
installed by default with Microsoft Windows 7 operating systems.

1

On the computer, open a command line interface.

2

Start a Telnet session using the Polycom RealPresence Group system IP
address and port number — for example, telnet 10.11.12.13 24.

Using the API Controller Code
In cooperation with the leading touch panel controller manufacturers,
Polycom provides its own version of controller code designed to run on a
Crestron control system. It provides a fully executable controller program but
also serves as a guideline for ongoing development using Polycom preferred
methodology and commands.

Additional API Resources
The following online resources are available for your reference as you use the
API.

Technical Support Contact Information
To contact Polycom Technical Support, go to support.polycom.com. This web
site provides you with contact information for Polycom technical support. Use
this web site when you need help using the API.

56

Polycom, Inc.

Using the API

Feature Enhancement Request Web Site
Go to support.polycom.com and navigate to Feature Request. This web site
allows you to submit suggestions for feature enhancements. Use this web site
when you have requests for future development of the Polycom API.

Video Test Numbers
Refer to www.polycom.com/videotest. This web site provides you with test
numbers of various Polycom systems worldwide. Use this web site when you
need to access video test numbers to use when testing your Polycom system.

Knowledge Base
Refer to the Knowledge Base at support.polycom.com. This tool allows you to
search for user guides, release notes, and other forms of product
documentation. You can also search for troubleshooting information and
technical briefs. Use this web site when you need to access Polycom product
documentation or tips.

Polycom, Inc.

57

Integrator’s Reference Manual for the Polycom RealPresence Group Series

58

Polycom, Inc.

4
System Commands

This chapter describes the API commands for RealPresence Group software
version 4.1.1.
For an alphabetical list of all the commands, refer to the table of contents for
this document. For a list of commands by category, refer to Categorical List of
API Commands on page 265.

About the API Commands
Syntax Conventions
The following conventions are used for the API command descriptions in this
chapter. All of the commands are case sensitive.
Convention

Meaning



Multiple valid parameters are enclosed in angle brackets and separated by
the pipe (“|”) character.
Example: allowdialing  shows that the allowdialing
command must be followed by one of the parameters listed.

[param]
[“param”]

Optional parameters are enclosed in square brackets. Quotation marks
indicate strings to be supplied by the user.
Example: teleareacode set ["telephone_area_code"] shows that you can
supply a value for the area code, or omit it and let the default value apply.
You do not need to enclose the actual value in quotes unless it contains a
space.

Polycom, Inc.

59

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Convention

Meaning

{a..z}

A range of possible alphanumeric values is enclosed in braces.
Example: abk letter {a..z} shows that the abk command can be used to
return address book entries that begin with an alphanumeric character in
the range specified.
Example: camera near {1..4} shows that the camera command can be
used to select Camera 1, 2, 3, or 4 at the near site.

“x”

Quotation marks indicate strings to be supplied by the user. You do not
need to enclose the value in quotes unless it contains a space.

Although the API command parser may accept the minimum number of
characters in a command that makes it unique, you should always use the full
command string.

Availability of Commands
The availability of API commands depends on the type of system optional
equipment installed or connected, security settings and the software version
installed on the system. If a particular command is not supported on the
system, the command returns feedback such as “error: this command is not
supported on this model” or “command is not available in current system
configuration”. If a setting is configured by a provisioning service, the
command may return feedback such as “this setting is controlled by a
provisioning service and cannot be changed. For more information about
provisioned settings, refer to your provisioning service
administrator.”

Deprecated commands are included for backward compatibility only and are
not recommended for use with this version. Suitable replacements are noted
for each deprecated command.
Commands that are not listed in this chapter are not supported by Polycom.
Commands might change or be removed at any time. Polycom discourages
integrators from using unpublished commands.

API support is not available for software versions for the Joint Interoperability
Test Command (JITC) certification.

60

Polycom, Inc.

System Commands

Command Response Syntax
When you send a command, the system returns responses using the syntax
described in the following sections, where  indicates a carriage return
and  indicates a line feed.
The end of line (EOL) character for the echo is different for serial and LAN
responses. The feedback examples below and elsewhere in the Integrator’s
Reference Manual are based on the serial response.

When Not Registered to Receive Notifications
When your system is not registered to receive any notifications and you send
an API command, a single API acknowledgement is returned.
For example:
camera near 2 API command

returns

camera near 2API acknowledgement

In the example above, the command was sent with an end of line character of
a carriage return .
The API expects a carriage return  as well as the standard end of line
characters carriage return/line feed . All API responses end in
carriage return/line feed .

When Registered to Receive Notifications
Registering for notifications adds extra line responses in the form of API
registration responses. The number of additional lines depends on the specific
registration. In the following example, the response shows an API
acknowledgement and an API registration response returned.
•

camera near 1 API command

returns

camera near 1API acknowledgement
notification:vidsourcechange:near:1:Main:people

API registration response
When your system is registered for notifications, always use the API
registration response for status.

Commands that Restart the System
Commands that Restart the System with a Prompt
•
Polycom, Inc.

reboot
61

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Commands that Restart the System without a Prompt
•

reboot now

•

resetsystem

•

The system does not provide flow control. If the connection is lost through
restarting the system or other means, you must re-establish the
connection.

•

The API processes one command at a time.

•

Polycom does not recommend sending multiple commands
simultaneously without a pause or delay between them.

•

For commands with a single action and a single response: A delay of
200 milliseconds between commands is usually sufficient. Examples of
these commands include the commands for switching cameras (camera
near 1), sending content (vcbutton play), and checking the status of the
audio mute (mute near get).

•

For commands with a single action and a more extensive response: The
time required to receive the response, and thus the time between
commands, may be longer than 200 milliseconds. The response length,
which can vary in size, determines the time required to receive the
response. Examples of these commands include the commands for
retrieving the local address book (addrbook all), the global address book
(gaddrbook all), the list of system settings, and system session
information (such as whoami).

•

When developing your program, always allow enough time for the
response to the requested command to complete before sending another
command.

•

Do not send any commands while an incoming or outgoing call is being
established.

•

The API provides feedback status in two ways: registrations or polling.

•

It is only required that you send registration and notification API
commands once, because the registrations become written into Flash
memory and are retained even upon restarting the system.

•

Polycom recommends putting registrations in the initialization or startup
of Crestron and AMX systems.

•

Registrations are recommended over polling since they will provide status
updates without having to query for changes.

•

Never poll for registrations.

•

Registrations are specific to the port from which they are registered. If you
register for notifications from com port 1, registration will not be sent to
com port 2 or Telnet port 24.

Additional Tips

62

Polycom, Inc.

System Commands

addrbook
Returns local directory (address book) entries.

Syntax
Commands for local directory
addrbook
addrbook
addrbook
addrbook
addrbook
addrbook

all
batch {0..59}
batch search “pattern” “count”
batch define “start_no” “stop_no”
letter {a..z}
range “start_no” “stop_no”

Commands for LDAP only
addrbook names  [] []
addrbook names  size
addrbook names search "search_pattern" 
[] []
addrbook names search "search_pattern"  size
addrbook group "group_name" [] []
addrbook group "group_name" size
addrbook address "sys_name" ["sys_label"]

Parameter

Description

all

Returns all the entries in the local directory.

batch

Returns a batch of 10 local directory entries. Requires
a batch number, which must be an integer in the
range {0..59}.

search

Specifies a batch search.

“pattern”

Specifies a pattern to match for the batch search.

“count”

Specifies the number of entries to list that match the
pattern.

define

Returns a batch of entries in the range defined by
“start_no” to “stop_no.”

letter

Returns entries beginning with the letter specified
from the range {a..z}. Requires one or two
alphanumeric characters. Valid characters are:
- _ / ; @ , . \
0 through 9
a through z

Polycom, Inc.

63

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Parameter

Description

range

Returns local directory entries numbered
“start_no” through “stop_no”. Requires two
integers.

“start_no”

Specifies the beginning of the range of entries to
return.

“stop_no”

Specifies the end of the range of entries to return.

names

Returns a list of system names in the local address
book. Also returns the system type: video,
multicodec, phone, or multisite. A multi-codec
system will appear as a single row.
The response is in the following format:
addrbook names {0..n}. name:"sys_name"
sys_label:"sys_label"
type:

...
addrbook names  done



Specifies the type of entries to return. video returns
entries that have video addresses. all returns
entries with video numbers or phone numbers or
both.

size

Returns the size of the result set that will be returned
by the command. The size parameter can be used
with the names and the names search commands.
The response is in the following format:
addrbook names  size {0..n}
addrbook names search "search_pattern"
 size {0..n}

64

range_start

For the names, names search, and group commands,
specifies the beginning of the range of entries to
return.

range_end

For the names, names search, and group commands,
specifies the end of the range of entries to return. If a
range_start is specified without a range_end, then
the single range_start entry will be returned. If
range_end is -1, all entries starting with range_start
will be returned.

Polycom, Inc.

System Commands

Parameter

Description

search

Returns a list local directory names that match the
search criteria.
The response is similar to the names command
described above:
addrbook search {0..n}. name:"sys_name"
sys_label:"sys_label"
type:

...
addrbook names search "search_pattern"
 done

search_pattern

Specifies the string pattern for which to search.
Wildcard characters are not supported. The search
string is used to match the beginning of any of the
attributes listed in the “names search” parameter
description above. For example, the search string
“Jo” would match any name that begins with Jo, such
as John or Jones. The search is not case sensitive.

group

Returns a list of the names of all the sites included in
a local directory group in this format:
addrbook group {0..n}. name:"site_sys_name"
sys_label:"site_sys_label"
...
addrbook group "group_name" [range] done
addrbook group size 

Polycom, Inc.

group_name

A local address book group name.

address

Obtains the address information for a specified entry.
If the entry is an ITP system, the results will include
the addresses for all codecs. If codecs support
multiple protocols, the different addresses will be
returned on separate lines. This command is not
supported for multisite entries.

sys_name

The friendly name for an address book entry. It is the
name of the person or the room. It is surrounded by
quotes if it contains spaces.

sys_label

If a person/room has more than one system, the
result set will include a row for each system. If those
systems are of the same type the client will consider
that entry to be a telepresence system with multiple
codecs rather than separate systems. If the systems
are of different types, then this sys_label attribute will
be included to differentiate the systems.

65

Integrator’s Reference Manual for the Polycom RealPresence Group Series

Parameter

Description

type

The type of local address book entry. Possible values
are:
video, multicodec, phone, group

site_sys_name

The name of a site in a group. It is surrounded by
quotes if it contains spaces

site_sys_label

The label associated with a site name in a local
group. It is surrounded by quotes if it contains
spaces.

codec:<1..4>

If the entry is a telepresence system, each codec will
include a codec number attribute.

h323_spd

The preferred speed for an H.323 call to this entry. If
no speed is associated with the entry, then the value
of the configuration variable "globaladdrmaxh323" is
returned. The default is 384.

h323_num

H.323 address or alias.

h323_ext

H.323 extension or E.164 number.

sip_spd

The preferred speed for a SIP call to this entry. If no
speed is associated with the entry, then this is the
same as the h323_spd.

sip_num

IP address.

xmpp_addr

XMPP address, also known as the Jabber ID (JID).

Feedback Examples
•

addrbook all

returns
addrbook 0. “Polycom Group Series Demo 1” isdn_spd:384
isdn_num:1.700.5551212 isdn_ext:
addrbook 1. “Polycom Group Series Demo 2” h323_spd:384
h323_num:192.168.1.101 h323_ext:7878
addrbook 2. “Polycom Group Series Demo 3” sip_spd:384
sip_num:polycomgroupseries@polycom.com
addrbook 3. “Polycom Group Series Demo 3” phone_num:1.512.5121212
(and so on, until all entries in the local directory are listed,
then:)
addrbook all done

•

addrbook batch 0

returns
addrbook 0. “Polycom Group Series Demo 1” isdn_spd:384
isdn_num:1.700.5551212 isdn_ext:
addrbook 1. “Polycom Group Series Demo 2” h323_spd:384

66

Polycom, Inc.

System Commands

h323_num:192.168.1.101 h323_ext:7878
addrbook 2. “Polycom Group Series Demo 3” sip_spd:384
sip_num:polycomgroupseries@polycom.com
addrbook 3. “Polycom Group Series Demo 3” phone_num:1.512.5121212
(and so on, through the last entry in the batch of 10 directory
entries, such as:)
addrbook 9. “Polycom Group Series Demo 20” h323_spd:384
h323_num:192.168.1.120 h323_ext:
addrbook batch 0 done

•

addrbook batch define 0 2

returns
addrbook 0. “Polycom Group Series Demo 1” isdn_spd:384
isdn_num:1.700.5551212 isdn_ext:
addrbook 1. “Polycom Group Series Demo 2” h323_spd:384
h323_num:192.168.1.101 h323_ext:7878
addrbook 2. “Polycom Group Series Demo 3” sip_spd:384
sip_num:polycomgroupseries@polycom.com
addrbook batch define 0 2 done

•

addrbook names all size

returns
addrbook names all size 21

•

addrbook names all size 21

returns
addrbook names all size 21
addrbook names 0. name:"Eng RPX" sys_label:"Group Series"
type:multicodec
addrbook names 1. name:"Fulton" sys_label:"" type:video
addrbook names 2. name:"Gen Group" sys_label:"" type:group
addrbook names 3. name:"Geno Alissi" sys_label:"" type:video
addrbook names 4. name:"Joseph Sigrist" sys_label:"" type:video
addrbook names 5. name:"Lab TPX" sys_label:"" type:video
addrbook names 6. name:"Minuteman RPX" sys_label:"" type:multicodec
addrbook names 7. name:"Monday Staff Mtg" sys_label:"" type:group
addrbook names 8. name:"Polycom Austin Stereo" sys_label:""
type:video
addrbook names 9. name:"Polycom Austin HD" sys_label:"" type:video
addrbook names all 0 9 done

•

addrbook names all

returns
addrbook
addrbook
addrbook
addrbook
addrbook
addrbook
addrbook
addrbook
addrbook

Polycom, Inc.

names
names
names
names
names
names
names
names
names

0. name:"Eng RPX" sys_label:"HDX" type:multicodec
1. name:"Fulton" sys_label:"" type:video
2. name:"Gen Group" sys_label:"" type:group
3. name:"Geno Alissi" sys_label:"" type:video
4. name:"Joseph Sigrist" sys_label:"" type:video
5. name:"Lab TPX" sys_label:"" type:video
6. name:"Minuteman RPX" sys_label:"" type: multicodec
7. name:"Monday Staff Mtg" sys_label:"" type:group
8. name:"Polycom Austin Stereo" sys_label:""
67

Integrator’s Reference Manual for the Polycom RealPresence Group Series

type:video
addrbook names
addrbook names
type:video
addrbook names
addrbook names
addrbook names
addrbook names
addrbook names
addrbook names
addrbook names
addrbook names
addrbook names
addrbook names
addrbook names

•

9. name:"Polycom Austin HD" sys_label:"" type:video
10. name:"Polycom Austin USA IP" sys_label:""
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
all

addrbook names search "p" all

returns
addrbook search
addrbook search
type:video
addrbook search
type:video
addrbook search
addrbook search
addrbook search
addrbook search

•

0. name:"Polycom Austin HD" sys_label:"" type:video
1. name:"Polycom Austin Stereo" sys_label:""
2. name:"Polycom Austin USA IP" sys_label:""
3. name:"Polycom Japan" sys_label:"" type:video
4. name:"Scott Phone" sys_label:"" type:phone
5. name:"Scott PVX" sys_label:"" type:video
search p all done

addrbook names search "p" all 0 2

returns
addrbook search
addrbook search
type:video
addrbook search
type:video
addrbook search

•

0. name:"Polycom Austin HD" sys_label:"" type:video
1. name:"Polycom Austin Stereo" sys_label:""
2. name:"Polycom Austin USA IP" sys_label:""
search p all 0 2 done

addrbook group "Monday Staff Mtg"

returns
addrbook
addrbook
addrbook
addrbook
addrbook

•

name:"Polycom Japan" sys_label:"" type:video
name:"Scott CMAD IP" sys_label:"" type:video
name:"Scott Phone" sys_label:"" type:phone
name:"Scott PVX" sys_label:"" type:video
name:"Scott Quasar 19" sys_label:"" type:video
name:"SQA Group Series" sys_label:"" type:video
name:"Sunil Bhalla" sys_label:"" type:video
name:"Test System 1" sys_label:"" type:video
name:"Test System 2A" sys_label:"" type:video
name:"Test System 2B" sys_label:"" type:video
done

group
group
group
group
group

0. name:"Eng RPX" sys_label:"HDX"
1. name:"Geno Alissi" sys_label:""
2. name:"Joseph Sigrist" sys_label:""
3. name:"TPW" sys_label:"HDX"
"Monday Staff Mtg" done

addrbook address "Geno Alissi"

return
addrbook address 0. name:"Geno Alissi" sys_label:"" codec:1
h323_spd:384 h323_num:172.25.137.101 h323_ext:
addrbook address name:"Geno Alissi" sys_label:"" done

68

Polycom, Inc.

System Commands

See Also
See the gaddrbook command on page 126 and speeddial command on
page 192.

Polycom, Inc.

69

Integrator’s Reference Manual for the Polycom RealPresence Group Series

advnetstats
Gets advanced network statistics for a call connection.

Syntax

advnetstats [{0..n}]

Parameter

Description

{0..n}

Specifies a connection in a multipoint call, where n is
the maximum number of connections supported by
the system. 0 is call #1, 1 is call #2, 2 is call #3, and so
on. Select a number from this range to specify a
remote site call for which you want to obtain
advanced network statistics.
Omit this parameter when retrieving statistics for a
point-to-point call.

Feedback Examples
•

advnetstats 1

returns
call:1 tar:24k rar:24k tvr:64.3k rvr:104k
tvru:63.8k rvru:114.6k tvfr:15.0 rvfr:15.0 vfe --tapl:66 rapl:0 taj:46mS raj:40mS tvpl:122 rvpl:0
tvj:21mS rvj:60mS dc:--- rsid:Polycom_4.2 ccaps:E9P

•

70

Returned parameters are:
tar=Transmit audio rate
rar=Receive audio rate
tvr=Transmit video rate
rvr=Receive video rate
tvru=Transmit video rate used
rvru=Receive video rate used
tvfr=Transmit video frame rate
rvfr=Receive video frame rate
vfe=Video FEC errors
tapl=Transmit audio packet loss (H.323 calls only)
tlsdp=Transmit LSD protocol (H.320 calls only)
rapl=Receive audio packet loss (H.323 calls only)
rlsdp=Receive LSD protocol (H.320 calls only)
taj=Transmit audio jitter (H.323 calls only)
tlsdr=Transmit LSD rate (H.320 calls only)
raj=Receive audio jitter (H.323 calls only)
rlsd=Receive LSD rate (H.320 calls only)
tvpl=Transmit video packet loss (H.323 calls only)
tmlpp=Transmit MLP protocol (H.320 calls only)
rvpl=Receive video packet loss (H.323 calls only)
Polycom, Inc.

System Commands

rmlpp=Receive MLP protocol (H.320 calls only)
tvj=Transmit video jitter (H.323 calls only)
tmlpr=Transmit MLP rate (H.320 calls only)
rvj=Receive video jitter (H.323 calls only)
rmlpr=Receive MLP rate (H.320 calls only)
dc=Encryption information
rsid=Remote system id
ccaps=Content capability, where possible responses include “9”
(H.239), “E” (enterprise dual streams), “N” (none), and “P” (content
over the people stream)

See Also
To return network statistics for a call, use the netstats command on page 165.

Polycom, Inc.

71

Integrator’s Reference Manual for the Polycom RealPresence Group Series

all register
Registers for most commonly-used user registration events.

Syntax

all register

Feedback Examples
•

all register

returns
callstate registered
camera registered
chaircontrol registered
mute registered
preset registered
screen registered
vcbutton registered
volume registered

Comments
Registers changes to any of the following types of parameters:
•

Current near-site or far-site source

•

State of privacy

•

Current volume level

•

Active camera presets

•

Status of point-to-point or multipoint calls

•

IP connection to codec

•

System information

This command is particularly useful when two different control systems are
being used simultaneously, such as the web and API commands. The system
maintains the registration changes through restarts.
To register for events not included in this feedback, refer to the specific
registration command.
This is a one time registration command that is retained in flash memory.
Sending the command a second time results in the following feedback
response:
•

info: event/notification already active:callstate
info: event/notification already active:camera
info: event/notification already active:linestate

72

Polycom, Inc.

System Commands
info: event/notification already active:mute
info:
info:
info:
info:

event/notification
event/notification
event/notification
event/notification

already
already
already
already

active:preset
active:screen
active:vcbutton
active:volume

The all register command does not return local camera movements if the
camera is moved using the remote control, the web interface, or the Polycom
Touch Control virtual remote.

Polycom, Inc.

73

Integrator’s Reference Manual for the Polycom RealPresence Group Series

all unregister
Simultaneously unregisters all registered user feedback so that the API no
longer reports changes to the parameters.

Syntax

all unregister

Feedback Examples
all unregister

returns
callstate unregistered
camera unregistered
linestate unregistered
mute unregistered
preset unregistered
screen unregistered
vcbutton unregistered
volume unregistered

Comments
The following types of parameters are unregistered:

74

•

Current near-site or far-site source

•

State of privacy

•

Current volume level

•

Active camera presets

•

Status of point-to-point or multipoint calls

•

IP connection to codec

•

System information

Polycom, Inc.

System Commands

amxdd
Sets or gets the AMX Device Discovery beacon.

Syntax

amxdd get
amxdd 

Parameter

Description

get

Returns the current setting.

on

Turns on the AMX Device Discovery beacon.

off

Turns off the AMX Device Discovery beacon.

Feedback Examples
•

amxdd get

returns
amxdd off

•

amxdd on

returns
amxdd on

Comments
The default setting for this signal is off.

Polycom, Inc.

75

Integrator’s Reference Manual for the Polycom RealPresence Group Series

answer
Answers incoming video calls.

Syntax

answer
Source Exif Data: 
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.6
Linearized                      : No
Author                          : Polycom, Inc
Create Date                     : 2013:08:05 14:56:25Z
Keywords                        : "video conferencing, videoconferencing, HDX, integration, API, cables, commands, adapters, connectors, room design, specifications"
Modify Date                     : 2013:08:08 14:10:02+08:00
Language                        : en
XMP Toolkit                     : Adobe XMP Core 5.2-c001 63.139439, 2010/09/27-13:37:26
Format                          : application/pdf
Title                           : Integrator's Reference Manual for Polycom RealPresence Group Series Systems, Version 4.1.1
Creator                         : Polycom, Inc
Description                     : Includes cable diagrams, API commands, specifications, and information about equipment integration and room design.
Subject                         : video conferencing,videoconferencing,HDX,integration,API,cables,commands,adapters,connectors,room design, specifications
Creator Tool                    : FrameMaker 10.0.2
Metadata Date                   : 2013:08:08 14:10:02+08:00
Producer                        : Acrobat Distiller 10.0.0 (Windows)
Document ID                     : uuid:3c58e9af-6d9d-448d-87f5-cc8485458083
Instance ID                     : uuid:c776d1b9-7468-4f71-962c-dc686a5a5898
Page Mode                       : UseOutlines
Page Count                      : 294
Warning                         : [Minor] Ignored duplicate Info dictionary
EXIF Metadata provided by EXIF.tools

Navigation menu