SpeedTouch USB HOWTO
usando los manejadores CódigoAbierto
de Benoit Papillault

Autores :
Sylvain Trias bozo@nobodix.org
Edouard Gomez ed.gomez@free.fr
Bernard Brandl brandl@tuxfamily.org
_{Ultimas Modificaciones : 7 de mayo del 2002}

Tabla de Contenido

Introducción
Requerido
Instalación/Configuración
Activando la conexión
¿ Donde buscar (mas) Ayuda ?

Introducción

Este documento le guiará por el proceso de instalación del manejador código abierto de Benoit Papillaut para el modem Alcatel SpeedTouch USB.

Requerido:

Manejadores CódigoAbierto
Microcódigo Thomson para el modem
Un kernel con soporte usb support (los kernels 2.4.x son una buena elección pero los kernels 2.2.x funcionan tambien)
pppd

Descarga de manejadores CódigoAbierto

Descargue la última versión de la »» Página «« del proyecto en sourceforge

Descarga del firmware para el Modem Thomson

Lo que necesita es descargar el microcódigo para el modem que se provee con los manejadores de Thomson. Tiene dos posibilidades:

Puede encontrarse en la forma de dos archivos:

Un archivo mgmt.o encontrado en el paquete GNU/Linux
Un archivo alcaudsl.sys encontrado en el paquete Windows^TM

(Si su modem ya esta corriendo en windows, puede evitar la descarga simplemente tomando el archivo en c:\windows\system).

Manejadores GNU/Linux en el sitio de Thomson : http://www.speedtouchdsl.com/dvrreg_lx.htm

Advertencia:

Solo descargue los manejadores de Thomson y descomprimalos. NO los instale. Solo los necesita por el microcódigo (ej: una pieza de software cargado en el modem al iniciar)

Una nota sobre los kernels de linux

Los manejadores de Benoit trabajan muy bien con la serie 2.4.x, pero es posible hacerlos funcionar en la 2.2.18 y mayor pues usan el código USB de los kernels 2.4.x.

Si no es diestro en la compilación del kernel, no se libere de preocupaciones y reze. Las distros recientes probablemente provean un kernel operacional (Mandrake 8.x/RH 7.x/Debian Potato/Woody/Sid por ejemplo). Sin embargo, es preferible hacer su propio kernel por muchas razones que no podrian ser explicadas en este documento. Otra buena razon de hacerlo es que puede aplicar un parche un módulo de kernel, previniendo una falla cuando la conexión es reiniciada.

Como conclusión :

Si escoje hacer un nuevo kernel trate de escojer uno reciente: El soporte USB se esta mejorando con las versiones.

Url para descargar el kernel de Linux : http://www.kernel.org

NB : Evite la 2.4.5 como la plaga pues ralentiza todo el tiempo

versión pppd

pppd deberia funcionar desde la versión 2.3.11 (esta fue la versión anciana que teniamos para probar)

NB : Si tiene un kernel de Linux 2.4.x, usted debe usar un pppd 2.4.x (los kernels 2.2 corren bien con ambos demonios pppd 2.3.x y 2.4.x).

Instalación/Configuración :

Este es un trabajo de dos pasos:

Configuración del Kernel
Configuración de Pppd

Configuración del Kernel

Para permitir que los manejadores de Benoit funcionen, su kernel debe tener algunas opciones activadas. Configurelo con sus opciones de diario y cuidadosamente añada las siguientes:

Soporte USB

Su kernel obviamente debe tener soporte USB para usar el Alcatel SpeedTouch USB.

Dependiendo de su controlador USB (chipset en tarjeta madre o pci), tiene que escojer entre dos modulos: UHCI o OHCI
Sin explicar todo el asunto, hay dos estandards USB incompatibles.
Por eso es que tiene que saber cual chipser tiene.

Para determinar cual usar :
# lspci -v | grep USB

Deberia obtener algo como :

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

Si su chipset usa el estandard OHCI, tendra que escoger usb-ohci (¡ sorprendente !).
Si, por el contrario, usa el estandard UHCI tendra que escoger entre usb-uhci o uhci. Ambos deberian funcionar, pero en caso de que tenga problemas activando el soporte usb con un modulo, escoja el otro, ¡y reze!

Opciones para permitir soporte usb :

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

Soporte PPP

Necesitará soporte ppp en su kernel. Si se necesita, compilé estas partes:

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

Soporte HDLC

Esta parte es mas sensible. Si necesita permitir una apropiada reconección, tendrá que parchear este módulo.
Tómelo con calma, encontrará el parche en el tarball con los manejadores y la linea de comando para correr es simple :

# cd /usr/src/linux

     # patch -p1 --dry-run <
    /ruta/a/drivers/n_hdlc.c.diff  (¡ fíjese: dos - antes de
    dry-run !)

Si no obtiene un mensaje de error, escriba el comando real para parchear las fuentes del kernel
#patch -p1 < /ruta/a/drivers/n_hdlc.c.diff

NB: Kernels >= 2.4.18 incluyen nuestro parche n_hdlc asi que ya no necesita aplicar el parche

Puede continuar, ahora :

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

Instalando los manejadores

Esta instalación es de frente, descomprima el tarball con el manejador escribiendo :
# tar xvzf speedtouch-xxx.tar.gz

cd al nuevo directorio y escriba :
# ./configure && make

Si todo corrió bien su root y finalice la instalación escribiendo :
# make install

Saludos, los manejadores deben ahora estar instalados

