Difference between revisions of "DSL SpeedTouch modem"

From ArchWiki
Jump to: navigation, search
(Introduction)
m (netcfg: the file used here is the same as the installed by netcfg-pppoa, no need to show it here)
(37 intermediate revisions by 19 users not shown)
Line 1: Line 1:
[[Category:DSL Modem]]
+
[[Category:Modems]]
[Stub]
+
=ATTENTION=
+
Newer udev (060 or so) puts itself as the hotplug program in /proc/sys/kernel/hotplug, but doesn't handle firmware loading requests, thus the automatic firmware loading as described below won't work. Best way to solve this problem is yet unclear.
+
  
Please see this bug report for more details: http://bugs.archlinux.org/task/3439
+
== Introduction ==
  
==Introduction==
 
 
This howto shows one way to get a working speedtouch USB modem. It uses the kernel driver, '''not''' the userspace driver. This howto assumes that your ISP uses PPPoA and not PPPoE. For info about PPPoE with these modems see first url below.
 
This howto shows one way to get a working speedtouch USB modem. It uses the kernel driver, '''not''' the userspace driver. This howto assumes that your ISP uses PPPoA and not PPPoE. For info about PPPoE with these modems see first url below.
  
 
Important sites where most info comes from:
 
Important sites where most info comes from:
* [http://www.linux-usb.org/SpeedTouch Link1]
+
* http://www.linux-usb.org/SpeedTouch
* [http://lkml.org/lkml/2004/12/27/63 Link2]
+
* http://lkml.org/lkml/2004/12/27/63
  
 
If the below instructions are not enough to get it working, then read the above sites.
 
If the below instructions are not enough to get it working, then read the above sites.
Line 17: Line 13:
 
The following steps are needed to get the modem working:
 
The following steps are needed to get the modem working:
  
1) Make sure you have a kernel with the proper support (at least the modules ppp_generic, pppoatm, slhc, atm, usb_atm and speedtch). The default Arch kernel should work: <code>pacman -S kernel26</code>
+
== Kernel config and ppp ==
  
2) Install ppp: <code>pacman -S ppp</code>
+
Make sure you have a kernel with the proper support (at least the modules ppp_generic, pppoatm, slhc, atm, usbatm and speedtch). The default Arch kernel should work.
  
3) Configure pppd's config files
+
Otherwise make sure that your kernel supports firmware loading:
 +
$ zgrep FW_LOADER /proc/config.gz
  
==Configuring pppd==
+
Install ppp: <code>pacman -S ppp</code>
 +
 
 +
==The Arch Way==
 +
===netcfg===
 +
 
 +
{{Out of date|netcfg has been superseded by [[netctl]], but there is no package like ''netctl-pppoa''. In fact, this is the only page on ArchWiki mentioning pppoa.}}
 +
 
 +
Install the package {{AUR|netcfg-pppoa}}.
 +
 
 +
Now configure the connection. We'll put it in {{ic|/etc/network.d/adsl}}:
 +
 
 +
<pre>
 +
CONNECTION='pppoa'
 +
DESCRIPTION='ADSL connection'
 +
INTERFACE='ppp0'
 +
USER='username'
 +
PASSWORD='password'
 +
PPPOA_VPI=8
 +
PPPOA_VCI=48
 +
 
 +
# This causes pppd to reconnect if the link goes down
 +
LCP_ECHO_INTERVAL=15
 +
LCP_ECHO_FAILURE=10
 +
</pre>
 +
 
 +
You should now be able to connect by calling {{ic|netcfg adsl}}. For more details, see the [[netcfg|netcfg wiki page]].
 +
 
 +
==The manual way==
 +
 
 +
===Configuring pppd===
 
<pre>
 
<pre>
 
###  /etc/ppp/peers/speedtch
 
###  /etc/ppp/peers/speedtch
Line 50: Line 76:
 
</pre>
 
</pre>
  
