cxacru guide

Conexant Access Runner ADSL USB modems with Ubuntu >= 6.06 'Dapper Drake'

-----=====> ATTENZIONE: MATERIALE OBSOLETO!!! <=====-----

02/11/2008

Il materiale riportato di seguito è obsoleto e non verrà più aggiornato.
Viene lasciato solo come traccia generale.
Per informazioni aggiornate e complete si consiglia di rivolgersi al supporto fornito dalla propria distribuzione (forum, newsgroup, mailing list ecc.)
Causa mancanza di tempo, non risponderò più a email di richiesta aiuto sugli argomenti qui trattati.

Grazie,
Giovanni Chiodi

Sito del progetto e materiale da scaricare:

Conexant AccessRunner ADSL USB modems with Linux
se state cercando di far funzionare il modem evidentemente non avete una connessione internet quindi prima di partire, da un computer connesso ad internet:

Salvate/stampate la pagina Modems supported by the Linux driver e questa guida.
Da un computer connesso ad internet scaricate il pacchetto utils.tar.gz . Contiene l'estrattore per il firmware ( preso dal pacchetto cxacru-fw-ng.tar.gz ) e l'utility per creare la ROM di boot a partire dal file WBoot.hex.

Supported modems:

collegare il modem

user@ubuntu:~$ lsusb
Bus 004 Device 001: ID 0000:0000
Bus 003 Device 003: ID 0572:cb00 Conexant Systems (Rockwell), Inc. E-Tech ADSL USB Modem v2
Bus 003 Device 001: ID 0000:0000
Bus 002 Device 001: ID 0000:0000
Bus 001 Device 003: ID 0000:0000
Bus 001 Device 001: ID 0000:0000

confrontare il Vendor e il ProdID ( nel mio caso 0572:cb00 ) con quelli all'indirizzo
Modems supported by the Linux driver

Assicurarsi che il modulo cxacru sia presente nel kernel:

user@ubuntu:~$ cat /boot/config-`uname -r` | grep USB_CXACRU
CONFIG_USB_CXACRU=m
oppure
CONFIG_USB_CXACRU=y

A partire dalla Ubuntu 6.06 'Dapper Drake' dovrebbe ritornare una dei due risultati precedenti,
quindi si puo' proseguire al prossimo paragrafo.

Se invece non e' presente e' necessario aggiungere il modulo/ricompilare il kernel, per questo
si rimanda al sito
Linux kernel driver
ed a eventuali guide su come ricompilare il kernel ( Google )
N.B. Nelle ultime release del Kernel ( dalla 2.6.13-rc1 ) il modulo cxacru e' gia' presente

commit 1b0e614652344a2d39eb336f3dc07651782883bf
Author: Duncan Sands
Date: Wed May 11 20:19:29 2005 +0200

[PATCH] USB ATM: driver for the Conexant AccessRunner chipset cxacru

Driver for modems based on the Conexant AccessRunner chipset.
Original patch by Josep Comas, much reworked by Roman Kagan.

Signed-off-by: Duncan Sands
Signed-off-by: Greg Kroah-Hartman

quindi non e' necessario sovrascrivere il sottoalbero del kernel drivers/usb/atm.
Questo a meno di un eventuale versione piu' aggiornata sul sito
Linux kernel driver
o se si vuole compilare solo il modulo e non tutto il kernel.

Installazione pacchetti necessari:

Da linux verificare che siano installati/installare i seguenti pacchetti:
ppp
build-essential
un qualsiasi editor di testo ( ad esempio nano )

user@ubuntu:~$ sudo apt-get install ppp build-essential nano

Se il comando precedente non va a buon fine molto probabilmente e' perche'
il CD di ubuntu non e' nella lista dei repository ( /etc/apt/sources.list ).
Per aggiungerlo: sudo apt-cdrom add

Estrarre il firmware:

Salvate sul desktop l'archivio utils.tar.gz e da un terminale estraetelo con:

user@ubuntu:~/Desktop$ tar xzf utils.tar.gz

copiate nella cartella utils il file WBoot.hex prendendolo dall'archivio USBADSLV151-1008fr.tar.gz
compilate i sorgenti delle utility:

user@ubuntu:~/Desktop$ cd utils
user@ubuntu:~/Desktop/utils$ make
cc cxacru-fw.c -o cxacru-fw
cc cxacru-bp.c -o cxacru-bp

copiate cnxetu.sys ( prendendolo dal cd di installazione del vostro modem ) nella cartella utils e poi estraete il firmware.

