Export to GitHub

webrtc2sip - Building_Source_v2_0.wiki

This section explains how to build the project using CentOS 64 but could be easily adapted for any Linux, Windows or OS X.
webrtc2sip gateway depends on Doubango IMS Framework v2.0.
We highly recommend reading the Technical guide.

Preparing the system

sudo yum update sudo yum install make libtool autoconf subversion git cvs wget libogg-devel gcc gcc-c++ pkgconfig nasm

Building Doubango IMS Framework and 3rd-party libraries

Doubango is an IMS framework and contains all signaling protocols (SIP, SDP, WebSocket…) and media engine (RTP stack, audio/video codecs…) required by webrtc2sip gateway.
The first step is to checkout Doubango 2.0 source code: svn checkout https://doubango.googlecode.com/svn/branches/2.0/doubango doubango

Building libsrtp

libsrtp is required. git clone https://github.com/cisco/libsrtp/ cd libsrtp git checkout v1.5.0 CFLAGS="-fPIC" ./configure --enable-pic && make && make install

Building OpenSSL

OpenSSL is required if you want to use the RTCWeb Breaker module or Secure WebSocket transport (WSS). OpenSSL version 1.0.1 is required if you want support for DTLS-SRTP.
This section is only required if you don’t have OpenSSL installed on your system or using version prior to 1.0.1 and want to enable DTLS-SRTP.
A quick way to have OpenSSL may be installing openssl-devel package but this version will most likely be outdated (prior to 1.0.1). Anyway, you can check the version like this: openssl version To build OpenSSL: wget http://www.openssl.org/source/openssl-1.0.1c.tar.gz tar -xvzf openssl-1.0.1c.tar.gz cd openssl-1.0.1c ./config shared --prefix=/usr/local --openssldir=/usr/local/openssl && make && make install

Building libspeex and libspeexdsp

libspeex (audio codec) an libspeexdsp (audio processing and jitter buffer) are optional. It’s highly recommended to enable libspeexdsp.

You can install the devel packages: sudo yum install speex-devel Or build the source by yourself: wget http://downloads.xiph.org/releases/speex/speex-1.2beta3.tar.gz tar -xvzf speex-1.2beta3.tar.gz cd speex-1.2beta3 ./configure --disable-oggtest --without-libogg && make && make install

Building YASM

YASM is only required if you want to enable VPX (VP8 video codec) or x264 (H.264 codec). wget http://www.tortall.net/projects/yasm/releases/yasm-1.2.0.tar.gz tar -xvzf yasm-1.2.0.tar.gz cd yasm-1.2.0 ./configure && make && make install

Building libvpx

Date: December 1, 2012
libvpx adds support for VP8 and is optional but highly recommended if you want support for video when using Google Chrome or Mozilla Firefox.

You can install the devel packages: sudo yum install libvpx-devel Or build the source by yourself: git clone http://git.chromium.org/webm/libvpx.git cd libvpx ./configure --enable-realtime-only --enable-error-concealment --disable-examples --enable-vp8 --enable-pic --enable-shared --as=yasm make && make install

Building libyuv

libyuv is optional. Adds support for video scaling and chroma conversion. mkdir libyuv && cd libyuv svn co http://src.chromium.org/svn/trunk/tools/depot_tools . ./gclient config http://libyuv.googlecode.com/svn/trunk ./gclient sync && cd trunk make -j6 V=1 -r libyuv BUILDTYPE=Release make -j6 V=1 -r libjpeg BUILDTYPE=Release cp out/Release/obj.target/libyuv.a /usr/local/lib cp out/Release/obj.target/third_party/libjpeg_turbo/libjpeg_turbo.a /usr/local/lib mkdir --parents /usr/local/include/libyuv/libyuv cp -rf include/libyuv.h /usr/local/include/libyuv cp -rf include/libyuv/*.h /usr/local/include/libyuv/libyuv

Building libopus

libopus is optional but highly recommended as it’s an MTI codec for WebRTC. Adds support for Opus audio codec. wget http://downloads.xiph.org/releases/opus/opus-1.0.2.tar.gz tar -xvzf opus-1.0.2.tar.gz cd opus-1.0.2 ./configure --with-pic --enable-float-approx && make && make install

