Advertisement

Quick Links

Odin TeleSystems Inc.
RTP Bridge
User's Guide
Doc. No. 1412-1-SAA-1020-1
Rev. 1.9
December 20, 2010
Copyright © Odin TeleSystems Inc, 2010
www.odints.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the RTP Bridge and is the answer not in the manual?

Questions and answers

Summary of Contents for Odin TeleSystems RTP Bridge

  • Page 1 Odin TeleSystems Inc. RTP Bridge User’s Guide Doc. No. 1412-1-SAA-1020-1 Rev. 1.9 December 20, 2010 Copyright © Odin TeleSystems Inc, 2010 www.odints.com...
  • Page 2 The material in this document is for information only and is subject to change without notice. While reasonable efforts have been made in the preparation of this document to assure its accuracy, Odin TeleSystems Inc., assumes no liability resulting from errors or omissions in this document, or from the use of the information contained herein.
  • Page 3: Table Of Contents

    The RTP Bridge Installation and Running..................9 Command Line Arguments......................10 The RTP Bridge Commands ......................11 Running RTP Bridge Commands from a Configuration File............18 Running RTP Bridge Commands from a Command Line..............18 Running RTP Bridge Commands via Telnet Interface..............18 Transcoding Operation........................
  • Page 4: Introduction

    RTP end-points (G.711, G.723, G.726, G.729, GSM-FR, G.722 / G.722.1 / G.722.2 (AMR-WB)) in any order. (See Figure 1) It is also possible to use the RTP Bridge product without E1/T1 TDM streams. In that case the RTP Bridge connects data from one IP-Address:Port to another IP-Address:Port, with transcoding options.
  • Page 5: Features

    E1/T1 timeslot to different remote locations at the same time.)  N64 Streaming support (The RTP Bridge allows to send E1 super channels over UDP to PC, and backwards, to receive UDP packets with E1 data and to send them to E1 as super channels).
  • Page 6: T1/E1 Channels Configuration

    6(36) 2 T1/E1 Channels Configuration The T1/E1 channels configuration before running the RTP Bridge is optional. It is set in “OtxHwLayer.conf” file in a case of RTP Bridge uses T1/E1 streams. The structure of the OtxHwLayer configuration file should be composed from the parameters provided by line.
  • Page 7 Explanation of abbreviations for the BoardType parameter: A2 - OTX_DEVICE_DMP_ALVIS_2_CSI, A2P - OTX_DEVICE_DMP_ALVIS_2_PBX, A4 - OTX_DEVICE_DMP_ALVIS_4_CSI, A8 - OTX_DEVICE_DMP_ALVIS_8_CSI, A4M - OTX_DEVICE_DMP_ALVIS_4M_CSI, A8M - OTX_DEVICE_DMP_ALVIS_8M_CSI, AA - OTX_DEVICE_DMP_ALVIS. Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 8 # Set Monitor (-20dB) mode (YES/NO) SetMonitorMode # Turning front end Amplifier ON/OFF FrontEndAmplifier OFF T1E1LiMode E1 # Board type BoardType # Board No BoardNo -------------------------------------------------- EOF -------------------------------------------------- Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 9: The Rtp Bridge Installation And Running

    RTP Bridge User’s Guide 9(36) 3 The RTP Bridge Installation and Running It is recommended to install the RTP Bridge on Alvis-4-CSI board with firmware package version 2.11.12 or later. For more information of firmware upgrade, please refer Alvis-CSI Firmware Upgrade HOW TO (Odin document #1712-1-HCA-1020-1.0-...
  • Page 10: Command Line Arguments

    RTP Bridge User’s Guide 10(36) 4 Command Line Arguments The RTP Bridge accepts several command line arguments: --help or -h Displays help with command line arguments available. --daemon or -d Runs the RTP Bridge in a daemon mode. --pid <file_name> or -p <file_name>...
  • Page 11: The Rtp Bridge Commands

    RTP Bridge User’s Guide 11(36) 5 The RTP Bridge Commands There are several commands available to control / get status of connections between the RTP and TDM media streams (or mixed):  CONNECT  MCONNECT  LIST  DISCONNECT ...
  • Page 12 Example: connect tdm:li0:ts10:alaw rtp:192.168.102.70:5060:6060:g729 4. RTP -> RTP Mode connect rtp:<src_ip>:<src_remote_port>:<src_local_port>[:src_codec] rtp:<dst_ip>:<dst_remote_port>:<dst_local_port>[:dst_codec] Example: connect rtp:192.168.102.60:5060:6060:g726 rtp:192.168.102.70:5060:6060:g729 5. N64 Streaming connect tdmli:<src_li#>[:format] tdmop:<dst_ip>:<dst_remote_port>:<dst_local_port> connect tdmop:<src_ip>:<src_remote_port>:<src_local_port> tdmli:<dst_li#> Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 13 (or g711u), g723, g726, g729. Note: You can use this command only in the case of RTP Bridge commands run from a configuration file (Refer to Chapter 5.1). If src_codec and dst_codec parameters are not specified, they take the default value.
  • Page 14 To disconnect a certain connection please see the number of this connection in the list and type the command (See Figure 3): DISCONNECT <connection_number> Also for disconnection you can use a command similar to CONNECT: DISCONNECT <src_type>:<src_stream>:<src_idx>:[opt] dst_type>:<dst_stream>:<dst_idx>:[opt] Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 15 Figure 4 DSP core load output Note: These DSP LOAD commands are available only from console. To display the Burst statistics use the following command (See Figure 5): BURST STATS Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 16 Figure 5 Burst statistics output Note: This command can be run only from console. This command is deprecated. It is applicable in non Core-2-Core mode of RTP Bridge only. To display channel statistics (is channel incoming or outgoing, TDM or RTP, payload type, Jitter statistics for RTP connections) use the command (See Figure 6): CONSTAT <connection_number>...
  • Page 17 Example: jitter blocks:500:30 (jitter time is 5 seconds, jitter delay is 300 milliseconds) SHOW LICENSE – displays information on RTP Bridge license (customer name, software version, board serial number, and expiration date). PACKET SIZE <msec> - sets the default size of RTP packets (in milliseconds) in TDM->RTP Mode.
  • Page 18: Running Rtp Bridge Commands From A Configuration File

    READCONFIG <file_name> 5.2 Running RTP Bridge Commands from a Command Line The RTP Bridge commands can be run from a command line (CLI). Type the appropriate commands after running of RTP Bridge. 5.3 Running RTP Bridge Commands via Telnet Interface If the RTP Bridge is already running, you can use the Telnet Interface for dynamic configuration (real-time control commands).
  • Page 19: Transcoding Operation

    Odin provides boards with pre-installed and pre-configured vocoders. They are also available with the OTX XDM SDK. The RTP Bridge supports the transcoding operation (data converting from one codec to another as softswitch) by the following scheme: CodecA -> linear PCM16 -> CodecB.
  • Page 20 2.43 Table 3 Overall testing results with account of incoming and outgoing RTP connections and jitter The Alvis powered by the RTP Bridge can successfully offload x86 servers increasing the compactness of solution. This makes possible to create low power-consumption devices as a breeze.
  • Page 21 21(36) Enc / Dec G.723.1 G.729 Scenario Encoding: TDM(A-law)->encoding->RTP Decoding: RTP->decoding->TDM(A-law) Encoding+Decoding: TDM(A-law)->encoding-> RTP(127.0.0.1)->decoding->TDM(A-law) Encoding+Decoding: RTP->decoding->encoding->RTP Table 5 TI C64+ DSP Core Load Tests in various Encoding/Decoding Scenarios Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 22: Multi-Conferences Support

    22(36) 7 Multi-conferences support The RTP Bridge supports a multi-conference mode. It is possible to create any number of conference participants. The number of conferences is unlimited and mixing operations are offloaded on the DSP C64x+ core simultaneously with transcoding and RTP packetizing.
  • Page 23 RTP 2 RTP 1 Figure 9 TDM+RTP-to-RTP conference connection scheme Scheme4: connect rtp:<src_ip_1>:<src_port_1>:[src_codec_1] conf:4 connect rtp:<src_ip_2>:<src_port_2>:[src_codec_2] conf:4 connect conf:4 rtp:<src_ip_3>:<src_port_3>:[src_codec_3] Figure 10 RTP-to-RTP conference connection scheme Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 24 RTP Bridge User’s Guide 24(36) Example: connect rtp:192.168.102.9:8002:7002 conf:test1 connect rtp:192.168.102.9:8004:7004 conf:test1 connect conf:test1 rtp:192.168.102.9:8006:7006:alaw Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 25: Testing Verification Procedure

    25(36) 8 Testing Verification Procedure 8.1 Testing Scheme 1 To test RTP Bridge please use the following connection scheme (See Figure 11): Figure 11 RTP Bridge Testing Scheme 1 Notes to the scheme: a. The T1/E1Analyzer is run on an OTX board (e.g., on t2pp) connected to Li0 of the Alvis Board.
  • Page 26: Testing Scheme 2

    3. Run the T1/E1 Analyzer. Play audio file in a-law format with T1/E1 Analyzer on TS1. 4. The RTP Bridge should put a-law data to Li0:TS1 that you can listen with the T1/E1 Analyzer. 8.2 Testing Scheme 2 Note: For testing by this scheme, you should have RTP Streamer software with valid license.
  • Page 27 If you will get a “No license found” message please follow the instructions in Chapter 9 - The RTP Bridge License. 9. In CLI of RTP Bridge at Alvis Board #2 issue the command: connect rtp:10.0.1.2:5002:6002 rtp:10.0.1.2:5004:6004:g711u where 10.0.1.2 is the IP-address of the Alvis Board #1.
  • Page 28 The RTP Streamer should get TDM data from Li0:TS1 and send RTP packets with G.711 (a-law) payload to the RTP Bridge. b. The RTP Bridge should decode this G.711 (a-law) encoded data and return it in RTP packets with G.711 (u-law) payload to the RTP Streamer.
  • Page 29: The Rtp Bridge License

    29(36) 9 The RTP Bridge License To successfully run the OTX RTP Bridge you should have a license (.lic file) in the “/opt/rtpbridge” directory of installed software. Please perform these steps: 1. Get a board serial number. To do this, run the RTP Bridge with a key: rtpbridge --getsn The “sn.txt”...
  • Page 30: References

    (Odin document # 1111-1-HCA-1020-1-1.0- 1.5)  Alvis-PCIe Technical Description (Odin document # 1111-1-HCA-1021-1-1.0- 1.1)  Alvis-ASM Technical Description (Odin document #1111-1-HCA-1018-1-1.0- 1.0)  RTP Streamer User’s Guide (Odin document #1412-1-SMA-1035-1-1.0-1.1) Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 31: Product Versions History

    [. ] Changed default pid file name to /var/run/rtpbridge.pid (was /var/run/rtpstreamer.pid). 24/06/2010 V.1.7.0 Internal release [*] Fixed several alignment traps. [. ] Used OTX XdmLink Layer API v.1.7.0. Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 32 [+] Performance gains and several stability fixes. 12/02/2010 V.1.2.0 Internal release [+] Asynchronous transcoding is added. [+] Performance gains. 27/01/2010 V.1.1.0 Internal release [+] Many internal changes are added. 15/01/2010 V.1.0.1 Internal release Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 33 RTP Bridge User’s Guide 33(36) [*] Timestamps calculation for outgoing RTP packets is fixed. [*] Telnet interface is fixed. 29/12/2009 V.1.0.0 Initial internal alpha release Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...
  • Page 34: Document History

    Added an example of how to see board serial number in the case of RTP Streamer. Rev. 1.4 June, 18, 2010  Added ‘constat’ command description in Chapter 3 The RTP Bridge Commands.  Added a note about license generating in Chapter 6 Testing Procedure. ...
  • Page 35 RTP Bridge User’s Guide 35(36)  Updated Chapter 2 OtxHwLayer Configuration.  Changed the title of Chapter 3 to The RTP Bridge Commands.  Added 3 sub-chapters in Chapter 3: how-to run RTP Bridge commands.  Refreshed benchmark tables. ...
  • Page 36: Glossary

    API – Application Programmer Interface  RTP – Real-time Transport Protocol  TDM – Time-division multiplexing  SNMP – Simple Network Management Protocol  LED – Light-emitting diode Doc. No. 1412-1-SAA-1020-1 www.odints.com Rev. 1.9 Copyright © Odin TeleSystems Inc., 2010...

Table of Contents