La video sous Asterisk (UMTS/3G)

Traduction

J’ai mis en place une version wiki permettant de traduire. Merci à tous les traducteurs.

 Anglais
 Espagnol
 Français
 Portugais

Objectif

Installer Asterisk 1.4 avec le support de la vidéo 3G sur une distribution Debian etch. Nous utiliserons aussi une carte Digium B410P avec avec port BRI. (T0)

Pour le moment, semble fonctionner avec un téléphone Nokia n95 (SFR) et le dernier LG (Orange). Ne semble pas marcher avec un Sony Ericson k600i (Orange).

Installation / mise à jour de debian

Le première chose à faire sera d’installer un système d’exploitation GNU/Linux. Nous allons choisir la distribution debian. Disponible sur http://www.debian.org.

Une fois l’installation terminée et vu qu’il s’agit d’une installation toute nouvelle, nous devons mettre à jour notre distribution.

Lancez dans un prompt

 aptitude update
 aptitude dist-upgrade

Répondez Y à la mise à jour. Puis rebooter votre machine car il y a sûrement des mises à jour sur le noyau linux.

 reboot

Installation des drivers mISDN

Ces drivers nous permettrons d’avoir une connection sur un T0 avec une carte B410P de chez Digium.

Si jamais vous n’avez pas installé les outils de compilation, n’oubliez pas de les installer, ainsi que les kernel headers pour les modules mISDN.

 aptitude install build-essential
 aptitude install linux-headers-2.6.18-5-686

 cd /usr/src/
 wget http://www.misdn.org/downloads/rele...
 tar xfvz mISDN-1_1_7.tar.gz
 cd mISDN-1_1_7
 make
 make install
 cd ..
 aptitude install flex
  wget http://www.misdn.org/downloads/rele...
 tar xfvz mISDNuser-1_1_7.tar.gz
 cd mISDNuser-1_1_7
 make
 make install

Installation des dépendances pour faire marcher mISDN

 aptitude install pciutils bc

Puis configuration de la carte

 /etc/init.d/misdn-init scan
 /etc/init.d/misdn-init config
 /etc/init.d/misdn-init start

Vérification de la présence des dépendances nécessaire.

Dans un terminal utilisez dpkg pour vérifier la présence de openssl, zlib, zlib-devel, curl, libnewt-dev.

 dpkg -l libncurses5 libncurses5-dev libssl0.9.7 libssl-dev zlib1g zlib1g-dev curl libnewt-dev
 Souhait=inconnU/Installé/suppRimé/Purgé/H=à garder
 | État=Non/Installé/fichier-Config/dépaqUeté/échec-conFig/H=semi-installé
 |/ Err ?=(aucune)/H=à garder/besoin Réinstallation/X=les deux (État,Err : majuscule=mauvais)
 ||/ Nom                               Version                           Description
 +++-=================================-=================================-==================================================================================
 ii  libncurses5                       5.4-4                             Shared libraries for terminal handling
 ii  libncurses5-dev                   5.4-4                             Developer’s libraries and docs for ncurses
 ii  libssl0.9.7                       0.9.7e-3sarge4                    SSL shared libraries
 ii  libssl-dev                        0.9.7e-3sarge4                    SSL development libraries, header files and documentation
 ii  libnewt-dev                       0.52.2-10                         Developer’s toolkit for newt windowing library
 ii  zlib1g                            1.2.2-4.sarge.2                   compression library - runtime
 ii  zlib1g-dev                        1.2.2-4.sarge.2                   compression library - development
 ii  curl                              7.13.2-2sarge5                    Get a file from an HTTP, HTTPS, FTP or GOPHER server

Vous devez avoir tous les paquets requis installés.

Si cela n’est pas le cas il faudra les installer avec la commande :

 aptitude install libncurses5 libncurses5-dev libssl0.9.7 libssl-dev zlib1g zlib1g-dev curl libnewt-dev

Télécharger les tarballs du code source de la version 1.4

 Dans un terminal, connectez vous en root avec sudo -s.
 Changez de répertoire

 cd  /usr/src 
 wget http://downloads.digium.com/pub/ast...
 wget http://downloads.digium.com/pub/ast...
 wget http://downloads.digium.com/pub/zap...
 wget http://downloads.digium.com/pub/tel...
 wget http://downloads.digium.com/pub/tel...
 wget http://downloads.digium.com/pub/tel...

