Speedtouch Links

En Español

Home
Firmware Extractor
Ubuntu
Mandriva
SuSE
Linux From Scratch
Xbox and PS2 Masquerading
FAQ
Help (mailing list)
Tux riding the SpeedTouch
SourceForge Logo

The Linux Kernel Speedtouch Driver for Fedora Core

Preparations

Logistics

The first problem is getting the firmware (and some other things) onto your new Fedora system. You'll need to boot into a system that's online, save what you need and then reboot into Fedora. You could save the files on a partition of your hard drive, a flash memory stick or a floppy disk. It all depends on your hardware, so you'll have to sort those details out for yourself.

Save a copy of this page, then you will have it available whilst you're offline in Fedora. Before you go there, make sure you have the details you need from this table. You need to know if your ISP uses PPPoATM or PPPoE and the VP/VC values for your country/ISP.

If your ISP uses PPPoE you will need two other things, a copy of the br2684ctl bridging utility and libatm.so.1.

The Firmware

For the kernel to load the firmware it first needs to be split into two parts with the firmware-extractor. If you already have firmware you know works with your modem, use that. Otherwise, if you have a revision 0 modem you should use the mgmt.o firmware from this speedmgmt.tar.gz tarball. For the newer revision 2 and 4 (speedtouch 330) modems you should use the newer firmware

If you're not sure what revision of modem you have, you should be able to find out with this command

awk '/4061/ { print $5 }' /proc/bus/usb/devices

It should print out the revision number of your modem

Reboot into Fedora

Copy the firmware and other things into your home folder and open a terminal (on the top panel click Applications > Accessories > Terminal). Untar the firmware and split it in two with the firmware-extractor with these commands in the terminal window.

Revision 0

If you have an old green revision 0:

tar xzf speedmgmt.tar.gz &&
chmod +x firmware-extractor &&
./firmware-extractor mgmt/mgmt.o

Revision 2

If you have a revision 2 modem unzip and split the KQD6_3.012 file with these commands

unzip SpeedTouch330_firmware_3012.zip &&
chmod +x firmware-extractor &&
./firmware-extractor KQD6_3.012

Revision 4

If you have a silver revision 4, unzip and split the ZZZL_3.012 file with these commands

unzip SpeedTouch330_firmware_3012.zip &&
chmod +x firmware-extractor &&
./firmware-extractor ZZZL_3.012

If you get an error message that says "No such file or directory" then check that you've copied the files you need into your home folder.

Secrets

When ppp calls up your ISP it will need to know your username and password. Open a text editor (On the top Panel, Applications > Accessories > Text Editor) and enter one line in this format

"username@isp" "*" "password"

username@isp should be your username with your ISP and password should be the password for your internet account. Don't miss out the spaces in the " "*" " bit. Save that file in your home folder and call it secrets.

If your ISP uses PPPoE skip down to the PPPoE section


PPP Over ATM

Create a configuration file for pppd. Open a text editor, copy and paste this into it and save it in your home folder in a file called ifcfg-ppp0

PEERDNS=yes
TYPE=xDSL
DEVICE=ppp0
BOOTPROTO=dialup
PIDFILE=/var/run/pppoa-adsl.pid
CONNECT_POLL=6
CONNECT_TIMEOUT=300
SYNCHRONOUS=no
DEFROUTE=yes
LCP_INTERVAL=10
LCP_FAILURE=2
USER='username@isp'
VPI=vpi-number
VCI=vci-number
LINUX_PLUGIN=pppoatm.so

Change username@isp for the username your ISP knows you by. Often (but not always) it has an @isp bit at the end (It may be @dsl4.bt, for example). Also, change the vpi-number and vci-number for the VPI/VCI numbers for your country and ISP.

Tidying up

Now that you're prepared, all that's left to do is copy these files system side. That will need root privileges so become root with the command su.

su
# enter the root password

Now copy and paste these commands:

cp speedtch-{1,2}.bin /lib/firmware
install -m400 ifcfg-ppp0 /etc/sysconfig/network-scripts
install -m400 secrets /etc/ppp/chap-secrets
install -m400 secrets /etc/ppp/pap-secrets

If you get an error message that says "No such file or directory" then check that you've copied the files you need into your home folder and that they have the right names.

When you reboot, you should be online. You don't need to keep any of the files left in your home folder, but it might be useful to keep a copy of the firmware and the firmware-extractor.

Please report any problems to the mailing list


PPPoE

Create a configuration file for pppd. Open a text editor, copy and paste this into it and save it in your home folder in a file called ifcfg-ppp0

PEERDNS=yes
TYPE=xDSL
DEVICE=ppp0
BOOTPROTO=dialup
PIDFILE=/var/run/pppoe-adsl.pid
BR2684DEV=0
CONNECT_POLL=6
CONNECT_TIMEOUT=300
SYNCHRONOUS=no
DEFROUTE=yes
LCP_INTERVAL=10
LCP_FAILURE=2
USER='username@isp'
VPI=vpi-number
VCI=vci-number
LINUX_PLUGIN=rp-pppoe.so

Change username@isp for the username your ISP knows you by. Also, change the vpi-number and vci-number for the VPI/VCI numbers for your country and ISP.

Tidying up

Now that you're prepared all that's left to do is copy these files system side. You'll need to have root privileges to write there so become root with the command su.

su
# enter the root password

Now copy and paste these commands:

cp speedtch-{1,2}.bin /lib/firmware
install -m400 ifcfg-ppp0 /etc/sysconfig/network-scripts
install -m400 secrets /etc/ppp/chap-secrets
install -m400 secrets /etc/ppp/pap-secrets
install -m755 br2684ctl /usr/sbin
install -m644 libatm.so.1 /usr/lib

If you get an error message that says "No such file or directory" then check that you've copied the files you need into your home folder and that they have the right names.

When you reboot, you should be online. You don't need to keep any of the files left in your home folder, but it might be useful to keep a copy of the firmware and the firmware-extractor.

Please report any problems to the mailing list