SpeedTouch USB ADSL Modem HowTo for Ubuntu 5.10 Breezy Badger (UK)
--------------------------------------------------------------------
Requirements for the U.K. only!
NOTE:
Print a copy of this HowTo or have it visible on another machine that doesn't require an internet connection. Else save it and transfer it onto your ubuntu machine.
If you're a newbie, it would also be a good idea to print a copy of basic questions and commands (if you don't have a book) that will speed up your development. These are general to most linux distro's (distributions) and are available from - Download:
http://www.linuxhelp.net/newbies/newbies-print.php0 - SpeedTouch ADSL version 4 modem (Thomson / Alcatel)
1 - libatm1_2.4.1-17_i386.deb
('libatm' is already packaged with Breezy Badger but you should re-install it to prevent any further frustrations. Newer versions will possibly supercede this, but this works) Download:
http://packages.ubuntu.com/hoary/libs/libatm12 - speedtouch-firmware_0.3012k_all.deb
(Modem firmware that ensures your modem runs everytime you plug it in, switch your computer on or click to browse the internet.) Download:
http://ftp.linux.it/pub/People/md/warez ... 2k_all.deb3 - speedtch.txt
(This script is necessary for hotplugging the modem ie: connecting / disconnecting when the usb plug to the modem is inserted / pulled out of the usb port [PlugandPlay]. Many thanks to Darrell - ubuntu forum member)
Copy and save in Notepad everything between the lines as "speedtch.txt"
-------------------------------------------------------------------------------------
#!/bin/sh
# Script based on /etc/hotplug/usb/speedtouch from the speedtouch debian package.
# This package is not required with kernel 2.6.10, but without this little bit
# of its functionality, we would lose automatic connection on hotplugging the
# speedtouch modem (and immediate killing of the pppd on disconnection).
PATH=/sbin:/bin:/usr/sbin:/usr/bin
export PATH
# ignore device events
#[ "$PRODUCT" ] || exit 0
# a PPP peer to call
PPPD_PEER="adslscript" # the name of a connection script in /etc/ppp/peers
# start the pppd process
pppd call $PPPD_PEER
#This will make sure that the pppd process is killed immediately if the
# modem is unplugged, thereby making everything ready for immediate reconnection
[ "$REMOVER" ] || exit 0
{
echo "#!/bin/sh"
[ "$PPPD_PEER" ] && printf "poff $PPPD_PEER\nsleep 5\n"
} >> $REMOVER
chmod +x $REMOVER
exit 0
-------------------------------------------------------------------------------------
MAKE SURE YOU HAVE EVERYTHING PRINTED OR SAVED IN YOUR HOME DIRECTORY IN UBUNTU THAT YOU REQUIRE! IT IS SOMETIMES BETTER IF YOU HAVE THE HOWTO LOADED ON THE SAME SYSTEM SO YOU CAN JUST COPY AND PAST.
FINALLY MAKE SURE YOU HAVE AN INTERNET CONNECTION BUT DON'T PLUG YOUR USB MODEM IN JUST YET. YOU WILL BE PROMPTED TO DO THIS LATER.
Assuming you're already in Ubuntu - OPEN A TERMINAL (Application -> Accessories -> Terminal)
STEP 1: install the package 'libatm1_2.4.1-17_i386.deb'
CODE TO TYPE:
sudo su <ENTER> (this will require your root password and give you something like this 'root@your username:/home/yourusername#')
dpkg -i libatm1_2.4.1-17_i386.deb <ENTER>
Step 2: install the modem firmware package 'speedtouch-firmware_0.3012k_all.deb'
CODE TO TYPE:
dpkg -i speedtouch-firmware_0.3012k_all.deb <ENTER> (you must still be in root - This will install the firmware files to your computer.)
Step 3: configure the software
You are now going to load the pppoatm module, and set up your machine so the pppoatm module is loaded at every boot - before you do this type 'exit' to get out of root ie: root@your username:/home/yourusername# exit <ENTER>
This will leave you with: your username@your username:~$
CODE TO TYPE:
sudo modprobe pppoatm <ENTER> (note: whenever you're not in root and you type 'sudo' at the start of a command, you will be prompted for your root password)
sudo gedit /etc/modules <ENTER> (this will open up gedit word editor - in the editor window, add the word - pppoatm - at the bottom of the list, save and exit.
Now we're going to create a pppd connection script to control logging on to your ISP:
CODE TO TYPE:
sudo cp /usr/share/doc/ppp/examples/peers-pppoe /etc/ppp/peers/adslscript <ENTER>
sudo gedit /etc/ppp/peers/adslscript <ENTER> (this will open up gedit word editor - in the editor window, change the line -
# user "myusername@myprovider.com"
to
user "your-own-isp-username"
below this you are going to replace a few lines (remember to include the blank line, up to eth0), which are:
# Load the pppoe plugin.
plugin rp-pppoe.so
.........ethernet interface...........
eth0
and replace with
CODE TO TYPE:
# These options configure pppd to talk with the kernelspace speedtch driver.
# Don't forget to adapt the VP.VC pair to your ISP/country settings.
# (see
http://www.linux-usb.org/SpeedTouch/faq/index.html#q12)
plugin pppoatm.so
0.38 #UK
After this you should have the following:
# 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.
defaultroute
# Makes pppd "dial again" when the connection is lost.
persist
# Do not ask the remote to authenticate.
noauth
If you have the above, then there's nothing else to do here except save and exit the editor.
But, if you have the following towards the bottom, comment out (ie put a # at the beginning of the line):
noaccomp
and
default-asyncmap
After you have commented out the above lines, save and exit the editor.
Now you are going to set up your isp password:
CODE TO TYPE:
sudo gedit /etc/ppp/chap-secrets <ENTER> (In the editor window, add the following line)
your-isp-username * your-isp-password * (Note: there is a space between username, *, password and *)
Save file and close the editor.
CODE TO TYPE:
sudo gedit /etc/ppp/pap-secrets <ENTER> (In the editor window, add the identical line to that just added to the chap secrets file. Don't forget the spaces.)
Save file and close the editor. (Only one of these two files that you have just edited will be used by your ISP to connect, it just depends on the authentication method used by your ISP.)
Finally, setup the hotplug system to automatically connect when the modem is plugged in and at boot time:
CODE TO TYPE:
sudo cp /your/path/to/speedtch.txt /etc/hotplug/usb/speedtch <ENTER> (/your/path/to must be replaced with the location of the speedtch.txt file)
Now we are going to turn this script into an executable file
CODE TO TYPE:
sudo chmod +x /etc/hotplug/usb/speedtch <ENTER>
CODE TO TYPE:
tail -f /var/log/messages <ENTER> (NOW IS THE TIME TO: Plug in your modem and watch it connect. You should see in the messages displayed with a month, date, time and localhost format with the more important stuff at the end, which will read something like this:
usbcore: registered new driver speedtch
speedtch: loaded successfully
Plugin pppoatm.so loaded
pppd 2.4.3 started...
found stage 2 firmware...
Exit
Exit
Using interface ppp0
Connect: ppp0 <--> 0.38
ADSL line is synchronising
CHAP authentication succeeded
PPP...registered
PPP...registered
local IP address ......
remote IP address ......
primary DNS address ........
secondary DNS address .......
ADSL line is up (2272 Kib/s down ¦ 288 Kib/s up)
CODE TO TYPE:
ctrl-c (to get out of the scrolling messages display).
You should now be connected to the internet.
NOTE: In other countries using PPPoA should work by changing the VPI/VCI numbers. To check what your VPI/VCI numbers are look at
http://www.linux-usb.org/SpeedTouch/ubuntu/index.html.
