[ Prev ] [ Index ] [ Next ]

adsl

Created Monday 29/5/2006

The following describes configuring PPP over ADSL within a Linux environment. There is a specific slant to Fedora Core and to configuring modems attached via usb and to the eagle-atm driver.

Warning: The eagle driver configuration refers to eagle-usb, which is now deprecated and replaced with the eagle-atm (see eagle-atm) Convention: Commands to be executed are indicated in fixed font as bash $ or bash #. The former is a non-privileged user action and the latter must be executed by a privileged user

1. Linux ADSL - PPPoE

Ensure that rp-pppoe is installed. The easiest way to do this in Fedora Core is to use yum

bash # yum install rp-pppoe

Another option is to download the relevent rpm and unstall with rpm(1). E.g.,

bash $ wget ftp://ftp.univie.ac.at/systems/linux/fedora/4/i386/os/Fedora/RPMS/rp-pppoe-3.5-27.i386.rpm 
bash # rpm -Uvh rp-pppoe-3.5-27.i386.rpm

After installation, configure the ppoe stack by running adsl-setup:

bash # adsl-setup

2. Linux ADSL via usb

For usb modems, the rpm's libusb, libusb-devel and usbutils must be installed. Again, the simplest option is yum:

bash # yum install libusb libusb-devel usbutils

Alternatively, download the rpms and install manually. E.g.,

bash $ wget http://wraptastic.org/pub/rawhide/packages/libusb-0.1.8-3.i386.rpm
bash $ wget http://wraptastic.org/pub/rawhide/packages/libusb-devel-0.1.8-3.i386.rpm
bash $ wget http://wraptastic.org/pub/rawhide/packages/usbutils-0.11-6.i386.rpm
bash # rpm -Uvh libusb-0.1.8-3.i386.rpm libusb-devel-0.1.8-3.i386.rpm usbutils-0.11-6.i386.rpm

3. SAGEM 800 E2 usb modem

The eagle usb drivers support the Sagem 800 E2 modem. There is a wiki with quite a bit of doco at dev.eagle-usb.org

3.A. Ensure kernel headers are installed

Note: glibc-kernheaders only required for older Fedora installations, prior to FC5

The eagle usb driver is delivered as a tarball, which needs to be compiled. To do this the kernel headers must be installed. Check to see if these are installed:

bash $ rpm -aq | egrep 'glibc-kernheaders|kernel-devel'

And install if not:

bash # yum install glibc-kernheaders kernel-devel

3.B. Get the eagle usb driver source

Go grab then compile and install the "eagle-usb" drivers (also need modules from #1 and #2). The eagle driver is delivered as an tarball. E.g., to compile and install the 2.1.1 version:

bash $ wget http://baud123.free.fr/eagle-usb/eagle-usb-2.1.0/eagle-usb-2.1.1.tar.bz2
bash $ tar jxvf eagle-usb-2.1.1.tar.bz2
bash $ cd eagle-usb-2.1.1
bash $ ./configure
bash $ make
bash # make install

3.C. Configure the modem properties

The Eagle configuration sets the parameters for the modem. This is none with the eagleconfig script. This will ask a few questions and install config to /etc/eagle-usb. The userid, password, load-at-boot and the PPPoA or PPPoE options will be configured. The configuration of PPPoA/E, encapsulation, VCI and VPI are all based on a predefined set. E.g., for Telecomunicja Polska, the code PL01 is entered and this defines PPPoA, VPI=0, VCI=0x23.

3.D. Loading the Sagem 800 E2 modem driver

The sagem 800 E3 modem driver can be loaded with the eaglectrl command

bash # eaglectrl -d
bash # eaglectrl -w

3.E. Display the ppp interface

The eagleconfig script should also have installed some modem and device management scripts. These are installed to /usr/local/sbin by default, but the location is system depenent and may be different for your environent.

3.E.1 Check that the eagle usb driver is loaded

Use lsmod(8) to determine if the eagle-usb driver is loaded

bash # lsmod | grep eagle_usb
eagle_usb

3.E.2 Load the device config to the modem

bash # eaglectl -d;eaglectl -w;

3.E.3 Bringing up the ppp interface

bash # startadsl

3.E.4 Shutting down the ppp interface

bash # stopadsl

4. ADSL status:

Optional: Not actually required for installation

To determine the current status of the eagle driver connection:

bash $ eaglestat
bash $ ifconfig ppp0 (or ifconfig -a)

The eaglediag script can be run to gather more complete diagnostics. If run as root, the results are written to /var/log/eagle-usb/yyyymmddhhmmss.txt, If run as non-priviledged user, the diagnostic file is written to $HOME/.eagle-usb

bash # eaglediag -mscui

The meaning of the options are:

-m = diagnose any compilation issues
-s = diagnose modem synchronization issues
-c = diagnose connect problems (ifconfig and route issues)
-u = check for usb related issues (latency)
-i = check interupt problems

5. Eagle USB from CVS

Optional: Not actually required for installation

The eagle-usb source is available via anonymous cvs using pserver at (no password required, press enter at prompt):

bash $ cvs -d:pserver:anonymous@cvs.gna.org:/cvs/eagleusb co eagleusb

Note, that the sourceforge site is no longer used. The new cvs repository, docs, bug management, mailing lits and etc. are now managed at:

https://gna.org/projects/eagleusb

Backlinks: :eagle-atm