Odin TeleSystems RTP Bridge, User Manual

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: ...BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR PARTICULAR PURPOSE ODIN TELESYSTEMS DOES NOT WARRANT THAT THE FUNCTIONALITY OF THE PRODUCT WILL MEET ANY REQUIREMENTS OR THAT THE OPERATIONS OF THE PRODUCT WILL BE UNINTERRUPTED OR ERROR FREE OR THAT DEFECTS WILL BE CORRECTED FURTHERMORE ODIN TELESYSTEMS DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF TH...

Page 3: ...Configuration File 18 5 2 Running RTP Bridge Commands from a Command Line 18 5 3 Running RTP Bridge Commands via Telnet Interface 18 6 Transcoding Operation 19 7 Multi conferences support 22 8 Testing Verification Procedure 25 8 1 Testing Scheme 1 25 8 2 Testing Scheme 2 26 9 The RTP Bridge License 29 10 References 30 11 Product Versions History 31 12 Document History 34 13 Glossary 36 Doc No 1412...

Page 4: ... 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 Figure 1 The universal streaming media gateway on the OTX Hardware The RTP Bridge is targeted to use DaVinci enabled products of Odin TeleSystems like Alvis CSI Alvis PBX Alvis PCIe Alvis ASM It runs on the emb...

Page 5: ...d built in configurable jitter buffer of incoming RTP packets TDM Passive monitoring provides the ability to stream E1 T1 spans to the RTP end points in a non intrusive mode Optimized data processing using multi core DaVinci architecture with offloading of all real time operations on the powerful C64 DSP core Compatible with the OTX DaVinci driver Compatible with the OTX XDM SDK API Multi session ...

Page 6: ...hrough any number of spaces Example T1E1LiMode E1 The configuration file can also contain comments The comment line begins with character and ends with the end of line If you need to allocate a few lines for comment you should put a character at the beginning of each line Example Line termination mode Most of the parameters are set by default all you need is to define a number of key parameters th...

Page 7: ...are marked bold 2 Line termination mode can be one of the following OTX_T1E1_TERM_120_OHM Span is terminated for 120 ohm twisted pair balanced differential signal OTX_T1E1_TERM_100_OHM Span is terminated for 100 ohm twisted pair balanced differential signal OTX_T1E1_TERM_75_OHM Span is terminated for 75 ohm coax unbalanced unipolar signal OTX_T1E1_TERM_HIGHZ Span is not terminated Balanced High im...

Page 8: ...is 4 CSI OtxHwLayer conf E1FrameFormat OTX_E1_FF_CRC4_MULTIFRAME Line termination mode Termination OTX_T1E1_TERM_100_OHM Receive threshold in mV RxThreshold 500 Set Monitor 20dB mode YES NO SetMonitorMode NO Turning front end Amplifier ON OFF FrontEndAmplifier OFF T1E1LiMode E1 Board type BoardType A4 Board No BoardNo 0 EOF ...

Page 9: ...w these steps 1 Update the rpm repository packets list apt get update 2 Install RTP Bridge package with a command apt get install rtpbridge 3 Reboot the board Alvis CSI sync reboot The RTP Bridge will automatically start at system start up daemon mode You can connect it via Telnet If you want to start with CLI then issue the commands service rtpbridge stop opt rtpbridge rtpbridge If you will get a...

Page 10: ...name or p file_name Changes the name of pid file where process identifier is stored By default it is var run rtpbridge pid port or P Changes port for Telnet interface By default it is 10000 burst or b Uses Burst events instead of Core to Core mechanism packetsize msec or s msec Sets the default size of RTP packets in milliseconds in TDM RTP Mode Doc No 1412 1 SAA 1020 1 www odints com Rev 1 9 Copy...

