SpeedTouch USB HOWTO
met Benoit Papillault's GPL drivers

Autheurs :
Sylvain Trias bozo@nobodix.org
Edouard Gomez ed.gomez@wanadoo.fr
Bernard Brandl brandl@tuxfamily.org
Timothy Demulder syphon@wanadoo.be
_{Laatste Aanpassing : 7 Mei 2002}

Inhoudstabel

Inleiding
Benodigdheden
Installatie/Configuratie
Verbinding maken
Waar (meer) hulp vinden?

Inleiding

Dit document zal je door de installatie van Benoit Papillaut's GPL driver voor de Alcatel USB SpeedtTouch USB modem helpen

Benodigdheden:

GPL drivers
Thomson's microcode voor de modem
Alle kernels met usb support (2.4.x zijn een goede keuze, maar 2.2.x kernels werken ook
pppd

Download GPL drivers

Download de laatste versie van de sourceforge project »» Homepage ««

Download Thomson's Modem firmware

Wat je moet downloaden is de microcode voor de modem meegeleverd bij de Thomson drivers. Je hebt 2 mogelijkheden:

Je kan het vinden in de vorm van 2 bestanden:

Het mgmt.o bestand in the GNU/Linux pakket
Het alcaudsl.sys bestand in het Windows^TM pakket

(Als je modem al geinstalleerd is in windows kun je het bestand nemen uit c:\windows\system en zo opnieuw downloaden vermijden.)

GNU/Linux drivers op Thomson's site : http://www.speedtouchdsl.com/dvrreg_lx.htm

Waarschuwing:

Download de Thomson drivers en decompress ze. Installeer ze NIET. Je hebt ze alleen nodig voor de microcode (een stuk software dat in de modem geladen wordt ter initialisatie

Woordje over de linux kernels

Benoit's drivers werken zeer goed met de 2.4.x serie, maar het is ook mogelijk ze te laten werken met de 2.2.18 en hoger kernels omdat ze de USB code van de 2.4.x kernels gebruiken.

Als je nog niet comfortabel voelt met een kernel compilatie, geen probleem. Recente distro's hebben hoogst waarschijnlijk een operationele kernel (bv Mandrake 8.x/RH 7.x/Debian Potato/Woody/Sid)

Conclusie:

Als je kiest om een nieuwe kernel te compileren, kies een recente versie, de nieuwste versie heeft de beste USB support

URL om de Linux kernel te downloaden : http://www.kernel.org

PS: Vermijd 2.4.5 als de pest want het heeft de vervelende gewoonte constant te swappen.

pppd versie

pppd werkt vanaf versie 2.3.11 (dit was de oudste versie die we hadden om te testen)

PS :Als je een 2.4.x kernel hebt, moetje een 2.4.x pppd gebruiken (2.2 kernels werken met zowel 2.3.x als 2.4.x pppd daemons).

Installatie/Configuratie :

Dit onderdeel gebeurd in 2 stappen:

Kernel configuratie
Pppd Configuratie

Kernel Configuratie

Om Benoit's drivers te laten werken moet je een paar opties activeren in de kernel. Configureer het met je normale instellingen, maar voeg deze zeker er aan toe:

USB support

De kernel moet logischerwijs USB ondersteuning hebben om de Alcatel Speedtouch te laten werken.

Afhankelijk van jouw USB controller (chipset op het moederbord/pci kaart) zal je moeten kiezen tussen 2 modules: UHCI of OHCI
Zonder het helemaal uit te leggen, dat zijn 2 incompatibele types
Daarom zal je moeten weten welke chipset je gebruikt.

Om te bepalen welke je gebruikt :
# lspci -v | grep USB

Je zou iets zoals dit moeten krijgen :

usb-ohci : CMD technologies Inc|USB0670B usb-uhci : USB Controller: Intel Corporation 82371AB PIIX4 USB (rev 01) (prog-if 00 [UHCI])

Als je chipset de OHCI standaard gebruikt, zal je usb-ohci moeten kiezen (verassend !).
Als het daarentegen de OHCI standaard gebruikt, zal je moeten kiezen tussen usb-uhci en uhci. Normaalgezien zouden ze allebei moeten werken, maar als je problemen hebt met de ene, neem de andere en bidt !

Opties om USB support te activeren:

<M>/<*> Support for USB (CONFIG_USB) <*> Preliminary USB device filesystem (CONFIG_USB_DEVICEFS) <M> UHCI (Intel PIIX4, VIA, ...) support (CONFIG_USB_UHCI) <M> UHCI Alternate Driver (JE) support (CONFIG_USB_UHCI_ALT) <M> OHCI (Compaq, iMacs, OPTi, SiS, ALi, ...) support (CONFIG_USB_OHCI)

PPP support

Je zal ppp ondersteuning moeten hebben in jouw kernel. Indien nodig activeer deze opties:

<M> PPP (point-to-point protocol) support (CONFIG_PPP) <M> PPP support for sync tty ports (CONFIG_PPP_SYNC_TTY)

HDLC support

Dit deel is delicater. Als je wilt reconnecten, zal je deze module moeten patchen.
Doe het rustig aan, je zal de patch in de tarball van de drivers vinden en het commando is simpel:

# cd /usr/src/linux

     # patch -p1 --dry-run <
    /path/to/drivers/n_hdlc.c.diff  (opgelet: 2 - voor
    dry-run ! )

Als je geen foutboodschap krijgt,voer het echte commando uit om de brancode te patchen:
#patch -p1 < /path/to/drivers/n_hdlc.c.diff

NB:Dit deel is geïntegreerd vanaf kernel versie 2.4.18. Het is niet nodig n_hdlc te patchen als het versienummer van de kernel die je gebruikt er groter of gelijk aan is

Nu kan je doorgaan:

Character devices ---> [*] Non-standard serial port support <M> HDLC line discipline support [*]Unix98 PTY support

De drivers installeren

De installatie is heel geammkelijk, Decompress de tarball van de drivers en typ:
# tar xvzf speedtouch-xxx.tar.gz

cd in de nieuwe directory en typ:
# ./configure && make

Als alles goed verlopen is, su root en beeindig de installatie:
# make install

Proficiat, de drivers zouden nu geïnstalleerd moeten zijn

NB: Controlleer je PATH als je modem_run niet kan starten, het zit in /usr/local/sbin

Aanmaken van de PPP devices

Cd in jouw /dev directory :
# cd /dev

Controlleer of de ppp devices bestaan:
# ls *ppp*

Als het ls commando iets weergeeft ga naar de volgende stap,anders maak de ppp devices aan:
# ./MAKEDEV ppp

Pppd configuratie

Controlleer jouw pppd versie:
# pppd --version.

De drivers zijn getest met pppd 2.4.0 en 2.4.1. Ze werken ook met oudere versies zoals pppd 2.3.11, meegeleverd met Potato Debian GNU/Linux.

Om pppd te configureren zal je 4 bestanden moeten bewerken.

1st bestand :

Je zou een /etc/ppp/options bestand moeten hebben, bewerk het maar hou deze 4 regels (zet voor alle andere lijnen een #)

------------------ /etc/ppp/options Beginning ------------- noauth usepeerdns lock noipdefault ------------------ /etc/ppp/options End ------------------

2de bestand

Maak /etc/ppp/peers/adsl : # mkdir /etc/ppp/peers # touch /etc/ppp/peers/adsl

Kopieer en plak wat volgt hieronder (zonder de "---" ;) )

-------------------/etc/ppp/peers/adsl Beginning------------ # # This file could be rename but its place is under /etc/ppp/peers # To connect to Internet using this configuration file # pppd call adsl updetach, where "adsl" stands for the name of this file # debug kdebug 1 noipdefault defaultroute pty "/usr/local/sbin/pppoa3 -m 1 -c -vpi 8 -vci 35" sync user "your_login_here" noauth noaccomp nopcomp noccp novj holdoff 4 persist maxfail 25 usepeerdns ------------------/etc/ppp/peers/adsl EOF------------------

Als pppoa3 om een onbekende reden niet gaat, kan je nog steeds de pppoa2 daemon gebruiken. Je zal dan de lijn pty "/usr/local/sbin/pppoa3 -m 1 -c -vpi 8 -vci 35" moeten vervangen door pty "/usr/local/sbin/pppoa2 -vpi 8 -vci 35"
Voor meer details omtrend ppoa2/3, typ "man pppoa3, man pppoa2".

Vergeet niet de vpi en vci waarden aan te passen in de lijn :
pty "/usr/local/sbin/pppoa2 -vpi 8 -vci 35"

Opmerking over het VCI/VPI paar [ als je haast hebt, ga dan naar de volgende sectie ;^) ] :

Wanneer jouw connectie door ATM gaat, onstaan er 2 nieuwe parameters:

VPI : Virtual Path ID

VCI : Virtual Circuit ID

Wat is hun functie ?

Goede vraag. Ze worden gebruikt om jouw Virtual Path Connection (VP) en Virtual Circuit Connection (VC) the identificeren.
Ze vergemakkelijken network management en verminderen connectievertragingen.

Een ATM ziet er zo uit:

VC--------|----|-------------|----|--------
VC--------| VP |             | VP |--------
VC--------|----| Transmition |----|--------
               |    Path     |
VC--------|----|             |----|--------
VC--------| VP |             | VP |--------
VC--------|----|-------------|----|--------

3de bestand:

Internet Providers kunnen 2 protocols gebruiken om hun gebruikers te identificeren: CHAP of PAP.
Afhankelijk van je provider, pas /etc/ppp/chap-secrets of /etc/ppp/pap-secrets aan.

Die velden zien er zo uit:

-------------------/etc/ppp/chap-secrets Begining-------------- # client server secret IP addresses "your_login_here" "*" "your_password_here" "*" -------------------/etc/ppp/chap-secrets End-------------------

Als je niet weet welk protocol je provider gebruikt, kan je de twee bestanden invullen, het kan geen kwaad.

4de bestand :

Bewerk /etc/modules.conf (of /etc/conf.modules als jouw systeem wat aan de oude kant is) en voeg de volgende lijnen toe:

alias char-major-108 ppp_generic alias /dev/ppp ppp_generic alias tty-ldisc-3 ppp_async alias tty-ldisc-13 n_hdlc alias tty-ldisc-14 ppp_synctty alias ppp-compress-21 bsd_comp alias ppp-compress-24 ppp_deflate alias ppp-compress-26 ppp_deflate

Sommige lijnen zijn niet nodig, maar dat kan geen kwaad !

Verbinding maken

Je zal dit moeten doen :

De microcode van de modem laden:
Start pppd

PS: Om verbinding maken is het nodig dat je inlogt als root.

Verifications

Controlleer dat alle modules geladen zijn (als je ze niet rechtstreeks in de kernel gecompileerd hebt) :



    # modprobe ppp_generic

     # modprobe ppp_synctty

     # modprobe n_hdlc

Controlleer dan of usbdevs gemount is: # modprobe usbcore # mount none /proc/bus/usb -t usbdevfs # modprobe usb-uhci or usb-ohci or uhci

Load de firmware:

Om de firmware te laden in de modem, voer de volgende commando's uit:



    # modem_run -f /path/to/mgmt.o

     or

     # modem_run -f /path/to/alcaudsl.sys

pppd starten

Type (and pray) :



    # pppd call adsl updetach

Wacht een paar seconden (20) en controlleer of de verbinding gemaakt is door dit uit te voeren: # ifconfig ppp0

Je zou een beschrijving van de interface moeten krijgen.
Indien dit niet het geval is, is het tijd om hulp te zoeken (dus lees het volgende deel van deze howto).

Waar kan je (meer) hulp vinden?

De MAN paginas

Je moet eerst naar de man paginas kijken, ontwikkelaars schrijven ze omdat ze je belangrijke informatie kunnen geven :)
man pppoa2, man pppoa3, man modem_run kunnen je de informatie geven die je nodig hebt

