Polycom ATX SDK, ATX 300 User Manual

Release Notes
Polycom® ATX SDK Version 2.0.1 and ATX 300 Version 2.7.1
This document provides the latest information about the Polycom Architected Telepresence Experience™ (ATX) Software Development Kit (SDK) version 2.0.1 and the Polycom ATX 300 version
2.7.1.
Introducing the Polycom ATX SDK Version 2.0.1 and ATX 300 Version 2.7.1 .............................. 2
What’s New in ATX SDK Version 2.0.1 and ATX 300 Version 2.7.1? ............................................. 2
Software and Firmware Used in ATX SDK Version 2.0.1 and ATX 300 Version 2.7.1 ................. 3
ATX SDK Version 2.0.1 ................................................................................................................... 3
ATX 300 Version 2.7.1 ..................................................................................................................... 3
Software Version History ........................................................................................................................ 3
Upgrading the Software .......................................................................................................................... 4
Issues Fixed in This Release ................................................................................................................. 5
For ATX SDK Version 2.0.1 ............................................................................................................ 5
For ATX 300 Version 2.7.1 .............................................................................................................. 6
ATX SDK Version 2.0.1 Known Issues and Limitations ..................................................................... 6
For Users ........................................................................................................................................... 6
For Integrators .................................................................................................................................. 7
ATX 300 Version 2.7.1 Known Issues and Limitations ...................................................................... 7
For Users ........................................................................................................................................... 7
For Integrators .................................................................................................................................. 9
Where to Get the Latest Product Information ...................................................................................... 11
               
