We assume here that you want to connect your LEAF router to the Internet via a Speedtouch USB modem. The Alcatel SpeedTouch USB modem is one of a very few non-ethernet modems with Linux drivers. This modem is quite popular in Europe (Alcatel's home turf), and is widely used elsewhere as well. See the appendix of the DSL How-To for background information.

The Speedtouch USB How-to and FAQ, the PPP-Howto and the DSL-Howto are useful references for this section.

The following setup has been tested by Matthew Pozzi, who gets connected to the XX DSL service in Australia.

Thanks to Matthew for his patience in testing!

Comments on this section should be addressed to its maintainer: Jacques Nilo <jnilo at users.sourceforge.net>.

In order to be able to get connected through Alcatel Speedtouch USB you will need to install on your floppy the speedtch.lrp package which will provide the latest (1.2-beta1) driver devlopped by B. Papillaud and alii.

Boot your Bering floppy image. Once the LEAF menu appears get access to the linux shell by (q)uitting the menu. Edit the syslinux.cfg file and REPLACE the pump entry by [ppp,speedtch] in the LRP= list of packages to be loaded at boot. Check the Bering installation guide to learn how to do that.

Your syslinux.cfg file will then look like (adjust to your tastes):

display syslinux.dpy
timeout 0
default linux initrd=initrd.lrp init=/linuxrc rw root=/dev/ram0 boot=/dev/fd0u1680:msdos
	PKGPATH=/dev/fd0u1680 LRP=root,etc,local,modules,iptables,ppp,speedtch,keyboard,shorwall,ulogd,dnscache,weblet

The speedtch.lrp package is available here. The ppp.lrp package is available on the Bering standard floppy.

In order to have your modem working you need to copy in your /lib/module directory the following set of modules:

To declare your modules, go to the LEAF Packages configuration menu and choose modules. Enter 1) to edit the /etc/modules file and enter the following information:

# 8390 based ethernet cards
8390
ne2k-pci

# Modules needed for PPP connection
slhc
n_hdlc
ppp_generic
ppp_synctty

# USB support
usbcore
# Choose one of the two below
#usb-uhci
usb-ohci

# Masquerading 'helper' modules
ip_conntrack_ftp
ip_conntrack_irc
ip_nat_ftp
ip_nat_irc

Backup the modules.lrp package.

Through the LEAF packages configuration menu get access to speedtch configuration. The following menu will show-up:

                        LEAF configuration menu



                        speedtch configuration files

        1) adsl peers script

  q) quit
  ----------------------------------------------------------------------------
        Selection:

Enter 1) and adjust the corresponding /etc/ppp/peers/adsl file:

#
# This file could be rename but its place is under /etc/ppp/peers
# To connect to Internet using this configuration file
# pppd call adsl, where "adsl" stands for the name of this file
#

debug
kdebug 1
noipdefault
defaultroute
pty "/usr/sbin/pppoa3 -m 1 -c -vpi 8 -vci 35"
sync
user "your_login_here"
noauth
noaccomp
nopcomp
noccp
novj
holdoff 4
persist
maxfail 25

The most important parameters in this file are the vpi/vci combination which depends on your country and your ISP "user" parameter.

Once your parameters are correct, save the speedtch.lrp package!

Then move to the ppp configuration menu:

                        ppp configuration files

        1) ISP pppd options
        2) ISP login script
        3) System wide pppd options
        4) chap secret
        5) pap secret
        6) pppd daemon script

  q) quit
  ----------------------------------------------------------------------------
        Selection:

Edit the pppd options file (entry 3) which should have a single line:

lock

Edit either the chap (Entry 4) or pap (Entry 5) option to set up how your system authenticates. If you edit chap, replace #ISPUserID and ISPUserPassword this the relevant information.

# Secrets for authentication using CHAP
# client        server  secret                  IP addresses
#ISPUserID      *       ISPUserPassword

ISPUserID must exactly match the entry that you made for the user parameter in the "adsl peers script" file. The "*" can be replaced with the IP address or name of the server you are dialling into if you know it. Usually, an asterisk is sufficient.

If you want to authenticate using PAP, add the same entry to the PAP item instead.

Backup the ppp.lrp package.

Trough the LEAF configuration menu type 1 to access to the network configuration menu and 1 again to edit your /etc/network/interfaces file. Enter the following information:

# Loopback interface.
auto lo
iface lo inet loopback

# Declare the external (ppp) interface
auto ppp0
iface ppp0 inet ppp
	pre-up mount none /proc/bus/usb -t usbdevfs
	pre-up sleep 2
	pre-up modem_run -f /lib/modules/mgmt.o -m
	pre-up sleep 1
	provider adsl

# Declare the internal interface
# Default: eth0 / fixed IP = 192.168.1.254
auto eth0
iface eth0 inet static
	address 192.168.1.254
	masklen 24
	broadcast 192.168.1.255

In this /etc/network/interfaces file the lo, ppp0 and eth0 interfaces are brought up automatically when the ifup -a statement is executed at boot time by the /etc/init.d/networking script.

The "iface ppp0 inet ppp" section defines the external address of the router and activates the pon script.

The "iface eth0 inet static" defines the internal address of the router.

Backup the etc.lrp package.

Through the LEAF packages configuration menu, choose shorwall and check the three following files:

A/ The interfaces file (entry 3) defines your interfaces. Here connection to the net goes through ppp0. So we must set:

(...)
#ZONE   INTERFACE       BROADCAST       OPTIONS
net     ppp0            -
loc     eth0            detect
#LAST LINE -- ADD YOUR ENTRIES BEFORE THIS ONE -- DO NOT REMOVE

B/ The masq file (entry 8). It should look like:

(...)
#INTERFACE              SUBNET
ppp0                    eth0
#LAST LINE -- ADD YOUR ENTRIES ABOVE THIS LINE -- DO NOT REMOVE

Backup the shorwall.lrp package.

Your PPP connection should be established automatically. Type plog to check the login sequence with your ISP. If there is no output check /var/log/syslog to get a clue on potential problems.