Gebruiker's mailing lijsten

Als je op zoek bent naar hulp van andere gebruikers net als jij (Benoit is ook op de mailing lijst, dus het is nutteloos om een mail te sturen naar hem EN de lijst) De mailing lijst is gemaakt voor jullie, je kan alles aanhalen wat met de SpeedTouch USB modem te maken heeft. (off topic zijn : Windows , NAT configuration, DNS setup, ...). Engels en Frans worden aanvaard, maar geen HTML.

Eerst en voorla, lees het archief van de mailinglijst voor je jezelf toevoegt aan de lijst. Er kan al een oplossing zijn voor jouw probleem.
Om je toe te voegen aan de lijst, zend een mail naar speedtouch-request@ml.free.fr met subscribe als onderwerp.

IRC

Als je liever rechtsreeks hulp krijgt of je wilt praten over de opbouw van de driver, dan is er een kanaal voor jou. Soms is er veel activiteit en soms lijkt het alsof iedereen slaapt. Weet wel dat Engels & Frans door elkaar gebruikt worden.



    Server : irc.freenode.net

    Kanaal : #speedtouch

    

     Known nicknames :

    

     benoit : Benoit PAPILLAULT

     francois : François ROGLER

     GomGom : Edouard GOMEZ

Benoit PAPILLAUT's Driver homepage

SpeedTouch USB HOWTO met Benoit Papillault's GPL drivers