NB: revise su ruta si no puede correr modem_run, ya que se copia en /usr/local/sbin

Creación de los dispositivos PPP

Cd a su directorio /dev :
# cd /dev

Revise la existencia de dispositivos ppp haciendo :
# ls *ppp*

Si el comando ls muestra una salida vaya al siguiente paso, si no cree todos los dispositivos ppp escribiendo :
# ./MAKEDEV ppp

Configuración Pppd

Revise su version de pppd version escribiendo :
# pppd --version.

Los manejadores son probados con pppd 2.4.0 y 2.4.1. Tambien corren bien con versiones anteriores, por ejemplo pppd 2.3.11 empacado con Potato Debian GNU/Linux.

Para configurar pppd, tendrá que editar 4 archivos.

1er archivo :

Deberia tener un archivo /etc/ppp/options, editelo y mantenga estas 4 lineas en el (comente todas las lineas extra con un #)

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

2do archivo

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

Copie y pegue lo que sigue (sin los "---" ;) )

-------------------/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------------------

Si por alguna razón desconocida pppoa3 fallase, puede todavia intentar el viejo demonio pppoa2. Usted deberia cambiar la linea pty "/usr/local/sbin/pppoa3 -m 1 -c -vpi 8 -vci 35" por pty "/usr/local/sbin/pppoa2 -vpi 8 -vci 35"
Para mas detalles sobre pppoa2/3, escriba "man pppoa3, man pppoa2".

No olvide adaptar los valores vpi y vci en la linea :
pty "/usr/local/sbin/pppoa2 -vpi 8 -vci 35"

Nota sobre el par VCI/VPI pair [ si está apurada vaya a la siguiente sección ;^) ] :

Como su conexión va a travez de ATM, 2 parametros nuevos aparecen :

VPI : Virtual Path ID

VCI : Virtual Circuit ID

¿ Cuales son sus funciones ?

Esa es una buena pregunta. Se usan para identificar su Conexión de Ruta Virtual (VP) y su Conexión de Circuito Virtual (VC).
Ellos simplifican la administracion de la red, minimizando retrasos de conexión. Tambien permiten commutación de celdas.

Una red ATM se ve asi :

VC--------|----|-------------|----|--------
VC--------| VP |             | VP |--------
VC--------|----|   Ruta de   |----|--------
               | Transmisión |
VC--------|----|             |----|--------
VC--------| VP |             | VP |--------
VC--------|----|-------------|----|--------

3er archivo :

2 protocolos pueden ser usados por proveedores para identificar sus usuarios: CHAP o PAP.
Dependiendo de su proveedor, edite /etc/ppp/chap-secrets o /etc/ppp/pap-secrets.

Esos campos se ven asi :

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

Si usted no sabe que protocolo es utilizado por su proveedor, puede llenar ambos archivos, no dolerá.

4to archivo :

Edite /etc/modules.conf (o /etc/conf.modules si su sistema es algo viejo) y añada las siguientes lineas :

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

¡Algunas entradas son inútiles, pero una vez mas no dolerá !

Activando la conexión

Tendrá que :

Cargar el microcódigo del modem
Iniciar pppd

NB: para activar la conexión, es casi mandatorio estar registrado como root.

Verificaciones

Revise si todos los módulos se han cargado (si no los compiló directamente en el kernel) :



    # modprobe ppp_generic

     # modprobe ppp_synctty

     # modprobe n_hdlc

Luego, revise que usbdevfs esté montado : # modprobe usbcore # mount none /proc/bus/usb -t usbdevfs # modprobe usb-uhci or usb-ohci or uhci

Cargue el firmware

Para cargar el microcódigo en el modem, simplemente escriba :



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

     o

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

Activar pppd

Escriba (y reze) :



    # pppd call adsl updetach

Espere algunos segundos (20) y revise si el enlace está activo escribiendo : # ifconfig ppp0

Deberia tener una descripción de la interfaz.
Si no, bueno es momento de buscar ayuda (y por tanto leer la siguiente parte de este howto).

¿ Donde buscar (mas) Auyda ?

Las páginas MAN

Deberia primero mirar las páginas man, los desarrolladores las escriben porque pueden dar informaciones útiles :-)
man pppoa2, man pppoa3, man modem_run pueden darle la información que está buscando.

Lista de correo para Usuarios

Si está buscando ayuda de otros usuarios como usted (Benoit está tambien en la lista de correo, asi que es inútil enviar un correo a la lista Y para el). Esta lista de correo es para usted, puede discutir cualquier cosa relacionada con el modem SpeedTouch USB (fuera de tópico son : Windows , configuración NAT, montaje DNS, ...). Tanto Francés como Inglés es aceptable, pero no HTML.

Primero que nada, lea el archivo de esta lista de correo antes de subscribirse. Su problema podria ya tener solución.
Para subscribirse a la lista, envie un correo a speedtouch-request@ml.free.fr con subscribe como el tópico.

IRC

Si usted prefiere obtener ayuda directa o le gustaria discutir el diseño del manejador, hay un canal para usted. Está a veces muy activo y a veces pareciera que todos están durmiendo. Esté prevenido que Francés & Inglés van mezclados.



    Servidor : irc.freenode.net

     Canal : #speedtouch

    

     Apodos conocidos :

    

     benoit : Benoit PAPILLAULT

     francois : François ROGLER

     GomGom : Edouard GOMEZ

Página del manejador de Benoit PAPILLAUT

SpeedTouch USB HOWTO usando los manejadores CódigoAbierto de Benoit Papillault