Page 11: ...utgoing stream To do a duplex connection one more connection needs to be done separately The fields are src_type dst_type RTP RTP connection TDM TDM cross connect TDMOE Pseudowire cross connect src_stream dst_stream For RTP IP address for TDM Span number src_idx dst_idx For RTP Port number local remote for TDM Timeslot opt Usually src_codec dst_codec are voice codec used for the specified stream e...

Page 12: ...ote_port src_local_port src_codec tdm dst_li dst_ts dst_codec Example connect rtp 192 168 102 70 5060 6060 g729 tdm li0 ts10 alaw Note Omitted src_codec will be set according to the incoming RTP payload type automatically Omitted dst_codec will be substituted by the default RTP stream encoder codec 3 TDM RTP Mode connect tdm src_li src_ts src_codec rtp dst_ip dst_remote_port dst_local_port dst_cod...

Page 13: ...f_conn rtp src_ip src_remote_port shift src_local_port shift src_codec rtp dst_ip dst_remote_port shift dst_local_port shift dst_codec The abbreviations are num_of_conn number of connections src_ip dst_ip source destination IP address src_remote_port dst_remote_port source destination remote port number src_local_port dst_local_port source destination local port number shift port s shift src_codec...

Page 14: ...se 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: ...ands See Figure 4 DSP LOAD Output the DSP load once DSP LOAD EX Output the DSP load in a loop 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: ...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 Figure 6 RTP connection statistics To set the jitter blocks parameters size and delay use the following command Doc No 1412 1 SAA 1020 1 www odints com Rev 1 9 Copyright Odin TeleSystems Inc 2010 ...

Page 17: ...g723 enc dec choose one option to test encoder or decoder test_num number of tests to run Note This command is not applicable to alaw ulaw and for some decoders Command is available only from console This command is only applicable if no connection exists TRACES on off switches DSP traces on off Note This command can be executed from consolу only EVENTS udp dst_ip dst_port src_port sets up event s...

Page 18: ...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 The default port is 10000 You can restrict access to RTP Bridge via the Telnet interface using White List feature For this please create allow conf file in o...

Page 19: ...oding operation of the following codecs G 711 a law u law G 711 1 G 711 2 G 723 G 726 G 729 GSM FR G 722 G 722 1 G 722 2 AMR WB Note that it is possible any combination between these codecs as in RTP channels so in TDM channels The transcoding operations are offloaded to powerful C64 DSP core 4700 MIPS of the TI DM64XX SoC processors without increasing the load of ARM core So the total number of t...

Page 20: ...63 28 30 1 9 G 723 enc 35 57 0 43 65 70 1 37 G 723 dec 35 15 3 2 45 50 2 0 G 726 enc 20 64 2 55 38 40 2 15 G 726 dec 20 51 1 53 40 45 1 73 G 729 enc 30 46 0 73 52 1 6 G 729 dec 30 22 0 53 50 55 2 43 Table 3 Overall testing results with account of incoming and outgoing RTP connections and jitter6 The Alvis powered by the RTP Bridge can successfully offload x86 servers increasing the compactness of ...

Page 21: ... decoding TDM A law 124 200 144 Encoding Decoding TDM A law encoding RTP 127 0 0 1 decoding TDM A law 62 51 49 Encoding Decoding RTP decoding encoding RTP 93 62 62 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: ... IP address for TDM Span number src_idx dst_idx For RTP Port number local remote for TDM Timeslot opt Usually src_codec dst_codec are voice codec used for the specified stream end e g alaw or g711a ulaw or g711u g729 g723 g726 etc conf_id Conference identifier any string to identify the conference The abbreviations are src is source dst destination li span ts timeslot codec codec name ip IP addres...

Page 23: ... 8 TDM to RTP conference connection scheme Scheme3 connect tdm src_li src_ts src_codec_1 conf 3 connect rtp src_ip src_port src_codec_2 conf 3 connect conf 3 rtp dst_ip dst_port dst_codec TDM RTP 1 RTP 2 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_p...

