| By Declan McMullen|
This tutorial is written for anyone who wishes to use Eircom I-Stream with the SpeedTouch USB Modem
I got this to work on Debian 3.0 with a 2.4.18 kernel.
So please note that all later 2.4.X kernels now come with bridging/pppoe
support and the alcatel speedtouch usb modem driver all built in to the
kernel. As such the patching of the kernel and compiling of the
speedtouch module as mentioned in the tutorial are no longer a
Before we begin here are the packages you will need to get this working.
For The Hardware:
The speedmgmt application from Alcatel; http://www.speedtouchdsl.com
The Open Source Kernel Module written and maintained by John Verrept; http://linux-usb.sourceforge.net/SpeedTouch
The SARLib; http://sarlib.sourceforge.net
A linux kernel, 2.4.2 or above.; http://ftp.kernel.org/pub/linux/kernel/v2.4
A PPPoE aware daemon; http://skyhawk.redbrick.dcu.ie/Adsl/ppp-2.4.0-pppoe4.tgz
The RFC2684 Bridging kernel patch and configuration utility
The versions I used of these packages are available here
Firstly you must patch the kernel:
Change to the directory where you will be untarring the kernel
Untar the kernel source:
tar zxvf linux-2.4.x.tar.gz
Your source may be in .tar.bz2 format
If so do this
tar xvf linux-2.4.x.tar
Now to apply the PPPoE patch:
patch -p1 -s -E < /pathTo/br2684-against2.4.17.diff
Now you must configure the kernel:
choose your preferred kernel config program
e.g make menuconfig, make xconfig
The Following options must be set for the adsl to work:
Code Maturity Level Options
Prompt for development and/or incomplete code/drivers [Y]
Loadable Module Support
Enable Loadable Module Support [Y]
Processor type and features
Symmetric multi-processing support [N]
Packet Socket [Y]
Asynchronus Transfer Mode (ATM) (EXPERIMENTAL) [Y]
RFC 1482/2684 Bridged protocols [Y]
Network Device Support
PPP (Point-to-Point Protocol) Support [Y]
PPP Deflate Compression [Y]
PPP over Ethernet (EXPERIMENTAL)
Support for USB [Y]
Preliminary USB Device Filesystem [Y]
UHCI (Intel PIIX4, VIA,...) Support [M]
OHCI (Compag, iMacs, Opti, SiS, Ali,...) support [M]
NOTE:These are merely the options needed to get the adsl functioning
Don't forget to select the other modules needed for your systems
Once your selections have been made save your new kernel configuration
and compile your new kernel.
If all goes to plan you should now have a new kernel.
Reboot for the changes to take effect.
On reboot type uname -a to verify the new kernel version.
Next the Speedtouch module must be compiled:
Untar and build the SARLib:
tar xvzf sarlib-0.2.x.tgz
ln -s sarlib-0.2.x sarlib
Now the SpeedTouch module:
tar xvzf speedtouch-1.x.tar.gz
You should now have the required kernel module.
Next we need to install the Binary Management Application:
tar xvzf speedmgmt-1.x.gz
cp speedmgmt /usr/sbin
DO NOT compile these files, we only need the firmware application itself.
Next you need to install PPPoE support:
Firstly the ATM Package:
tar xvzf atm-0.78.tar.gz
Next compile the br2684 utility
cc -o br2684ctl brctl-010226.c -latm
cp br2684ctl /usr/sbin
Lastly install the PPPoE daemon:
tar xvzf ppp-2.4.0-pppoe4.tgz
That completes the installation of the required packages.
Now all thats left is to configure the system.
Configuring the usb system
Add this line to /etc/fstab
/dev/usb /proc/bus/usb usbdevfs defaults 0 0
This will mount your usb filesystem at boot-time
Edit your /etc/ppp/options file and replace it with:
Next edit /etc/ppp/chap-secrets and /etc/ppp/pap-secrets and add the following
"yourIstreamName@eircom.net" * "yourIstreamPass"
And finally testing the system:
Make sure your usb modules and speedtouch modules are active
go to /kernel/drivers/usb
and select the speedtch module and your required usb module/s
Verify the modules have taken by typing lsmod.
Now the moment of truth
Firstly bring up the Ethernet bridge
br2684ctl -b -c 0 -a 8.35
Next bring up the nas0 interface
ifconfig nas0 up
Now initialise the modem with the binary application
And lastly initialise your ppp daemon
IF all goes well you should see the following in /var/log/syslog
pulsar pppd: Plugin /usr/lib/pppd/plugins/pppoe.so loaded.
pulsar pppd: PPPoE Plugin Initialized
pulsar pppd: pppd 2.4.0 started by root, uid 0
pulsar pppd: Sending PADI
pulsar pppd: HOST_UNIQ successful match
pulsar pppd: HOST_UNIQ successful match
pulsar pppd: Got connection: f41
pulsar pppd: Connecting PPPoE socket: 00:02:3b:01:de:88 410f nas0
pulsar pppd: Using interface ppp0
pulsar pppd: Connect: ppp0 <--> nas0
pulsar pppd: Remote message: CHAP authentication success, unit 38
pulsar pppd: local IP address 22.214.171.124
pulsar pppd: remote IP address 126.96.36.199
CONGRATULATIONS your adsl line is working.
There are a lot of ways in which things can go wrong whilst attempting this.
It took me countless recompiles and reboots to finally get it going.
If you are having problems feel free to drop me a mail and hopefully
it's an error that I may have come across during my ordeal in getting this
About the author, Declan McMullen.