Décompresser le code source

Toujours en étant connecté en root, dans le répertoire /usr/src, décompressez le code source :

 tar xfvz asterisk-1.4.15.tar.gz
 tar xfvz asterisk-addons-1.4.5.tar.gz
 tar xfvz libpri-1.4.2.tar.gz
 tar xfvz zaptel-1.4.7.tar.gz

Vous devez maintenant avoir les répertoires suivants :

 libpri-1.4.2
 zaptel-1.4.7
 asterisk-1.4.15
 asterisk-addons-1.4.5

Nous traiterons les fichiers sons et les fichiers de la musique d’attente un peu plus tard.

Compiler Asterisk et ses dépendances

L’ordre que nous devons suivre pour compiler le code

 libpri
 zaptel
 asterisk
 asterisk-addons

Vous remarquerez que Zaptel et Asterisk possèdent une étape supplémentaire : make config

Le ’’make config’’ configure linux afin qu’il lance ces applications au démarrage.

 cd libpri-1.4.2
 make
 make install
 cd ..
 cd zaptel-1.4.7
 ./configure
 make 
 make install
 make config 
 cd ..

 cd asterisk-1.4.15
 ./configure
 make
 make install
 make samples
 make config
 cd ..

 cd asterisk-addons-1.4.5
 ./configure
 make
 make install
 make samples
 cd ..

Après la prochaine étape consistant à redémarrer, vous devez avoir un Asterisk fonctionnel.

Installation du support 3G Asterisk

Développeur : http://sip.fontventa.com

Récupération des outils

 aptitude install subversion
 aptitude install libpt-1.11.2-dev
 cd /usr/src/
 svn co http://sip.fontventa.com/svn/asterisk/ asterisk-video
 cd asterisk-video

Compilation de la librairie H324M

Comme nous souhaitons utiliser cette librairie avec mISDN, il faudra modifier le fichier h324m.cpp et commenter les lignes avec // qui contiendront TIFFReverseBits

Attention, ceci n’est valable que pour mISDN et non pour zaptel. Voir le lien : http://sip.fontventa.com/content/vi...

Nous allons le modifier avec ce petit patch. Il suffit de le copier dans un fichier, par exemple misdn_patch_h324m.diff puis d’aller dans le répertoire.

Le patch

 --- h324m.cpp   2007-12-17 09:06:50.000000000 +0100
 +++ h324m.cpp.orig      2007-12-17 09:06:22.000000000 +0100
 @@ -40,14 +40,14 @@
  int  H324MSessionRead(void * id,unsigned char *buffer,int len)
   
 -       //TIFFReverseBits(buffer,len) ;
 +       TIFFReverseBits(buffer,len) ;
         return ((H324MSession*)id)->Read(buffer,len) ; 
  

  int  H324MSessionWrite(void * id,unsigned char *buffer,int len)
   
         int ret = ((H324MSession*)id)->Write(buffer,len) ; 
 -       //TIFFReverseBits(buffer,len) ;
 +       TIFFReverseBits(buffer,len) ;
        return ret ;
 

Puis

 cd /usr/src/asterisk-video/libh324m
 cp endroit_de_votre_patch .

Pour le patcher

 patch -p0 < misdn_patch_h324m.diff

Puis nous pourrons compiler la librairie

 cd /usr/src/asterisk-video/libh324m
 make
 make install

Installation du codec AMR

Nous allons installer notre codec AMR afin de pouvoir prendre en compte ce codec qui n’est pas par défaut dans Asterisk.

 cd /usr/src/asterisk-1.4.15
 patch -p0 < /usr/src/asterisk-video/amr/amr-asterisk-patch.txt
 cd codecs
 ln -s ../../asterisk-video/amr/amr_slin_ex.h .
 ln -s ../../asterisk-video/amr/slin_amr_ex.h .
 ln -s ../../asterisk-video/amr/codec_amr.c .
 mkdir amr
 cd amr
 wget http://www.3gpp.org/ftp/Specs/archive/26_series/26.104/26104-700.zip
 aptitude install unzip
 unzip -j 26104-700.zip
 unzip -j 26104-700_ANSI_C_source_code.zip
 ln -s ../../asterisk-video/amr/Makefile .