The last entry depends on your country/ISP and is created from the VPI and VCI setting in the format <code>VPI.VCI</code>. A windows speedtouch diagnostic program may show you the VPI and VCI settings for your country/ISP.
+
The last entry depends on your country/ISP and is created from the VPI and VCI setting in the format <code>VPI.VCI</code>. This page has a [http://www.linux-usb.org/SpeedTouch/faq/index.html#q12 VPI / VCI Setting List].
 
+
This page has a [http://www.edimax.com.tw/html/english/products/AR-7024Um.htm VPI / VCI Setting List], which I have partially reproduced below.
+
 
+
{|style="width:400px; height:50px" border="1" cellpadding="5" cellspacing="0" align="Left"
+
|-
+
!style="background:#efefef;" | Country
+
!style="background:#efefef;" | ISP
+
!style="background:#efefef;" | VPI
+
!style="background:#efefef;" | VCI
+
|-
+
| Australia
+
| All Internet providers
+
| 8
+
| 35
+
|-
+
| rowspan=3|Suomi
+
| Island ssimi
+
| 0
+
| 35
+
|-
+
| Landssimi
+
| rowspan=2| 8
+
| rowspan=2| 48
+
|-
+
| Vortex
+
|-
+
| United Kingdom
+
| British Telecom
+
| 0
+
| 38
+
|}
+
<br>
+
  
 
You also need to configure /etc/ppp/pap-secrets or chap-secrets, depending on your ISP.  pap-secrets files are of the format:
 
You also need to configure /etc/ppp/pap-secrets or chap-secrets, depending on your ISP.  pap-secrets files are of the format:
 
<pre>
 
<pre>
 
# Secrets for authentication using PAP
 
# Secrets for authentication using PAP
# client        server  secret acceptable local IP addresses
+
# client        server  secret IP addresses
fred * flintstone
+
"ISP-Username" * ISP-password *
 
</pre>
 
</pre>
See [http://www.tldp.org/HOWTO/PPP-HOWTO/x1005.html The PAP/CHAP secrets file] for more detials.
+
See [http://www.tldp.org/HOWTO/PPP-HOWTO/x1005.html The PAP/CHAP secrets file] for more details.
  
If you want to use the DNS servers provided by your ISP then make a symlink /etc/resolv.conf pointing to /etc/ppp/resolv.conf:
+
If you want to use the DNS servers provided by your ISP (you probably do!) then make a symlink /etc/resolv.conf pointing to /etc/ppp/resolv.conf:
 
  cd etc
 
  cd etc
 
  rm resolv.conf
 
  rm resolv.conf
 
  ln -s ppp/resolv.conf resolv.conf
 
  ln -s ppp/resolv.conf resolv.conf
  
4) Configure hotplug:
+
===Configure udev===
 
+
Make an executable (chmod +x) file /etc/hotplug/usb/speedtch and put something like the next in it:
+
<pre>
+
#!/bin/sh
+
case $ACTION in
+
add)
+
if [[ ! -z "$SEQNUM" -a ! -f /tmp/bla ]]; then
+
sleep 1;
+
/usr/sbin/pppd call speedtch &> /tmp/bla;
+
echo -e "--- $SEQNUM ---\n$DEVPATH" >> /tmp/bla;
+
fi
+
;;
+
*)
+
echo -n "speedtch unknown action: $ACTION" >> /tmp/unknown-action;
+
esac
+
</pre>
+
  
 +
Make a file {{ic|/etc/udev/rules.d/99-speedtouch.rules}} and put something like the following in it:
 +
ACTION=="add", SUBSYSTEM=="atm", KERNEL=="speedtch*", RUN="/usr/bin/pppd call speedtch"
  
5) Now you have everything except the firmware loading. Easiest is if you let hotplug do it. The above script assumes that. If you want to do it manually then you'll need to do it in the above speedtch script with the appropriate sleeps to give the modem enough time.
+
With this Udev will start pppd automatically, if you do not want this you can simply bring up your modem using
 +
