1 Einfuehrung ************* 1.1 Beschreibung ================ EciAdsl ist ein freier Linuxtreiber um Ihren Computer mit dem Internet zu verbinden, wenn Sie ein ADSL USB Modem mit GlobeSpan-Chipsatz besitzen. Andere Betriebssysteme wie *BSD sind in Entwicklung (fu"r weitere Informationen kontaktieren Sie bitte die Autoren - *Note Autoren / Support::.) Die EciAdsl Treiber Homepage befindet sich hier: `http://eciadsl.flashtux.org' Eine aktuelle Liste mit unterstu"tzten Modems ist hier zu finden: `http://eciadsl.flashtux.org/modems.php?lang=en&supported=yes' 1.2 Voraussetzungen =================== 1.2.1 Pakete ------------ Um den EciAdsl zu installieren, werden folgende Pakete/Programme beno"tigt: * Ein GNU/Linux System (x86 Architektur) mit Standard-Tools (MDK9/RH8/top-aktuelle/exotische haben evtl. (lo"sbare) Probleme, *BSD und andere Systeme werden noch nicht offiziell unterstu"tzt) * USB 1.1 Hardwareunterstu"tzung * Linux kernel 2.4.x (>=2.4.18-pre3 oder <2.4.18-pre3+N_HDLC Patch wird empfohlen um die automatische pppd-Wiedereinwahl nutzen zu ko"nnen) * USB Unterstu"tzung (als Module): - general USB support - USB preliminary fs - HUB USB controller ALS MODUL - keine Aktivierung des Moduls dabusb * PPP Unterstu"tzung (zusammen mit dem pppd usermode Paket >=2.4.0) * zur Installation aus dem Quellcode heraus: Standardentwicklungspakete (Linux Quellcode in /usr/src/linux, GNU Software, z.B. gcc>=2.91.66, GNU make, etc.) * USB Modem (auf GlobeSpan-Chip basiert) * bash (>=2.x.x) * optional: tcl/tk >= 8.x.x, perl * root Berechtigungen (zumindest fu"r die Treiberinstallation) 1.2.2 Kernel ------------ Wenn Sie die aktuellste Mandrake/Redhat-Distribution mit dem Stan- dardkernel verwenden, ko"nnen Sie dieses Kapitel u"berspringen. Bei anderen Distribution ko"nnen einige Optionen im Kernel fehlen. Wenn eciadsl-doctor fehlende Optionen entdeckt, mu"ssen Sie Ihren Kernel neu kompilieren. Folgende Einstellungen mu"ssen aktiviert werden ("*" steht fu"r "fest im Kernel", "M" steht fu"r "als Modul"): 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 Installation ************** 2.1 dabusb entfernen ==================== Wenn das Modem beim Starten von Linux aktiviert wird, muss dabusb entfernt werden. Bleibt das Modem deaktiviert, ko"nnen Sie diesen Abschnitt u"berspringen. Hotplug ist evtl. aktiviert, und es erkennt fa"lschlicherweise das Modem als Audiogera"t und la"dt das dabusb Modul um es zu aktivieren. Wenn /etc/hotplug/blacklist existiert, editieren Sie die Datei und fu"gen Sie eine Zeile mit dem Inhalt 'dabusb' (ohne Anfu"hrungszeichen) hinzu. Starten Sie Linux neu. Ko"nnen Sie keine Dateien finden, in denen hotplug installiert und aktiviert wird, muss es einen anderen Weg geben, auf dem dabusb geladen wird. Es kann aber auf jeden Fall mit der folgenden Methode deaktiviert werden: * Fahren Sie Linux hoch, wobei das Modem nicht mit dem Rechner verbunden sein darf! * Nun ko"nnen Sie das dabusb Modul mit eciadsl-config-tk oder eciadsl-config-text entfernen oder direkt eciadsl-remove-dabusb (standardma"ssig zu finden in /usr/local/bin) aufrufen. Eine weitere Mo"glichkeit stellt das folgende Kommando dar: `modprobe -r dabusb && rm -f $(modprobe -l | grep dabusb) && depmod -a' Wurde der Kernel per Hand kompiliert, vergessen Sie nicht, das dabusb Modul in der Konfiguration zu deaktivieren. 2.2 Treiberinstallation ======================= Laden Sie das aktuellste stable usermode Paket herunter (Quellcode oder das Paket fu"r Ihre Distribution) von dieser Seite: `http://eciadsl.flashtux.org/download.php?lang=en' Je nach Paket benutzen Sie eines der folgenden Kommandos: * Sources (.tar.gz): `tar xvzf /path/eciadsl-usermode-x.y.tar.gz' * Sources (.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): siehe `http://doc.gentoofr.org/Members/BeTa/eciadsl-gentoo-howto/view' wobei x.y fu"r die jeweilige Version steht (z.B.: 0.8) 2.3 Kompilieren =============== Haben Sie das distributionsspezifische Paket (Redhat/Mandrake, Debian, Slackware, Gentoo) installiert, ko"nnen Sie diesen Abschnitt u"berspringen. Ansonsten mu"ssen Sie nur folgendes in einer Konsole/Terminal aufrufen: `./configure' `make' Als "root": `make install' `./configure --help' gibt eine Liste aller Parameter aus. Wenn Sie die Software bspw. an einen anderen Platz als /usr/local installieren wollen, benutzen Sie bspw. `--prefix=/opt'. Die Konfigurationsdateien des Treibers ko"nnen mit den Parametern -conf-prefix (Standard: /) und -conf-fir (Standard: etc/eciadsl) ein- gestellt werden, bspw.: `--conf-prefix=/opt --conf-dir=etc/eciadsl' oder `--conf-prefix=/opt/eciadsl --conf-dir=etc' Vorsicht mit -etc-prefix, das auch gea"ndert werden kann. Standard ist hier /, was bedeutet, dass /etc benutzt wird. Es wird benutzt um die Systemkonfigurationsdateien wie resolv.conf oder die von pppd zu fin- den. Benutzen Sie -etc-prefix nur wenn Sie wissen was Sie tun! 3 Konfiguration *************** 3.1 Konfigurationstool ====================== * Wenn Tcl/Tk auf Ihrem System installiert ist, ko"nnen Sie das grafische Konfigurationstool verwenden: `eciadsl-config-tk' Geben Sie alle Parameter ein und achten Sie nicht weiter auf die Meldung "Change synch .bin file". * Andernfalls benutzen Sie das Konfigurationstool im Textmodus: `eciadsl-config-text' Folgen Sie einfach den Anweisungen um den Treiber zu konfigurieren. 3.2 Details zu den Parametern ============================= `user' Benutzername, der Ihnen vom Provider zugewiesen wurde z.B.: username@clubadsl1 `password' das dazugeho"rige Passwort, das Ihnen Ihr Provider gegeben hat `VPI' die erste der zu wa"hlenden Nummern Wenn der Windowstreiber bspw. die Zahlen 8, 35 wa"hlt, geho"rt hier die 8 hin. `VCI' die zweite zu wa"hlende Nummer In unserem Beispiel wa"re dies die 35. `Provider DNS' IP-Adresse(n) des/der DNS-Server, die Ihr Provider benutzt Aktivieren Sie "Update provider DNS" und wa"hlen Sie Ihren Provider aus der Liste aus. Ist er nicht aufgefu"hrt, mu"ssen Sie die IP-Adresse(n) manuell eingeben. Wenn Sie die IP-Adressen des/der DNS-Server Ihres Providers nicht wissen, lesen Sie die folgende Frage in den FAQ: `http://eciadsl.flashtux.org/faq.php?lang=en#1.6' Bei T-Online wa"ren hier die folgenden Adressen einzutragen: 212.185.253.9 und 194.25.2.129 `Modem' Wa"hlen Sie Ihr Modem aus der Liste aus. Ist Ihr Modem nicht in der Liste, schauen Sie bitte hier nach: `http://eciadsl.flashtux.org/modems.php?lang=en' - Steht Ihr Modem unter "not supported", wird Ihr Modem von EciAdsl nie unterstu"tzt werden. Bitte fragen Sie in diesem Fall auch nicht die Entwickler - suchen Sie stattdessen bitte einen anderen Treiber fu"r Ihr Modem. - Ist Ihr Modem unter "maybe supported" zu finden, ko"nnen Sie die Entwickler nach dem aktuellen Stand der Unterstu"tzung fragen. *Note Autoren / Support::. `Modem chipset' [value is automatically setted by choosing Modem model]. 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' `Synch .bin file' Wa"hlen Sie diese Option nur, wenn eciadsl-start keine Synchronisierung des Modems bewerkstelligen kann. `PPP mode' - Benutzer in Frankreich wa"hlen hier VCM_RFC2364. - Alle anderen mu"ssen die fu"r den jeweiligen Provider zutreffende Option auswa"hlen. Schauen Sie hierzu bitte in den FAQ nach: `http://eciadsl.flashtux.org/faq.php?lang=en#5.4' - Kunden mit einem T-DSL-Anschluss wa"hlen hier die Option RFC1483 BRIDGED ETH with NO FCS `DHCP' Wa"hlen Sie diese Option wenn Ihr Provider Ihnen eine IP-Adresse per DHCP zuweist. Bei T-DSL trifft dies bspw. nicht zu. `Static IP' Wa"hlen Sie dies wenn Sie eine statische IP-Adresse benutzen. Geben Sie diese und das Gateway anschliessend ein. Im Zweifelsfall lassen Sie diese Option deaktiviert. 4 Verbindung ************ 4.1 Eciadsl-start ================= Um eine Internetverbindung herzustellen, geben Sie das folgende Kommando als root ein: `eciadsl-start | tee log.txt' 4.1.1 Probleme mit der Synchronisierung --------------------------------------- Bei Problemen mit der Synchronisierung (eciadsl-synch timeout/error oder lcp timeouts nach Synchronisierung), folgen Sie diesen Anweisungen: * Download des .bin Pakets: `http://eciadsl.flashtux.org/download.php?lang=en&view=sync' * das Paket als root in /etc/eciadsl entpacken: `cd /etc/eciadsl && tar xvzf /path/eciadsl-synch_bin.tar.gz' * mit eciadsl-config-tk oder eciadsl-config-text eine andere .bin Datei wa"hlen * Ru"cksetzen des Modems: entweder `modprobe -r usb-uhci && modprobe usb-uhci' (bzw. usb-ohci) oder das USB-Kabel kurzzeitig entfernen * eciadsl-start erneut aufrufen Gibt es immer noch synch-Probleme, benutzen Sie eine andere synch .bin Datei. Sie ko"nnen ALLE synch .bin Dateien benutzen, die Ihnen zur Verfu"gung gestellt werden. Falls keine funktioniert, mu"ssen Sie Ihre eigene .bin Datei unter Windows erzeugen. *Note Erzeugen von synch .bin Dateien::. Bei anderen Problemen mit eciadsl-start, schauen Sie bitte in den FAQ: `http://eciadsl.flashtux.org/faq.php?lang=en' 4.1.2 PPPoE Benutzer -------------------- Verwendet Ihr Provider PPPoE, mu"ssen Sie einen PPPoE-Client installieren und konfigurieren, bspw. rp-pppoe (http://www.roaringpenguin.com/pppoe), um eine Modemverbindung via tap0 herstellen zu ko"nnen. 4.2 Weitere Skripte =================== 4.2.1 eciadsl-probe-device -------------------------- Benutzen Sie dieses Skript wenn eciadsl-start Ihr Modem nicht findet. Dieses Skript sucht nach der VID/PID Ihres Modems und zeigt diese an. Fu"r weitere Details kontaktieren Sie bitte die Entwickler. *Note Autoren / Support::. 4.2.2 eciadsl-doctor -------------------- Benutzen Sie dieses Skript (mit der Option `--usb-init') falls eciadsl-start ein anderes Problem hat als "Modem not found" oder Probleme mit der Synchronisierung. 4.2.3 eciadsl-probe-synch ------------------------- Wenn Sie Probleme mit der Synchronisierung haben, ko"nnen Sie dieses Skript benutzen um automatisch alle synch .bin Dateien durchzuprobieren. 5 Erzeugen von synch .bin Dateien ********************************* Wenn Sie Probleme mit der Synchronisierung haben und alle .bin Da- teien ausprobiert haben, mu"ssen Sie sich Ihre eigene .bin Datei unter Windows erzeugen. Andernfalls ko"nnen Sie dieses Kapitel komplett u"berspringen. 5.1 Eci Windowstreiber ====================== [`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 -------------- Benutzen Sie den Eci Windowstreiber fu"r Ihr Modem (andernfalls wu"rde Ihre .bin Datei nicht unter Linux funktionieren). Version 1.06 des Windowstreibers ko"nnen Sie hier herunterladen: `http://eciadsl.flashtux.org/download/eci_drv_106_win.zip' 5.1.2 Treibermodifizierung -------------------------- Wenn Ihr Modem keine der folgenden VID/PID-Kombinationen besitzt, mu"s- sen Sie eine Änderung in den Treiberdateien vornehmen. - VID1/PID1: 0547/2131, VID2/PID2: 0915/8000 - VID1/PID1: 0915/0001, VID2/PID2: 0915/0002 Um Ihre VID/PID herauszubekommen, schauen Sie bitte hier nach: `http://eciadsl.flashtux.org/modems.php?lang=en'. Folgendes mu"ssen Sie modifizieren: - in der Datei *gafwload.inf*, Zeile 24: `ExcludeFromSelect = USB\VID_*0547*&PID_*2131*' ersetzen Sie 0547 mit Ihrer VID1 und 2131 mit Ihrer PID1 - in der Datei *gafwload.inf*, Zeile 30: `%GSILOAD.DeviceDescAnchor% = GSIUSBLDRANCHOR, USB\VID_*0547*&PID_*2131*' ersetzen Sie 0547 mit Ihrer VID1 und 2131 mit Ihrer PID1 - in der Datei *gwausb.inf*, Zeile 34: `ExcludeFromSelect = USB\VID_*0915*&PID_*8000*' ersetzen Sie 0915 mit Ihrer VID2 und 8000 mit Ihrer PID2 - in der Datei *gwausb.inf*, Zeile 42: `%ADSLUSB.DeviceDesc% = ADSLUSB.gspnDefault, USB\VID_*0915*&PID_*8000*' ersetzen Sie 0915 mit Ihrer VID2 und 8000 mit Ihrer PID2 - in der Datei *gwausb.inf*, Zeile 58: `HKR, Ndi, DeviceID, 0, "USB\VID_*0915*&PID_*8000*"' ersetzen Sie 0915 mit Ihrer VID2 und 8000 mit Ihrer PID2 5.1.3 Installation ------------------ Rufen Sie setup.exe auf und folgen Sie den Anweisungen. 5.2 USB Sniffer =============== Laden Sie sich die neueste Version des USB sniffers herunter und installieren Sie sie: `http://benoit.papillault.free.fr/usbsnoop/' Die Dokumentation fu"r den USB sniffer ("Snoopy") finden Sie hier: `http://benoit.papillault.free.fr/usbsnoop/doc.php' 5.3 USB Pakete unter Windows "sniffen" ====================================== Deaktivieren Sie die automatische Interneteinwahl und entfernen Sie alle USB-Gera"te ausser dem Modem. Starten Sie den sniffer, wa"hlen Sie die Zeile aus, die fu"r Ihr Modem steht (z.B. "Wan modem") und klicken Sie auf "Install". Anschliessend mu"ssen Sie das Modem kurz vom Rechner trennen und wieder anschliessen. Sobald das Modem mit der Synchronisierung fertig ist (achten Sie auf die LEDs am Modem), klicken Sie auf "Uninstall". Eventuell mu"ssen Sie das Modem auch wieder vom Rechner trennen, da- mit der Sniffer keine weiteren Pakete mitschreibt. Die abgeho"rten USB-Pakete sollten nun in `C:\WINxxx\usbsnoop.log' zu finden sein. Booten Sie anschliessend Linux. 5.4 Konvertieren der log Datei in eine synch .bin Datei ======================================================= Mounten Sie die Windowspartition und kopieren Sie die Datei usbsnoop.log auf die Linuxpartition. Rufen Sie anschliessend auf: `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 (das Perlskript befindet sich im Paket usermode). Rufen Sie das folgende Kommando auf: `mv #BIN_FILENAME_CREATED# /etc/eciadsl/my_synch.bin' substitute `#BIN_FILENAME_CREATED' with bin file name created. und benutzen Sie anschliessend eciadsl-config-text um die neue synch .bin Datei zu aktivieren. Starten Sie nun eciadsl-start... ...und dru"cken Sie die Daumen! ;-) 6 Autoren / Support ******************* 6.1 Autoren =========== EciAdsl Treiber wurde geschrieben von: * FlashCode > * Jean-Se'bastien Valette > * Benoit Papillault > * Crevetor > * Laurent Wandrebeck (low) > 6.2 Hier bekommen Sie Support ============================= Bitte lesen Sie die vollsta"ndige Dokumentation und die FAQ bevor Sie nach Support fragen. Sehen Sie sich ebenfalls in /usr/local/doc/eciadsl die Dateien README, INSTALL und TROUBLESHOOTING an. * Support im IRC: - server: irc.freenode.net - channel: #eci * EciAdsl Forum: `http://eciadsl.sf.net/scripts/forum' * Support per mailing list: - um sich einzutragen, senden Sie eine Mail mit dem Betreff "subscribe" an - um eine E-Mail an die mailing list zu schicken, verwenden Sie die Adresse - um sich auszutragen, senden Sie eine E-Mail mit dem Betreff "unsubscribe" an Dank ZeGuigui ist hier ein Archiv der mailing list zu finden: `http://liste.eci.free.fr' * weitere Details sind auf der EciAdsl Supportseite zu finden: `http://eciadsl.flashtux.org/support.php?lang=en'