Odin TeleSystems RTP Bridge User Manual

Summary of 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

    Rtp bridge user’s guide 2(36) copyright © copyright 2010, odin telesystems, inc. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the pri...

  • Page 3: Table of Contents

    Rtp bridge user’s guide 3(36) table of contents 1 introduction ......................................................................................................................................... 4 1.1 description ....................................................................................

  • Page 4: 1  Introduction

    Rtp bridge user’s guide 4(36) 1 introduction the rtp bridge is a universal streaming media gateway application running on the top of tdm (e1/t1) and rtp media streams designed for the industry's award-winning odin telecom frameworx (otx) hardware. This document provides detailed information about th...

  • Page 5

    Rtp bridge user’s guide 5(36) 1.2 features  simultaneous bi-directional data transfer between e1/t1 spans and various rtp remote nodes.  uses a telnet interface for e1/t1 timeslot–to-rtp endpoints mapping configuration.  transcoding of voice data between any of g.711 (a-law, u-law) / g.711.1 / g....

  • Page 6

    Rtp bridge user’s guide 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 para...

  • Page 7

    Rtp bridge user’s guide 7(36) parameter name possible values termination otx_t1e1_term_120_ohm, otx_t1e1_term_100_ohm, otx_t1e1_term_75_ohm, otx_t1e1_term_75_ohm_balanced, otx_t1e1_term_300_ohm, otx_t1e1_term_highz 2 rxthreshold positive integer, defaults to otx_hwlayer_default_rx_threshold: 500 set...

  • Page 8

    Rtp bridge user’s guide 8(36) doc. No. 1412-1-saa-1020-1 www.Odints.Com rev. 1.9 copyright © odin telesystems inc., 2010 example (alvis-4-csi): --------------------------------------------- otxhwlayer.Conf -------------------------------------- e1frameformat otx_e1_ff_crc4_multiframe # line terminat...

  • Page 9

    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 to alvis-csi firmware upgrade how to (odin document #1712-1-...

  • Page 10: 4  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 or -p changes the name of pid-file (where process identifier is ...

  • Page 11: 5  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 dsp load dsp load ex burst stats constat jitter blocksjitter blocks readconfig show ...

  • Page 12

    Rtp bridge user’s guide 12(36) packet. The abbreviations are: src is source, dst - destination, li - span, ts – timeslot, codec - codec name, ip – ip-address, r_port – remote port number, l_port – local port number. For span and timeslot parameters several formats are supported; you can skip li, ts ...

  • Page 13

    Rtp bridge user’s guide 13(36) the abbreviations are: src_li, dst_li: source/destination e1/t1 span src_ip, dst_ip: source/destination ip-address src_remote_port, dst_remote_port: source/destination src_local_port, dst_local_port: source/destination local port number format - defines which timeslots...

  • Page 14

    Rtp bridge user’s guide 14(36) figure 2 list of rtp connections created using mconnect command to disconnect a certain connection please see the number of this connection in the list and type the command (see figure 3): disconnect also for disconnection you can use a command similar to connect: disc...

  • Page 15

    Rtp bridge user’s guide 15(36) figure 3 list of connections after disconnection of one stream to test the dsp core load you can use the following commands (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 ...

  • Page 16

    Rtp bridge user’s guide 16(36) 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 s...

  • Page 17

    Rtp bridge user’s guide 17(36) jitter blocks:: the abbreviations are: max - jitter size, min - jitter delay in 10ms blocks. Note: new jitter blocks values do not apply to previously created connects. Thus you should create connects only after jitter blocks command input. This command can not be run ...

  • Page 18

    Rtp bridge user’s guide 18(36) example: core readconfig my.Conf 5.1 running rtp bridge commands from a configuration file to run the rtp bridge commands from a configuration file please input appropriate commands in a ‘cfg’ file and place it in a /root directory. The commands will run at rtp bridge ...

  • Page 19: 6  Transcoding Operation

    Rtp bridge user’s guide 19(36) doc. No. 1412-1-saa-1020-1 www.Odints.Com rev. 1.9 copyright © odin telesystems inc., 2010 6 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...

  • Page 20

    Codec name enc / dec number of test iterations bytes processed milliseconds bytes output n 5 g.723 enc 350 11256000 7270 562800 97 g.723 dec 500 20040000 2657 40080000 943 g.726 enc 120 3859200 6099 964800 40 g.726 dec 60 1200000 7191 4800000 42 g.729 enc 350 11256000 6047 703500 117 g.729 dec 850 4...

  • Page 21

    Rtp bridge user’s guide 21(36) enc / dec scenario gsm g.723.1 g.729 encoding: tdm(a-law)->encoding->rtp 129 67 77 decoding: rtp->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...

  • Page 22

    Rtp bridge user’s guide 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...

  • Page 23

    Rtp bridge user’s guide 23(36) doc. No. 1412-1-saa-1020-1 www.Odints.Com rev. 1.9 figure 7 rtp-to-tdm conference connection scheme scheme2: connect tdm:::[src_codec_1] conf:2 connect tdm:::[src_codec_2] conf:2 connect conf:2 rtp::::[dst_codec] figure 8 tdm-to-rtp conference connection scheme scheme3...

  • 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

    Rtp bridge user’s guide 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 ...

  • Page 26

    Rtp bridge user’s guide 26(36) 4. Run rtp bridge at alvis board 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. 1. In cli of rtp bridge issue the commands: connect tdm:li0:ts1:g711a rtp:127....

  • Page 27

    Rtp bridge user’s guide 27(36) c. Alvis board #1 should be one of the following otx boards:  alvis-4-csi  alvis-8-csi  alvis-asm d. Alvis board #2 should be one of the following otx boards: a. Alvis-2-csi b. Alvis-4-csi c. Alvis-4m-csi d. Alvis-8-csi e. Alvis-8m-csi f. Alvis-asm g. Alvis-pcie h. ...

  • Page 28

    Rtp bridge user’s guide 28(36) 11. Install rtp streamer package at alvis board #1 with a command: apt-get install rtpstreamer 12. Edit config file /opt/rtpstreamer/otxrtpstreamer.Conf. E.G.: -------------------- otxrtpstreamer.Conf -------------------- connect tdm:li0:ts1:alaw rtp:10.0.1.100:6002:50...

  • Page 29: 9  The Rtp Bridge License

    Rtp bridge user’s guide 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...

  • Page 30: 10  References

    Rtp bridge user’s guide 30(36) 10 references alvis-csi technical description (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 gu...

  • Page 31

    Rtp bridge user’s guide 31(36) doc. No. 1412-1-saa-1020-1 www.Odints.Com rev. 1.9 11 product versions history legend: [+] new features [–] removed functionality [*] bugs fixed [. ] other things 15/11/2010 v.1.9.1 internal beta release [+] added initial support for n64 streaming (31 timeslots, no hea...

  • Page 32

    Rtp bridge user’s guide 32(36) [+] added command "constat " that prints information about connection. [+] added command "jitter blocks::" that sets jitter time and jitter delay in 10ms blocks. 11/06/2010 v.1.6.1 internal release [. ] used otx xdmlink layer api v.1.6.0 [. ] some internal changes. 04/...

  • 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: 12  Document History

    Rtp bridge user’s guide 34(36) 12 document history rev. 1.9 december, 20, 2010  added new board types in chapter 2 t1/e1 channels configuration.  added new commands (bench, traces, events, console, core) in chapter 5 the rtp bridge commands. Updated some commands.  updated chapter 8 testing verif...

  • 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.  updated chapter 6 testing procedure. Rev. 1.2 june, 7, 2010 ...

  • Page 36: 13  Glossary

    Rtp bridge user’s guide 36(36) doc. No. 1412-1-saa-1020-1 www.Odints.Com rev. 1.9 copyright © odin telesystems inc., 2010 13 glossary  otx – odin telecom frameworx  csi – complete system integration  dsp – digital signal processor  sdk – software development kit  api – application programmer in...