Building opencore-amr

opencore-amr is optional. Adds support for AMR audio codec. git clone git://opencore-amr.git.sourceforge.net/gitroot/opencore-amr/opencore-amr cd opencore-amr autoreconf --install && ./configure && make && make install

Building libgsm

libgsm is optional. Adds support for GSM audio codec.

You can install the devel packages (recommended): sudo yum install gsm-devel Or build the source by yourself: ``` wget http://www.quut.com/gsm/gsm-1.0.13.tar.gz tar -xvzf gsm-1.0.13.tar.gz cd gsm-1.0-pl13 && make && make install

cp -rf ./inc/* /usr/local/include

cp -rf ./lib/* /usr/local/lib

```

Building g729

G729 is optional. Adds support for G.729 audio codec. svn co http://g729.googlecode.com/svn/trunk/ g729b cd g729b ./autogen.sh && ./configure --enable-static --disable-shared && make && make install

Building iLBC

iLBC is optional. Adds support for iLBC audio codec. svn co http://doubango.googlecode.com/svn/branches/2.0/doubango/thirdparties/scripts/ilbc cd ilbc wget http://www.ietf.org/rfc/rfc3951.txt awk -f extract.awk rfc3951.txt ./autogen.sh && ./configure make && make install

Building x264

Date: December 2, 2012
x264 is optional and adds support for H.264 video codec (requires FFmpeg). ``` wget ftp://ftp.videolan.org/pub/x264/snapshots/last_x264.tar.bz2 tar -xvjf last_x264.tar.bz2

the output directory may be difference depending on the version and date

cd x264-snapshot-20121201-2245 ./configure --enable-shared --enable-pic && make && make install ```

Building FFmpeg

Date: December 2, 2012
FFmpeg is optional and adds support for H.263, H.264 (requires x264) and MP4V-ES video codecs. ``` git clone git://source.ffmpeg.org/ffmpeg.git ffmpeg cd ffmpeg

grap a release branch

git checkout n1.2

configure source code

./configure \ --extra-cflags="-fPIC" \ --extra-ldflags="-lpthread" \ \ --enable-pic --enable-memalign-hack --enable-pthreads \ --enable-shared --disable-static \ --disable-network --enable-pthreads \ --disable-ffmpeg --disable-ffplay --disable-ffserver --disable-ffprobe \ \ --enable-gpl --enable-nonfree \ \ --disable-debug

to force enabling h264, append to the configure command: --enable-libx264 --enable-encoder=libx264 --enable-decoder=h264

to force enabling h263 and h263+, append to the configure command: --enable-encoder=h263 --enable-encoder=h263p --enable-decoder=h263

build and install

make && make install ```

Building OpenH264

OpenH264 is optional. Adds support for H.264 constrained baseline video codec. git clone https://github.com/cisco/openh264.git cd openh264 git checkout v1.1 make ENABLE64BIT=Yes # Use ENABLE64BIT=No for 32bit platforms make install

Building Doubango

  • Minimal build cd doubango && ./autogen.sh && ./configure --with-ssl --with-srtp --with-speexdsp make && make install
  • Recommended build cd doubango && ./autogen.sh && ./configure --with-ssl --with-srtp --with-vpx --with-speexdsp --with-ffmpeg --with-opus make && make install
  • Full build cd doubango && ./autogen.sh && ./configure --with-ssl --with-srtp --with-vpx --with-yuv --with-amr --with-speex --with-speexdsp --with-opus --with-gsm --with-ilbc --with-g729 --with-ffmpeg make && make install

Building webrtc2sip and 3rd-party libraries

webrtc2sip depends on Doubango IMS Framework v2.0 and libxml2.
The first step is to checkout the source code: svn co https://webrtc2sip.googlecode.com/svn/trunk/ webrtc2sip

Installing libxml2

yum install libxml2-devel

Building webrtc2sip

export PREFIX=/opt/webrtc2sip cd webrtc2sip && ./autogen.sh && ./configure --prefix=$PREFIX make clean && make && make install cp -f ./config.xml $PREFIX/sbin/config.xml The gateway is configured using config.xml. Please check the technical guide for more information about this file.


Et voilà