Editer le fichier Makefile dans /usr/src/asterisk-1.4.15/codecs et modifier la ligne 59 :

 vi /usr/src/asterisk-1.4.15/codecs/Makefile

Changer

 $(LIBAMR) :
         @$(MAKE) -C amr

par

 $(LIBAMR) :
         @$(MAKE) -C amr all

Vous pouvez également modifier les fichiers interf_enc.c et interf_dec.c en enlevant les caractères bizarre en fin du fichier. Puis retourner dans les sources d’Asterisk.

 cd /usr/src/asterisk-1.4.15/
 ./configure
 make
 make install

Rajouter la ligne suivante dans votre fichier de configuration des codecs Asterisk (/etc/asterisk/codecs.conf)

 [amr]
 octet-aligned=1

Installation de l’application H324 gateway

Cette application permettra d’avoir des commandes pour recevoir et émettre des appels en 3G. Nous allons ajouter un petit Makefile afin de pouvoir recompiler plus facilement notre application.

 cd /usr/src/asterisk-video/app_h324m
 cat Makefile << EOF
 ---------- cut ------------
 CFLAGS ?= -O2 -fPIC
 Z_CFLAGS := $(CFLAGS) -D _GNU_SOURCE -Wall -Wmissing-prototypes -Wstrict-prototypes
 LIBS ?=
 Z_LIBS := $(LIBS) -lpthread -lh324m
 BINARY = app_h324m.so
 OBJECTS = app_h324m.o

 DESTDIR ?=
 PREFIX ?= /usr

 .PHONY : install clean

 $(BINARY) : $(OBJECTS)
         $(CC) -shared -Xlinker -x -o $(BINARY) $(OBJECTS) $(Z_LIBS)

 %.o : %.c
         $(CC) $(Z_CFLAGS) -c -o $@ $<

 install : $(BINARY)
         install -d $(DESTDIR)$(PREFIX)/lib/asterisk/modules
         install -m 755 $(BINARY) $(DESTDIR)$(PREFIX)/lib/asterisk/modules

 clean :
         rm -f $(BINARY) $(OBJECTS)
 ---------- cut ---------
 EOF

Il faudra également modifier le fichier app_h324m.c en ajoutant ligne 48 ce #define.

 #define AST_MODULE      "h324m application"

Installation de la librairie mpeg4ip

Cette librairie est une dépendance de l’application app_mp4.

 cd /usr/src/
 wget http://heanet.dl.sourceforge.net/so...
 tar xfvz mpeg4ip-1.5.0.1.tar.gz
 cd mpeg4ip-1.5.0.1
 aptitude install libtool
 ./bootstrap
 ./configure —disable-player —prefix=/usr
 make
 make install

Installation de l’application app_mp4

Nous allons encore une fois créer un fichier Makefile.

 cd /usr/src/asterisk-video/app_mp4
 cat Makefile << EOF
 ---------- cut ------------
 CFLAGS ?= -O2 -fPIC
 Z_CFLAGS := $(CFLAGS) -D _GNU_SOURCE -Wall -Wmissing-prototypes -Wstrict-prototypes
 LIBS ?=
 Z_LIBS := $(LIBS) -lpthread -lmp4 -lmp4v2
 BINARY = app_mp4.so
 OBJECTS = app_mp4.o

 DESTDIR ?=
 PREFIX ?= /usr

 .PHONY : install clean

 $(BINARY) : $(OBJECTS)
         $(CC) -shared -Xlinker -x -o $(BINARY) $(OBJECTS) $(Z_LIBS)

 %.o : %.c
         $(CC) $(Z_CFLAGS) -c -o $@ $<

 install : $(BINARY)
         install -d $(DESTDIR)$(PREFIX)/lib/asterisk/modules
         install -m 755 $(BINARY) $(DESTDIR)$(PREFIX)/lib/asterisk/modules

 clean :
         rm -f $(BINARY) $(OBJECTS)
 ---------- cut ---------
 EOF

Modifier la ligne 51 du fichier app_mp4.c et ajouter ceci :

 #define AST_MODULE      "MP4 application"

