1 #LyX 1.1 created this file. For more info see http://www.lyx.org/
14 \paperorientation portrait
17 \paragraph_separation indent
19 \quotes_language french
23 \paperpagestyle default
28 \begin_inset LatexCommand \label{manual}
32 MANUEL DE L'UTILISATEUR DE LINPHONE
35 Simon Morlat (simon.morlat@linphone.org)
44 Linphone est un simple logiciel de téléphonie sur le web.
45 Il permet d'effectuer des conversations comprenants deux participants en
46 utilisant un réseau IP comme Internet.
47 Ainsi, voici l'équipement nécessaire pour utiliser Linphone :
50 Linux ( Peut fonctionner dans d'autres environnements tels que BSD ou d'autres
51 UNIX, mais personne ne l'a encore testé.)
54 Gnome 1.2 ou supérieur, installé mais pas nécessairement utilisé.
57 Une carte son configuré correctement.
60 Des écouteurs ou haut-parleurs.
66 Une connection réseau (Internet par exemple), par modem, carte réseau Ethernet
70 Il est préférable de fermer toutes les applications utilisant la carte son
71 avant d'utiliser Linphone.
72 Linphone est un logiciel libre, il est distribué sous la license publique
78 ATTENTION : Ce logiciel est distribué SANS GARANTIE.
79 Lisez le fichier COPYING pour plus de détails.
80 Ceci signifie entre autre que vous ne devez pas utiliser Linphone pour
81 des conversations confidentielles : il y a AUCUN CRYPTAGE, de ce fait,
82 il est peut-être facile pour quelqu'un de mal intentionné de pirater les
84 Notez toutefois, qu'il n'est pas recommandé d'utiliser Linphone en tant
91 Linphone peut être utilisé suivant 3 modes différents :
94 En tant qu'application (normale) : Dans le menu de Gnome, Linphone devrait
95 apparaître dans la section Réseau ( "Network" ).
96 Si vous n'utilisez pas Gnome, vous pouvez démarrer Linphone dans une fenêtre
98 Quand Linphone n'est pas en cours d'éxecution, vous ne pouvez pas recevoir
102 En tant qu'applet Gnome : en cliquant sur le panneau Gnome du bouton droit,
104 Linphone apparait dans la section Réseau.
105 En tournant en tâche de fond dans le panneau Gnome, Linphone est capable
106 de recevoir des appel(s) même si sa fenêtre n'est pas visible.
107 Si vous voulez voir la fenêtre principale, cliquez sur l'applet.
108 Quand un appel arrive, la fenêtre principale passe en premier plan,et vous
109 entendrez normalement la sonnerie retentir.
112 En tant que démon : Ceci est intéressant pour les non-utilisateurs de Gnome.
113 Par exemple pour KDE, vous avez un repertoire /home/user/.kde2/AutoStart/
114 où vous pouvez rajouter les applications que vous voulez voir démarrer
115 à votre début de session.
116 Ainsi, dans le repertoire cité, à l'aide du gestionnaire de fichiers, ajouter
117 un lien en cliquant du bouton droit.
118 La commande à rentrer est "linphone -daemon".
119 Vous ne verrez pas l'interface de Linphone, donc, pour la faire apparaitre,
120 démarrez Linphone normalement, par exemple à travers une fenêtre terminal.
129 Linphone utilise le protocole SIP (Session Initiation Protocol) pour établir
130 les appels avec vos correspondants.
131 Le protocole spécifie que chaque personne doit être identifié par une URL
132 sip de la forme: sip:user_name@host_name.
133 Cette manière d'adresser les personnes est très proche de celle utilisée
134 pour le courrier électronique.
137 User_name est un nom d'utilisateurs sur une machine, comme un nom de login
138 sur une machine linux, par exemple.
139 Host_name est le nom d'une machine, soit sous forme d'adresse IP, ou plus
140 simplement sous forme de nom de domaine (ex: linphone.org)
143 Notez que SIP est un nouveau protocole de télécommunication fait pour être
144 simple et efficace sur l'internet, et qu'il est totalement différent et
145 incompatible avec H.323.
146 H.323 est le protocole actuellement utilisé par NetMeeting ou GnomeMeeting.
149 Application: deux personnes (Bob et Tom) se connectent à internet par un
150 modem analogique classique.
153 Voici la manière la plus simple de procéder :
159 Un modem 28.8 Baud ou plus.
166 Il est convenu que Bob doit appeler Tom à 21h00.
167 A 21h00, Tom se connecte à Internet en utilisant kppp, gppp ou wvdial (ou
169 Dès qu'il est connecté sur l'Internet, il peut lancer Linphone.En ouvrant
170 la fenêtre de statistiques de kppp ou gppp, il peut voir son adresse IP
171 (sinon, il peut taper /sbin/ifconfig pour l'obtenir).
172 Le nom de l'interface modem doit être ppp0.
175 Ensuite, il envoit un email à Bob disant : "Mon adresse IP estxxx.xxx.xxx.xxx".
178 Bob recoit l'email et tape dans la fenêtre de Linphone le nom est l'adresse
179 IP de la personne à contacter : Tom@xxx.xxx.xxx.xxx(L'adresse IP de Tom) et
180 pour finir, il appuit sur le bouton Appeler.
184 Linphone sonne à la maison de Tom ...Tom a juste à répondre à l'appel en cliquant
185 sur le bouton "répondre" et ainsi devrait pouvoir commencer la discussion.
189 Si vous rencontrez des problèmes dans une de ces étapes, allez à la section
193 Essai en local: vous n'avez personne à appeler pour l'instant, mais vous
194 souhaiteriez voir si linphone marche vraiment.
198 \begin_inset LatexCommand \label{sipomatic}
202 Depuis la version 0.3.0, Linphone est livré avec un programme de test appelé
204 Sipomatic peut répondre automatiquement aux appels provenant de Linphone.
211 Démarrez sipomatic dans une fenêtre terminal.
212 Ne soyez pas supris, sipomatic ne possède aucune interface graphique, mais
213 vous n'avez pas besoin de modifier quoi-que-ce-soit.
217 Dans Linphone, allez dans les propriétés, section réseau, et choisissez
218 "lo" comme interface par défaut.
219 Appliquez les changements en cliquant sur OK.
220 Tapez l'adresse S.I.P suivante dans la fenêtre principale : sip:robot@127.0.0.1:5064.
221 127.0.0.1 est l'adresse locale de votre ordinateur, et robot est le nom à
222 utiliser pour appeler sipomatic.
223 5064 est le port par lequel sipomatic peut-être contacté.
224 Normalement, vous devez toujours utiliser 5060 pour appeler quelqu'un,
225 mais sipomatic est une exception : il fonctionne sur le port 5064.
226 La raison est que Linphone fonctionne déjà sur le port 5060, et il est
227 impossible d'avoir deux applications utilisant le même port au même instant,
232 Appuyez sur le bouton "Appeler".
233 Après quelques secondes, sipomatic devrait répondre à votre appel et vous
234 devez entendre une courte annonce.
238 \begin_inset LatexCommand \label{params}
242 Paramètres des appels
246 \begin_inset LatexCommand \label{paramnetwork}
253 Liste des interfaces réseau: vous devez choisir une interface réseau à utiliser
255 Si vous voulez contacter quelqu'un sur l'Internet, vous devez choisir l'interfa
256 ce réseau connectée à l'Internet.
257 Par exemple, si vous utilisez un modem, celle-ci devrait être ppp0.
258 Si vous n'êtes connecté à aucun réseau, seulement l'interface réseau locale
259 appelé lo apparaitra dans la liste.
260 La seule chose que vous pouvez faire dans ce cas la est d'appeler
261 \begin_inset LatexCommand \ref[sipomatic]{sipomatic}
268 Type de connection: choisissez le type de connection que vous utilisez pour
269 vous connecter au réseau que vous désirez utiliser.
270 Ceci aidera Linphone à s'auto-configurer en fonction de la bande passante
271 de votre type de connection.
275 \begin_inset LatexCommand \label{paramrtp}
282 RTP signifie Real Time Protocol, il permet d'envoyer des flux de données
286 port RTP: Linphone utilise le port 7072 par défaut pour envoyer et recevoir
288 Si vous pensez que le port 7072 est utilisé par une autre application,
289 changez le comme vous voulez.
292 Jitter compensation: ce nombre représente le nombre de paquets audios que
293 Linphone attend avant de vous les faire entendre.
294 Augmentez ce nombre si vous entendez une voix hachée de manière à améliorer
295 la qualité de la transmission, mais attention, ceci augmente le delai (vous
296 entendrez la voix de l'utilisateur distant quelques millisecondes plus
297 tard).D'un autre côté, si vous utilisez un réseau parfait, et que vous disposez
298 de bon drivers audios, vous pouvez descendre ces paramètres très bas jusqu'à
299 3 paquets, ainsi vous aurez un délai très faible.
303 \begin_inset LatexCommand \label{paramsip}
310 SIP (Session Initiation Protocol) est un protocole qui permet d'établir
311 des sessions de téléphonie par l'intermédiaire d'un réseau IP.
312 En simplifiant, c'est la chose qui permet de faire sonner chez l'autre
313 utilisateur, démarrer ou terminer l'appel quand l'un des deux correspondants
317 port SIP: Linphone utilise par défaut le port 5060 pour envoyer / recevoir
319 Il est hautement recommandé par la RFC du protocole SIP d'utiliser celui-ci.
320 Donc, ne le changez pas à moins que vous n'ayez vraiment pas le choix.
323 Votre adresse SIP: modifiez ici votre nom d'utilisateur et votre nom de
325 Bien entendu donner un nom de machine ici ne signifie pas que ce nom soit
326 connue des autres machines du réseau.
327 Néammoins linphone utilisera peu ce nom de machine et préfèrera utiliser
328 votre adresse IP pour communiquer avec d'autres machines.
331 Utiliser un serveur sip registrar: Cochez ce choix, si vous voulez vous
332 enregistrer sur un serveur SIP (registrar) pour obtenir différents services.
333 Quand vous n'avez pas d'adresse IP fixe, cela peut-être très intéressant
334 pour permettre à vos amis de vous appeler.
335 Regardez la section intitulée "
336 \begin_inset LatexCommand \ref[enregistrement sur un serveur sip]{registering}
344 \begin_inset LatexCommand \label{paramcodec}
351 Les codecs sont des algorithmes utilisés pour compresser la voix.
352 Par exemple, une voix digitalisée en 16bit/8000Hz représente un flux de
353 données de 128kbits/seconde.
354 En utilisant le vocodeur GSM, ce flux est réduit à 13kbits/seconde, sans
355 perte significative de qualité.
358 Choix de codecs: Linphone peut utiliser plusieurs codecs.
359 Utilisez les boutons situés en dessous de la liste des codecs de manière
360 à les placer dans un order de préférence.
361 Notez bien, qu'en fonction de votre type de connection réseau, certains
362 codecs sont inutilisables.Ils apparaitront en rouge et ne seront pas sélectionna
364 Vous pouvez décider d'utiliser ou non un codec "utilisable" (en bleu) en
365 changeant son état à l'aide du bouton activer/désactiver en dessous de
370 \begin_inset LatexCommand \label{paramaudio}
377 Mode de pilotage: si vous avez installé des drivers ALSA avec une librairie
378 ALSA <0.9, choisissez ALSA pour avoir de meilleires performances.
379 Sinon, ou si vous n'en savez rien, choisissez OSS, cela marche suffisemment
383 Choix de la source d'enregistrement: vous pouvez choisir votre source d'enregist
385 Dans la plupart des cas, celle-ci sera le microphone.
388 Auto-kill option: en choissant cette option, Linphone essaiera de stopper
389 les processus sonores (esd & artsd) qui peuvent bloquer votre périphérique
390 sonore et ainsi provoquer des problèmes d'ouverture des périphériques par
391 Linphone quand il en a besoin.
392 Il est recommandé d'activer cette option.
398 Depuis la version 0.4.1 linphone dispose d'un carnet d'adresses (menu connexion,
399 carnet d'addresses), avec lequel vous pouvez memoriser des adresses, et
400 les rappeler facilement lorsque vous souhaitez appeler.
404 \begin_inset LatexCommand \label{registering}
408 Enregistrement sur un serveur sip
411 Vous pouvez souscrire des services sur des serveurs sip distants appelés
412 registrar, proxy ou redirect server.
413 Ces services peuvent être:
416 You can suscribe for services on remote SIP servers.
417 These services can be:
420 redirection: linphone va demander au serveur la création d' un compte <sip:votre
421 _nom@le_serveur_sip>.
422 Cette adresse pourra alors être utilisée par vos correspondants pour vous
424 Un petit example concret pour bien comprendre: vous n'êtes qu'un pauvre
425 internaute connecté temporairement grace à un modem 56k.
426 Votre machine n'a pas de nom de domaine connu et votre adresse IP change
427 à chaque nouvelle connexion.
428 Il est impossible pour vos amis de vous joindre car il ne peuvent deviner
429 votre adresse IP, à moins que vous ne leur donniez en envoyant un courriel,
431 Pour palier à ce problème, vous pouvez demander à avoir un compte sur un
432 serveur sip connu de vos amis, qui lui est fixe et tout le temps connecté.
433 Pour cela, spécifiez l'adresse du serveur dans la boite de propriété, section
435 Cette adresse est par exemple <sip:serveur_exemple.com> et votre nom d'utilisate
437 \begin_inset Quotes fld
441 \begin_inset Quotes frd
445 Linphone va alors envoyer au serveur un message pour l'informer de la correspon
446 dance entre l'adresse <sip:bob@serveur_exemple.com> et votre adresse IP actuelle.
447 Desormais vos amis peuvent vous appeler en utilisant cette nouvelle adresse,
448 leurs appels seront alors automatiquement redirigés vers votre machine.
449 Il n'ont plus besoin de connaitre votre adresse IP qui change tout le temps
451 Bien sur, <sip:serveur_exemple.com> est supposée être bien connue de tout
456 proxy: c'est exactement le meme principe, excepté que la redirection se
457 fait de manière transparente et invisible le linphone de l'appelant.
460 Le registrar que vous avez spécifié peut aussi être utilisé comme proxy
462 Dans ce cas tous les appels émanant de votre linphone seront dirigé vers
463 ce serveur, et il sera supposé les faire suivre vers les bonnes personnes.
464 Ceci est très utile et même indispensable lorsque vous utilisez linphone
465 dans un réseau privé abrité par un firewall, si bien sur un proxy sip est
466 actif sur le firewall.
470 Pour utiliser solliciter un serveur sip, vous devez aller à la boîte de
471 propriété, rubrique SIP, et cocher le bouton qui se trouve en face de "use
473 Tapez l'adresse du registrar, et choisissez un nom d'utilisateur qui n'est
474 pas trop fréquent de manière à éviter les conflits de noms.
475 Donnez une indication du service que le serveur doit effectuer pour vous
476 en cochant les boutons
477 \begin_inset Quotes fld
481 \begin_inset Quotes frd
485 \begin_inset Quotes fld
489 \begin_inset Quotes frd
493 Sélectionnez aussi l'option
494 \begin_inset Quotes fld
497 le serveur est un proxy sortant
498 \begin_inset Quotes frd
501 si vous êtes derrière un pare-feu.
504 Enfin en fermant la boite de propriétés linphone communiquera immédiatement
505 avec le serveur SIP pour y obtenir les services demandés.
506 De même lorsque vous fermez linphone, celui ci prendra quelques secondes
507 pour se désenregistrer auprès du serveur.
510 Une liste de serveurs sip peut être trouvée à cette addresse:
511 \begin_inset LatexCommand \url[http://www.cs.columbia.edu/~hgs/sip/servers.html]{http://www.cs.columbia.edu/~hgs/sip/servers.html}
516 Malheureusement, beaucoup de ces serveurs ne fonctionnent plus, peut-être
517 à cause de la crise et de ses faillites.
518 Certains ne sont pas utilisables car ils requierent des méthodes d'autentificat
519 ion qui ne sont pas encore implémentées dans linphone.
520 Afin donc de ne pas vous faire perdre votre temps, une liste des serveurs
521 sip publiques fonctionnant avec linphone est disponible sur
522 \begin_inset LatexCommand \url[http://simon.morlat.free.fr/english/servers.html]{http://simon.morlat.free.fr/english/servers.html}
529 Utilisation derrière les pares-feux
532 Linphone est capable de fonctionner derrière les firewalls grâce à un serveur
533 proxy SIP fonctionnant sur la machine firewall.
534 Un tel serveur est en cours de développement sur
535 \begin_inset LatexCommand \url[http://osipproxy.sourceforge.net]{http://osipproxy.sourceforge.net}
540 Bien sûr il sera libre et basé sur la librairie LGPL oSIP.
543 Une fois le proxy serveur mis en place, il vous faut configurer linphone
544 pour qu'il l'utilise.
545 Pour cela rendez vous dans la boite de propriétés, section SIP et cochez
547 \begin_inset Quotes fld
550 Utiliser un registrar SIP
551 \begin_inset Quotes frd
554 , indiquez son adresse, et cocher l'option
555 \begin_inset Quotes fld
558 le serveur est un proxy sortant
559 \begin_inset Quotes frd
565 Il y a un cas pour lequel le proxy n'est pas indispensable: c'est le cas
566 où les machines du réseau privé possèdent une adresse publique, le firewall
567 étant là pour filtrer les paquets entrants ou sortants.
568 Vous devez pour permettre a linphone de fonctionner avec des machines exterieur
569 es, autoriser le traffic UDP sur le port SIP (par defaut 5060, il est deconseill
570 é de le changer), et sur le port RTP de chaque linphone du sous réseau.
571 Le port RTP est paramètrable comme bon vous semble dans la boite de proprietés.
577 Problèmes de connexion
580 J'essaye d'appeler mon pote <sip:toto@example.com>, mais rien ne se passe,
584 Vous devez vérifier que linphone utilise l'interface réseau qui vous connecte
585 sur le réseau ou se trouve votre ami.
586 La liste des interface disponibles est donnée dans la boite de propriété,
588 Sélectionnez la bonne.
592 Si le problème persiste, il y a fort à parier que votre ami ne soit pas
593 joignable actuellement.
599 Linphone semble correctement établir l'appel, il sonne, mais une fois que
600 le correspondant a décrocher, plus rien ne se passe et on ne s'entend pas.
603 La plupart des gens ont ce genre de symptome car ils n'ont pas choisi la
604 bonne interface réseau.
605 Si vous êtes connectés par modem, ce doit être ppp0.
606 En aucun cas l'interface
607 \begin_inset Quotes fld
611 \begin_inset Quotes frd
614 ne peut permettre d'avoir une communication via le réseau.
615 Elle ne sert que pour le test local avec sipomatic (voir plus haut).
618 Augmentez le niveau sonore d'acquisition et de restitution, à l'aide des
619 potentiomètres situés en bas de la fenêtre principale.
622 Si la voix de votre correspondant vous semble coupée ou hachée, vous pouvez
623 essayer d'augmenter le paramètre jitter compensation de l'onglet RTP de
624 la boite de propriété.
625 Mais attention, cela augmente la latence en contrepartie.
628 Si linphone ne peut se servir de la carte son, vérifiez que celle ci n'est
629 pas utilisée au meme moment par d'autres programmes audio.
633 Enfin utilisez les drivers sons alsa (voir
634 \begin_inset LatexCommand \url[http://www.alsa-project.org]{http://www.alsa-project.org}
638 ) , plutôt que les oss fournit avec le kernel linux.
639 Malheureusement la plupart des distributions utilsent encore ces vieux
640 pilotes alors qu'ils presentent de nombreux bugs et problèmes de latence.
641 Les drivers ALSA sont beaucoup plus performants.
642 Notez que si vous changer vos drivers, vous n'avez nul besoin de recompiler
643 linphone ou de changer quoi que ce soit a sa configuration.
647 Rapports de bogues et suggestions
650 En premier lieu, allez sur le site de Linphone
651 \begin_inset LatexCommand \url[http://www.linphone.org]{http://www.linphone.org}
655 afin de vérifier que vous ayez bien la dernière version de Linphone.
659 Si linphone plante, envoyez moi directement un message à bugs@linphone.org.
660 Si Linphone ne fonctionne pas, mais ne se plante pas, vérifiez bien que
661 vous avez bien lu ce manuel entièrement avant de m'envoyer un compte rendu
662 à l'adresse précédente.
663 Dans tous les cas veillez à m'envoyer le plus d'information possible relatifs
664 à votre problème, notamment la sortie de debug que linphone écrit lorsque
665 vous l'executez depuis un terminal.
666 Si vous désirez autre chose, n'hésitez pas à m'envoyer un email à l'adresse
668 Prenez note que l'ajout de la vidéo et du mode conférence sont planifiés.
672 Si quelqu'un est interessé pour faire des traductions de Linphone, envoyez
673 moi un fichier xx.po basé sur celui se trouvant dans po/linphone.pot de la
675 Vous pouvez aussi traduire ce manuel utilisateur dans d'autres langues.
676 Dans tous les cas, contactez moi si vous voulez plus de détails.
682 Simon MORLAT (simon.morlat@linphone.org) a ecrit:
685 Programme principal (src)
688 librairie RTP (lprtplib)
691 osipua : la librarie sip User Agent au dessus d'osip.
694 interface pour les drivers audio (audio)
697 les wrappers pour les codecs lpc10-1.5, gsm et g711.
701 Aymeric Moizard (jack@atosc.org) a ecrit la pile SIP oSIP utilisé par linphone.
705 La librairie GSM a été écrite par: Jutta Degener and Carsten Bormann,Technische
709 La librairie LPC10-1.5 par: Andy Fingerhut Applied Research Laboratory <--
710 this line is optional if Washington University, Campus Box 1045/Bryan 509
711 you have limited space One Brookings Drive Saint Louis, MO 63130-4899 jaf@arl.wu
712 stl.edu http://www.arl.wustl.edu/~jaf/ Lisez les fichiers textes README dans
713 les repertoire gsmlib et lpc10-1.5 pour plus d'informations.
716 Les icones sont de Pablo Marcelo Moia et le logo de Philippe Beau.
722 Merci à Daemon Chaplin pour avoir fait Glade, le constructeur d'interface
726 Merci aux auteurs du code des LPC10-1.5 et GSM.
729 Merci à Joel Barrios ( jbarrios@-NO-SPAM-linuxparatodos.com ) pour ses RPMS.
732 Merci à Pablo Marcelo Moia pour les icones.
735 Merci à Philippe Beau pour la traduction de ce manuel en Francais, pour
736 le logo, et pour le nouveau site web qu'il a fait pour linphone.
740 \begin_inset LatexCommand \tableofcontents{}