Einfuehrung
***********

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 (für weitere Informationen kontaktieren Sie bitte die Autoren - see Autoren / Support.)

Die EciAdsl Treiber Homepage befindet sich hier:

http://eciadsl.flashtux.org

Eine aktuelle Liste mit unterstützten Modems ist hier zu finden:

http://eciadsl.flashtux.org/modems.php?lang=en&supported=yes

Voraussetzungen
===============

Pakete
------

Um den EciAdsl zu installieren, werden folgende Pakete/Programme benötigt:

  * Ein GNU/Linux System (x86 Architektur) mit Standard-Tools (MDK9/RH8/top-aktuelle/exotische haben evtl. (lösbare) Probleme, *BSD und andere Systeme werden noch nicht offiziell unterstützt)

  * USB 1.1 Hardwareunterstü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 können)

  * USB Unterstützung (als Module):

       - general USB support

       - USB preliminary fs

       - HUB USB controller ALS MODUL

       - keine Aktivierung des Moduls dabusb

  * PPP Unterstü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 für die Treiberinstallation)

Kernel
------

Wenn Sie die aktuellste Mandrake/Redhat-Distribution mit dem Stan- dardkernel verwenden, können Sie dieses Kapitel überspringen.

Bei anderen Distribution können einige Optionen im Kernel fehlen. Wenn eciadsl-doctor fehlende Optionen entdeckt, müssen Sie Ihren Kernel neu kompilieren.

Folgende Einstellungen müssen aktiviert werden ("*" steht für "fest im Kernel", "M" steht für "als Modul"):

USB support --->

  <M> 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)

  <M>   UHCI (Intel PIIX4, VIA, ...) support

  <M>   UHCI Alternate Driver (JE) support

  <M>   OHCI (Compaq, iMacs, OPTi, SiS, ALi, ...) support

  ..

  --- USB Multimedia devices

  ..

  < >   DABUSB driver

  ..

Character devices --->

  ..

  [*] Non-standard serial port support

  <M>   HDLC line discipline support

  ..

Network device support --->

  ..

  <M> PPP (point-to-point protocol) support

  [ ] PPP multilink support (EXPERIMENTAL)

  [ ] PPP filtering

  <M> PPP support for async serial ports

  <M> PPP support for sync tty ports

  <M> PPP Deflate compression

  <M> PPP BSD-Compress compression

  < > PPP over Ethernet (EXPERIMENTAL)

  < > PPP over ATM (EXPERIMENTAL)

Installation
************

dabusb entfernen
================

Wenn das Modem beim Starten von Linux aktiviert wird, muss dabusb entfernt werden. Bleibt das Modem deaktiviert, können Sie diesen Abschnitt überspringen.

Hotplug ist evtl. aktiviert, und es erkennt fälschlicherweise das Modem als Audiogerät und lädt das dabusb Modul um es zu aktivieren.

Wenn /etc/hotplug/blacklist existiert, editieren Sie die Datei und fügen Sie eine Zeile mit dem Inhalt 'dabusb' (ohne Anführungszeichen) hinzu. Starten Sie Linux neu.

Kö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 können Sie das dabusb Modul mit eciadsl-config-tk oder eciadsl-config-text entfernen oder direkt eciadsl-remove-dabusb (standardmäßig zu finden in /usr/local/bin) aufrufen.

     Eine weitere Mö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.

Treiberinstallation
===================