Puis lancer la compilation avec :

 make
 make install

Compilation de l’application app_rtsp

Permet de streamer du flux RTSP.

 CFLAGS ?= -O2 -fPIC
 Z_CFLAGS := $(CFLAGS) -D _GNU_SOURCE -Wall -Wmissing-prototypes -Wstrict-prototypes
 LIBS ?=
 Z_LIBS := $(LIBS) -lpthread
 BINARY = app_rtsp.so
 OBJECTS = app_rtsp.o

 DESTDIR ?=
 PREFIX ?= /usr

 .PHONY : install clean

 $(BINARY) : $(OBJECTS)
         $(CC) -shared -Xlinker -x -o $(BINARY) $(OBJECTS) $(Z_LIBS)

 %.o : %.c
         $(CC) $(Z_CFLAGS) -c -o $@ $<

 install : $(BINARY)
         install -d $(DESTDIR)$(PREFIX)/lib/asterisk/modules
         install -m 755 $(BINARY) $(DESTDIR)$(PREFIX)/lib/asterisk/modules

 clean :
         rm -f $(BINARY) $(OBJECTS)

Ne pas oublier aussi de rajouter le #define dans le fichier app_rtsp.c

 #define AST_MODULE "Rtsp application"

Comme fait précédement, copier le fichier Makefile puis taper :

 make
 make install

Pour l’utiliser mettez dans votre sip.conf dans [general].

 videosupport=yes
 disable=all
 allow=ulaw
 allow=alaw
 allow=h263
 allow=h263p

