1 Introduction ************** 1.1 Description =============== EciAdsl est un driver Linux libre pour connecter votre ordinateur a` internet, si vous avez un modem ADSL USB base' sur un chipset Globespan. D'autres syste`mes d'exploitation comme *BSD sont en de'veloppement (contactez les auteurs pour plus d'information, *Note Auteurs / Support::.) La page d'accueil du driver EciAdsl est ici : `http://eciadsl.flashtux.org' Une liste des modems supporte's est disponible sur cette page : `http://eciadsl.flashtux.org/modems.php?supported=yes' 1.2 Pre'-requis =============== 1.2.1 Programmes ---------------- Pour installer le driver EciAdsl, vous devez posse'der les programmes suivants : * un syste`me GNU/Linux (architecture x86) avec les outils standards (les MDK9/RH8/tre`s re'cente/exotique peuvent avoir des proble`mes (re'solvables), BSD et autres syste`mes ne sont pas encore officiellement supporte's). * support mate'riel USB 1.1 * noyau Linux 2.4.x (>=2.4.18-pre3 ou <2.4.18-pre3+patch N_HDLC pour avoir la reconnexion automatique pppd, ce qui est recommande') * support USB (sous forme de modules) : - support USB - "USB preliminary fs" - votre "HUB USB controller" EN MODULE - pas de module DABUSB * support PPP (y compris le package pppd usermode >=2.4.0) * installation par les sources: outils de de'veloppement standards (sources Linux dans /usr/src/linux, outils GNU comme gcc>=2.91.66, GNU make, etc.) * modem USB (avec puce GlobeSpan *seulement*) * bash (>=2.x.x) * facultatif : tcl/tk >= 8.x.x, perl * droits root (au moins pour l'installation) 1.2.2 Noyau ----------- Si vous avez la dernie`re version de Mandrake/Redhat avec le noyau par de'faut, vous pouvez sauter ce chapitre. Selon votre distribution, des options peuvent manquer dans votre noyau. Si eciadsl-doctor de'tecte des options manquantes, alors vous devez recompiler votre noyau. Vous DEVEZ inclure ces options ("*" signifie "dans le noyau", "M" signifie "en module"): 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 Suppression de dabusb ========================= Si le modem est allume' au de'marrage de Linux, alors vous devez supprimer dabusb. Sinon, vous pouvez sauter ce chapitre. A priori, hotplug est le coupable. Il de'tecte votre modem comme e'tant un pe'riphe'rique audio, et charge le module dabusb afin d'activer le support pour ce pe'riphe'rique. Si /etc/hotplug/blacklist est pre'sent, e'ditez-le et ajoutez-y une ligne contenant le mot 'dabusb' (sans les quotes). Rede'marrez Linux. Si vous ne pouvez pas trouver ce fichier alors que hotplug est bien installe' et active', il doit y avoir d'autres moyens de le configurer. Le cas e'che'ant, appliquez la me'thode suivante (c'est bourrin mais bon) : * De'marrez votre machine Linux avec votre modem de'branche' * Vous pouvez supprimer le module dabusb de votre syste`me en utilisant eciadsl-config-tk ou eciadsl-config-text. Vous pouvez aussi directement appeler eciadsl-remove-dabusb (dans /usr/local/bin par de'faut). Ou encore, manuellement, tapez la commande suivante : `modprobe -r dabusb && rm -f $(modprobe -l | grep dabusb) && depmod -a' Si le noyau a e'te' compile' a` la main, n'oubliez pas de retirer dabusb de la configuration du noyau. 2.2 Installation du driver ========================== Te'le'chargez la dernie`re version stable du package usermode (code source ou un package correspondant a` votre distribution) sur cette page : `http://eciadsl.flashtux.org/download.php' Selon le package que vous avez pris, tapez une de ces commandes : * 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): voir `http://doc.gentoofr.org/Members/BeTa/eciadsl-gentoo-howto/view' ou` x.y est la version (par exemple 0.8) 2.3 Compilation =============== Si vous avez installe' un package spe'cifique a` votre distribution (Redhat/Mandrake, Debian, Slackware, Gentoo), vous pouvez sauter cette e'tape. Tapez ceci dans une console ou un terminal : `./configure' `make' En "root": `make install' Tapez ./configure -help pour voir la liste des options disponibles. Si le driver doit e^tre installe' dans un autre re'pertoire de base que celui par de'faut (/usr/local), utilisez l'option -prefix, par exemple -prefix=/opt. Les fichiers de configuration du driver peuvent eux aussi e^tre installe's ailleurs que dans le re'pertoire par de'faut (/etc/eciadsl). Utilisez pour cela les options `--conf-prefix' (par de'faut: /) et -conf-dir (par de'faut: etc/eciadsl). Par exemple: `--conf-prefix=/opt --conf-dir=etc/eciadsl' ou `--conf-prefix=/opt/eciadsl --conf-dir=etc' Attention, l'option -etc-prefix (par de'fault: /, le re'pertoire est donc /etc) est utilise'e pour acce'der aux fichiers de configuration de pppd et a` resolv.conf notamment ! N'utiliser donc -etc-prefix qu'en sachant exactement ce que cela implique. D'autres options sont disponibles, ./configure -help vous renseignera sur ce point. 3 Configuration *************** 3.1 Outil de configuration ========================== * Si Tcl/Tk est installe' sur votre syste`me, vous pouvez lancer la configuration graphique : `eciadsl-config-tk' Entrez tous les parame`tres sans cocher "Change synch .bin file". * Sinon, lancez la configuration en mode texte : `eciadsl-config-text' Suivez simplement les e'tapes pour configurer le driver. 3.2 De'tail des parame`tres =========================== `user' Nom d'utilisateur fourni par votre fournisseur Par exemple : username@clubadsl1 `password' Mot de passe fourni par votre fournisseur. `VPI' Premier nume'ro du "nume'ro compose'" Par exemple si vous "composez" 8,35 avec le driver Windows, alors votre VPI est 8. `VCI' Second nume'ro du "nume'ro compose'" Par exemple si vous "composez" 8,35 avec le driver Windows, alors votre VCI est 35. `Provider DNS' Cochez la case "Update provider DNS" et choisissez votre fournisseur dans la liste. Si votre fournisseur n'est pas dans la liste, entrez manuellement les serveurs DNS dans les champs en dessous de la liste. Si vous ne connaissez pas vos serveurs DNS, lisez cette question de la FAQ : `http://eciadsl.flashtux.org/faq.php#1.6' `Modem' Se'lectionnez votre modem dans la liste. Si votre modem n'est pas dans la liste, ve'rifiez sur la page des modems : `http://eciadsl.flashtux.org/modems.php' - Si votre modem est "non supporte'", le driver ne fonctionnera jamais avec votre modem (merci de ne pas demander de support aux de'veloppeurs, vous devez chercher un autre driver). - Si votre modem est "peut-e^tre supporte'", alors contactez les de'veloppeurs pour plus de de'tails. *Note Auteurs / Support::. `Modem chipset' [la valeur est positionne'e automatiquement en choisissant le mode`le de modem]. Si vous avez un doute, consultez la page des modems : `http://eciadsl.flashtux.org/modems.php?lang=fr' `Alt synch' [la valeur est positionne'e automatiquement en choisissant le mode`le de modem]. C'est l'interface alt utilise'e pour l'USB par eciadsl pour communiquer avec le modem durant la phase de synchronisation. Les valeurs courantes sont : 4 pour GS7070 (anciens chipsets de modems) - 5 ou 0 pour les chipsets GS7470 (nouveaux chipsets) Si vous avez un doute, consultez la page des modems : `http://eciadsl.flashtux.org/modems.php?lang=fr' `Alt pppoeci' [la valeur est positionne'e automatiquement en choisissant le mode`le de modem]. C'est l'interface alt utilise'e pour l'USB par eciadsl pour communiquer avec le modem durant la phase pppoeci. Les valeurs courantes sont : 4 pour GS7070 (anciens chipsets de modems) - 1 ou 0 pour les chipsets GS7470 (nouveaux chipsets) Si vous avez un doute, consultez la page des modems : `http://eciadsl.flashtux.org/modems.php?lang=fr' `Synch .bin file' Cochez cette option seulement si eciadsl-start e'choue sur la synchronisation. `PPP mode' - Pour les utilisateurs en France, choisissez le mode PPP par de'faut (VCM_RFC2364). - Pour les autres utilisateurs, ve'rifiez le mode que votre fournisseur vous impose. Regardez cette question de la FAQ : `http://eciadsl.flashtux.org/faq.php#5.4' `DHCP' Cochez ceci seulement si votre fournisseur utilise DHCP. Si vous ne savez pas, laissez cette option non coche'e. `Static IP' Cochez cette option seulement si vous avez une adresse IP statique. Si c'est le cas, entrez votre adresse IP et la passerelle en dessous. Si vous ne savez pas, laissez cette option non coche'e. 4 Connexion *********** 4.1 Eciadsl-start ================= Pour vous connecter a' internet, tapez cette commande en utilisateur root : `eciadsl-start | tee log.txt' 4.1.1 Proble`me de synchronisation ---------------------------------- Si vous avez des proble`mes de synchronisation (eciadsl-synch timeout/erreur ou lcp timeouts apre`s la synchro), alors suivez les instructions ci-dessous : * Te'le'chargez le package des .bin de synchro ici : `http://eciadsl.flashtux.org/download.php?view=sync' * De'compressez le dans /etc/eciadsl (en root) : `cd /etc/eciadsl && tar xvzf /path/eciadsl-synch_bin.tar.gz' * Lancez eciadsl-config-tk ou eciadsl-config-text et choisissez un autre fichier .bin * Eteignez le modem : soit avec `modprobe -r usb-uhci' (or usb-ohci), soit en de'branchant/rebranchant le modem (cable USB). * Lancez eciadsl-start a` nouveau. Si vous avez toujours des proble`mes de synchronisation, alors essayez un autre fichier .bin Important : vous pouvez essayer TOUS les fichiers .bin de synchro, peu importe l'endroit et le fournisseur avec lequel le .bin a e'te' fait. Si aucun fichier .bin ne fonctionne, alors vous devrez cre'er votre propre fichier .bin sous Windows. *Note Creation du fichier .bin de synchro::. Pour les autres proble`mes avec eciadsl-start, veuillez consulter la FAQ : `http://eciadsl.flashtux.org/faq.php' 4.1.2 Utilisateurs de PPPoE --------------------------- Si vous utilisez PPPoE, vous devez configurer et utiliser un client PPPoE standard comme rp-pppoe (http://www.roaringpenguin.com/pppoe) pour connecter votre modem ADSL via tap0. 4.2 Autres scripts ================== 4.2.1 eciadsl-probe-device -------------------------- Utilisez ce script si eciadsl-start ne trouve pas votre modem. Ce script recherche le VendorID/ProductID (VID/PID) de votre modem et les affiche. Pour plus de de'tails, contactez-nous. *Note Auteurs / Support::. 4.2.2 eciadsl-doctor -------------------- Utilisez ce script si eciadsl-start e'choue avec un autre proble`me que "Modem not found" ou de synchronisation. 4.2.3 eciadsl-probe-synch ------------------------- Utilisez ce script (avec l'option `--usb-init') pour tester automatiquement tous les fichiers .bin, si vous avez des proble`mes de synchronisation. 5 Cre'ation du fichier .bin de synchro ************************************** Si vous avez des proble`mes de synchronisation et que vous avez essaye' tous les fichiers .bin sans succe`s, alors vous devez cre'er votre propre fichier .bin sous Windows. Sinon, vous pouvez sauter ce chapitre. 5.1 Driver Eci Windows ====================== [`Sautez cette section si votre modem a un chipset GS7470, VOUS DEVEZ UTILISER VOTRE PROPRE DRIVER WINDOWS. Si vous avez un doute, ve'rifiez votre chipset de modem ici :' `http://eciadsl.flashtux.org/modems.php?lang=fr']. 5.1.1 Te'le'chargement ---------------------- Te'le'chargez le driver Windows Eci version 1.06 (sinon le .bin ne fonctionnera pas sous Linux) : `http://eciadsl.flashtux.org/download/eci_drv_106_win.zip' 5.1.2 Modification du driver ---------------------------- Si votre modem n'a pas les me^mes VID/PID que ceux-ci, vous devez modifier deux fichiers dans le driver Eci Windows : - VID1/PID1: 0547/2131, VID2/PID2: 0915/8000 - VID1/PID1: 0915/0001, VID2/PID2: 0915/0002 Pour ve'rifier vos VID/PID, consultez cette page : `http://eciadsl.flashtux.org/modems.php'. Les modifications a` faire : - fichier *gafwload.inf*, ligne 24 : `ExcludeFromSelect = USB\VID_*0547*&PID_*2131*' remplacez 0547 par votre VID1 et 2131 par votre PID1 - fichier *gafwload.inf*, ligne 30 : `%GSILOAD.DeviceDescAnchor% = GSIUSBLDRANCHOR, USB\VID_*0547*&PID_*2131*' remplacez 0547 par votre VID1 et 2131 par votre PID1 - fichier *gwausb.inf*, ligne 34 : `ExcludeFromSelect = USB\VID_*0915*&PID_*8000*' remplacez 0915 par votre VID2 et 8000 par votre PID2 - fichier *gwausb.inf*, ligne 42 : `%ADSLUSB.DeviceDesc% = ADSLUSB.gspnDefault, USB\VID_*0915*&PID_*8000*' remplacez 0915 par votre VID2 et 8000 par votre PID2 - fichier *gwausb.inf*, ligne 58 : `HKR, Ndi, DeviceID, 0, "USB\VID_*0915*&PID_*8000*"' remplacez 0915 par votre VID2 et 8000 par votre PID2 5.1.3 Installation ------------------ Lancez setup.exe et suivez les instructions. 5.2 Sniffeur USB ================ Te'le'chargez et installez la dernie`re version du sniffeur USB ici : `http://benoit.papillault.free.fr/usbsnoop/' La documentation de Snoopy (le sniffeur USB) est disponible ici : `http://benoit.papillault.free.fr/usbsnoop/doc.php' 5.3 Sniff des paquets USB sous Windows ====================================== De'sactivez la connexion automatique a` internet et de'branchez tous les pe'riphe'riques USB (sauf le modem). De'marrez le sniffeur et installez le filtre sur le "Wan modem" ; de'branchez et rebranchez le modem. De`s que les lumie`res rouges et vertes sont fixes, de'sinstallez le filtre. Les paquets sniffe's devraient se trouver dans le fichier `C:\WINxxx\usbsnoop.log' Rede'marrez sous Linux. 5.4 Conversion du log vers le .bin sous Linux ============================================= Montez la partition Windows contenant le log usbsnoop pour le copier ou` vous le souhaitez. Tapez cette commande : `eciadsl-vendor-device.pl usbsnoop.log -chipset=#VOTRE_CHIPSET_MODEM#' remplacez `#VOTRE_CHIPSET_MODEM#' par votre chipset de modem (GS7070 ou GS7470). Pour l'aide, tapez cette commande : `eciadsl-vendor-device.pl -h' Ce script perl analyse le fichier log et ge'ne`re un nouveau fichier bin (ce script est fourni avec le package usermode). Tapez cette commande : `mv #FICHIER_BIN_CREE# /etc/eciadsl/my_synch.bin' substitute `#FICHIER_BIN_CREE' with bin file name created. et lancez eciadsl-config-text pour utiliser ce fichier .bin. Lancez eciadsl-start... ...et croisez les doigts :-) 6 Auteurs / Support ******************* 6.1 Auteurs =========== Le driver EciAdsl est e'crit par : * FlashCode > * Jean-Se'bastien Valette > * Benoit Papillault > * Crevetor > * Laurent Wandrebeck (low) > 6.2 Obtenir du support ====================== Avant de faire appel au support, assurez-vous d'avoir lu entie`rement la documentation et la FAQ fournies avec le driver (regardez dans /usr/local/doc/eciadsl, les fichiers README.fr, INSTALL.fr et TROUBLESHOOTING.fr). * Support via IRC: - serveur : irc.freenode.net - canal : #eci * Forum EciAdsl: `http://eciadsl.sf.net/scripts/forum' * Support avec la mailing list : - pour souscrire, envoyez un mail a` avec "subscribe" comme sujet - pour envoyer un mail a` toutes les personnes inscrites, envoyez votre mail a` - pour vous de'sinscrire, envoyez un mail a` avec "unsubscribe" comme sujet Gra^ce a` ZeGuigui, les archives de la mailing list sont disponibles ici : `http://liste.eci.free.fr' * Page de support EciAdsl : `http://eciadsl.flashtux.org/support.php'