Page 24: ...mple 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: ...TP Bridge sets RTP connection on a loopback IP address 127 0 0 1 c Alvis Board should be one of the following OTX boards Alvis 2 CSI Alvis 4 CSI Alvis 4M CSI Alvis 8 CSI Alvis 8M CSI Alvis ASM Alvis PCIe Alvis 2 PBX 1 Update the rpm repository packets list at Alvis Board apt get update 2 Install RTP Bridge package at Alvis Board with a command apt get install rtpbridge 3 Reset Linux file buffers a...

Page 26: ... 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 To test RTP Bridge in conjunction with RTP Streamer please use the following connection scheme See Figure 12 Figure 12 RTP B...

Page 27: ... a command apt get install rtpbridge 7 Reset Linux file buffers at Alvis Board 2 with a command sync 8 Run RTP Bridge at Alvis Board 2 with the command opt rtpbridge rtpbridge 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 g7...

Page 28: ...ere D use Alvis 4 CSI board K use Alvis 4M CSI board X use Alvis 8 CSI board Q use Alvis 8M CSI board A use Alvis DMP hosted on ASM or PCIe ME use E1 Li mode MT use T1 Li mode P bytes set RTP packets payload size in bytes 14 Run the T1 E1 Analyzer Play the file alaw bin with T1 E1 Analyzer on TS1 So a The RTP Streamer should get TDM data from Li0 TS1 and send RTP packets with G 711 a law payload t...

Page 29: ...idge getsn The sn txt file in the tmp folder will be generated 2 Send by the email the sn txt file to Odin s Distributor to acquire the license A list of Distributors is available on http odints com pages dist distfs htm 3 After valid license receiving put the RtpBridge lic file in opt rtpbridge directory on the Alvis CSI and run the RTP Bridge See Chapter 3 The RTP Bridge Installation and Running...

Page 30: ...0 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: ...Rtp so to work properly Added t testrtp command line argument that turns on check for RTP sequences for debug purposes Added dummy connection point null codec Added partial support of Alvis ASM Host x86 based application is necessary for TDM to work properly Improved ARM DSP interconnection Unified command handling for console telnet interfaces and config file root cfg Fixed mconnect command handl...

Page 32: ...ity is added TDM to RTP functionality is added TDM to TDM functionality is added 20 04 2010 V 1 4 1 Internal release Buffers handling in asynchronous transcoding are enhanced DSP jitter is enhanced Timestamps are fixed Source clock frequency for some RTP payload types is fixed 06 04 2010 V 1 4 0 Internal release Multi party conferences support is added 18 03 2010 V 1 3 1 Internal release New Telne...

Page 33: ...e 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: ...ENSE and PACKET SIZE commands Product Versions History was moved down to the Chapter 10 Rev 1 6 July 1 2010 Updated Product Revisions History changed history order added V 1 6 1 and V 1 7 0 descriptions Updated Figure 1 Updated list of features in Chapter 1 2 Updated Chapter 2 edited Table 1 and example of configuration file Added Chapter 3 The RTP Bridge Installation and Running Updated Chapter 4...

Page 35: ...hed benchmark tables Updated Chapter 6 testing Procedure Rev 1 2 June 7 2010 Added Chapter 2 OtxHwLayer Configuration Updated 1 2 Features Updated Linux command line format Rev 1 1 May 13 2010 Updated Table 3 in Chapter 4 new codec benchmark Added warning in Chapter 6 testing scheme Rev 1 0 Apr 22 2010 A First Version Doc No 1412 1 SAA 1020 1 www odints com Rev 1 9 Copyright Odin TeleSystems Inc 2...

Page 36: ...s Inc 2010 13 Glossary OTX Odin Telecom FrameworX CSI Complete System Integration DSP Digital Signal Processor SDK Software Development Kit API Application Programmer Interface RTP Real time Transport Protocol TDM Time division multiplexing SNMP Simple Network Management Protocol LED Light emitting diode ...