Puis dans votre dialplan (/etc/asterisk/extensions.conf) dans la section [default] par exemple :

 [default]
 exten => 5003,1,Answer()
 exten => 5003,n,Rtsp(rtsp ://192.168.1.1/live.sdp)
 exten => 5003,n,Hangup()

== Installation de l’application app_transcoder ==

 aptitude install libavcodec-dev

Attention, le fichier swscale.h est explicitement effacer par le packaging de debian car il est vu comme plus utilisé. Nous allons donc le récupérer pour compiler correctement notre application.

Ajouter un repository source dans votre fichier /etc/apt/sources.list.

 deb-src http://ftp.fr.debian.org/debian/ etch main contrib non-free

Puis télécharger les sources de ffmpeg.

 cd /usr/src
 apt-get source ffmpeg

Puis nous allons copier l’header manquant dans le répertoire des includes.

 cp /usr/src/ffmpeg-0.cvs20060823/libavcodec/swscale.h /usr/include/ffmpeg/

Ajouter dans le fichier app_transcoder.c à la ligne 47.

 #define AST_MODULE      "Transcoder application"

Puis mettez le fichier Makefile

 CFLAGS ?= -O2 -fPIC
 Z_CFLAGS := $(CFLAGS) -D _GNU_SOURCE -Wall -Wmissing-prototypes -Wstrict-prototypes
 LIBS ?=
 Z_LIBS := $(LIBS) -lpthread -lavcodec
 BINARY = app_transcoder.so
 OBJECTS = app_transcoder.o

 DESTDIR ?=
 PREFIX ?= /usr

 .PHONY : install clean

 $(BINARY) : $(OBJECTS)
         $(CC) -shared -Xlinker -x -o $(BINARY) $(OBJECTS) $(Z_LIBS)

 %.o : %.c
         $(CC) $(Z_CFLAGS) -c -o $@ $<

 install : $(BINARY)
         install -d $(DESTDIR)$(PREFIX)/lib/asterisk/modules
         install -m 755 $(BINARY) $(DESTDIR)$(PREFIX)/lib/asterisk/modules

 clean :
         rm -f $(BINARY) $(OBJECTS)

Puis il suffira de lancer :

 make
 make install

Pour s’en servir ajouter dans le fichier extensions.conf dans la section

[default] :
 exten => 5004,1,Answer()
 exten => 5004,n,Transcode(,s@camera,h263@qcif/fps=10/kb=52/qmin=4/qmax=12/gs=50)
 exten => 5004,n,Hangup()

 [camera] 
 exten => s,1,Answer()
 exten => s,n,Rtsp(http://192.168.1.2/live.sdp)
 exten => s,n,Hangup()

Installation de l’outils pcm2mp4

 cd /usr/src/asterisk-video/tools
 make
 cp mp4band pcm2mp4 /usr/bin/

Configuration de misdn.conf

Voici le fichier de configuration misdn.conf, situé dans /etc/asterisk que j’utilise.

 [general] 
 misdn_init=/etc/misdn-init.conf
 debug=0
 ntdebugflags=0
 ntdebugfile=/var/log/misdn-nt.log
 ntkeepcalls=no
 bridging=no
 l1watcher_timeout=0
 stop_tone_after_first_digit=yes
 append_digits2exten=yes
 dynamic_crypt=no
 crypt_prefix=**
 crypt_keys=test,muh
 [default]
 context=from-misdn
 language=fr
 musicclass=default
 senddtmf=yes
 far_alerting=no
 allowed_bearers=all
 nationalprefix=0
 internationalprefix=00
 rxgain=0
 txgain=0
 te_choose_channel=no
 pmp_l1_check=no
 reject_cause=16
 need_more_infos=no
 nttimeout=no
 method=standard
 overlapdial=yes
 dialplan=0
 localdialplan=0
 cpndialplan=0
 early_bconnect=yes
 incoming_early_audio=yes
 nodialtone=no
 presentation=-1
 screen=-1
 echocancel=no
 echotraining=no
 jitterbuffer=4000
 jitterbuffer_upper_threshold=0
 hdlc=yes
 max_incoming=-1
 max_outgoing=-1

 [extern]
 ports=1,2
 msns=*

Dialplan Asterisk

Faut pouvez maintenant créer un appel depuis l’extérieur vers votre Asterisk comme cale par exemplen en éditant votre fichier extensions.conf dans /etc/asterisk.

 [default]
 exten => 5002,1,H324m_gw(sylvain@3gp_videos)

 exten => 5003,1,Answer()
 exten => 5003,n,Rtsp(rtsp ://192.168.1.1/live.sdp)
 exten => 5003,n,Hangup()

 exten => 5004,1,Answer()
 exten => 5004,n,Transcode(,s@camera,h263@qcif/fps=10/kb=52/qmin=4/qmax=12/gs=50)
 exten => 5004,n,Hangup()

 [camera]

 exten => s,1,Answer()
 exten => s,n,Rtsp(http://192.168.1.2/live.sdp)
 exten => s,n,Hangup()

 [3gp_videos]

 exten => sylvain,1,H324m_gw_answer()
 exten => sylvain,n,Video_loopback()

 [from-misdn]

 exten => 9965,1,Goto(default,5002,1)

Mini tutoriel MP4

Voici le tutoriel proposé par Sergio García sur son site web mais en Français. (Référence : http://sip.fontventa.com/content/vi...)

Nous allons juste installer une dépendance requise pour ce tutoriel.

 aptitude install ffmpeg

Le fichier est téléchargeable ici : http://sip.fontventa.com/files/samp...

Avant de pouvoir utiliser un fichier mp4 avec app_rtsp et le streamer depuis un serveur avec un téléphone vidéo, il doit être encoder avec un format que support le téléphone.

Beaucoup de serveurs de streaming support les fichiers de type mp4/3gp. Le format h263-1998 reste cependant le meilleur choix pour encoder une vidéo et il existe beaucoup d’outils pour l’éditer/modifier. Le problème est que les codecs audio utilisé sur un téléphone vidéo (gsm/speech/g723/g729) ne sont pas spécialement utilisé pour faire du streaming contrairement à AAC/MP3.

Le format de fichier mp4 permet de stocker n’importe quelle type de donnée, mais pas beaucoup d’outils sont capable de nous permettre de faire cela.

L’outils pcm2mp4 permet de créer un fichier mp4 avec une piste audio PCMU (ulaw). Il peux être utilisé pour faire des tests de streaming. D’autres codecs pourrait être facilement intégré)

Nous allons utiliser un fichier de sample converti en h263 pour ce mini tutoriel.

 $ mp4info sample_300kbit.3gp
 mp4info version 1.5.0.1
 sample_300kbit.3gp :
 Track Type Info
 201 video H.263, 69.973 secs, 94 kbps, 176x144 @ 10.003859 fps
 65335 hint Payload H263-2000 for track 201
 101 audio MPEG-4 AAC LC, 70.000 secs, 8 kbps, 12000 Hz
 65435 hint Payload MP4A-LATM for track 101
 1 od Object Descriptors
 2 scene BIFS

D’abord nous allons extraire les deux médias de notre fichier.

 $ mp4creator -extract=201 sample_300kbit.3gp
 $ mv sample_300kbit.3gp.t201 sample_300kbit.263
 $ mp4creator -extract=101 sample_300kbit.3gp
 $ mv sample_300kbit.3gp.t101 sample_300kbit.aac

Puis nous allons convertir l’audio AAC en fichier PCMU.

 $ ffmpeg -i sample_300kbit.aac -acodec pcm_mulaw -ar 8000 -ac 1 -f mulaw sample_300kbit.mulaw
 FFmpeg version SVN-rUNKNOWN, Copyright (c) 2000-2006 Fabrice Bellard, et al.
 configuration : —prefix=/usr —libdir=$prefix/lib —shlibdir=$prefix/lib —incdir=$prefix/include/ffmpeg —enable-shared —enable-mp3lame
 —enable-gpl —enable-faad —mandir=$prefix/share/man —enable-vorbis —enable-pthreads —enable-faac —enable-xvid —enable-dts —enable-amr_nb
 —enable-amr_wb —enable-pp —enable-libogg —enable-libgsm —enable-x264 —enable-a52 —extra-cflags=-Wall -g -fPIC -DPIC —cc=ccache cc
 libavutil version : 49.1.0
 libavcodec version : 51.28.0
 libavformat version : 51.7.0
 built on Jan 19 2007 17:05:58, gcc : 4.1.2 20061115 (prerelease) (Debian 4.1.1-21)
 Input #0, aac, from ’sample_300kbit.aac’ :
 Duration : 00:01:09.4, start : 0.000000, bitrate : 8 kb/s
 Stream #0.0 : Audio : aac, 12000 Hz, mono, 8 kb/s
 Output #0, mulaw, to ’sample_300kbit.mulaw’ :
 Stream #0.0 : Audio : pcm_mulaw, 8000 Hz, mono, 64 kb/s
 Stream mapping :
 Stream #0.0 -> #0.0
 Press [q] to stop encoding
 size= 2184kB time=70.0 bitrate= 64.0kbits/s
 video:0kB audio:2184kB global headers:0kB muxing overhead 0.000000%

Nous allons maintenant utiliser l’outil pour créer un nouveau fichier mp4 avec notre fichier audio converti en PCMU.

 $ /usr/bin/pcm2mp4 sample_300kbit.mulaw sample_300kbit_ulaw.3gp
 $ mp4info sample_300kbit_ulaw.3gp
 mp4info version 1.5.0.1
 sample_300kbit_ulaw.3gp :
 Track Type Info
 1 audio G.711 uLaw, 70.000 secs, 64 kbps, 8000 Hz
 2 hint Payload PCMU for track 1

Ensuite nous allons juste rajouter la parti video h263 dedans.

 $ mp4creator -create=sample_300kbit.263 sample_300kbit_ulaw.3gp
 $ mp4info sample_300kbit_ulaw.3gp
 mp4info version 1.5.0.1
 sample_300kbit_ulaw.3gp :
 Track Type Info
 1 audio G.711 uLaw, 70.000 secs, 64 kbps, 8000 Hz
 2 hint Payload PCMU for track 1
 3 video H.263, 69.903 secs, 94 kbps, 176x144 @ 10.013876 fps
 $ mp4creator -hint=3 sample_300kbit_ulaw.3gp
 $ mp4info sample_300kbit_ulaw.3gp
 mp4info version 1.5.0.1
 sample_300kbit_ulaw.3gp :
 Track Type Info
 1 audio G.711 uLaw, 70.000 secs, 64 kbps, 8000 Hz
 2 hint Payload PCMU for track 1
 3 video H.263, 70 secs, 94 kbps, 176x144 @ 10.013876 fps
 4 hint Payload H263-2000 for track 3
 Metadata Tool : mp4creator 1.5.0.1