user@ubuntu:~/Desktop/utils$ ./cxacru-fw cnxetu.sys cxacru-fw.bin
user@ubuntu:~/Desktop/utils$ sudo cp cxacru-fw.bin /lib/firmware

create la ROM di boot con il comando:

user@ubuntu:~/Desktop/utils$ ./cxacru-bp > cxacru-bp.bin
user@ubuntu:~/Desktop/utils$ sudo cp cxacru-bp.bin /lib/firmware

A questo punto e' necessario riavviare il computer.

E' necessario perche' quando si e' collegato il modem ( paragrafo Supported modems ) e' stato caricato
il modulo cxacru che a sua volta ha tentato di inviare il firmware al modem fallendo:
cxacru 3-2:1.0: firmware (cxacru-fw.bin) unavailable (hotplug misconfiguration?)
Adesso che il firmware e' al posto giusto ( /lib/firmware/`uname -r` ) bisognerebbe poter ricaricare il modulo cxacru ( sudo modprobe -r cxacru && sudo modprobe cxacru ) che automaticamente invierebbe il firmware al modem. Questo, in teoria dovrebbe funzionare ma, in pratica non funziona perche' il comando sudo modprobe -r cxacru
non viene eseguito con successo ( e' un bug del modulo cxacru? ).
Se qualcuno ha qualche idea migliore, del riavvio, puo' farmelo sapere, grazie!

Dopo il riavvio continuate con il prossimo paragrafo Verifica intermedia

Verifica intermedia:

user@ubuntu:~$ dmesg

....
usb 3-2: new full speed USB device using uhci_hcd and address 2
usbcore: registered new driver cxacru
cxacru 3-2:1.0: found firmware cxacru-fw.bin

La lucina del modem inizia a lampeggiare e nel frattempo
nel log compaiono i seguenti messaggi:

user@ubuntu:~$ dmesg

....
cxacru 3-2:1.0: ADSL line: attemtping to activate
cxacru 3-2:1.0: ADSL line: down
cxacru 3-2:1.0: ADSL line: attemtping to activate
cxacru 3-2:1.0: ADSL line: down
....
cxacru 3-2:1.0: ADSL line: channel analysis
cxacru 3-2:1.0: ADSL line: up (XXXX kb/s down | XXX kb/s up)

oppure delle volte

cxacru 3-2:1.0: ADSL line: training
cxacru 3-2:1.0: ADSL line: exchange
cxacru 3-2:1.0: ADSL line: up (XXXX kb/s down | XXX kb/s up)

nel caso si ottenga

cxacru 3-2:1.0: poll status: error -5

come viene consigliato nella mailing list

If your modem isn't packaged with the right firmware, please try a
package for a similar modem. E.g. the most recent one I've seen
(version 099.085, dated 10/29/2003) was the package for Atlantis I-Storm
USB (A01-AU1); see
Atlantis I-Storm USB (A01-AU1) (version 099.085, dated 10/29/2003)

Configurazione di ppp ( i file si commentano da soli ):

N.B. commentare un'opzione con il cancelletto (#) e' equivalente a toglierla
quindi la doppia negazione #nocomando equivale all'affermazione del comando

potrebbe essere necessario modificare i file seguenti in base alle
proprie esigenze. Quindi per qualsiasi spiegazione aggiuntiva
si rimanda alla guida di pppd

user@ubuntu:~$ man pppd

( si ricorda che la funzione di ricerca all'interno di man e' richiamata con

/nomedacercare

prossima occorrenza di nomedacercare con n, precedente con N

per uscire :q

)

Potete trovare alcuni file di esempio sulla configurazione di PPP in
/usr/share/doc/ppp/examples

Editare i file come root quindi: sudo nome_editor file_da_editare ( Es. sudo nano /etc/ppp/options )
/etc/ppp/options

# example configuration for the kernel space PPP over ATM driver
#
# See the manual page pppd(8) for information on all the options.

# MUST CHANGE: Uncomment the following line, replacing the user@provider.net
# by the DSL user name given to your by your DSL provider.
# There should be a matching entry with the password in /etc/ppp/pap-secrets
# and/or /etc/ppp/chap-secrets.
# E' necessario sostituire user@provider.it con il proprio Nome utente
# ( solitamente e' in quella forma ).
user "user@provider.it"

# Load the PPPoA plugin.
# If needed, change the VP.VC pair to match the ones used by your ISP.
# sostituite VP.VC con il VP.VC del vostro provider
plugin pppoatm.so
VP.VC

# Enable this option if your ISP uses PPPoA with LLC encapsulation.
#llc-encaps

# Assumes that your IP address is allocated dynamically by the ISP.
noipdefault
# Try to get the name server addresses from the ISP.
usepeerdns
# Use this connection as the default route.
# Comment out if you already have the correct default route installed.
defaultroute

# Makes pppd "dial again" when the connection is lost.
persist

# Do not ask the remote to authenticate.
#noauth

# Do not try to negotiate compression.
#nopcomp
#noccp
#novj

#lcp-max-configure 50

#refuse-pap

#name any

Come ha detto prima

# There should be a matching entry with the password in /etc/ppp/pap-secrets
# and/or /etc/ppp/chap-secrets.

quindi

/etc/ppp/pap-secrets

user@provider.it[TAB]*[TAB]password[TAB]*[ENTER]

/etc/ppp/chap-secrets

user@provider.it[TAB]*[TAB]password[TAB]*[ENTER]

come prima user@provider.it sostituito con il vostro username
password con la propria password.
Al posto di [TAB] bisogna premere il tasto Tab sulla tastiera
Al posto di [ENTER] bisogna premere il tasto Enter (Invio) sulla tastiera

in /etc/ppp/options abbiamo scelto
# Try to get the name server addresses from the ISP.
usepeerdns

questo implica che se riesce dovrebbe scrivere automaticamente gli IP
dei Resolver in /etc/ppp/resolv.conf ma se non riesce o se l'ISP
non supporta questo servizio dovete inserirli voi a mano ( la prima volta ).

/etc/ppp/resolv.conf

nameserver XX.XX.XX.XX
nameserver XX.XX.XX.XX

le X vanno sostituite con l'indirizzo IP del vostro DNS

/etc/ppp/peers/provider

# These are the options to dial out to your default service provider.
# Please customize them correctly. Only the "provider" file will be
# handled by poff and pon (unless with extra command line arguments).

# You usually need this if there is no PAP authentication
# noauth

# The chat script (be sure to edit that file, too!)
# connect "/usr/sbin/chat -v -f /etc/chatscripts/provider"

# Set up routing to go through this PPP link
defaultroute

#If defaultroute is set and replacedefaultroute is also set, pppd replaces an
#existing default route with the new default route.
#Se anche voi, come me, solitamente vi collegate ad internet attraverso un
#router/computer che condivide la connessione a internet decommentate l'opzione
#che segue.

#replacedefaultroute

# Default modem (you better replace this with /dev/ttySx!)
# /dev/modem

# Speed
# 38400

# Keep modem up even if connection fails
persist

Collegarsi a internet:

user@ubuntu:~$ sudo pon

( puo' essere chaimato solo dopo che nel log appare
cxacru 3-2:1.0: ADSL line: up (XXXX kb/s down | XXX kb/s up)
e quindi la linea e' stata trovata )

user@ubuntu:~ cat /var/log/messages

dovrebbe mostrare qualcosa del tipo

kernel: [****] CSLIP: code copyright 1989 Regents of the University of California
kernel: [****] PPP generic driver version 2.4.2
pppd [****]: Plugin pppoatm.so loaded.
pppd [****]: pppd 2.4.4b1 started by xxxxxxxx, uid 1000
pppd [****]: Using interface ppp0
pppd [****]: Connect: ppp0 <--> VP.VC
pppd [****]: PAP authentication succeeded
kernel: [****] PPP BSD Compression module registered
kernel: [****] PPP Deflate Compression module registered
pppd [****]: local IP address XXX.XXX.XXX.XXX
pppd [****]: remote IP address XXX.XXX.XXX.XXX
pppd [****]: primary DNS address XXX.XXX.XXX.XXX
pppd [****]: secondary DNS address XXX.XXX.XXX.XXX

per vedere solo le informazioni di log relative al pppd
si puo chiamare anche

user@ubuntu:~ plog

Scollegarsi da internet:

user@ubuntu:~ sudo poff

e per vedere il log:

user@ubuntu:~ cat /var/log/messages
pppd [****]: Terminating on signal 15
pppd [****]: Connect time XX.X minutes.
pppd [****]: Sent XXXXXX bytes, received XXXXXXX bytes.
pppd [****]: Connection terminated.
pppd [****]: Exit.

Per finire:

Se siete riusciti a far funzionare il vostro modem e non e'
nella lista dei modem all'indirizzo "known to work"
segnalatelo:

report it to the mailing list

providing as much info about your modem as you can.
To post a message to all the list members, send email to
accessrunner-general@lists.sourceforge.net

For comments, bugs etc. giovanni.chiodi@gmail.com