Copyright Information
© 2010 Polycom, Inc. All rights reserved. 3725-29895-005/A (December 2010) Polycom, Inc.
4750 Willow Road Pleasanton, CA 94588-2708 USA
Trademark Information
POLYCOM®, the Polycom "Triangles" logo 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 property of their respective owners. No portion hereof may be reproduced or transmitted in any form or by any means, for any purpose other than the recipient's personal use, without the express written permission of Polycom.
1
Introducing the Polycom ATX SDK Version 2.0.1 and ATX 300 Version 2.7.1
With either version of the Polycom ATX, Polycom’s AV integration partners can create customized immersive telepresence suites using Polycom HDX 8000™ codecs, EagleEye™ II HD cameras, and HDX Ceiling Microphone Arrays along with displays, table, and chairs provided by the integrator or client.
The ATX SDK, which runs on the ATX 200, ATX 300, and ATX 400 hardware platforms, enables
AV integrators to add more value to these ATX solutions by allowing the integrators to support
the unique requirements of their customers. The ATX SDK version works in conjunction with
special control panel code (provided by the control panel vendor), enabling AV integrators to
customize the Touch Panel user interface to the specific needs of their customers.
The ATX 300 version 2.7.1 provides a user interface with the same feature set as the standard
Polycom Immersive Telepresence software, including the Touch Panel with Enhanced user
interface capabilities. Integration partners may also implement the Classic user interface, which
maintains the look and feel of the ATX 300 version 2.0 user interface, but does not include the
version 2.7.1 features. Note that a 10-inch Touch Panel is required for the Enhanced user
interface.
What’s New in ATX SDK Version 2.0.1 and ATX 300 Version 2.7.1?
ATX SDK version 2.0.1 and ATX 300 version 2.7.1 are maintenance releases for ATX SDK version 2.0 and ATX 300 version 2.7, which provide the following functionality:
For ATX SDK only: You can run the ATX SDK version 2.0.1 on the ATX 200 hardware platform
(which uses two displays), the ATX 400 hardware platform (which uses four displays), or on the
traditional ATX 300 hardware platform (which uses three displays).
Optimize bandwidth with H.264 High Profile, a standards-based video compression technology
that delivers full HD quality while lowering your bandwidth requirements by up to 50 percent.
H.264 High Profile is supported only on ATX systems with HDX 8000 series codecs.
Experience striking 1080p video resolution with Polycom EagleEye II 1080p cameras. Their sharp
focus and clear, crisp, natural colors provide the ultimate HD images. The EagleEye II HD
camera has a 72 degree wide viewing angle. When zoomed out all the way, a portion of person 1
and a portion of person 6 along with persons 2, 3, 4, and 5 will be visible onscreen, as shown in
the following illustration.
For more information about the EagleEye II HD cameras, refer to http://www.polycom.com/
products/telepresence_video/accessories/hdx_accessories/eagleeye_hd_camera.html
Simply and easily view a list of scheduled meetings and join those meetings using the Polycom
Conferencing for Microsoft® Outlook® feature.
.
Information on the configuration of these and other ATX features is provided in the Polycom
Immersive Telepresence (ITP) Administrator’s Guide.
2
Software and Firmware Used in ATX SDK Version 2.0.1 and ATX 300 Version
2.7.1
ATX SDK Version 2.0.1
The ATX SDK version 2.0.1, which includes support for the ATX 200, ATX 300, and ATX 400 hardware platforms, uses the following Polycom-provided software (note that other software is required, but it is provided by the Touch Panel control system vendor):
Polycom Telepresence Tool version: 2.7.1.1 (TelepresenceTool_2.7.1.1.msi) HDX software version: polycom-hdx-hf-2.6.1.3_00_itp271-5267.pup
ATX 300 Version 2.7.1
The ATX 300 version 2.7.1 uses the following software and firmware:
Polycom Telepresence Tool version: 2.7.1.1 (TelepresenceTool_2.7.1.1.msi) HDX software version: polycom-hdx-hf-2.6.1.3_00_itp271-5267.pup Crestron software version: 2.7.1-3 (TPX_2.7.1-3.zip) Crestron AV2 System Controller firmware version: 4.001.1012 (Feb 17 2009)
(pro2_av2_cp2_cp2e_rack2_pac2_4.001.1012.zip)
Crestron Touch Panel firmware version: 3.001.0015
(tps-3000_tps-3000l_tps-3100_tps-4000_tps- 4000l_3.001.0015.zip)
For information on versions of other Polycom products, such as RMX and CMA, that are compatible with this release, refer to the Polycom Immersive Telepresence (ITP) Deployment Guide.
Software Version History
Software Version Description
ATX SDK version 2.0.1 ATX 300 version 2.7.1
ATX SDK version 2.0 ATX 300 version 2.7
ATX 300 SDK version 1.0.1 ATX 300 version 2.6.1 Maintenance Releases
ATX 300 SDK version 1.0 ATX 300 version 2.6
Maintenance release.
For ATX SDK only: Support for the new ATX 200 and ATX 400 hardware platforms (as well as continued support for the ATX 300).
For both ATX SDK and ATX 300: Support for H.264 High Profile, EagleEye II HD cameras, Polycom Conferencing for Microsoft Outlook, Meeting Composer, and CMA browsing and searching.
Support for the new Polycom EagleEye II HD cameras.
First release of ATX 300 SDK. Support for Polycom Telepresence Tool, Meeting Composer, Enhanced and
Classic user interface, and Voice Activated Room Switching (VARS) with Multipoint Layout Application (MLA), Version 2.5.
ATX 300 version 2.0 First release of ATX 300.
3
Upgrading the Software
There are no restrictions for upgrading from earlier versions of ATX SDK software to version 2.0.1 or for upgrading from earlier versions of ATX 300 software to version 2.7.1.
The ATX software is now available at this location:
http://www.polycom.com/support/video/index.html
Before upgrading the software, note the following:
For ATX SDK, you must refer to the Release Notes and other documentation for the Crestron and
AMX modules to confirm compatibility with the ATX SDK version 2.0.1 software. To obtain the
Crestron and AMX documentation, refer to their respective web sites.
If you wish to upgrade to ATX SDK version 2.0.1 software but your ATX was manufactured after
April 30, 2010 and it did not ship with the 1080p software license with part number 5150-09603-
002, you may need to obtain a new 1080p software license (part number 5150-09603-002) from
Polycom. Please contact Polycom Customer Support at http://support.polycom.com
information.
.
for more
IMPORTANT
For complete information on how to upgrade the HDX software, refer to “Upgrading and Activating the HDX Software” in the Polycom ATX Integrator’s Guide (part number 3725-29615-003).
The HDX codecs do not come shipped with the appropriate HDX software installed. Therefore, you must download the correct HDX software into the codecs before using the ATX.
Display Behavior when Calling and Hanging Up
This is what you can expect to see on the displays when placing or hanging up a video call:
When placing a video call, each of the displays associated with a codec that is participating in the
call may show near-end video until the call connects.
When hanging up a video call, each of the displays will show the following:
a. Near-end video.
b. A completely black screen.
Steps a and b will take about five seconds to complete. The displays will then go into Standby
mode (if they were configured to do so).
4
Selecting the Video Format
The first time you use the Polycom Telepresence Tool with the ATX, the Select Telepresence Model dialog box will appear and you must do the following:
1. In the Select Model field, select the ATX system model.
2. In the Select Main Display field, select the video format for the main displays installed in the
room. If the video format you want is 720p DVI format, select Widescreen - 720p. (Note that
additional video formats have been added to the checklist for this release.)
3. In the Select Content Display field, select the video format for the content monitors installed in
the room.
4. Click OK.
Issues Fixed in This Release
ATX SDK version 2.0.1 and ATX 300 version 2.7.1 incorporate both HDX software version 2.6.1.3 and HDX hotfix version 2.6.1.3-HF5. HDX software version 2.6.1.3 provides a correction for an issue recently observed at the factory in which Polycom HDX systems restarted intermittently while in a call. HDX hotfix version 2.6.1.3-HF5 provides a correction to an intermittent lip sync issue.
For ATX SDK Version 2.0.1
The following table lists the issue fixed in ATX SDK version 2.0.1.
Feature Description
Audio/Video Calls
When viewing an RPX system in a 1080p multipoint call with an RMX 2000 or 4000 MPMx system, you will no longer see a thin black vertical line between cells of the RPX system. For more information, refer to the Polycom® ImmersiveTelepresence (ITP) Deployment Guide.
5
For ATX 300 Version 2.7.1
The following table lists the issue fixed in ATX 300 version 2.7.1.
Feature Description
Audio/Video Calls
Touch Panel/ User Interface
On rare occasions when placing a video or audio call when using Meeting Composer, the system automatically dialed the number before you pressed the Connect button.
When viewing an RPX system in a 1080p multipoint call with an RMX 2000 or RMX 4000 with MPMx, you will no longer see a thin black vertical line between cells of the RPX system. For more information, refer to the Polycom® ImmersiveTelepresence (ITP) Deployment Guide.
When joining a Polycom Conferencing for Microsoft Outlook (PCO) conference from the Touch Panel, you were not prompted for a conference password, even if a password was required for the meeting.
With PCO, private meeting details were displayed on the Touch Panel, even if the primary HDX system was not configured to Show Private Meeting Details.
On rare occasions with the Enhanced UI, you may have noticed that the speed dial and directory information was not displayed properly on the Touch Panel. This typically occurred following recovery from a power failure.
ATX SDK Version 2.0.1 Known Issues and Limitations
For Users
The following table lists the known issues relevant to Polycom ATX SDK end users.
Feature Description
Audio/Video Calls
6
If you place a call from a two-codec system (such as an RPX™ 200) to an ATX SDK, the left display on your system will very briefly show video from the ATX before it goes black. (Note that black video is what should appear at all times on the left display in a call between a two­codec system and an ATX SDK.)
For Integrators
The following table lists the known issues relevant to Polycom ATX SDK integrators.
Feature Description
Audio/Video Calls
Cameras If a cable to one of the cameras in the ATX SDK room becomes detached, that camera may
Microphones If you disconnect the Polycom Ceiling Microphone Arrays and then connect any microphones
Multipoint In the HDX web UI, do not select the Enable Multipoint Trial checkbox on the Admin Settings
Software Upgrades
User Interface
If your ITP environment is configured to use both the LDAP directory and H.323 Gatekeeper functions, and your speed dial entries are not IP addresses, video calls may take longer to connect due to the additional communication involved between the various components in the solution.
lose all of its camera settings from the Polycom Telepresence Tool. To avoid this issue, whenever a camera loses power, the HDX codec that is attached to that
camera should be rebooted.
other than Ceiling Microphone Arrays, the proper stereo settings may be lost. If this occurs, launch the Polycom Telepresence Tool, make sure that all the HDX codecs are
connected, and then click Configure HDXs to set the microphones to their correct settings.
> General Settings > Options page. Enabling this option could result in unpredictable behavior.
When upgrading the HDX systems, you normally see a screen that displays an hourglass and a red progress bar. This screen may not appear for HDX PAL systems; however, the upgrade is still occurring and can be monitored through the web UI.
If users report that it takes an unusually long time to receive directory information on the system’s user interface, check if there are LDAP entries in the directory that are no longer valid. If there are such entries, correct them.
ATX 300 Version 2.7.1 Known Issues and Limitations
For Users
The following table lists the known issues relevant to Polycom ATX 300 end users.
Feature Description
Audio/Video Calls
If you place an outgoing audio call or receive an incoming audio call when you are not in a video call, near-end video will appear momentarily on the center display and then becomes blanked.
When the call is hung up, the near-end video will appear again on the center display. If you want to remove the near-end video from the center display, you can place another video call and then hang it up. Alternatively, you can take no action and allow the Sleep Timer parameter (which is set by the system administrator or integrator) to remove the video from the display.
The ATX 300 will not accept any incoming audio calls when it is already in a video call. To avoid this issue, place outgoing audio calls instead of receiving incoming audio calls when
you are already in a video call.
7
Feature Description
Audio/Video Calls (continued)
Touch Panel/User Interface
When DTMF tones are heard during the process of dialing an audio call, the near-end and far-end audio is muted for a brief moment.
If you hang up an incoming audio call and then immediately place an outgoing audio call, the ATX 300 may not hang up the initial incoming audio call.
To avoid this issue, wait five seconds between consecutive audio calls.
If the ATX 300 is in a single endpoint video call (such as with a VSX or HDX video conferencing system) and the Do Not Disturb feature on the ATX 300 is disabled, an incoming call from a two-codec or three-codec system will cause the primary camera on the ATX 300 to momentarily move to the side before returning to its correct position.
If you are using Meeting Composer and you dial two audio sites concurrently, the Touch Panel may show that you are connected to the second audio number dialed when you are actually connected to the first number dialed.
To avoid this issue, when want to connect to multiple audio sites or to both audio and video sites when using Meeting Composer, connect to the video sites first (if any), and then add the audio sites one at a time.
If you dial an incomplete IP address for a video call (for example, 172.16.254.), you may hear a ringing sound for approximately 90 seconds. Until the ringing ceases, you will be unable to place another call.
When the video quality is set to Sharpness, a thin gray line is present at the bottom of the cells when connecting TPX and RPX endpoints to a conference running on RMX 2000 or RMX 4000 with MPMx.
If you press the Content button on the Touch Panel when no content source (such as a
laptop) is connected to the ATX 300 with the VGA cable, the Primary codec will generate the message "PC input resolution and/or refresh rate not supported." Because the system is blanked, this message is not visible; however, if you establish a video call while the message is activated, the call will take longer than usual to connect.
To avoid this issue, wait three seconds (during which time the message will time out) before placing a video call from the Touch Panel.
In an audio call from an ATX 300 to a cellular phone or analog phone, if the remote user disconnects the call first, then the Touch Panel continues to show the audio call as in progress.
To avoid this issue, manually press the Hang Up button after each audio call is completed. The ATX 300 will not accept incoming audio or video calls when the Hang Up button is off hook.
When searching for a site in the global directory with the Enhanced UI, up to nine characters can typically be displayed on the screen. However, depending on the width of the letters in the name, more or less of the site name may be truncated.
With Meeting Composer, when dialing a phone number with more than 10 digits, or dialing any other long string such as extension@IP_address (ex: 123456@172.25.130.201), the string will likely be truncated when displayed in the right-hand pane of the Touch Panel.
8
For Integrators
The following table lists the known issues relevant to Polycom ATX 300 integrators.
Feature Description
Audio/Video Calls
You may have experienced a power failure if either of these issues occurs:
o Any of the cameras do not move to Preset 96 in multipoint calls. o Any of the displays show near-end video rather than being blank.
To correct these issues, reboot the codecs. When the codecs finish rebooting, reboot the AV2 controller.
When the Primary codec answers an incoming video call, any HDX codecs that are not being used will automatically accept any other incoming video calls if the following conditions exist:
1. The ATX 300 is in a single endpoint video call with a VSX or HDX video conferencing system.
2. The ATX 300 is in a video call with an RPX 200 or a TPX HD 204M.
To prevent unused codecs from accepting any incoming calls, use the Do Not Disturb timer. To change the amount of time before Do Not Disturb is activated, access the
DoNotDisturbTimer field in the System_Config.ini file. In this field, you can enter a value between 10 and 300, or leave the value at 0 if you want to keep the feature disabled:
DoNotDisturbTimer=x where x is the value (in seconds) of the desired timeout period.
For example, DoNotDisturbTimer=120 sets the parameter to 120 seconds.
If you use the web UI to place a call that is not at the default call speed, the codecs will not automatically adjust to the same call speed.
To avoid this issue when placing a call using the web UI:
1. Telnet into the Crestron Touch Panel and change the default call speed.
2. Place a call using the web UI, making sure that you explicitly select the same call speed.
Avoid creating directory entries that have an “&” symbol in the name. If you do so, the entry will appear on the site list with the word “amp” in the name rather than the “&” symbol.
When the ATX 300 is in a call, sending Telnet commands to change the video format may not work properly.
To avoid this issue, do not use Telnet commands to change the video format when the ATX 300 is in a call.
If your ITP environment is configured to use both the LDAP directory and H.323 Gatekeeper functions, and your speed dial entries are not IP addresses, video calls may take longer to connect due to the additional communication involved between the various components in the solution.
Cameras If a cable to one of the cameras in the ATX 300 room becomes detached, that camera may
Control System When you connect to the codecs through Telnet or through the Crestron Toolbox and use the
9
lose all of its camera settings from the Polycom Telepresence Tool. To avoid this issue, whenever a camera loses power, the HDX codec that is attached to that
camera should be rebooted.
command prompt, you may see “overflow buffer” and other error messages when you use the Touch Panel. These errors also appear on the Crestron log. This issue does not affect system performance or functionality.
Feature Description
Directory If you add a site from the CMA directory to the speed dial list and then later change the name
Microphones If you disconnect the Polycom Ceiling Microphone Arrays and then connect any microphones
Multipoint In the HDX web UI, do not select the Enable Multipoint Trial checkbox on the Admin Settings
Software Upgrades
Telepresence Tool
Touch Panel/User Interface
of that site in the CMA, the speed dial entry name that is displayed on the Touch Panel may not be updated.
To fix this issue, reboot the codecs and the AV2 controller. Alternatively, from the HDX web UI, delete and re-add the renamed CMA site to the Speed Dial list.
other than Ceiling Microphone Arrays, the proper stereo settings may be lost. If this occurs, launch the Polycom Telepresence Tool, make sure that all the HDX codecs are
connected, and then click Configure HDXs to set the microphones to their correct settings.
> General Settings > Options page. Enabling this option could result in unpredictable behavior.
When upgrading the HDX systems, you normally see a screen that displays an hourglass and a red progress bar. This screen may not appear for HDX PAL systems; however, the upgrade is still occurring and can be monitored through the web UI. The Home screen will appear on the displays when the upgrade is complete.
When using the Telepresence Tool to remotely monitor a site, you may notice stuttering video.
Polycom recommends that you do not use the Telepresence Tool for remote monitoring while the system is in a video call.
If any of the HDX codecs are rebooted without rebooting the AV2 controller as well, the HDX UI remains onscreen.
To avoid this issue, reboot the AV2 controller whenever any of the HDX codecs are rebooted. The VNOC, Service, and Site Administration teams are advised to reboot (power up) the AV2 after the HDX reboots (powers up) as part of the reset process or when recovering from a power failure. Placing a call without rebooting the AV2 will cause the Touch Panel to freeze.
If you reboot the Primary codec while the ATX 300 is in an audio call (with the Help Desk, for example), the Hang Up button on the Touch Panel will freeze.
To avoid this issue, reboot the AV2 controller when the Hang Up button enters that frozen state.
Occasionally, the incorrect video format will be displayed on the Touch Panel Admin screen. To determine the correct video format:
1. From the web UI, go to Admin Settings > Cameras.
2. Check the Video Quality field for the camera being used. If Video Quality=Sharpness, the video format is 1080p30; if Video Quality=Motion, the video format is 720p60.
Alternatively, you can check the Video Format on the web UI Place a Call page.
When initially loading the Crestron Touch Panel and then loading the AV2 controller, a Toolbox Results dialog box may appear at the end of the installation process. Although this dialog box displays an error message, the installation completed successfully.
If users report that the Touch Panel seems to take an unusually long time to return directory information, check if there are LDAP entries in the directory that are no longer valid. If there are such entries, correct them.
10
Where to Get the Latest Product Information
To get more information about the Polycom HDX, visit the Polycom web site at
http://www.polycom.com/support/video/index.html
documentation, visit the Polycom Resource Center at http://portal.polycom.com/portal_web/login.jsp
. To view the latest Polycom ATX product
.
11
Loading...