pppd call speedtch
  
If you have a zip like e.g. rev4fw.zip, then unzip it. It probably contains two files, a small one and a big one. Copy the small file to:
+
==Firmware==
 +
Now you have everything except the firmware loading. The easiest way is to let udev do it. Download [http://steve-parker.org/speedtouchconf/rev4fw.zip rev4fw.zip] (note disclaimer [http://speedtouchconf.sourceforge.net/ here]) and  unzip it. It contains two files, a small one and a big one. Copy the small file to {{ic|/usr/lib/firmware/speedtch-1.bin}} and the big one to {{ic|/usr/lib/firmware/speedtch-2.bin}}
  
<code>/lib/firmware/speedtch-1.bin</code>
+
# mkdir -p /usr/lib/firmware
 +
# cp small_file /usr/lib/firmware/speedtch-1.bin
 +
# cp large_file /usr/lib/firmware/speedtch-2.bin
  
and the big one to:
+
If you cannot download this file then follow the instructions of the second link above and use the firmware extractor (or download another firmware which has the two files).
  
<code>/lib/firmware/speedtch-2.bin</code>
+
==Troubleshooting==
  
The first one should be about 990 bytes, and the second one about 660Kb. If you don't get those two files, but only one, then follow the instructions of the second link above and use the firmware extractor (or download another firmware which has the two files). The lib/firmware/ most likely doesn't exist yet, just make it.
+
If the modem is being detected correctly and the firmware is loading, you should see something like the following in dmesg:
 
+
Make sure that the kernel supports firmware loading:
+
$ zcat /proc/config.gz || grep FW_LOADER
+
 
+
should tell that. The default Arch kernel is ok.
+
 
+
Now reboot and pray that it works. In dmesg you'll get something like the following if everything goes alright:
+
  
 
<pre>
 
<pre>
Line 147: Line 124:
 
</pre>
 
</pre>
  
And the content of the /tmp/bla file should be something like:
+
pppd output in /var/log/messages should look something like:
  
 
<pre>
 
<pre>
Line 161: Line 138:
 
primary  DNS address 195.121.1.34
 
primary  DNS address 195.121.1.34
 
secondary DNS address 195.121.1.66
 
secondary DNS address 195.121.1.66
--- 363 ---
 
/devices/pci0000:00/0000:00:02.1/usb2/2-1/2-1:1.2
 
 
</pre>
 
</pre>
 +
 +
If you are having problems you can check pppd debug messages by adding '''debug''' to /etc/ppp/peers/speedtch.  This can help identify authentication problems (e.g. pap vs chap auth), etc.  Otherwise make sure you check your VPI/VCI settings!
  
 
----
 
----
For the origin of this doc, feedback or requests go to the [http://bbs.archlinux.org/viewtopic.php?p=80638 Forum discussion]
+
For the origin of this doc, feedback or requests go to the [https://bbs.archlinux.org/viewtopic.php?p=80638 Forum discussion]

Revision as of 15:18, 17 August 2013


Introduction

This howto shows one way to get a working speedtouch USB modem. It uses the kernel driver, not the userspace driver. This howto assumes that your ISP uses PPPoA and not PPPoE. For info about PPPoE with these modems see first url below.

Important sites where most info comes from:

If the below instructions are not enough to get it working, then read the above sites.

The following steps are needed to get the modem working:

Kernel config and ppp

Make sure you have a kernel with the proper support (at least the modules ppp_generic, pppoatm, slhc, atm, usbatm and speedtch). The default Arch kernel should work.

Otherwise make sure that your kernel supports firmware loading:

$ zgrep FW_LOADER /proc/config.gz 

Install ppp: pacman -S ppp

The Arch Way

netcfg

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: netcfg has been superseded by netctl, but there is no package like netctl-pppoa. In fact, this is the only page on ArchWiki mentioning pppoa. (Discuss in Talk:DSL SpeedTouch modem#)

Install the package netcfg-pppoaAUR.

Now configure the connection. We'll put it in /etc/network.d/adsl:

CONNECTION='pppoa'
DESCRIPTION='ADSL connection'
INTERFACE='ppp0'
USER='username'
PASSWORD='password'
PPPOA_VPI=8
PPPOA_VCI=48

# This causes pppd to reconnect if the link goes down
LCP_ECHO_INTERVAL=15
LCP_ECHO_FAILURE=10

You should now be able to connect by calling netcfg adsl. For more details, see the netcfg wiki page.

The manual way

Configuring pppd

###  /etc/ppp/peers/speedtch

# To connect to using this configuration file, do
#       pppd call speedtch

lcp-echo-interval 10
lcp-echo-failure 10
noipdefault
defaultroute
user "username@ispname"
noauth
noaccomp
nopcomp
noccp
novj
holdoff 4
persist
maxfail 25
updetach
usepeerdns
plugin pppoatm.so
# Following entry is country/ISP dependent
8.48

The last entry depends on your country/ISP and is created from the VPI and VCI setting in the format VPI.VCI. This page has a VPI / VCI Setting List.

You also need to configure /etc/ppp/pap-secrets or chap-secrets, depending on your ISP. pap-secrets files are of the format:

# Secrets for authentication using PAP
# client        server  secret		IP addresses
"ISP-Username"	*	ISP-password	*

See The PAP/CHAP secrets file for more details.

If you want to use the DNS servers provided by your ISP (you probably do!) then make a symlink /etc/resolv.conf pointing to /etc/ppp/resolv.conf:

cd etc
rm resolv.conf
ln -s ppp/resolv.conf resolv.conf

Configure udev

Make a file /etc/udev/rules.d/99-speedtouch.rules and put something like the following in it:

ACTION=="add", SUBSYSTEM=="atm", KERNEL=="speedtch*", RUN="/usr/bin/pppd call speedtch"

With this Udev will start pppd automatically, if you do not want this you can simply bring up your modem using

pppd call speedtch

Firmware

Now you have everything except the firmware loading. The easiest way is to let udev do it. Download rev4fw.zip (note disclaimer here) and unzip it. It contains two files, a small one and a big one. Copy the small file to /usr/lib/firmware/speedtch-1.bin and the big one to /usr/lib/firmware/speedtch-2.bin

# mkdir -p /usr/lib/firmware
# cp small_file /usr/lib/firmware/speedtch-1.bin
# cp large_file /usr/lib/firmware/speedtch-2.bin

If you cannot download this file then follow the instructions of the second link above and use the firmware extractor (or download another firmware which has the two files).

Troubleshooting

If the modem is being detected correctly and the firmware is loading, you should see something like the following in dmesg:

usbcore: registered new driver speedtch
usb 1-1: found stage 1 firmware speedtch-1.bin
CSLIP: code copyright 1989 Regents of the University of California
PPP generic driver version 2.4.2
usb 1-1: found stage 2 firmware speedtch-2.bin
ip_tables: (C) 2000-2002 Netfilter core team
ADSL line is synchronising
DSL line goes up
ADSL line is up (800 Kib/s down || 256 Kib/s up)

pppd output in /var/log/messages should look something like:

Plugin pppoatm.so loaded.
PPPoATM plugin_init
PPPoATM setdevname - remove unwanted options
PPPoATM setdevname_pppoatm - SUCCESS:8.48
Using interface ppp0
Connect: ppp0 <--> 8.48
PAP authentication succeeded
local  IP address 123.45.67.89
remote IP address 195.190.249.10
primary   DNS address 195.121.1.34
secondary DNS address 195.121.1.66

If you are having problems you can check pppd debug messages by adding debug to /etc/ppp/peers/speedtch. This can help identify authentication problems (e.g. pap vs chap auth), etc. Otherwise make sure you check your VPI/VCI settings!


For the origin of this doc, feedback or requests go to the Forum discussion