LINPHONE 'S USER MANUAL

  1. Introduction
  2. Utiliser linphone
  3. Comment appeler ?
  4. Parametrage des appels
  5. Le carnet d'adresses
  6. Utilisation d'un serveur SIP (registrar)
  7. Utilisation derrière les firewalls
  8. Limitations
  9. Problèmes divers
  10. Bogues, suggestions
  11. Auteurs
  12. Remerciements

1- Introduction

Linphone est un simple logiciel de téléphonie sur le web. Il permet d'effectuer des conversations comprenants deux participants en utilisant un réseau IP comme Internet. Ainsi, voici l'équipement nécessaire pour utiliser Linphone :

Vous devez fermer toutes les applications utilisant la carte son avant d'utiliser Linphone.
Linphone est un logiciel libre, il est distribué sous la license publique GNU.
ATTENTION : Ce logiciel est distribué SANS GARANTIE. Lisez le fichier COPYING pour plus de détails. Ceci signifie entre autre que vous ne devez pas utiliser Linphone pour des conversations confidentielles : il y a AUCUN CRYPTAGE, de ce fait, il est peut-être facile pour quelqu'un de mal intentionné de pirater les flux audios. Notez toutefois, qu'il n'est pas recommandé d'utiliser Linphone en tant qu'utilisateur root.

2- Utiliser linphone

Linphone peut être utilisé suivant 3 modes différents :

3- Comment appeler ?

a. Principes de bases

Linphone utilise le protocole S.I.P(Session Initiation Protocol) pour établir une connexion avec l'hôte distant. Pour appeler quelqu'un, vous devez fournir à Linphone une adresse SIP:
sip:nom_utilisateur@nom_machine(ou adresse IP).

Veuillez noter que S.I.P est un nouveau protocole de communication développé pour être simple et efficace, mais il n'est pas compatible avec H323.
Le nom_utilisateur est le nom d'utilisateur sur la machine Linux. Nom_machine est le nom de la machine, si bien sûr elle est connue des serveurs DNS. Sinon, utilisez l'adresse IP directement. Si vous utilisez une connection Internet non-permanente, de type MODEM par exemple, il est impératif de démarrer Linphone APRES s'être connecté, car Linphone doit trouver l'adresse IP actuelle de la machine. Si vous êtes connecté à plusieurs réseaux, Linphone vous avertira et il est ainsi recommandé de vérifier dans les propriétés qu'il utilise bien la BONNE connection réseau. La personne que vous voulez appeler doit impérativement avoir Linphone en route de manière à recevoir votre appel.
Comme le S.I.P est un protocole standart, Linphone devrait fonctionner avec d'autres logiciels de téléphonie compatibles S.I.P.

b. Application : 2 personnes connectées à Internet par modem.

Voici la manière la plus simple de procéder :

Pré-requis :

Déroulement :

c. Essais : Vous n'avez personne à appeler pour le moment, mais vous voudriez bien vérifier que Linphone fonctionne bien sur votre système.

Depuis la version 0.3.0, Linphone est livré avec un programme de test appelé "sipomatic". Sipomatic peut répondre automatiquement aux appels provenant de Linphone. A vous d'essayer :
Démarrez sipomatic dans une fenêtre terminal. Ne soyez pas supris, sipomatic ne possède aucune interface graphique, mais vous n'avez pas besoin de modifier quoi-que-ce-soit.
Dans Linphone, allez dans les propriétés, section réseau, et choisissez "lo" comme interface par défaut. Appliquez les changements en cliquant sur OK.
Tapez l'adresse S.I.P suivante dans la fenêtre principale :

sip:robot@127.0.0.1:5064.

127.0.0.1 est l'adresse locale de votre ordinateur, et robot est le nom à utiliser pour appeler sipomatic. 5064 est le port par lequel sipomatic peut-être contacté. Normalement, vous devez toujours utiliser 5060 pour appeler quelqu'un, mais sipomatic est une exception : il fonctionne sur le port 5064. La raison est que Linphone fonctionne déjà sur le port 5060, et il est impossible d'avoir deux applications utilisant le même port au même instant, sur la même machine.
Appuyez sur le bouton "Appeler". Après quelques secondes, sipomatic devrait répondre à votre appel et vous devez entendre une courte annonce.

4- Paramètrage des appels

Linphone poss&eagrave;de plusieurs param&eagrave;tres et options que vous pouvez changer:

5- Le carnet d'adresse

