1 Introduccio'n *************** 1.1 Descripcio'n ================ EciAdsl es un driver Linux gratuito para conectar su computador a Internet si es que Ud. posee un modem ADSL USB basado en el conjunto de chips Globespan. Otros sistemas operativos como *BSD esta'n en desarrollo (por favor contacte a los autores para ma's informacio'n - *Note Autores / Soporte::.) La pa'gina principal del driver EciAdsl se encuentra en: `http://eciadsl.flashtux.org' Una lista actualizada de los modems soportados esta' disponible en esta pa'gina: `http://eciadsl.flashtux.org/modems.php?lang=en&supported=yes' 1.2 Pre-requisitos ================== 1.2.1 Programas --------------- Para instalar el driver EciAdsl, usted necesita los siguientes programas / paquetes: * Un sistema GNU/Linux (arquitectura x86) con las herramientas esta'ndares (las distribuciones MDK9/RH8/mas-recientes/exoticas pueden tener problemas (solucionables), BSD y otros sistemas au'n no esta'n oficialmente soportados). * Soporte de hardware USB 1.1 * Nucleo Linux 2.4.x (>=2.4.18-pre3 or <2.4.18-pre3+el parche N_HDLC para obtener reconexio'n pppd automa'tica, la cual se recomienda) * Soporte USB (como modulos): - Soporte USB - "USB preliminary fs (file system USB preliminar)" - su controlador HUB USB COMO MODULO - mo'dulo DABUSB deshabilitado * soporte PPP (incluido el paquete usermode pppd >= 2.4.0) * instalacio'n desde los fuentes: paquetes de desarrollo estandar (Fuentes Linux en /usr/src/linux, herramientas GNU tales como gcc>=2.91.66, GNU make, etc.) * modem USB (*solamente* con chipset GlobeSpan incorporado) * bash (>=2.x.x) * opcionalmente: tcl/tk >= 8.x.x, perl * privilegios de root (al menos para instalar el driver) 1.2.2 Nucleo (Kernel) --------------------- Si usted posee la u'ltima distribucio'n de Mandrake/Redhat con la configuracio'n predeterminada del nu'cleo (kernel) usted puede omitir este capi'tulo. De acuerdo a su distribucio'n, algunas opciones pueden no estar configuradas en su nu'cleo. Si el script eciadsl-doctor detecta que falta alguna opcio'n, usted necesitara' recompilar su nu'cleo. Usted DEBE incluir las siguientes opciones("*" significa "en el nu'cleo(kernel)", "M" significa "modulo"): 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 Instalacio'n ************** 2.1 Removiendo dabusb ===================== Si el modem esta' energizado al inicio de Linux, entonces usted necesita remover el dabusb. De otro modo, omita esta seccio'n. El Hotplug probablemente este habilitado, y este detectara' erroneamente sus modems como dispositivos de audio y cargara' el mo'dulo dabusb para agregar el soporte para este dispositivo de audio. Si el archivo /etc/hotplug/blacklist existe, edi'telo y agregue una li'nea que contenga la palabra 'dabusb' (sin las comillas simples). Reinicie Linux. Si usted no puede encontrar el archivo indicado y el hotplug esta' instalado y habilitado, existe otra manera de configurarlo aplicando el siguiente metodo (un poco rudo pero funciona): * Inicie su ma'quina Linux con el modem desconectado * Usted puede remover el mo'dulo dabusb de su sistema usando el script eciadsl-config-tk o eciadsl-config-text. Usted tambie'n puede ejecutar directamente eciadsl-remove-dabusb (ubicado en /usr/local/bin por omision). O, manualmente digitando el siguiente comando: `modprobe -r dabusb && rm -f $(modprobe -l | grep dabusb) && depmod -a' Si el nu'cleo (kernel) ha sido compilado manualmente, no olvide remover el soporte dabusb de la configuracio'n del nu'cleo. 2.2 Instalacio'n del Driver =========================== Descargue la u'ltima versio'n estable del paquete usermode (co'digo fuente o un paquete adecuado para su distribucio'n) desde e'sta pa'gina: `http://eciadsl.flashtux.org/download.php' Dependiendo del paquete que usted obtenga, ejecute uno de estos comandos: * 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): ver `http://doc.gentoofr.org/Members/BeTa/eciadsl-gentoo-howto/view' en donde x.y es la versio'n (por ejemplo 0.7) 2.3 Compilacio'n ================ Si usted instalo' un paquete especi'fico a su distribucio'n (Redhat/Mandrake, Debian, Slackware, Gentoo), usted puede saltarse este paso. Todo lo que debe hacer es ejecutar en una consola o terminal: `./configure' `make' Como "root": `make install' Verifique con el comando ./configure -help para ver la lista de los para'metros opcionales. Si usted desea instalar el software en un lugar (directorio) diferente al predeterminado (/usr/local), utilise la opcio'n -prefix, por ejemplo -prefix=/opt. Los archivos de configuracio'n del Driver tambie'n pueden ser instalados en el directorio que usted prefiera (por omision es en /etc/eciadsl), utilizando los para'metros -conf-prefix (por omision es /) Y -conf-dir (por omisio'n es etc/eciadsl). Por ejemplo: `--conf-prefix=/opt --conf-dir=etc/eciadsl' o' `--conf-prefix=/opt/eciadsl --conf-dir=etc' Sea cuidadoso, -etc-prefix tambie'n puede ser cambiado (por omisio'n es /, de este modo /etc es usado), recuerde que e'ste es usado para obtener los archivos de configuracio'n del sistema tales como resolv.conf o los archivos de configuracio'n de pppd. Use el para'metro -etc-prefix so'lo si usted esta' seguro de lo que esta' haciendo. Vea las otras opciones disponibles utilizando ./configure -help. 3 Configuracio'n **************** 3.1 Herramientas de Configuracio'n ================================== * Si tiene instalado Tcl/Tk en su sistema, usted puede ejecutar la herramienta de configuracio'n gra'fica: `eciadsl-config-tk' Ingrese todos los para'metros sin verificacion "Change synch .bin file". * Si no, ejecute la configuracio'n en modo texto: `eciadsl-config-text' Siga los siguientes pasos para configurar el driver. 3.2 Detalle de los Para'metros ============================== `user' Nombre de usuario entregado por su proveedor Por ejemplo: username@clubadsl1 `password' Clave de acceso o Password entregada por su proveedor `VPI' Primer nu'mero del "nu'mero compuesto" Por ejemplo si usted "usa" 8,35 con el driver de Windows entonces su VPI es 8. `VCI' Segundo nu'mero del "nu'mero compuesto" Por ejemplo si usted "usa" 8,35 con el driver de Windows entonces su VCI es 35. `DNS del Proveedor' Seleccione la CheckBox "Actualizar el DNS del proveedor" y seleccione su proveedor de la lista. Si su proveedor no se encuentra en la lista, ingrese manualmente sus servidores DNS en los campos bajo la lista. Si usted no conoce cuales son sus servidores DNS, lea esta pregunta en las Preguntas Frecuentes (FAQ): `http://eciadsl.flashtux.org/faq.php?lang=es#1.6' `Modem' Seleccione su modem de la lista. Si su modem no se encuentra en la lista, verifique en la pa'gina web de los modems: `http://eciadsl.flashtux.org/modems.php?lang=en' - Si su modem "no es soportado", el driver no funcionara' con su modem (por favor no solicite soporte a los desarrolladores, usted tendra' que buscar otro driver). - Si su modem esta en la categori'a "puede ser soportado", entonces pregunte a los desarrolladores para mas detalles. *Note Autores / Soporte::. `Modem chipset' [el valor es configurado automaticamente eligiendo el modelo del Modem]. Ante cualquier duda por favor verifique en la pagina de Modems: `http://eciadsl.flashtux.org/modems.php?lang=en' `Alt synch' [el valor es configurado automaticamente eligiendo el modelo del Modem]. Este es el interface alt USB utilizado por eciadsl para comunicarse con los modems durante la fase de sincronismo. Valores Estandar: 4 para el GS7070 (Antiguos modelos de Modems) - 5 o 0 para el chipset GS7470 (nuevos modelos de modem) Ante cualquier duda por favor verifique en la pagina de Modems: `http://eciadsl.flashtux.org/modems.php?lang=en' `Alt pppoeci' [el valor es configurado automaticamente eligiendo el modelo del Modem]. Este es el interface alt USB utilizado por eciadsl para comunicarse con los modems durante la fase pppoeci. Valores Estandar: 4 para el GS7070 (Antiguos modelos de Modems) - 1 o 0 para el chipset GS7470 (nuevos modelos de modem) Ante cualquier duda por favor verifique en la pagina de Modems: `http://eciadsl.flashtux.org/modems.php?lang=en' `Synch .bin file' Seleccione esta opcio'n solamente si eciadsl-start falla en la sincronizacio'n. `PPP mode' - Para los usuarios en Francia, elijan el modo por omisio'n PPP (default PPP mode) (VCM_RFC2364). - Para los dema's usuarios, verifiquen el modo ppp apropiado con su proveedor. Vea tambie'n esta pregunta en las preguntas frecuentes (FAQ): `http://eciadsl.flashtux.org/faq.php?lang=es#5.4' `DHCP' Selecciones esta opcio'n so'lo si su proveedor utiliza DHCP. Si usted no lo sabe, deje esta opción sin seleccionar. `Static IP' Seleccione esta opcio'n so'lo si usted posee una direccio'n IP esta'tica. Si es asi', ingrese la direccio'n IP y el gateway. Si no lo sabe, deje esta opcio'n sin seleccionar. 4 Conexio'n *********** 4.1 Eciadsl-start ================= Para conectarse a internet, ejecute el siguiente comando como root: `eciadsl-start | tee log.txt' 4.1.1 Problema de Sincronizacio'n --------------------------------- Si usted tiene problemas de sincronizacio'n (eciadsl-synch timeout/error o lcp timeouts despue's de la sincronizacio'n), entonces siga las instruciones siguientes: * Descarge los archivos de sincronizacio'n .bin desde aqui': `http://eciadsl.flashtux.org/download.php&view=sync' * Descomprima el paquete en /etc/eciadsl (como root): `cd /etc/eciadsl && tar xvzf /path/eciadsl-synch_bin.tar.gz' * Ejecute eciadsl-config-tk o' eciadsl-config-text y elija otro archivo .bin * Desconecte el modem: ya sea con `modprobe -r usb-uhci' (o usb-ohci), o desenchufando/enchufando el cable USB del modem. * Ejecute nuevamente eciadsl-start. Si au'n tiene problemas de sincronizacio'n, pruebe con otro archivo .bin de sincronizacio'n. Importante : Usted puede probar TODOS los archivos .bin de sincronizacio'n, poco importa el lugar y el proveedor en donde fue' hecho el archivo .bin. Si ningu'n archivo .bin funciona, entonces usted debera' crear su propio archivo .bin bajo Windows. *Note Creacion del archivo .bin de sincronizacion::. Para los otros problemas con eciadsl-start, por favor consulte las FAQ: `http://eciadsl.flashtux.org/faq.php?lang=es' 4.1.2 Usuarios PPPoE -------------------- Si usted esta' utilizando PPPoE, usted tiene que configurar y utilizar un cliente PPPoE esta'ndar tal como rp-pppoe (http://www.roaringpenguin.com/pppoe) para conectar su modem ADSL vi'a tap0. 4.2 Otros scripts ================= 4.2.1 eciadsl-probe-device -------------------------- Utilice este script si eciadsl-start no puede encontrar su modem. Este script busca el VendorID/ProductID (VID/PID) de su modem y lo muestra. Para mas detalles, conta'ctenos. *Note Autores / Soporte::. 4.2.2 eciadsl-doctor -------------------- Utilice este script (con la optio'n `--usb-init') si eciadsl-start falla con otro problema diferente de "Modem not found" o de sincronizacio'n. 4.2.3 eciadsl-probe-synch ------------------------- Utilice este script para probar automaticamente todos los archivos .bin, si usted tiene problemas de sincronizacio'n. 5 Creacio'n del archivo .bin de sincronizacio'n *********************************************** Si usted tiene problemas de sincronizacio'n y ya probo' todos los archivos .bin sin e'xito, entonces usted tendra' que crear su propio archivo .bin bajo Windows. De otro modo, usted puede saltarse este capi'tulo. 5.1 Eci Windows driver ====================== [`Saltese esta seccion si su modem posee el chipset GS7470, USTED DEBE UTILIZAR SU DRIVER DE WINDOWS. Ante cualquier duda por favor verifique el chipset de su modem en:' `http://eciadsl.flashtux.org/modems.php?lang=en']. 5.1.1 Download -------------- Descargue el driver Eci para windows version 1.06 (de otro modo el archivo .bin no funcionara' bajo linux): `http://eciadsl.flashtux.org/download/eci_drv_106_win.zip' 5.1.2 Driver modification ------------------------- Si su modem no posee uno de estos VID/PID, Ud. debe modificar dos archivos en Eci Windows: - VID1/PID1: 0547/2131, VID2/PID2: 0915/8000 - VID1/PID1: 0915/0001, VID2/PID2: 0915/0002 Para verificar su VID/PID, por favor mire en : `http://eciadsl.flashtux.org/modems.php?lang=en'. Modificaciones que Ud. debe realizar: - En el archivo *gafwload.inf*, li'nea 24 : `ExcludeFromSelect = USB\VID_*0547*&PID_*2131*' reemplace el valor de su VID1 por 0547 y su PID1 por 2131 - en el archivo *gafwload.inf*, li'nea 30 : `%GSILOAD.DeviceDescAnchor% = GSIUSBLDRANCHOR, USB\VID_*0547*&PID_*2131*' reemplace el valor de su VID1 por 0547 y su PID1 por 2131 - en el archivo *gwausb.inf*, li'nea 34 : `ExcludeFromSelect = USB\VID_*0915*&PID_*8000*' reemplace el valor de su VID2 por 0915 y su PID2 por 8000 - en el archivo *gwausb.inf*, li'nea 42 : `%ADSLUSB.DeviceDesc% = ADSLUSB.gspnDefault, USB\VID_*0915*&PID_*8000*' reemplace el valor de su VID2 por 0915 y su PID2 por 8000 - en el archivo *gwausb.inf*, li'nea 58 : `HKR, Ndi, DeviceID, 0, "USB\VID_*0915*&PID_*8000*"' reemplace el valor de su VID2 por 0915 y su PID2 por 8000 5.1.3 Installation ------------------ Inicie el programa setup.exe y siga las instrucciones. 5.2 USB Sniffer =============== Descargue e instale el u'ltimo paquete sniffer para USB desde aqui': `http://benoit.papillault.free.fr/usbsnoop/' La documentacio'n para Snoopy (sniffer USB) esta' disponible aqui': `http://benoit.papillault.free.fr/usbsnoop/doc.php' 5.3 Sniff de paquetes USB bajo Windows ====================================== Desactive la auto-conexio'n a internet y desconecte todos los dispositivos USB (excepto el modem). Inicie el sniffer e instale el filtro en el "Wan modem", enseguida desconecte y reconecte el modem. Tan pronto como los dos leds dejen de parpadear, desinstale los filtros. Los paquetes capturados deben estar en el archivo `C:\WINxxx\usbsnoop.log' Reinicie bajo Linux. 5.4 Conversio'n del log a .bin bajo Linux ========================================= Monte la particio'n windows que contiene el archivo usbsnoop log para copiarlo donde usted desee. Ejecute este comando: `eciadsl-vendor-device.pl usbsnoop.log -chipset=#EL_CHIPSET_DE_SU_MODEM#' substituya `#EL_CHIPSET_DE_SU_MODEM#' con el chipset que posee su modem (GS7070 or GS7470). Para mas ayuda, ejecute el siguiente comando: `eciadsl-vendor-device.pl -h' Este script de perl analiza el archivo de log y crea un nuevo archivo bin (script provisto con el paquete usermode). Ejecute este comando: `mv #BIN_FILENAME_CREATED# /etc/eciadsl/my_synch.bin' substituya `#BIN_FILENAME_CREATED' con el nombre del archivo bin creado. y luego ejecute eciadsl-config-text para usar este .bin Ejecute eciadsl-start... ... y cruce sus dedos :-) 6 Autores / Soporte ******************* 6.1 Autores =========== El driver EciAdsl es creado y mantenido por: * FlashCode > * Jean-Se'bastien Valette > * Benoit Papillault > * Crevetor > * Laurent Wandrebeck (low) > 6.2 Obtener soporte =================== Antes de solicitar soporte, asegurese de haber lei'do la documentacion y las preguntas de uso frecuentes provistas con el driver (vea en /usr/local/doc/eciadsl, files README.es, INSTALL.es y TROUBLESHOOTING.es). * Soporte vía IRC: - servidor: irc.freenode.net - canal: #eci * Foro EciAdsl: `http://eciadsl.sf.net/scripts/forum' * Soporte vi'a lista de correo: - para suscribirse, envi'e un mail a con la palabra "subscribe" como Asunto (subject) - Para enviar un mail a todas las personas suscritas ala lista, envi'e su mail a - para terminar la suscripcio'n, envi'e un mail a con la palabra "unsubscribe" como asunto (subject) Agradecimientos a ZeGuigui, los archivos de la lista de correo esta'n disponibles aqui': `http://liste.eci.free.fr' * Pa'gina de soporte EciAdsl: `http://eciadsl.flashtux.org/support.php?lang=en'