TANDBERG Codec C90 D14128.02 System Integration Manual
TANDBERG Codec C90 D14128.02 System Integration Manual

TANDBERG Codec C90 D14128.02 System Integration Manual

Tandberg codec c90 user manual

Advertisement

Quick Links

Software version TC1.0
NOVEMBER 2008
TANDBERG Codec C90
System Integrator Guide
D14128.02—NOVEMBER 2008
1

Advertisement

Table of Contents
loading

Summary of Contents for TANDBERG Codec C90 D14128.02

  • Page 1 Software version TC1.0 NOVEMBER 2008 TANDBERG Codec C90 System Integrator Guide D14128.02—NOVEMBER 2008...
  • Page 2: Table Of Contents

    TANDBERG API ... 33 Basic Principles ... 33 The TANDBERG API-Engine ... 33 Structuring of Information ... 33 Addressing Using XPath or TANDBERG SimplePath ... 34 Feedback ... 34 Connecting to the codec ... 35 Accessing XACLI ... 35 Telnet/SSH login ... 35 Serial port login ...
  • Page 3 Cameras Appendices Contact us TANDBERG Remote Control TRC5 ... 120 TANDBERG Remote Control TRC5 key map ... 121 The PrecisionHD camera ... 122 Connecting the camera ... 122 CE Declaration for Codec C90 ... 123 China RoHS table ... 124 TANDBERG Codec C90 dimensions ...
  • Page 4 Introduction Contents Introduction Getting Started Thank you for choosing TANDBERG! Your TANDBERG Codec C90 has been designed to give you many years of safe, reliable operation. How to read this document You will find that some places information has been copied from other chapters (but adapted, when needed) to let you have all the relevant information there and then.
  • Page 5 Getting Started Intellectual Property Rights This System Integrator Guide and the Products to which it relates contain information that is proprietary to TANDBERG and its licensors. Information regarding the Products is found on the page entitled License Agreements and Patent Information.
  • Page 6: Safety Instructions

    Codec C90 Introduction Contents Introduction Getting Started Safety Instructions Water and Moisture Do not operate the apparatus under or near water – For your protection please read these safety for example near a bathtub, kitchen sink, or laundry instructions completely before you connect the tub, in a wet basement, near a swimming pool or in equipment to the power source.
  • Page 7: Environmental Issues

    • Comply with all relevant environmental legislation. Digital User Guides TANDBERG is pleased to announce that we have replaced the printed versions of our user guides with digital versions available on the TANDBERG web site: environmental benefits of this are significant. The user guides can still be printed locally, whenever needed.
  • Page 8: Getting Started

    Codec C90 Getting Started Contents Introduction Getting Started This chapter introduces you to the codec and gets you up and going. This guide has been divided into several chapters, all of which provide different information. You can access the chapters directly by clicking on the menu bar at the top of this page.
  • Page 9 Codec C90 Getting Started Contents Introduction Getting Started Assemble your system The illustration shows you the basic setup when connecting your monitor, PC, camera, microphone, loudspeakers (if applicable), LAN and line voltage to your codec. Monitor (Audio from HDMI 1 or Line Out 1–2) OPTIONAL: Dual monitor setup...
  • Page 10: Using The Remote Control

    Codec C90 Getting Started Contents Introduction Getting Started Using the Remote Control The functions keys in the upper part of the remote control reflects the soft keys on screen..and the middle part of the remote control is used to handle the video part of the call.
  • Page 11 Codec C90 Getting Started Contents Introduction Getting Started Using the Remote CALL KEY Control, cont... INITIATE CALL: Select a name from the Phone book or enter the name, number or URI and press the Call key to initiate the call. SHORTCUT TO RECENT CALLS: Use the Call button as a The functions keys shortcut to Recent Calls when the Call menu is not visible.
  • Page 12 Codec C90 Getting Started Contents Introduction Getting Started Turn on the system • Turn on the codec and wait a few minutes for the system to start • Make sure the remote control has the batteries installed. • Press Home ( ) on the remote control to show the menu on screen •...
  • Page 13: Time Zone Settings

    H323 alias, gatekeeper address, etc. For SIP type of communication, similar type of information will be supplied. For networks administrated through TMS (TANDBERG Management Suite), your TMS administrator will be able to assist you when configuring. The H323 and SIP settings are configured from the Administrator Settings menu: Navigate to Settings >...
  • Page 14 Codec C90 Getting Started Contents Introduction Getting Started About monitors The main monitor The main monitor can be connected to the default video output HDMI 1 or one of the other outputs which are HDMI 3, DVI-I 2 or DVI-I 4. When connecting to HDMI 1 When you connect the main monitor to the default video output on Codec C90 the menu, icons and other information on screen (OSD -...
  • Page 15 Codec C90 Contents Introduction Getting Started In this chapter you will find an in-depth presentation of the rear panel sockets and interface of the TANDBERG Codec C90, including audio signal levels and formats supported. D14128.02—NOVEMBER 2008 Interfaces Interfaces About the API...
  • Page 16: The Front Panel

    Codec C90 Contents Introduction Getting Started The front panel There are four LED’s in the front of the Codec: • Power – The POWER LED turns ON when power is connected, otherwise OFF • Call – The CALL LED turns ON when there are active calls on the codec, otherwise OFF •...
  • Page 17 Rear panel sockets Video sockets overview The video input sockets are: 4 x HDMI The TANDBERG Codec C90 offers a great flexibility 4 x HD-SDI in connecting audio and video equipment to the 2 x DVI-I system. 2 x Analog Component (Y-Pr-Pb) The illustration below shows the rear panel of the TANDBERG Codec C90.
  • Page 18 Codec C90 Contents Introduction Getting Started The Video Input Matrix The video input matrix is found at the rear side of the codec and illustrates the combinations in which the video inputs can be connected. About the matrix Only one video input source from each row can be active at any time. The numbers in the left column represents the Video Input Sources 1–5.
  • Page 19 Codec C90 Contents Introduction Getting Started Video inputs (I) All video inputs can not be active at the same time. Please refer to the Video Input Matrix on the previous page to see an overview. Component 1–2 (Y-Pr-Pb) 2 x 3 BNC sockets, analog video input 1, 2. There are three BNC connectors for each Component interface;...
  • Page 20 DVI-I - Digital Video Interface - Integrated (digital DVI-D and analog DVI-A) Typical use. Two digital video inputs for PC presentations or used for the TANDBERG Precision HD Camera. Main connector. The DVI-I 3 is the main connector for PC input.
  • Page 21: Video Outputs

    Codec C90 Contents Introduction Getting Started Video outputs HDMI 1 and 3 2 x HDMI sockets, digital video and audio output 1, 3. HDMI - High Definition Multimedia Interface (digital, sound & picture) Typical use. Monitor, recording device Main connector. The HDMI output 1 is the main connector to the monitor.
  • Page 22 Codec C90 Contents Introduction Getting Started Audio inputs (I) Unused, but connected audio inputs should be set to Off to avoid unwanted audio/noise. Microphone/Line In 1–8 (XLR) 8 x Balanced XLR sockets, audio input 1–8. Main connector. The Microphone/Line In 1 is the main connector for the microphone.
  • Page 23 Codec C90 Contents Introduction Getting Started Audio inputs (II) Unused, but connected audio inputs should be set to Off to avoid unwanted audio/noise. Line In 1–4 (RCA) 4 x RCA sockets, audio input 1–4 Audio Line In 1–4 are used when connecting to PC and to external playback devices, such as VCR’s or DVD players.
  • Page 24 Codec C90 Contents Introduction Getting Started Audio outputs (I) Line Out 5–6 (XLR) 2 x Balanced XLR sockets, audio output 5–6. Audio Line Out 5–6 are balanced outputs, for connection to balanced speakers. Default configuration. In default configuration Line Out 5 is configured as Left speaker, and Line Out 6 is configured as right speaker.
  • Page 25 Out 2 (right) are the main connectors to the local loudspeaker system. The local loudspeaker system may or may not include the TANDBERG DNAM (Digital Natural Audio Module). Default configuration Line Out 1-2. In default configuration, Line Out 1 and 2 are configured as stereo speakers.
  • Page 26 Codec C90 Contents Introduction Getting Started Audio Signal Levels tables Microphone Inputs 1 to 8 XLR female Signal Clipping level Nominal Signal levels level levels Level Level setting setting [dB] [mVpp] [dBu] [dBu] [dB] 275.0 -18.0 -36.0 245.1 -19.0 -37.0 218.4 -20.0 -38.0...
  • Page 27 Codec C90 Contents Introduction Getting Started Audio signal levels, cont... Line outputs 1 to 4 Female RCA/phone Signal Absolute max Nominal levels output level level Level setting [dB] [Vpp] [dBu] [dBu] -18.0 -18.0 -17.0 -17.0 -16.0 -16.0 -15.0 -15.0 -14.0 -14.0 -13.0 -13.0...
  • Page 28: Network Connectors

    Codec C90 Contents Introduction Getting Started Network connectors Ethernet interface 2 × Gigabit Ethernet LAN (RJ-45 Jack) interface (GbE). Ethernet 1: Main connector for network connection Ethernet 2: For future use. RJ-45 Connector pin-out Wiring diagram standard cable D14128.02—NOVEMBER 2008 Interfaces Interfaces About the API...
  • Page 29: Control Port

    From DCE Clear to send, CTS From DCE Ring indicator, RI System Integrator Guide xStatus Cameras Appendices Pin-out—TANDBERG camera cable Signal RJ-45 pin Signal name name +12V (presence 2.8mA current source +12V DC when connected in daisy chain) TXD (out)
  • Page 30 Codec C90 Contents Introduction Getting Started Power Power socket Power Cord Socket. Accepts 100-240V, 50/60Hz, 2.8A max. CAUTION! This equipment must be grounded. Power switch Power Switch (On/Off) Chassis grounding For grounding of the chassis D14128.02—NOVEMBER 2008 Interfaces Interfaces About the API xConfiguration xCommand System Integrator Guide...
  • Page 31 Codec C90 Contents Introduction Getting Started Other connectors 1 × USB Host 1 × USB Device For future use. GPIO 1 × GPIO (General Purpose I/O) 6 pins Phoenix plug, having 4 ports for On/Off control, GND and +12V For future use. T Link 2 ×...
  • Page 32 Codec C90 Contents Introduction Getting Started The heart of the API is the TANDBERG API-Engine. This is where all information is stored and processed. The API engine can be accessed by an easy-to-use Command Line Interface called XACLI using RS-232/Telnet/SSH, or by the TANDBERG XML API Service (TXAS) over HTTP/HTTPS.
  • Page 33 Accessing catalogues on a Windows computer using the Command Prompt gives a different view The TANDBERG API-Engine is optimized for easy, yet advanced, machine-machine interaction between a than using Windows Explorer, but the information TANDBERG system and an external control application.
  • Page 34 About the API xConfiguration xCommand Feedback Feedback is an extremely powerful feature where the TANDBERG system actively returns updated status and configuration information to the user/control application whenever changes occur. The user/control application can specify what parts of the status and configuration hierarchies it wants to monitor by using XPath.
  • Page 35 COM port. The COM port (RS-232) is a 9-pin, female, D-sub connector located on the back of the TANDBERG Codec C90. See the illustration to the right. The port is configured as a DCE (Data Communications Equipment).
  • Page 36 Cable. A straight-through cable should be used between the TANDBERG RS-232 port and the DTE. The lower table shows the recommended cable-wiring scheme when connecting the TANDBERG Codec C90 to a PC through RS-232.
  • Page 37 Codec C90 Contents Introduction Getting Started Value types and formats The system supports the following value types: • Integer values • Literal values • String values • E164 string values (strings only containing digits, ‘#’ and ‘*’) • IPv4 Address values •...
  • Page 38: Root Commands

    Codec C90 Contents Introduction Getting Started Root commands By typing help after connecting to the TANDBERG Codec C90 using RS-232/Telnet/SSH, the system will list all supported root commands. D14128.02—NOVEMBER 2008 About the API Interfaces About the API xConfiguration xCommand - User Commands -...
  • Page 39 Feedback will only be issued on the RS-232/Telnet/ SSH session for which it is specified. If connecting to the TANDBERG codec with multiple RS-232/Telnet/SSH sessions, each session can define feedback individually. More on this can be found in xfeedback.
  • Page 40 Codec C90 Contents Introduction Getting Started About xConfiguration The xConfiguration type commands defines the system settings and are either supplied or read by the user. The xConfigurations commands are organized in a hierarchic tree structure. To get an overview of accessible top-level configuration elements within the xConfiguration commands, enter help after the...
  • Page 41 Codec C90 Contents Introduction Getting Started xConfiguration operations xConfiguration Help To get help on a system setting you can use a help Configuration type commands defines system query. Enter the path followed by ? or help. settings and are either supplied or read by the user. •...
  • Page 42 Codec C90 Contents Introduction Getting Started About xCommand xCommand type commands instructs the system to perform an action. xCommand type commands are supplied by the user. To get an overview of the supported xCommand type commands, type help after the xCommand: •...
  • Page 43 Codec C90 Contents Introduction Getting Started xCommand operations xCommand Help To get help on a setting you can use a help query. Command type commands are used to instruct the Enter the path followed by ? or help. system to perform a given action. •...
  • Page 44 Codec C90 Contents Introduction Getting Started About xStatus commands Status type commands returns information about the system and system processes. Status type commands are read by the user. All status information is structured in a hierarchy, making up a database constantly being updated by the system to reflect system and process changes.
  • Page 45 You can query all information or just some of it. To address status information enter the xStatus command followed by an address expression (XPath or TANDBERG SimplePath). You can set up the xStatus read command to address all information or just some of it, see the examples to the right for illustrations.
  • Page 46 Codec C90 Contents Introduction Getting Started About xHistory command History type commands returns information about what has happened on the system. History type commands are read by the user. All history information is structured in a hierarchy, making up a database constantly being updated by the system to reflect system and process changes.
  • Page 47 The xFeedback command will only be issued on the RS-232/Telnet/ SSH for which it is specified. If connecting to the TANDBERG codec with multiple RS-232/Telnet/ SSH sessions, each session can define feedback individually. D14128.02—NOVEMBER 2008...
  • Page 48 This command has various settings to define the formatting of the XACLI output. It is therefore important to define settings to match the parser used on the control system. XACLI is designed to make parsing of data from the TANDBERG Codec C90 very simple. xPreferences output mode: •...
  • Page 49 Introduction Getting Started TANDBERG XML API service TXAS is a service provided by TANDBERG units for transmitting and receiving (transceiving) information encoded in XML format. The API uses HTTP(S) as the transport mechanism and connects to the normal web port (80). TXAS can be accessed by bare-bone HTTP requests where URL’s uniquely identifies the request.
  • Page 50 Codec C90 Contents Introduction Getting Started This chapter gives a detailed description of the xConfiguration commands. Configuration type commands defines system settings and are either supplied or read by the user. The Configurations type commands are structured in a hierarchy, making up a database of system settings.
  • Page 51: Using The Remote Control

    In the following pages you will find a complete list of the xConfiguration commands. The examples shows either the default value or an example of a value. We recommend you visit the TANDBERG web site regularly for updated versions of the manual. Go to: http://www.tandberg.com/docs...
  • Page 52 (1 or 3). Auto: The system will select analog or digital (SPDIF) mode depending on the detected Audio Module. If a TANDBERG Digital NAM is detected then SPDIF mode will be selected, otherwise analog mode will be selected. SPDIF: Set to SPDIF when you want the Audio Line 1 or 3 output to be in digital mode. This will disable Output Line 2 and 4.
  • Page 53 Applies to cameras which supports Flip mode. Enables the video on screen to be flipped upside down. Addresses the specific camera. TANDBERG PrecisionHD 1080p camera auto detects if the camera is mounted upside down, hence flip mode is not necessary.
  • Page 54 Applies to cameras which supports Gamma mode. The Gamma Mode setting enables for gamma corrections. Gamma describes the nonlinear relationship between image pixels and monitor brightness. Addresses the specific camera. The TANDBERG PrecisionHD 1080p camera do not need Gamma Mode. The TANDBERG PrecisionHD camera do support Gamma Mode.
  • Page 55 Codec C90 Contents Introduction Getting Started xConfiguration Conference [1..1] Encryption Mode: BestEffort: The system will use encryption whenever possible. In Point to point calls: If the far end system supports encryption (AES-128), the call will be encrypted. If not, the call will proceed without encryption. In MultiSite calls: In order to have encrypted MultiSite conferences, all sites must support encryption.
  • Page 56 Codec C90 Contents Introduction Getting Started xConfiguration H323 Profile [1..1] Gatekeeper Address: Specifies the IP address of the Gatekeeper. Requires the H.323 Call Setup Mode to be set to Gatekeeper and the Gatekeeper Discovery to be set to Manual. Format: String with a maximum of 64 characters. Example: xConfiguration H323 Profile 1 Gatekeeper Address: “10.47.1.58”...
  • Page 57 Codec C90 Contents Introduction Getting Started xConfiguration Network [1..1] IPv4 QoS Diffserv Audio: The DiffServ Audio setting is used to define which priority Audio packets should have in an IP network. Enter a priority, which ranges from 0 to 63 for the packets. The higher the number, the higher the priority. These priorities might be overridden when packets are leaving the network controlled by the local network administrator.
  • Page 58 SNMP requests. SNMP requests must have a ‘password’ (case sensitive) in order to receive a response from the SNMP Agent in the codec. The default password is “public”. If you have the TANDBERG Management Suite (TMS) you must make sure the same SNMP Community is configured there too. Note! The SNMP Community password is case sensitive.
  • Page 59 Off: The system will not try to register to any management system. TMS: If set to TMS the system will try to register with a TMS server as described in Provisioning ExternalManager settings. TMS is short for TANDBERG Management System. Please contact your TANDBERG representative for more information.
  • Page 60 Codec C90 Contents Introduction Getting Started The SIP Profile settings xConfiguration SIP Profile [1..1] URI [1..1]: <S: 0, 255> The SIP URI or number is used to address the system. This is the URI that is registered and used by the SIP services to route inbound calls to the system.
  • Page 61: Time Zone Settings

    Codec C90 Contents Introduction Getting Started The System unit settings xConfiguration SystemUnit Name: <S: 0, 50> Enter a System Name to define a name of the system unit. If the H.323 Alias ID is configured on the system then this ID will be used instead of the system name. The system name will be displayed: * When the codec is acting as an SNMP Agent * Towards a DHCP server Format: String with a maximum of 50 characters.
  • Page 62 Visca chain. Addresses the specific video input source. Cascaded cameras and Visca commands are described in the PrecisionHD 1080p User Guide. The user guide is found at www.tandberg.com/docs Example: xConfiguration Video Input Source 1 CameraControl CameraId: 1 xConfiguration Video Input Source [1..5] Name:...
  • Page 63: Video Outputs

    The Advanced configurations menu has an option called Experimental. The settings within this menu can be used ‘as is’ and will not be documented. NOTE! The Experimenal menu WILL change. We recommend you visit the TANDBERG web site regularly for updated versions of the manual. Go to: http://www.tandberg.com/docs <640_480_60/800_600_60/1024_768 <PAL/NTSC>...
  • Page 64 Codec C90 Contents Introduction Getting Started Command type commands are used to instruct the system to perform a given action. Examples: place a call, mute microphones, disconnect a call and more. The command type is followed by a set of parameters to specify how the given action is to be executed.
  • Page 65 Getting Started xCommands with parameters In the following pages you will find a complete list of all xCommand type commands with parameters. We recommend you visit the TANDBERG web site regularly for updated versions of the manual. Go to: http://www.tandberg.com/docs NOTE: The description of the xCommand commands are preliminary, and subject to change.
  • Page 66 Codec C90 Contents Introduction Getting Started xCommand Audio LocalInput Update Update local input settings. Required parameters with (r): InputId(r): <0..65534> MixerMode: <Auto/Fixed> AGC: <On/Off> Mute: <On/Off> Channels: <1..2> Example: xCommand Audio LocalInput Update InputId:1 AGC:off *r AudioInputGroupUpdateResult (status=OK): *r/end xCommand Audio RemoteInput Update Update remote input settings.
  • Page 67 Codec C90 Contents Introduction Getting Started The Boot command xCommand Boot Boot system. Example: xCommand Boot *r BootResult (status=OK): *r/end CUIL reboot request, restarting Connection closed by foreign host. The Call commands xCommand Call Disconnect Disconnect specified call. Required parameters with (r): CallId(r): <0..65534>...
  • Page 68 Codec C90 Contents Introduction Getting Started xCommand Call Reject Reject incoming call. If no call id is specified, all incoming calls will be rejected. Required parameters with (r): CallId: <0..65534> Example: xCommand Call Reject CallId:20 *r CallRejectResult (status=OK): *r/end The Call Log commands xCommand CallLog Clear Clear all call logs.
  • Page 69 Codec C90 Contents Introduction Getting Started The Camera commands xCommand Camera BestView Activate the best view function. Required parameters with (r): CameraId(r): <1..7> Duration: <0..65534> Example: xCommand Camera BestView CameraId:1 Duration:7 *r BestViewResult (status=OK): *r/end xCommand Camera CameraUpgrade Upgrade camera software. Required parameters with (r): CameraId(r): <1..7>...
  • Page 70 Codec C90 Contents Introduction Getting Started xCommand Camera PositionSet Set camera position to specified values. Required parameters with (r): CameraId(r): <1..7> Pan: <-65535..65535> Tilt: <-65535..65535> Zoom: <0..65535> Focus: <0..65535> Example: xCommand Camera PositionSet CameraId:1 Pan:200 Tilt:300 *r CameraPositionSetResult (status=OK): *r/end D14128.02—NOVEMBER 2008 xCommand Interfaces...
  • Page 71 Codec C90 Contents Introduction Getting Started xCommand Camera ReconfigureCameraChain Reinitialize camera chain. Get info about what camera is sitting in what position in the camera chain. Example: xCommand Camera ReconfigureCameraChain *r ReconfigureCameraChainResult (status=OK): *r/end xCommand Camera TriggerAutofocus Trigger auto focus. Required parameters with (r): CameraId(r): <1..7>...
  • Page 72 Codec C90 Contents Introduction Getting Started The DTMF Send command xCommand DTMFSend Send DTMF tones to the far end. Required parameters with (r): CallId(r): <0..65534> DTMFString(r): <S: 0, 32> Example: xCommand DTMFSend CallId:2 DTMFString:1234 *r DTMFSendResult (status=OK): *r/end D14128.02—NOVEMBER 2008 xCommand Interfaces About the API...
  • Page 73 Codec C90 Contents Introduction Getting Started The Far End Control commands xCommand FarEndControl Camera Move Move far end camera. Required parameters with (r): CallId(r): <0..65534> Value(r): <Left/Right/Up/Down/ZoomIn/ZoomOut> Example: xCommand FarEndControl Camera Move CallId:3 Value:left *r FECCMoveResult (status=OK): *r/end xCommand FarEndControl Camera Stop Stop far end control move.
  • Page 74: Feedback

    Codec C90 Contents Introduction Getting Started xCommand FarEndControl Source Select To be described. Required parameters with (r): CallId(r): <0..65534> PresetId(r): <0..15> Example: xCommand FarEndControl Source Select CallId:3 PresetId:1 *r FECCSelectSourceResult (status=OK): *r/end D14128.02—NOVEMBER 2008 xCommand Interfaces About the API xConfiguration xCommand The HTTP Feedback commands xCommand HttpFeedback Register...
  • Page 75 Codec C90 Contents Introduction Getting Started xCommand HttpFeedback Deregister Command used to deregister XML eedback over HTTP(S). Required parameters with (r): FeedbackSlot: <1..3> Example: xCommand HttpFeedback Deregister FeedbackSlot:1 *r FeedbackDeregisterResult (status=OK): FeedbackSlot: 1 *r/end D14128.02—NOVEMBER 2008 xCommand Interfaces About the API xConfiguration xCommand The Key commands...
  • Page 76 Codec C90 Contents Introduction Getting Started xCommand Key Release Command used to emulate release an already pressed key on the remote control. The Key Release command should be preceded by a Key Press command to emulate pressing the key. Required parameters with (r): Key(r): <0/1/2/3/4/5/6/7/8/9/C/Call/Disconnect/Down/F1/F2/F3/F4/F5/Grab/Home/ Layout/Left/Mute/MuteMic/Ok/PhoneBook/Presentation/Right/Selfview/ Square/SrcAux/SrcCamera/SrcDocCam/SrcPc/SrcVcr/Star/Up/VolumeDown/...
  • Page 77 Codec C90 Contents Introduction Getting Started The Preset commands xCommand Preset Activate Activate local preset. Will move camera to predefined position. Required parameters with (r): PresetId(r): <1..15> Example: xCommand Preset Activate PresetId:3 *r PresetActivateResult (status=OK): *r/end xCommand Preset Clear Delete a preset storing a camera position. Required parameters with (r): PresetId(r): <1..15>...
  • Page 78 Codec C90 Contents Introduction Getting Started The SString Send command xCommand SStringSend Used to send data to far end, e.g. for control systems. Uses the H.224 data channel (UDP). Required parameters with (r): Message(r): <S: 1, 256> CallId: <0..65534> Example: xCommand SStringSend CallId:4 Message:”This is a test”...
  • Page 79 Codec C90 Contents Introduction Getting Started The Video command xCommand Video PictureLayoutSet Select screen layout mode. Required parameters with (r): LayoutFamily(r): <auto/equal/fullscreen/presentationlargespeaker/ presentationsmallspeaker> Example: xCommand Video PictureLayoutSet LayoutFamily:equal *r SetPictureLayoutResult (status=OK): *r/end D14128.02—NOVEMBER 2008 xCommand Interfaces About the API xConfiguration xCommand The CamCtrlPip command xCommand CamCtrlPip...
  • Page 80 Codec C90 Contents Introduction Getting Started The System Unit commands xCommand SystemUnit OptionKey Add Add option key to add extra system capabilities, e.g. Multisite. Required parameters with (r): Key(r): <S: 16, 24> Example: xCommand SystemUnit OptionKey Add Key:****************** *r OptionKeyResult (status=OK): *r/end xCommand SystemUnit ReleaseKey Add Add software release key.
  • Page 81 Codec C90 Contents Introduction Getting Started xCommand SystemUnit MenuPassword Validate Validate that supplied password is correct. Required parameters with (r): Password(r): <S: 0, 255> Example: xCommand SystemUnit MenuPassword Validate Password:*********** *r MenuPasswordValidateResult (status=OK): *r/end D14128.02—NOVEMBER 2008 xCommand Interfaces About the API xConfiguration xCommand The Phone book commands...
  • Page 82 Codec C90 Contents Introduction Getting Started xCommand Phonebook Contact Modify Modify existing contact in local phonebook. Required parameters with (r): ContactId(r): <S: 0, 255> ContactType: <Group/Person/System/Room/Other> DisplayName: <S: 0, 255> ImageUrl: <S: 0, 255> ParentGroupId: <S: 0, 255> Example: xCommand Phonebook Contact Modify ContactId:localContactId-1 DisplayName:john.smith.office *r LpbModContactResult (status=OK): *r/end...
  • Page 83 Codec C90 Contents Introduction Getting Started xCommand Phonebook Group Add Add a local phonebook group (used to group phonebook contacts). Required parameters with (r): DisplayName(r): <S: 0, 255> Number: <S: 0, 255> Description: <S: 0, 255> ParentGroupId: <S: 0, 255> Example: xCommand Phonebook Group Add GroupId:TestDept DisplayName:TestDept Description:Test...
  • Page 84 Codec C90 Contents Introduction Getting Started xCommand Phonebook Search To be described. Required parameters with (r): PhonebookId: <S: 0, 255> SearchString(r): <S: 0, 255> SearchType: <Default/T9/WordStart> SearchFields: <S: 0, 255> ContactTypes: <S: 0, 255> OrderBy: <S: 0, 255> SortOrder: <Ascending/Descending> Offset: <0..65534>...
  • Page 85 The Experimental commands can be used ‘as is’ and will not be further documented. NOTE! The Experimental commands WILL change. We recommend you visit the TANDBERG web site regularly for updated versions of the manual. Go to: http://www.tandberg.com/docs xCommand Experimental Audio LocalInput Add Required parameters with (r): Name: <S: 0, 255>...
  • Page 86 Codec C90 Contents Introduction Getting Started NOTE! The Experimental commands can be used ‘as is’ and WILL change. xCommand Experimental Audio LocalOutput ConnectInput Required parameters with (r): OutputId(r): <0..65534> InputId(r): <0..65534> xCommand Experimental Audio LocalOutput DisconnectInput Required parameters with (r): OutputId(r): <0..65534>...
  • Page 87 Codec C90 Contents Introduction Getting Started NOTE! The Experimental commands can be used ‘as is’ and WILL change. xCommand Experimental Video Layout Frame Update Required parameters with (r): LayoutId(r): <1..2147483647> FrameId(r): <1..65535> PositionX(r): <0..10000> PositionY(r): <0..10000> Width(r): <1..10000> Height(r): <1..10000> Layer(r): <1..5>...
  • Page 88: Status Type Commands

    Codec C90 Contents Introduction Getting Started Status type commands returns information about the system and system processes. The information is generated by the system and gives status about ongoing calls, network status, conference status and more. The status information is structured in a hierarchy, making up a database constantly being updated by the system to reflect system and process changes.
  • Page 89: D14128.02—November

    Status type commands returns information about the system and system processes. The following pages will list an example of the xStatus commands and the response. We recommend you visit the TANDBERG web site regularly for updated versions of the manual. Go to: http://www.tandberg.com/docs...
  • Page 90: The Call Status

    Codec C90 Contents Introduction Getting Started xStatus Audio Input LocalInput [1..n] Name States the name of the LocalInput with InputId n Value space: S: 0..100 Default value: Example: *s Audio Input LocalInput 1 Name: “Microphone” xStatus Audio Input LocalInput [1..n] MixerMode A LocalInput is a group of connectors mixed together by the stated mixermode Value space: Auto/Fixed...
  • Page 91: The Camera Status

    *s Camera 1 HardwareID: “50000000” xStatus Camera [1..7] Manufacturer States the manufacturer of the camera. Value space: S: 0..100 Default value: Example: *s Camera 1 Manufacturer: “Tandberg” xStatus Camera [1..7] Model States the camera model. Value space: S: 0..100 Default value: Example: *s Camera 1 Model: “Rover”...
  • Page 92: The Conference Status

    Codec C90 Contents Introduction Getting Started xStatus Camera [1..7] Position Pan Current pan position. Value range depends on camera type. Value space: -65535..65535 Default value: Example: *s Camera 1 Position Pan: 514 xStatus Camera [1..7] Position Tilt Current tilt position. Value range depends on camera type. Value space: -65535..65535 Default value:...
  • Page 93: The Diagnostics Call Status

    Codec C90 Contents Introduction Getting Started The Diagnostics Call status xStatus Diagnostics Call [1..n] Channels IncomingAudioChannel [1..n] Netstat 1 Jitter Current jitter as specified by RFC3550. Value space: Integer value Default value: Example: *s Diagnostics Call 11 Channels IncomingAudioChannel 168 Netstat 1 Jitter: 0 xStatus Diagnostics Call [1..n] Channels IncomingAudioChannel [1..n] Netstat 1 Packets...
  • Page 94 Codec C90 Contents Introduction Getting Started xStatus Diagnostics Call [1..n] Channels IncomingVideoChannel [1..n] Netstat 1 Drop Packets dropped in this media channel. Value space: Integer value Default value: Example: *s Diagnostics Call 11 Channels IncomingVideoChannel 174 Netstat 1 Drop: xStatus Diagnostics Call [1..n] Channels IncomingVideoChannel [1..n] Netstat 1 Bytes Number of bytes received in this media channel.
  • Page 95 Codec C90 Contents Introduction Getting Started xStatus Diagnostics Call [1..n] Channels IncomingDataChannel [1..n] Netstat 1 MaxJitter Max jitter measured during last time interval (5 seconds). Value space: Integer value Default value: Example: *s Diagnostics Call 11 Channels IncomingDataChannel 176 Netstat 1 MaxJitter: 0 xStatus Diagnostics Call [1..n] Channels OutgoingAudioChannel [1..n] Netstat 1 Jitter Current jitter as specified by RFC3550.
  • Page 96 Codec C90 Contents Introduction Getting Started xStatus Diagnostics Call [1..n] Channels OutgoingVideoChannel [1..n] Netstat 1 Loss Packets lost in this media channel. Value space: Integer value Default value: Example: *s Diagnostics Call 11 Channels OutgoingVideoChannel 172 Netstat 1 Loss: xStatus Diagnostics Call [1..n] Channels OutgoingVideoChannel [1..n] Netstat 1 Drop Packets dropped in this media channel.
  • Page 97: The Media Channels Call Status

    Codec C90 Contents Introduction Getting Started xStatus Diagnostics Call [1..n] Channels OutgoingDataChannel [1..n] Netstat 1 ChannelRate Current bandwidth for this media channel. Value space: Integer value Default value: Example: *s Diagnostics Call 11 Channels OutgoingDataChannel 177 Netstat 1 ChannelRate: 0 xStatus Diagnostics Call [1..n] Channels OutgoingDataChannel [1..n] Netstat 1 MaxJitter Max jitter measured during last time interval (5 seconds).
  • Page 98 Codec C90 Contents Introduction Getting Started xStatus MediaChannels Call [1..n] IncomingAudioChannel [1..n] Audio Protocol Audio algorithm. Value space: AACLD, G722, G7221, G711Mu Default value: Example: *s MediaChannels Call 11 IncomingAudioChannel 181 Audio Protocol: AACLD xStatus MediaChannels Call [1..n] IncomingAudioChannel [1..n] Audio Mute Audio mute status of incoming audio.
  • Page 99 Codec C90 Contents Introduction Getting Started xStatus MediaChannels Call [1..n] OutgoingVideoChannel [1..n] ChannelRole Main video channel or presentation video channel. Value space: Main/Presentation Default value: Example: *s MediaChannels Call 11 OutgoingVideoChannel 185 ChannelRole: Main xStatus MediaChannels Call [1..n] OutgoingVideoChannel [1..n] Video Protocol Video algorithm.
  • Page 100: The Sip Status

    Digest, NTLM, Off Default value: Example: *s SIP Registration 1 Authentication: Off The System unit status xStatus SystemUnit ProductType Product type. Value space: S: 0..100 Default value: Example: *s SystemUnit ProductType: “TANDBERG Codec” System Integrator Guide xStatus xStatus Cameras Appendices Contact us...
  • Page 101 Introduction Getting Started xStatus SystemUnit ProductId Product id. Value space: S: 0..100 Default value: Example: *s SystemUnit ProductId: “TANDBERG Codec C90” xStatus SystemUnit Uptime Seconds since last system reboot. Value space: Integer value Default value: Example: *s SystemUnit Uptime: 357708 xStatus SystemUnit Software Application Software application.
  • Page 102 Codec C90 Contents Introduction Getting Started xStatus SystemUnit Hardware MainBoard SerialNumber Serial number of main board. Value space: S: 0..100 Default value: Example: *s SystemUnit Hardware MainBoard SerialNumber: “PH0528833” xStatus SystemUnit Hardware MainBoard Identifier States hardware revision of MainBoard. Value space: S: 0..100 Default value: Example:...
  • Page 103: The Video Status

    Codec C90 Contents Introduction Getting Started xStatus SystemUnit State NumberOfInProgressCalls Number of calls in progress. Value space: 0..5 Default value: Example: *s SystemUnit State NumberOfInProgressCalls: 0 xStatus SystemUnit State Subsystem Application State of system application. Value space: Initialized, Initializing Default value: N/AInitializing Example: *s SystemUnit State Subsystem Application: Initialized...
  • Page 104 Codec C90 Contents Introduction Getting Started xStatus Video Input YPbPr [1..2] Connected True if a connection on YPbPr 1 or YPbPr 2 is detected. Not all connections can be detected. Value space: True/False Default value: Example: *s Video Input YPbPr 2 Connected: False xStatus Video Input DVI [3, 5] Connected True if a connection on DVI 3 or DVI 5 is detected.
  • Page 105: Connecting The Camera

    Getting Started Your TANDBERG PrecisionHD 1080p Camera has been designed to give you many years of safe, reliable operation. Additional information about the camera is found in the TANDBERG PrecisionHD 1080p User Guide. D14128.02—NOVEMBER 2008 Interfaces About the API xConfiguration...
  • Page 106 & power on the camera to the Camera port on the codec. When the camera is used with TANDBERG codecs power will be supplied through Camera Control cable. When used with non-TANDBERG Codecs, you may have to connect power separately. HDMI and HD-SDI •...
  • Page 107 About the API xConfiguration xCommand Connecting HDMI If you need to connect the camera to a TANDBERG Video Switch or to a system with a DVI-D socket, use the enclosed HDMI to DVI-D adapter. System Integrator Guide Cameras xStatus Cameras...
  • Page 108 • Beard is normally not a problem. Using Best view Note that Best view works with TANDBERG C90 Codecs only! Press the Layout key on the remote control to display the Layout menu. Select Selfview to be shown as required.
  • Page 109 Contents Introduction Getting Started Video output formats This section describes the video output formats for the TANDBERG PrecisionHD 1080p camera. DIP switch settings for video output formats The video output format for the camera is set by DIP switches. The DIP switches are found on the bottom side of the camera.
  • Page 110 Contents Introduction Getting Started Cameras in daisy chain Example. Four daisy chained TANDBERG PrecisionHD 1080p cameras. A single daisy chain can have up to seven cameras. Cascaded cameras The sockets named Extra Camera and Power In are used when connecting cameras in daisy chain.
  • Page 111: Technical Specifications

    Codec C90 System Integrator Guide Appendices Contents Introduction Getting Started Interfaces About the API xConfiguration xCommand xStatus Cameras Appendices Contact us Chapter 9 Appendices In this chapter... Software upgrade Upload certificates XML files Log files NTP Time Zone expression Supported RFCs in SIP Remote Control TRC5 Remote Control key map PrecisionHD camera...
  • Page 112: D14128.02—November

    Software upgrade The software upgrade procedure Upgrade tab lets you select the software Contact your TANDBERG representative to obtain the software upgrade file. upgrade file for TANDBERG Codec C90 and install the new software. Please follow the procedure described on this page.
  • Page 113 Codec C90 Contents Introduction Getting Started Upload certificates The certificates upload procedure Upload certificates tab lets you upload a CA list Contact your system administrator to obtain the required files (.PEM format). (ROOT certificate) to authenticate TLS connections on SIP and a HTTPS certificate to enable HTTPS. The system administrator issues/obtains and installs unique certificates to each system.
  • Page 114 Codec C90 Contents Introduction Getting Started XML files View XML files XML files tab gives a complete overview of the Select the XML file to see a tree structure of all the configuration commands status of the system and the commands available on XML format.
  • Page 115: Log Files

    Select a debug log file by clicking on the name of the file. These are TANDBERG specific debug files which Some of the log files can be opened or saved. may be required by TANDBERG in the need of technical support. D14128.02—NOVEMBER 2008...
  • Page 116 Codec C90 Contents Introduction Getting Started NTP Time Zone expressions With reference to the setting xConfiguration Time Zone: <S: 0, 100> Specifies the NTP time zone where the system is located. Example 1: xConfiguration Time Zone: “America/New_York” Example 2: xConfiguration Time Zone: “Etc/UTC” NOTE: Spelling correctly is important when entering the NTP Time Zone expression.
  • Page 117 Codec C90 Contents Introduction Getting Started NTP Time Zone expressions, cont... America/Pangnirtung America/Yellowknife America/Paramaribo Antarctica America/Phoenix Antarctica/Casey America/Port_of_Spain Antarctica/Davis America/Port-au-Prince Antarctica/DumontDUrville America/Porto_Acre Antarctica/Mawson America/Porto_Velho Antarctica/McMurdo America/Puerto_Rico Antarctica/Palmer America/Rainy_River Antarctica/Rothera America/Rankin_Inlet Antarctica/South_Pole America/Recife Antarctica/Syowa America/Regina Antarctica/Vostok America/Resolute Arctic America/Rio_Branco Arctic/Longyearbyen America/Rosario Asia America/Santiago Asia/Aden...
  • Page 118 Codec C90 Contents Introduction Getting Started NTP Time Zone expressions, cont... Canada/Newfoundland Etc/GMT-2 Canada/Pacific Etc/GMT-3 Canada/Saskatchewan Etc/GMT-4 Canada/Yukon Etc/GMT-5 Etc/GMT-6 Chile Etc/GMT-7 Chile/Continental Etc/GMT-8 Chile/EasterIsland Etc/GMT-9 CST6CDT Etc/Greenwich Cuba Etc/UCT Etc/Universal Egypt Etc/UTC Eire Etc/Zulu Europe EST5EDT Europe/Amsterdam Europe/Andorra Etc/GMT Europe/Athens Etc/GMT+0 Europe/Belfast...
  • Page 119 Codec C90 Contents Introduction Getting Started Supported RFCs in SIP The RFC (Request for Comments) series contains technical and organizational documents about the Internet, including the technical specifications and policy documents produced by the Internet Engineering Task Force (IETF). D14128.02—NOVEMBER 2008 Interfaces About the API xConfiguration...
  • Page 120 Codec C90 Contents Introduction Getting Started TANDBERG Remote Control TRC5 Microphone: Press the key to toggle the microphones on/off. Volume: Press the – on the key to adjust the codec OK/Select: Press the key to confirm your choice or selection.
  • Page 121 Codec C90 Contents Introduction Getting Started TANDBERG Remote Control TRC5 key map The TANDBERG Remote control TRC5 has the following button codes and IR signal parameters. D14128.02—NOVEMBER 2008 Interfaces About the API xConfiguration Button codes - Remote control TRC5 Button codes - Remote control TRC5...
  • Page 122 Contents Introduction Getting Started The PrecisionHD camera This page describes the TANDBERG PrecisionHD camera, which was the first TANDBERG HD camera. Connecting the camera Video out. For video out signals, connect from the HDMI on the camera to a HDMI video input on the codec.
  • Page 123 Contents Introduction Getting Started CE Declaration for Codec C90 For an official, signed version of this document, or details regarding documentation from the technical construction file, please contact TANDBERG. EC Declaration of conformity MANUFACTURER: TANDBERG Telecom AS PRODUCT NAME: TANDBERG Codec C90...
  • Page 124 Codec C90 System Integrator Guide Appendices Contents Introduction Getting Started Interfaces About the API xConfiguration xCommand xStatus Cameras Appendices Contact us China RoHS table This product complies with the Chineese RoHS. D14128.02—NOVEMBER 2008...
  • Page 125 Codec C90 Contents Introduction Getting Started TANDBERG Codec C90 dimensions Dimensions in mm. D14128.02—NOVEMBER 2008 Interfaces About the API xConfiguration Front view Top view System Integrator Guide Appendices xCommand xStatus Cameras Appendices Left side view Contact us...
  • Page 126 Codec C90 Contents Introduction Getting Started PrecisionHD 1080p camera dimensions 105,0 148,1 32,2 220,0 ø79,6 ø82,0 D14128.02—NOVEMBER 2008 Interfaces About the API xConfiguration xCommand 105,9 (eye centre) 20,5 114,6 34,5 System Integrator Guide Appendices xStatus Cameras Appendices 142,0 125,4 190,0 14,0 191,0 Contact us...
  • Page 127 Codec C90 System Integrator Guide Appendices Contents Introduction Getting Started Interfaces About the API xConfiguration xCommand xStatus Cameras Appendices Contact us PrecisionHD camera dimensions D14128.02—NOVEMBER 2008...
  • Page 128: Dvi-I

    Up to 10 Mbps total MultiSite bandwidth • 1920x1080@50 fps (1080p50) • 1920x1080@30 fps (1080p30) FIREWALL TRAVERSAL • 1920x1080@25 fps (1080p25) • TANDBERG Expressway™ Technology • 1280x720@60 fps (720p60) • H.460.18, H.460.19 Firewall Traversal • 1280x720@50 fps (720p50) • 640x480@60 fps (480p60) VIDEO STANDARDS •...
  • Page 129: Not Supported In Version

    All images in these materials are for representational purposes only, actual products may differ. TANDBERG and Expressway are registered trademarks or trademarks of TANDBERG in the U.S. and other countries. All other trademarks are property of their respective owners. System Integrator Guide...
  • Page 130: D14128.02—November

    New York, NY 10036 Norway Telephone: +1 212 692 6500 Telephone: +47 67 125 125 Fax: +1 212 692 6501 Fax: +47 67 125 234 Video: +1 212 692 6535 Video: +47 67 126 126 E-mail: tandberg@tandberg.com E-mail: tandberg@tandberg.com D14128.02—NOVEMBER 2008...

This manual is also suitable for:

Codec c90

Table of Contents