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{}