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 MANUALE UTENTE LINPHONE
35 Simon Morlat (simon.morlat@linphone.org)
44 Linphone è un semplice strumento di telefonia su rete.
45 Permette di effettuare conversazioni tra due utenti utilizzando una modalità
47 Ecco l'equipaggiamento necessario per usare Linphone :
50 Linux ( Può funzionare anche in altri ambienti come BSD, o altri\SpecialChar ~
52 non l'ho ancora testato personalmente.)
55 Gnome 1.2 o superiore, installato ma non necessariamente usato.
58 Una scheda sonora correttamente configurata.
61 Cuffie o altoparlanti.
67 Una connessione rete (Internet ad esempio), modem, scheda Ethernet ...
71 E' consigliabile chiudere tutte le applicazioni che fanno uso della scheda
72 sonora prima di usare Linphone.
73 Linphone è un programma libero, distribuito sotto la licenza pubblica GNU.
78 ATTENZIONE : Questo strumento è distribuito SENZA GARANZIA.
79 Leggere il file COPYING per maggiori dettagli.
80 Questo significa tra l'altro che non dovete usare Linphone per chiamate
81 confidenziali: non ha ALCUNA CODIFICA DI PROTEZIONE, e quindi può essere
82 molto facile per qualche malintenzionato captare i flussi audio.
83 Si noti inoltre che si raccomanda di non usare Linphone come utente root.
89 Linphone può essere usato in 3 modi diversi :
92 Come applicazione (normale) : nel menu Gnome, Linphone dovrebbe apparire
94 Se non utilizzi Gnome, puoi lanciare Linphone da una finestra terminale,
96 Quando Linphone non è in esecuzione, non è possibile ricevere chiamate.
99 Come applet Gnome : cliccando sul pannello Gnome col pulsante destro, aggiungere
101 Linphone apparirà nella sezione Rete.
102 Apparendo nel pannello Gnome, Linphone è capace di ricevere chiamate anche
103 se la sua finestra non è visibile.
104 Se si vuol vedere la finestra principale, cliccare sull'applet.
105 Quando c'è una chiamata, la finestra principale passa in primo piano, e
106 sentirai gli squilli della chiamata.
109 Come demone : questo è interessante per coloro che non utilizzano Gnome.
110 Per esempio, per KDE, c'é una directory /home/user/.kde2/AutoStart/ dove
111 si possono inserire le applicazioni che si vogliono lanciare ad inizio
113 Nella directory citata, con l'aiuto di un gestore di file, aggiungere un
114 collegamento cliccando col pulsante destro.
115 Il comando da inserire è "linphone -daemon".
116 L'interfaccia prinicipale di Linphone non sarà visibile, e dunque, per
117 farla apparire, si lanci Linphone normalmente, per esempio da una finestra
127 Linphone utilizza il protocollo SIP (Session Initiation Protocol) per effettuare
128 chiamate con altri interlocutori.
129 Il protocollo specifica che ciascuna persona dev'essere identificata da
130 un URL sip della forma: sip:nome_utente@nome_host.
131 Questo modo di chiamare le persone è molto simile a quello utilizzato per
132 la posta elettronica.
135 Nome_utente è il nome di un utente su una macchina, come il login su una
136 macchina linux, per esempio.
137 Nome_host è il nome di una macchina sotto forma di indirizzo IP, o più
138 semplicemente sotto forma di dominio (es: linphone.org).
141 Si noti che SIP è un nuovo protocollo di telecomunicazione fatto per essere
142 semplice ed efficace su internet, che è totalmente diverso ed incompatibile
144 H.323 è il protocollo attualmente usato da NetMeeting e GnomeMeeting.
147 Applicazione: due persone (Bob e Tom) si connettono ad internet con un modem
151 Ecco il modo più semplice di procedere :
157 Un modem da 28.8 Baud o più.
164 Si è convenuto che Bob debba chiamare Tom alle 21.00.
165 Alle 21.00, Tom si connette ad Internet utilizzando kppp, gppp o wvdial
167 Una volta connesso ad internet, può lanciare Linphone.
168 Aprendo la finestra delle statistiche di kppp o gppp, può vedere il suo
169 indirizzo IP (altrimenti può digitare /sbin/ifconfig per vederlo).
170 Il nome dell'interfaccia modem dev'essere ppp0.
173 Di seguito, manda un messaggio a Bob dicendo : "Il mio indirizzo IP è xxx.xxx.xxx.x
177 Bob legge l'email e riporta nella finestra di Linphone il nome e l'indirizzo
178 IP della personne da contattare : Tom@xxx.xxx.xxx.xxx(L'indirizzo IP di Tom)
179 e per finire, clicca sul pulsante Chiamare.
182 Linphone suona a casa di Tom ...Tom risponde alla chiamata cliccando sul pulsante
183 "Rispondere" ed a questo punto la conversazione può iniziare.
187 Se si incontrassero problemi in uno di questi punti, si vada alla sezione
191 Test in locale: non hai nessuno da chiamare per il momento, ma vuoi controllare
192 se Linphone funzioni davvero.
196 \begin_inset LatexCommand \label{sipomatic}
200 A partire dalla versione 0.3.0, Linphone è dotato di un programma di test
201 chiamato "sipomatic".
202 Sipomatic può rispondere automaticamente alle chiamate provenienti da Linphone.
209 Lanciare sipomatic in una finestra terminale.
210 Non siate sorpresi, sipomatic non possiede alcuna interfaccia grafica,
211 ma non c'è bisogno di modificare quello che sta sotto.
215 In Linphone, menu Parametri, sezione Rete, scegliere "lo" come interfaccia
217 Applicare il cambiamento cliccando su OK.
218 Digitare l'indirizzo S.I.P seguente nella finestra principale : sip:robot@127.0.0.1:
220 127.0.0.1 è l'indirizzo locale del tuo computer, e robot è il nome da usare
221 per chiamare sipomatic.
222 5064 è la porta con cui sipomatic può essere contattato.
223 Normalmente si deve utilizzare 5060 per chiamare qualcuno, ma sipomatic
224 fa eccezione : funziona con la porta 5064.
225 Il motivo è che Linphone funziona già sulla porta 5060, ed è impossibile
226 avere due applicazioni che utilizzino la stessa porta nello stesso momento,
227 sulla stessa macchina.
231 Cliccare sul pulsante "Chiamare".
232 Dopo qualche secondo, sipomatic dovrebbe rispondere alla chiamata e vi
233 dovrebbe dire un breve messaggio.
237 \begin_inset LatexCommand \label{params}
241 Parametri di chiamata
245 \begin_inset LatexCommand \label{paramnetwork}
252 Lista delle interfacce di rete: bisogna scegliere un'interfaccia di rete
253 da usare con Linphone.
254 Se si vuole contattare qualcuno su Internet, bisogna scegliere l'interfaccia
255 di rete connessa ad Internet.
256 Per esempio, se si utilizza un modem, dovrà essere ppp0.
257 Se non si è connessi ad alcuna rete, solo l'interfaccia di rete locale,
258 chiamata lo, apparirà nella lista.
259 L'unica scelta che si può fare in questo caso è chiamare
260 \begin_inset LatexCommand \ref[sipomatic]{sipomatic}
267 Tipo di connessione: scegliere il tipo di connessione utilizzata per connettervi
268 alla rete che si desidera utilizzare.
269 Questo aiuterà Linphone ad autoconfigurarsi in funzione della banda passante
270 del tipo di connessione.
274 \begin_inset LatexCommand \label{paramrtp}
284 porta RTP: \SpecialChar ~
285 Linphone utilizza la porta 7072 di default per inviare e ricevere
287 Se la porta 7072 è usata da un'altra applicazione, la si cambi a piacere.
290 Compensazione Jitter: questo numero rappresenta il numero di pacchetti audio
291 che Linphone aspetta prima di farli sentire.
292 Si aumenti questo numero se si sente male la voce, in modo da migliorare
293 la qualità di trasmissione, ma attenzione: questo aumenta il ritardo (Si
294 sentirà la voce dell'interlocutore qualche millisecondo più tardi).
295 D'altro canto, se si utilizza un server perfetto, e si dispone di buoni
296 driver audio, si può scegliere un valore basso fino a 3 pacchetti, sentendo
297 così un ritardo trascurabile.
301 \begin_inset LatexCommand \label{paramsip}
308 SIP (Session Initiation Protocol) è un protocollo che permette di stabilire
309 sessioni telefoniche grazie ad un server IP.
310 Semplificando, è ciò che permette di far suonare il telefono all'altro
311 interlocutore, sospendere o terminare una chiamata quando uno dei due riattacca.
314 porta SIP: Linphone utilizza di default la porta 5060 per inviare / ricevere
316 Si raccomanda caldamente per la RFC del protocollo SIP di utilizzare questo
318 Non lo si cambi a meno che non si sappia davvero cosa si stia facendo.
321 Indirizzo SIP: modifica nome utente e macchina a piacere.
322 Beninteso, dare un nome di macchina quinon significa che questo nome sia
323 conosciuto da altre macchine del server.
324 Nemmeno Linphone userà il nome della macchina e preferirà usare l'indirizzo
325 IP per comunicare con altre macchine.
328 Usare un server segretario sip: si faccia questa scelta, se ci si vuole
329 registrare su un server SIP (segretario) per ottenere servizi vari.
330 Quando non si ha un indirizzo IP fisso, questo può essere interessante
331 per permettere agli amici di chiamare.
333 \begin_inset LatexCommand \ref[enregistrement sur un serveur sip]{registering}
341 \begin_inset LatexCommand \label{paramcodec}
348 I codecs sono algoritmi per comprimere la voce.
349 Per esempio, una voce digitalizzata a 16bit/8000Hz rappresenta un flusso
350 di dati di 128kbits/secondo.
351 Usando il codificatore vocale GSM, questo flusso è ridotto a 13kbits/secondo,
352 senza perdita significativa di qualità.
355 Scelta dei codecs: Linphone può usare diversi codec.
356 Usare i pulsanti posti a lato della lista dei codec in modo da porli nell'ordin
358 Si badi bene, che in funzione del tipo di connessione alla rete, alcuni
359 codec sono inutilizzabili.
360 Questi appariranno in rosso e non saranno selezionabili.
361 Si può decidere di usare o no un codec "utilizzabile" (in blu) cambiando
362 il suo stato con l'aiuto del pulsante Attiva / Disattiva in fianco alla
367 \begin_inset LatexCommand \label{paramaudio}
374 Modo d'uso: se si ha installato il driver ALSA con una libreria ALSA <0.9,
375 si scelga ALSA per avere risultati migliori.
376 Altrimenti, o se non si sa, usare OSS, che funziona sufficientemente bene.
380 Scelta della fonte di registrazione: si può scegliere la fonte di registrazione
382 Nella maggior parte dei casi, sarà il microfono.
385 Opzione auto-kill: scegliendo questa opzione, Linphone fermerà i server
386 sonori (esd & artsd) che possono bloccare la periferica sonora e provocare
387 così problemi problemi d'apertura delle periferiche da parte di Linphone
389 Si raccomanda di attivare questa opzione.
395 A partire dalla versione 0.4.1 Linphone dispone di una rubrica (menu connessione,
396 rubrica), con la quale memorizzare indirizzi, e richiamarli facilmente
397 quando si vuol chiamare.
401 \begin_inset LatexCommand \label{registering}
405 Registrazione su un server sip
408 E' possibile sottoscrivere alcuni servizi sui server sip remoti chiamati
409 segretari, proxy o server ridiretti.
410 Questi servizi possono essere:
413 ridirezione: Linphone chiede al server la creazione di un account <sip:votre_nom
415 Questo indirizzo potrà allora essere utilizzato dai tuoi interlocutori
417 Un piccolo esempio concreto può essere utile: tu non sei altro che un internaut
418 a poverino, connesso temporaneamente grazie ad un modem 56k.
419 La tua macchina non ha un nome di dominio conosciuto ed il tuo indirizzo
420 IP cambia ad ogni connessione.
421 E' impossibile per gli amici chiamare in mancanza dell'indirizzo IP, a
422 meno che non lo si comunichi via posta elettronica, per esempio.
423 Per risolvere questo problema, si può chiedere di avere un indirizzo su
424 un server sip conosciuto dagli amici, fisso e sempre connesso.
425 Per far ciò, specificare l'indirizzo del server nel menu parametri, sezione
427 Questo indirizzo è, per esempio, <sip:server_esempio.com> ed il nome utente
429 \begin_inset Quotes fld
433 \begin_inset Quotes frd
437 Linphone invia allora al server un messaggio per informare della corrispondenza
438 tra l'indirizzo <sip:bob@server_esempio.com> e l'indirizzo IP attuale.
439 D'ora in poi gli amici potranno chiamare usando questo nuovo indirizzo:
440 le chiamate saranno ridirette automaticamente verso la tua macchina.
441 Non ci sarà più bisogno di conoscere l'indirizzo IP, che cambia ogni volta,
443 Ovviamente, si suppone che <sip:server_esempio.com> sia conosciuto da tutti
447 Proxy: è esattamente lo stesso principio, tranne che la ridirezione viene
448 fatta in maniera trasparente ed invisibile dal Linphone del chiamante.
451 Il segretario specificato può essere utilizzato come proxy in uscita.
452 In questo caso tutte le chiamate in uscita dal tuo Linphone saranno dirette
453 verso tale server, che si suppone sia gestito da brave persone.
454 E' quindi molto utile, per non dire indispensabile, che si usi Linphone
455 su una rete privata, gestita da un firewall, anche se su un proxy sip è
456 sicuramente attivo un firewall.
460 Per usare fin da subito un server sip, bisogna aprire il menu Parametri,
461 SIP, e cliccare sul pulsante in fianco a "Usa il segretario sip".
462 Digitare l'indirizzo del segretario, e scegliere un nome utente non troppo
463 comune, in modo da evitare conflitti di nomi.
464 Dare un'indicazione del servizio che il server deve effettuare per te e
465 cliccare sui pulsanti
466 \begin_inset Quotes fld
470 \begin_inset Quotes frd
474 \begin_inset Quotes fld
478 \begin_inset Quotes frd
482 Selezionare anche l'opzione
483 \begin_inset Quotes fld
486 il server è un proxy in uscita
487 \begin_inset Quotes frd
491 se sei dietro ad un firewall.
494 Infine, confermando la scelta, Linphone comunicherà immediatamente con il\SpecialChar ~
496 server SIP per ottenere i servizi richiesti.
497 Allo stesso modo, in fase di uscita da Linphone, ci vorrà qualche secondo
498 per togliere la registrazione dal server.
501 Una lista di server sip può essere trovata a questo indirizzo:
502 \begin_inset LatexCommand \url[http://www.cs.columbia.edu/~hgs/sip/servers.html]{http://www.cs.columbia.edu/~hgs/sip/servers.html}
509 Sfortunatamente, poiché alcuni di questi server non funzionano più, forse
510 a causa della crisi e di fallimenti di società.
511 Alcuni non sono utilizzabili poiché richiedono metodi di autentificazione
512 non ancora implementati in Linphone.
513 Per non perdere tempo, una lista di server sip pubblici funzionanti con
514 Linphone è reperibile su
515 \begin_inset LatexCommand \url[http://simon.morlat.free.fr/english/servers.html]{http://simon.morlat.free.fr/english/servers.html}
522 Uso dietro i firewall
525 Linphone è in grado di funzionare dietro i firewall grazie ad un server
526 proxy SIP in funzione sulla macchina firewall.
527 Un tale server è in corso di sviluppo su
528 \begin_inset LatexCommand \url[http://osipproxy.sourceforge.net]{http://osipproxy.sourceforge.net}
533 Ovviamente sarà libero e basato sulla libreria LGPL oSIP.
536 Una volta che il server proxy sarà attivo, si potrà configurare Linphone
538 Per far ciò, andare in Parametri, sezione SIP e attivare la casella
539 \begin_inset Quotes fld
542 Usa il segretario SIP
543 \begin_inset Quotes frd
546 , indicare il suo indirizzo, ed attivare l'opzione
547 \begin_inset Quotes fld
550 il server è un proxy in uscita
551 \begin_inset Quotes frd
557 C'è un caso in cui il\SpecialChar ~
558 proxy non è indispensabile: quello in cui le macchine
559 di reti private possiedano un indirizzo pubblico: il firewall filtra i
560 pacchetti in entrata o uscita.
561 Bisogna permettere a Linphone di funzionare con le macchine esterne, autorizzar
562 e il traffico UDP sulla porta SIP (di default 5060, è possibile cambiarla),
563 e sulla porta RTP di ciascun Linphone nelle sottoreti.
564 La porta RTP è parametrizzabile, come si è visto, nel menu Parametri.
570 Problemi di connessione
573 Tento di chiamare il mio amico <sip:toto@esempio.com>, ma niente da fare,
577 Bisogna verificare che Linphone usi l'interfaccia di rete a cui sei connesso
578 con la rete su cui si trova il tuo amico.
579 La lista delle interfacce disponibili si trova in Parametri, sezione Rete.
584 Se il problema persistesse, potrebbe essere che il tuo amico non sia al
585 momento raggiungibile.
591 Linphone sembra connettersi correttamente, si sentono gli squilli, ma appena
592 l'interlocutore risponde, non si sente o si capisce più nulla.
595 La maggior parte degli utenti ha di questi problemi poiché non è stata scelta
596 l'interfaccia di rete corretta.
597 Se si usa il modem, dev'essere ppp0.
598 In ogni caso, l'interfaccia
599 \begin_inset Quotes fld
603 \begin_inset Quotes frd
606 non permette di avere una comunicazione via rete.
607 Serve solo per il test locale con sipomatic (vedere più avanti).
610 Aumentare il livello sonoro di acquisizione ed emissione, usando i potenziometri
611 posti nella finestra principale.
614 Se la voce dell'interlocutore sembra vibrare o echeggiare, si può tentaredi
615 aumentare il parametro comensazione jitter (Parametri, RTP).
616 Ma attenzione, questo aumenta il ritardo nella controparte.
619 Se Linphone nonriesce ad usare la scheda sonora, verificare che non sia
620 utilizzata da qualche altro programma audio.
624 Infine, utilizzare il driver sonoro ALSA (vedere
625 \begin_inset LatexCommand \url[http://www.alsa-project.org]{http://www.alsa-project.org}
629 ) , piuttosto che OSS, fornito con il kernel linux.
630 Sfortunatamente la maggior parte delle distribuzioni usano ancora vecchi
631 driver che hanno vari errori e problemi di ritardo.
632 I driver ALSA danno risultati migliori.
633 Si noti che se si cambiano driver, non c'è bisogno di ricompilare Linphone
634 o di cambiare una qualsiasi configurazione.
638 Errori e suggerimenti
641 In primo luogo, andare sul sito di Linphone
642 \begin_inset LatexCommand \url[http://www.linphone.org]{http://www.linphone.org}
646 e verificare di avere la versione più recente di Linphone.
650 Se Linphone si bloccassse, inviami direttamente un messaggio a bugs@linphone.org.
651 Qualora Linphone non funzionasse, ma non si bloccasse, verificare bene
652 di aver letto tutto il manuale prima di mandare un resoconto all'indirizzo
654 In ogni caso invia più informazioni possibili relativamente al problema,
655 in particolar modo i messaggi che compaiono quando lo si lancia da un terminale.
656 Se desideri qualche altra cosa, non esitare ad inviarmi un messaggio a
657 help@linphone.org.Tieni presente che l'aggiunta della modalità video e conferenza
662 Se qualcuno fosse interessato a fare traduzioni di Linphone, mi invii un
663 file xx.po basato su quello in po/linphone.pot della distribuzione.
664 Si può anche tradurre il manuale utente in altre lingue.
665 In ogni caso, contattami qualora volessi maggiori dettagli.
671 Simon MORLAT (simon.morlat@linphone.org) ha scritto:
674 Programma principale (src)
677 Libreria RTP (lprtplib)
680 osipua : la libreria Agente utente sip .
683 Interfaccia per i driver audio (audio)
686 Wrappers per i codecs lpc10-1.5, gsm e g711.
690 Aymeric Moizard (jack@atosc.org) ha scritto la pila SIP oSIP usata da linphone.
694 La libreria GSM è stata scritta da: Jutta Degener and Carsten Bormann,Technische
698 La librairie LPC10-1.5 par: Andy Fingerhut Applied Research Laboratory Washington
699 University, Campus Box 1045/Bryan 509 One Brookings Drive Saint Louis,
700 MO 63130-4899 jaf@arl.wustl.edu http://www.arl.wustl.edu/~jaf/
703 Leggere i file di testo README nella directory gsmlib e lpc10-1.5 per maggiori
707 Le icone sono di Pablo Marcelo Moia ed il logo di Philippe Beau.
713 Grazie a Daemon Chaplin per aver scritto Glade, il costruttore d'interfaccia
717 Grazie agli autori del codice di LPC10-1.5 e GSM.
720 Grazie a Joel Barrios ( jbarrios@-NO-SPAM-linuxparatodos.com ) per i suoi
724 Grazie a Pablo Marcelo Moiaper le icone.
727 Grazie a Philippe Beau per la traduzione di questo manuale in francese,
728 per il logo, e per il nuovo sito web che ha creato per Linphone.
731 Grazie a Alberto Zanoni <alberto.zanoni@-NO-SPAM-PLEASE!-tiscalinet.it> per
732 la traduzione di linphone e questo manuale in Italiano.
736 \begin_inset LatexCommand \tableofcontents{}