Depuis la version 0.4.1 linphone dispose d'un carnet d'adresses (menu connexion, carnet d'addresses), avec lequel vous pouvez memoriser des adresses, et les rappeler facilement lorsque vous souhaitez appeler.

6- Utilisation d'un registrar sip

Quand vous vous connectez à l'Internet à l'aide d'une connection modem non-permanente, il se pose un problème pour vos amis pour qu'ils sachent si vous êtes connecté ou non, et surtout connaître votre adresse IP de manière à vous appeler. Pour cette raison, vous pouvez enregistrer une adresse SIP fixe auprès d'un serveur SIP encore appelé registrar ou serveur de redirection. Votre adresse SIP sera ainsi sip:monnom@monregistrar. Vos amis auront ainsi la possibilité de vous téléphoner en utilisant cette adresse. Le principe est vraiment simple : quand linphone démarre, il indique au registrar la correspondance entre votre adresse SIP sip:monnom@monregistrar et votre adresse IP. De ce fait, quand vos amis vous téléphonent à l'aide de votre adresse SIP, le registrar leur donne votre adresse IP exacte et l'appel est redirigé vers vous.

Pour utiliser ceci, vous devez aller à la boîte de propriété, rubrique SIP, and sélectionner le bouton qui se trouve en face de “use registrar”. Tapez l'adresse du registrar, et choisissez un nom d'utilisateur qui n'est pas trop fréquent de manière à éviter les conflits de noms.
Par exemple, vous aurez moins de problème à utiliser une adresse comme jack.dupond@registrar.com plutot que jack@registrar.com.

Vous aurez peut-être à choisir un mot de passe pour votre enregistrement : ceci dépend du serveur. Suivez bien les instructions données sur le site web du registrar.

Pour finir, cliquez sur le bouton OK de la boîte de propriété. Elle se fermera et linphone va immédiatement se connecter au registrar. Une liste des registrars publiques peut-être trouvée ici :
http://www.cs.columbia.edu/~hgs/sip/servers.html
Malheureusement, beaucoup de ces serveurs ne fonctionnent plus, ceci étant surement dû à la récente crise dans le secteur des télécommunications. De plus certains ont besoin de méthodes d'authentifications qui ne sont actuellements pas supportées par Linphone.
Dans le but de ne pas vous faire perdre votre temps, une liste des serveurs SIP publiques et fonctionnants avec Linphone est disponible sur le site de Linphone :
http://simon.morlat.free.fr/english/servers.html
Certains peuvent necessiter que vous remplissiez un formulaire d'enregistrement, mais ne vous inquietez pas, tous les serveurs de cette liste sont entièrement gratuits.

7- Utilisation derrière les pare-feux

Le support complet des firewalls est prevu prochainement.
Cependant vous pouvez déjà utiliser linphone dans ce cas precis:

Dans d'autres cas, vous ne pouvez pas utiliser linphone derrière un pare feu.

8- Limitations

Depuis la version 0.4.0, Linphone utilise la pile osip pour implémenter le protocole SIP. Certaines réponses ou requêtes ne sont toujours pas supportées, mais les autres fonctionnent parfaitement (INVITE, BYE, ACK, REGISTER, 200, 486, 606, 404). Notez que certains menus ou boîtes de dialogues n'ont aucune(s) réaction(s). Ceci est normal, ils sont réservé(e)s aux versions futures.
Linphone 0.4.0 casse la compatibilité des versions plus antérieures. Ceci signifie que vous ne pouvez pas utiliser une version 0.4.0 pour appeler une version 0.3.0 et vice-versa.

9- Problèmes

Voici la liste des choses que vous pouvez vérifier avant de dire "c'est quoi cette merde ?" :

a) Problèmes d'audio

b) Problème de connexion

Note: Regardez dans le fichier BUGS contenu dans les sources pour d'autres informations à propos de choses étranges.

Note(2) : Linphone ne peut pas fonctionner par l'interface réseau locale. N'essayez pas de vous appeler, ou de lancer plusieurs Linphone, ca ne fonctionnera pas. Seul l'appel à sipomatic fonctionne en local.

10- Bugs, suggestions

En premier lieu, allez sur le site de Linphone à http://simon.morlat.free.fr afin de vérifier que vous ayez bien la dernière version de Linphone.

Si linphone plante, envoyez moi durectement un message à
linphonebugs@free.fr
Si Linphone ne fonctionne pas, mais ne se plante pas, vérifiez bien que vous avez bien lu ce manuel entièrement avant de m'envoyer un compte rendu à l'adresse précédente.Si vous désirez autre chose, n'hésitez pas à m'envoyer un email à la même adresse. Prenez note que l'ajout de la vidéo, du proxy, et du mode conférence sont planifiés.

Si quelqu'un est interessé pour faire des traductions de Linphone, envoyez moi un fichier xx.po basé sur celui se trouvant dans po/linphone.pot de la distribution. Vous pouvez aussi traduire ce manuel utiisateur dans d'autres langues. Dans tous les cas, contactez moi si vous voulez plus de détails.

11- Auteurs

Simon MORLAT (simon.morlat@free.fr) a ecrit:

Aymeric Moizard (jack@atosc.org) a ecrit la pile SIP oSIP utilisé par linphone.

La librairie GSM a été écrite par:
Jutta Degener and Carsten Bormann,Technische Universitaet Berlin.

La librairie LPC10-1.5 par:
Andy Fingerhut
Applied Research Laboratory <-- this line is optional if
Washington University, Campus Box 1045/Bryan 509 you have limited space
One Brookings Drive
Saint Louis, MO 63130-4899
jaf@arl.wustl.edu
http://www.arl.wustl.edu/~jaf/
Lisez les fichiers textes README dans les repertoire gsmlib et lpc10-1.5 pour plus d'informations.

Les icones sont de Pablo Marcelo Moia et le logo de Philippe Beau.

Traduction en anglais par Delphine PERREAU.

12- Remerciememts

Merci à Daemon Chaplin pour avoir fait Glade, le constructeur d'interface graphique GTK+.

Merci aux auteurs du code des LPC10-1.5 et GSM.

Merci à Joel Barrios ( jbarrios@linuxparatodos.com ) pour ses RPMS.

Merci à Pablo Marcelo Moia pour les icones.

Merci à Philippe Beau pour la traduction de ce manuel en Francais, pour le logo, et pour le nouveau site web qu'il est entrain de faire pour linphone

Merci à l'équipe de developpemement BlueFish pour avoir réalisé bluefish, le merveilleux editeur HTML qui m'a servi à faire ces pages.