1 Introduzione ************** 1.1 Descrizione =============== EciAdsl e` un driver libero per Linux per connettere il tuo computer ad internet, se hai un modem ADSL USB basato sul chipset Globespan. Altri sistemi operativo come *BSD sono sotto sviluppo (per favore contatta gli autori per maggiori informazioni, *Note Autori / Supporto::.) Questa e` la homepage del driver EciAdsl: `http://eciadsl.flashtux.org' Una lista aggiornata dei modem supportati e` disponibile in questa pagina: `http://eciadsl.flashtux.org/modems.php?lang=en&supported=yes' 1.2 Pre-requisiti ================= 1.2.1 Pacchetti --------------- Per installare il driver EciAdsl, tu necessiti i seguenti programmi/pacchetti: * Un sistema GNU/Linux funzionante (architettura x86) con gli strumenti standard (distribuzioni MDK9/RH8/recenti/esotiche possono avere problemi (risolvibili), BSD ed altri sistemi non sono ancora ufficialmente supportati) * supporto hardware USB 1.1 * kernel Linux 2.4.x (>=2.4.18-pre3 o <2.4.18-pre3 + patch N_HDLC per attivare la riconnessione pppd automatica, che raccomandiamo) * supporto USB (come modulo): - supporto generale USB - fs USB preliminare - il tuo controller HUB USB come MODULO - modulo DABUSB disabilitato * supporto PPP (incluso il pacchetto pppd usermode >=2.4.0) * installazione dai sorgenti: pacchetti di sviluppo standard (sorgenti di Linux in /usr/src/linux, software GNU come gcc>=2.91.66, GNU make, etc...) * modem USB (*solo* quelli con chipset GlobeSpan) * bash (>=2.x.x) * opzionale: tcl/tk >= 8.x.x * privilegi di root (almeno per installare il driver) 1.2.2 Kernel ------------ Se hai l'ultima versione di Mandrake/Redhat con il kernel predefinito puoi saltare questo capitolo. A seconda della tua distribuzione, alcune opzioni potrebbero mancare nel tuo kernel. Se eciadsl-doctor dice che ci sono opzioni mancanti, hai bisogno di ricompilare il tuo kernel. Tu DEVI includere queste opzioni ("*" va incluso "nel kernel", "M" va come "modulo"): USB support --> Support for USB [ ] USB verbose debug messages -- Miscellaneous USB options [*] Preliminary USB device filesystem [ ] Enforce USB bandwidth allocation (EXPERIMENTAL) [ ] Long timeout for slow-responding devices (some MGE Ellipse UPSes) -- USB Host Controller Drivers < > EHCI HCD (USB 2.0) support (EXPERIMENTAL) UHCI (Intel PIIX4, VIA, ...) support UHCI Alternate Driver (JE) support OHCI (Compaq, iMacs, OPTi, SiS, ALi, ...) support .. -- USB Multimedia devices .. < > DABUSB driver .. Character devices --> .. [*] Non-standard serial port support HDLC line discipline support .. Network device support --> .. PPP (point-to-point protocol) support [ ] PPP multilink support (EXPERIMENTAL) [ ] PPP filtering PPP support for async serial ports PPP support for sync tty ports PPP Deflate compression PPP BSD-Compress compression < > PPP over Ethernet (EXPERIMENTAL) < > PPP over ATM (EXPERIMENTAL) 2 Installazione *************** 2.1 Rimozione dabusb ==================== Se il modem si accende all'avvio di Linux, devi rimuovere dabusb. Altrimenti, salta questa sezione. Hotplug e` probabilmente abilitato, e questo trova erroneamente il tuo modem come una periferica audio e carica il modulo dabusb per questa periferica audio. Se /etc/hotplug/blacklist esiste, modificalo e aggiungi una lina contente la parola 'dabusb' (senza virgolette). Riavvia Linux. Se non trovi il file nonostante hotplug sia installato e abilitato, ci deve essere un'altra strada per configurarlo, ma puoi anche applicare il seguente metodo (un o` alla larga): * Fai partire la macchina con Linux con il modem staccato * Puoi rimuovere il modulo dabusb dal tuo sistema usando eciadsl-config-tk o eciadsl-config-text. Puoi anche utilizzare direttamente eciadsl-remove-dabusb (in /usr/local/bin di default). O, manualmente inserire il seguente comando: `modprobe -r dabusb && rm -f $(modprobe -l | grep dabusb) && depmod -a' Se il kernel e` stato compilato a mano, non dimenticare di rimuovere il supporto dabusb anche dalla configurazione del kernel. 2.2 Installazione pacchetto =========================== Scarica l'ultimo pacchetto stabile usermode (codice sorgente o un pacchetto per la tua distrubuzione) in questa pagina: `http://eciadsl.flashtux.org/download.php?lang=en' A seconda del pacchetto che scarichi, usa uno di questi comandi: * Sorgenti (.tar.gz): `tar xvzf /path/eciadsl-usermode-x.y.tar.gz' * Sorgenti (.tar.bz2): `tar xvjf /path/eciadsl-usermode-x.y.tar.bz2' * RedHat/Mandrake (.rpm): `rpm -i /path/eciadsl-usermode-x.y-1.i386.rpm' * Debian (.deb): `dpkg -i /path/eciadsl-usermode_x.y-1_i386.deb' * Slackware (.tgz): `installpkg /path/eciadsl-usermode-x.y-i386-1.tgz' * Gentoo (.ebuild): guarda `http://doc.gentoofr.org/Members/BeTa/eciadsl-gentoo-howto/view' dove x.y e` la versione (per esempio 0.8) 2.3 Compilazione ================ Se hai installato un pacchetto specifico per la tua distribuzione (Redhat/Mandrake, Debian, Slackware, Gentoo), puoi saltare questo passaggio. Tutto ciò che bisogna fare è eseguire dal terminale o da una console: `./configure' `make' Come "root": `make install' Esegui './configure -help' per avere una lista dei settaggi opzionali. Potresti voler installare il software in una directory diversa da quella di default (/usr/local), usando ad esempio -prefix=/opt. I file di configurazione del driver possono essere installati in una directory a scelta (di default in /ect/eciadsl), usando i parametri -conf-prefix (il default è /) e -conf-dir (il default è etc/eciadsl). Ad esempio: `--conf-prefix=/opt --conf-dir=etc/eciadsl' o `--conf-prefix=/opt/eciadsl --conf-dir=etc' Fai attenzione, puoi cambiare anche -etc-prefix (il default è /, così viene usato /etc), però questo parametro viene usato anche per raggiungere file come resolv.conf o il file di configurazione di pppd. Usa -ect-prefix solo se sai cosa stai facendo. Vedi gli altri parametri usando './configure -help'. 3 Configurazione **************** 3.1 Strumento di configurazione =============================== * Se Tcl/Tk e` installato sul tuo sistema, puoi eseguire lo strumento di configurazione grafico: `eciadsl-config-tk' Inserisci tutti i parametri senza cliccare su "Change synch .bin file". * Altrimenti, esegui la configurazione testuale: `eciadsl-config-text' Segui i passaggi per configurare il driver. 3.2 Dettagli dei parametri ========================== `utente' Nome utente fornito dal tuo provider Per esempio: username@clubadsl1 `password' Password fornita dal tuo provider `VPI' Primo numero di "numero chiamato" Per esempio se tu "chiami" 8,35 con Windows il tuo VPI e` 8. `VCI' Secondo numero di "numero chiamato" Per esempio se tu "chiami" 8,35 con Windows il tuo VCI e` 35. `Provider DNS' Seleziona la casella "Update provider DNS" e scegli il tuo provider nella lista. Se il tuo provider non e` nella lista, inserisci manualmente i tuoi server DNS nei campi sotto la lista. Se non conosci i tuoi server DNS, leggi questa domanda nelle FAQ: `http://eciadsl.flashtux.org/faq.php?lang=it#1.6' `Modem' Seleziona il tuo modem nella lista. Se il tuo modem non e` nella lista, controlla la pagina dei modem: `http://eciadsl.flashtux.org/modems.php?lang=en' - Se il tuo modem e` "non supportato", il driver non funzionera' mai con il tuo modem (per favore non chiedere supporto agli sviluppatori, devi cercare un altro driver). - Se il tuo modem e` "probabilmente supportato", chiedi agli sviluppatori per i dettagli. *Note Autori / Supporto::. `Modem chipset' [value is automatically setted by choosing Modem model]. Select your modem chipset model from the list. For any doubt please check on modems page: `http://eciadsl.flashtux.org/modems.php?lang=en' `Alt synch' [value is automatically setted by choosing Modem model]. It is the USB alt interface used by eciadsl to comunicate with modems during synch phase. Standard values: 4 for GS7070 (old modem models) - 5 or 0 for GS7470 chipset (new modem models) For any doubt please check on modems page: `http://eciadsl.flashtux.org/modems.php?lang=en' `Alt pppoeci' [value is automatically setted by choosing Modem model]. It is the USB alt interface used by eciadsl to comunicate with modems during pppoeci phase. Standard values: 4 for GS7070 (old modem models) - 1 or 0 for GS7470 chipset (new modem models) For any doubt please check on modems page: `http://eciadsl.flashtux.org/modems.php?lang=en' `File di sincronizzazione .bin' Seleziona questa opzione solo se eciadsl-start fallisce la sincronizzazione. `Modalita' PPP' - Per gli utenti francesi, scegli la modalita' PPP predefinita (VCM_RFC2364). - Per gli altri utenti, controlla la modalita' PPP approprieata con il tuo provider. Guarda questa domanda nelle FAQ: `http://eciadsl.flashtux.org/faq.php?lang=it#5.4' `DHCP' Selezionalo solo se il tuo provider usa DHCP. Se non lo sai, lascia questa opzione deselezionata. `IP statico' Selezionalo solo se hai un IP statico. Se si, inserisci l'indirizzo IP e il gateway qui sotto. Se non lo sai, lascia questa opzione deselezionata. 4 Connessione ************* 4.1 Eciadsl-start ================= Per connetterti ad internet, usa il comando da root: `eciadsl-start | tee log.txt' 4.1.1 Problemi di sincronizzazione ---------------------------------- Se hai problemi di sincronizzazione (eciadsl-synch timeout/errore o lcp timeout dopo la sincronizzazione), segui le istruzioni qui sotto: * Download .bin package there: `http://eciadsl.flashtux.org/download.php?lang=en&view=sync' * Decomprimi il pacchetto in /etc/eciadsl (come root): `cd /etc/eciadsl && tar xvzf /path/eciadsl-synch_bin.tar.gz' * Esegui eciadsl-config-tk o eciadsl-config-text e scegli un altro file .bin * Spegni il modem: con `modprobe -r usb-uhci' (o usb-ohci), oppure scollegando/ricollegando il modem (cavo USB). * Esegui eciadsl-start di nuovo. Se hai ancora problemi di sincronizzazione, prova un altro file .bin. Importante: puoi provare TUTTI i file .bin, non guardare il posto o il provider del .bin. Se nessun .bin funziona, dovrai creare il tuo file. bin personalizzato sotto Windows. *Note Creazione del .bin di sincronizzazione::. Per altri problemi con eciadsl-start, per favore guarda le FAQ: `http://eciadsl.flashtux.org/faq.php?lang=it' 4.1.2 Utenti PPPoE ------------------ Se stai usando PPPoE, devi configurare ed utilizzare un client standard PPPoE come rp-pppoe (http://www.roaringpenguin.com/pppoe) per connettere il tuo modem ADSL attraverso tap0. 4.2 Altri script ================ 4.2.1 eciadsl-probe-device -------------------------- Usa questo script se eciadsl-start non trova il tuo modem. Questo script guarda i VID/PID del tuo modem e li visualizza. Per i dettagli, per favore contattaci, *Note Autori / Supporto::. 4.2.2 eciadsl-doctor -------------------- Usa questo script (con opzione `--usb-init') se eciadsl-start fallisce con altri problemi oltre a "Modem non trovato" o di sincronizzazione. 4.2.3 eciadsl-probe-synch ------------------------- Usa questo script per provare automaticamente tutti i file .bin, se hai problemi di sincronizzazione. 5 Creazione del .bin di sincronizzazione **************************************** Se hai problemi di sincronizzazione e hai provato tutti i file .bin senza successo, devi creare il tuo file .bin personalizzato sotto Windows. Altrimenti, puoi saltare questo capitolo. 5.1 Driver Eci per Windows ========================== [`Skip this section if your modem has a GS7470 chipset, YOU MUST USE YOUR OWN WINDOWS DRIVER. For any doubt please check your modem chipset at:' `http://eciadsl.flashtux.org/modems.php?lang=en']. 5.1.1 Download -------------- Scarica il driver Eci per windows versione 1.06 (altrimenti il file .bin non funzionera' sotto linux): `http://eciadsl.flashtux.org/download/eci_drv_106_win.zip' 5.1.2 Modifica del driver ------------------------- Se il tuo modem non ha uno di questi VID/PID, devi modificare due file nel driver di windows: - VID1/PID1: 0547/2131, VID2/PID2: 0915/8000 - VID1/PID1: 0915/0001, VID2/PID2: 0915/0002 Per verificare i tuoi VID/PID, guarda qui: `http://eciadsl.flashtux.org/modems.php?lang=en'. Modifiche da fare: - nel file *gafwload.inf*, linea 24 : `ExcludeFromSelect = USB\VID_*0547*&PID_*2131*' sostituisci 0547 con il tuo VID1 e 2131 con il tuo PID1 - nel file *gafwload.inf*, line 30 : `%GSILOAD.DeviceDescAnchor% = GSIUSBLDRANCHOR, USB\VID_*0547*&PID_*2131*' sostituisci 0547 con il tuo VID1 e 2131 con il tuo PID1 - nel file *gwausb.inf*, linea 34 : `ExcludeFromSelect = USB\VID_*0915*&PID_*8000*' sostituisci 0915 con il tuo VID2 e 8000 con il tuo PID2 - nel file *gwausb.inf*, linea 42 : `%ADSLUSB.DeviceDesc% = ADSLUSB.gspnDefault, USB\VID_*0915*&PID_*8000*' sostituisci 0915 con il tuo VID2 e 8000 con il tuo PID2 - nel file *gwausb.inf*, linea 58 : `HKR, Ndi, DeviceID, 0, "USB\VID_*0915*&PID_*8000*"' sostituisci 0915 con il tuo VID2 e 8000 con il tuo PID2 5.1.3 Installazione ------------------- Lancia setup.exe e segui le istruzioni. 5.2 Sniffer USB =============== Scarica e installa l'ultima versione del pacchetto sniffer USB. Puoi trovarla qui: `http://benoit.papillault.free.fr/usbsnoop/' La documentazione per Snoopy (sniffer USB) e` disponibile qui: `http://benoit.papillault.free.fr/usbsnoop/doc.php' 5.3 Sniffing di pacchetti USB sotto Windows =========================================== Disabilitata l'auto-connessione ad internet e scollega tutte le periferiche USB (eccetto il modem). Avvia lo sniffer e installa il filtro sul "modem Wan", quindi scollega e ricollega il modem. Appena le luci rosse e verdi sono fisse, disinstalla i filtri. I pacchetti sniffati dovrebbe essere nel file `C:\WINxxx\usbsnoop.log' Riavvia sotto Linux. 5.4 Conversione da log a .bin sotto Linux ========================================= Monta la partizione di windows contente il file usbsnoop.log e copialo dove vuoi. Esegui questo comando: `eciadsl-vendor-device.pl usbsnoop.log -chipset=#YOUR_MODEM_CHISPET#' substitute `#YOUR_MODEM_CHISPET#' with your modem chipset (GS7070 or GS7470). For help, issue this command: `eciadsl-vendor-device.pl -h' This perl script parses the log file and generates a new bin file (script fornito con il pacchetto usermode). Esegui questo comando: `mv #BIN_FILENAME_CREATED# /etc/eciadsl/my_synch.bin' substitute `#BIN_FILENAME_CREATED' with bin file name created. quindi esegui eciadsl-config-text e usa questo.bin Esegui eciadsl-start... ...e incrocia le dita :-) 6 Autori / Supporto ******************* 6.1 Autori ========== Driver EciAdsl e` scritto da: * FlashCode > * Jean-Se'bastien Valette > * Benoit Papillault > * Crevetor > * Laurent Wandrebeck (low) > 6.2 Ricevi supporto =================== Prima di chiedere supporto, assicurati di aver letto la documentazione e le FAQ forniti con il driver (guarda dentro /usr/local/doc/eciadsl, file README, INSTALL e TROUBLESHOOTING). * Supporto con IRC: - server: irc.freenode.net - canale: #eci * Forum EciAdsl: `http://eciadsl.sf.net/scripts/forum' * Supporto con mailing list: - per iscriversi, inviare una mail a con "subscribe" come oggetto - per inviare una mail a tutti gli iscritti alla mailing list, invia la tua mail a - per cancellare l'iscrizione, invia una mail a con "unsubscribe" come oggetto Grazie a ZeGuigui, l'archivio della mailing list archive e` disponibile qui: `http://liste.eci.free.fr' * Guarda la pagina di supporto EciAdsl per i dettagli: `http://eciadsl.flashtux.org/support.php?lang=en'