Laden Sie das aktuellste stable usermode Paket herunter (Quellcode oder das Paket fü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 für die jeweilige Version steht (z.B.: 0.8)

Kompilieren
===========

Haben Sie das distributionsspezifische Paket (Redhat/Mandrake, Debian, Slackware, Gentoo) installiert, können Sie diesen Abschnitt überspringen.

Ansonsten mü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 kö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 geä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!

Konfiguration
*************

Konfigurationstool
==================

  * Wenn Tcl/Tk auf Ihrem System installiert ist, kö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.

Details zu den Parametern
=========================

user
     Benutzername, der Ihnen vom Provider zugewiesen wurde

     z.B.: username@clubadsl1

password
     das dazugehörige Passwort, das Ihnen Ihr Provider gegeben hat

VPI
     die erste der zu wählenden Nummern

     Wenn der Windowstreiber bspw. die Zahlen 8, 35 wählt, gehört hier die 8 hin.

VCI
     die zweite zu wählende Nummer

     In unserem Beispiel wäre dies die 35.

Provider DNS
     IP-Adresse(n) des/der DNS-Server, die Ihr Provider benutzt

     Aktivieren Sie "Update provider DNS" und wählen Sie Ihren Provider aus der Liste aus. Ist er nicht aufgeführt, mü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 wären hier die folgenden Adressen einzutragen:

     212.185.253.9 und 194.25.2.129

Modem
     Wä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 unterstützt werden. Bitte fragen Sie in diesem Fall auch nicht die Entwickler - suchen Sie stattdessen bitte einen anderen Treiber für Ihr Modem.

     - Ist Ihr Modem unter "maybe supported" zu finden, können Sie die Entwickler nach dem aktuellen Stand der Unterstützung fragen. See 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
     Wählen Sie diese Option nur, wenn eciadsl-start keine Synchronisierung des Modems bewerkstelligen kann.

PPP mode
     - Benutzer in Frankreich wählen hier VCM_RFC2364.

     - Alle anderen müssen die für den jeweiligen Provider zutreffende Option auswä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 wählen hier die Option RFC1483 BRIDGED ETH with NO FCS

DHCP
     Wählen Sie diese Option wenn Ihr Provider Ihnen eine IP-Adresse per DHCP zuweist. Bei T-DSL trifft dies bspw. nicht zu.

Static IP
     Wählen Sie dies wenn Sie eine statische IP-Adresse benutzen.

     Geben Sie diese und das Gateway anschließend ein.

     Im Zweifelsfall lassen Sie diese Option deaktiviert.

Verbindung
**********

Eciadsl-start
=============

Um eine Internetverbindung herzustellen, geben Sie das folgende Kommando als root ein:

eciadsl-start | tee log.txt

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 wählen

  * Rü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 können ALLE synch .bin Dateien benutzen, die Ihnen zur Verfügung gestellt werden.

     Falls keine funktioniert, müssen Sie Ihre eigene .bin Datei unter Windows erzeugen. See 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

PPPoE Benutzer
--------------

Verwendet Ihr Provider PPPoE, müssen Sie einen PPPoE-Client installieren und konfigurieren, bspw. rp-pppoe (http://www.roaringpenguin.com/pppoe), um eine Modemverbindung via tap0 herstellen zu können.

Weitere Skripte
===============

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. Für weitere Details kontaktieren Sie bitte die Entwickler. See Autoren / Support.

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.

eciadsl-probe-synch
-------------------

Wenn Sie Probleme mit der Synchronisierung haben, können Sie dieses Skript benutzen um automatisch alle synch .bin Dateien durchzuprobieren.

Erzeugen von synch .bin Dateien
*******************************

Wenn Sie Probleme mit der Synchronisierung haben und alle .bin Da- teien ausprobiert haben, müssen Sie sich Ihre eigene .bin Datei unter Windows erzeugen.

Andernfalls können Sie dieses Kapitel komplett überspringen.

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].

Download
--------

Benutzen Sie den Eci Windowstreiber für Ihr Modem (andernfalls würde Ihre .bin Datei nicht unter Linux funktionieren). Version 1.06 des Windowstreibers können Sie hier herunterladen:

http://eciadsl.flashtux.org/download/eci_drv_106_win.zip

Treibermodifizierung
--------------------

Wenn Ihr Modem keine der folgenden VID/PID-Kombinationen besitzt, mü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 mü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

Installation
------------

Rufen Sie setup.exe auf und folgen Sie den Anweisungen.

USB Sniffer
===========

Laden Sie sich die neueste Version des USB sniffers herunter und installieren Sie sie:

http://benoit.papillault.free.fr/usbsnoop/

Die Dokumentation für den USB sniffer (``Snoopy'') finden Sie hier:

http://benoit.papillault.free.fr/usbsnoop/doc.php

USB Pakete unter Windows ``sniffen''
====================================

Deaktivieren Sie die automatische Interneteinwahl und entfernen Sie alle USB-Geräte außer dem Modem.

Starten Sie den sniffer, wählen Sie die Zeile aus, die für Ihr Modem steht (z.B. ``Wan modem'') und klicken Sie auf ``Install''. Anschließend müssen Sie das Modem kurz vom Rechner trennen und wieder anschließen. Sobald das Modem mit der Synchronisierung fertig ist (achten Sie auf die LEDs am Modem), klicken Sie auf ``Uninstall''.

Eventuell müssen Sie das Modem auch wieder vom Rechner trennen, da- mit der Sniffer keine weiteren Pakete mitschreibt.

Die abgehörten USB-Pakete sollten nun in C:\WINxxx\usbsnoop.log zu finden sein.

Booten Sie anschließend Linux.

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 anschließend 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 anschließend eciadsl-config-text um die neue synch .bin Datei zu aktivieren.

Starten Sie nun eciadsl-start...

...und drücken Sie die Daumen! ;-)

Autoren / Support
*****************

Autoren
=======

EciAdsl Treiber wurde geschrieben von:

  * FlashCode <flashcode AT flashtux.org>

  * Jean-Sébastien Valette <jeanseb.valette AT free.fr>

  * Benoit Papillault <benoit.papillault AT free.fr>

  * Crevetor <crevetor AT caramail.com>

  * Laurent Wandrebeck (low) <wandre.l AT free.fr>

Hier bekommen Sie Support
=========================

Bitte lesen Sie die vollstä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 eci-request@ml.free.fr - um eine E-Mail an die mailing list zu schicken, verwenden Sie die Adresse eci@ml.free.fr

     - um sich auszutragen, senden Sie eine E-Mail mit dem Betreff ``unsubscribe'' an eci-request@ml.free.fr

     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