HARDWARE_ueagle-atm

ueagle-atm is the new driver that comes with the kernel till 2.6.15 It deprecates eagle-usb which is driver for the same purpose at the userspace.

Supported Modems

The following modems has been verified to work with this driver

• SAGEM F800
• SAGEM F@st 840
• U.S. Robotics SureConnect ADSL USB Modem 9000

Short Description

The modems of this kind, comes with a small processor and a small ram. When you plug the modem it is useless until the driver uploads it a firmware (a small program that the modem's processor will run). After that, the modem will be ready to connect at the DSL network.

Install

To make the modem full operation you have to do the followings:

• Compile the ueagle-atm driver of kernel, so it can "speak" with the modem
• Install the firmware of the modem at a way that driver will find it and upload at the mode.
• Configure a PPP connection to get internet from ISP

The driver of modem comes with kernel, all you have to do is select it.

Configure Kernel

To enable support of the eagle modems you must compile the driver at the kernel. For more info on how to mess with the kernel there is an excelent guide: Kernel

• Enter in the directory of kernel source

cd /usr/src/linux

• Enter in kconfig

make menuconfig

Enable the support of ATM

Networking --->
 Networking Options --->
  <M> Asynchronous Transfer Mode (ATM) (EXPERIMENTAL)

Enable the support for ppp networking and PPPoA

Device Drivers --->
 Network device support --->
  <*> PPP (point-to-point protocol) support             
  [ ]   PPP multilink support (EXPERIMENTAL)            
  [ ]   PPP filtering                                   
  <M>   PPP support for async serial ports              
  <M>   PPP support for sync tty ports                  
  <M>   PPP Deflate compression                         
  <M>   PPP BSD-Compress compression                    
  < >   PPP MPPE compression (encryption) (EXPERIMENTAL)
  <M>   PPP over Ethernet (EXPERIMENTAL)                
  <M>   PPP over ATM                                    

Finally we select the driver of the modem

Device Drivers --->
 USB support --->
  <M> USB DSL modem support              
  < >   Speedtouch USB support           
  < >   Conexant AccessRunner USB support
  <M>   ADI 930 and eagle USB DSL modem  
  < >   Other USB DSL modem support      

At the end you have to compile kernel with new changes and install modules and kernel

Compile kernel

make

Install modules

make modules_install

Install kernel image (there are many ways to do it, so feel free to do it your way)

make install

Restart and continue guide..

Install firmware

Now that the modem is installed, you must install the firmware of modem. Fortunetly there is already a package of the non-free firmware of the modem and is called ueagle-atm (although it has the same name with the modules this is not the driver and cannot work without the driver descripted above)

emerge ueagle-atm

But for driver to find the firmware, the hotplug package must be installed

emerge hotplug

At this step we 'll test the driver.

• Load the module

depmod -a
modprobe ueagle-atm

• Plug the modem at the usb
• Check the log of the kernel

dmesg

You must something like:

[ueagle-atm] driver ueagle 1.3 loaded
usb 2-2: [ueagle-atm] ADSL device founded vid (0X1110) pid (0X9031) : Eagle III
usb 2-2: reset full speed USB device using uhci_hcd and address 2
usb 2-2: [ueagle-atm] using iso mode
usb 2-2: [ueagle-atm] (re)booting started
usbcore: registered new driver ueagle-atm
CSLIP: code copyright 1989 Regents of the University of California
PPP generic driver version 2.4.2
usb 2-2: [ueagle-atm] modem operational
usb 2-2: [ueagle-atm] ATU-R firmware version : 44e2ea17

In most cases, firmware installation is now completed successfully. However for some internet providers (mostly from Germany, Sweden, Czech Republic, Italy, Spain and Switzerland) special firmware files are needed. If this is the case, you will have symptoms with the DSP or CMV firmware such as that the modem can't synchronize the line and some modem diodes blink but there is no connection. If you have this problem after loading the driver, please follow the instructions found at http://atm.eagle-usb.org/wakka.php?wiki=UeagleAtmDoc

To make automate the load of the driver add the following lines at /etc/modules.autoload.d/kernel-2.6

# Eagle modem
ueagle-atm

Configure Connection to ISP

According to your ISP and country there are various ways to connect with your ISP, BUT you cannot select one you must follow your ISP's one. Because I have only tried PPPoATM I will only explaing this one.

Connect with PPP over ATM

First you need the ppp package with plugin 'pppoatm'

USE="atm" emerge ppp

To connect you must know the following info from your ISP

• username@isp_domain
• password
• VPI/VCI

They can be found on this page : http://www.eagle-usb.org/article.php3?id_article=23

Open the network configuration file

config_ppp0=( "ppp" )  # Runs /lib/rcscripts/net/pppd.sh
# This is encouraged to be NULL for PPPoAtm connections
link_ppp0=( "/dev/null" )
# The 2 numbers represent the VPI & VCI of your ISP, and they are separated
# by a dot. Ask your ISP about those numbers.
plugins_ppp0=( "pppoa 8.35" )
# 'man pppd' shows other options. Compression is disabled because it is
# rarely taken advantage of, and may interfere with the connection.
# Add option 'usepeerdns' to populate /etc/resolv.conf
#pppd_ppp0=( updetach noauth debug defaultroute noaccomp nobsdcomp noccp
#        nodeflate nopcomp novj novjccomp child-timeout 60 )
pppd_ppp0=(
       "updetach"      # WARNING: If you don't specify this then we will
#                       # not wait for the actual PPP link to go up
#       "maxfail 0"     # WARNING: It's not recommended you use change this
#                       # if you don't specify maxfail then we assume 0
       "debug"         # Enables syslog debugging
       "noauth"        # Do not require the peer to authenticate itself
       "defaultroute"  # Make this PPP interface the default route
       "usepeerdns"    # Use the DNS settings provided by PPP
)

username_ppp0='myusername@ispdomain'      # ADSL login, assigned by your ISP
password_ppp0='mypassword'                # ADSL password, assigned by your ISP

Now that you have configured the ppp0 interface create the script that will handle it

ln -s /etc/init.d/net.lo /etc/init.d/net.ppp0

Connect with PPPoE

First you need the ppp package and RFC2684 bridge control utils

emerge br2684ctl ppp

To connect you must know the following info from your ISP

• username@isp_domain
• password
• VPI/VCI

They can be found on this page : http://www.eagle-usb.org/article.php3?id_article=23

Open the network configuration file

# Configure first the RFC2684 bridge interface
config_nas0=( null )
# Use "-e 0" for LLC mux or "-e 1" for VC mux.
# The 2 numbers after "-a" represent the VPI & VCI of your ISP, and
# they are separated by a dot. Ask your ISP about those numbers.
br2684ctl_nas0="-e 0 -a 0.38"

config_ppp0=( ppp )  # Runs /lib/rcscripts/net/pppd.sh
link_ppp0='nas0' # The name of the RFC2684 bridge interface
plugins_ppp0=( 'pppoe' )
# 'man pppd' shows other options. Compression is disabled because it is
# rarely taken advantage of, and may interfere with the connection.
# Add option 'usepeerdns' to populate /etc/resolv.conf
pppd_ppp0=( updetach noauth debug defaultroute noaccomp nobsdcomp noccp
        nodeflate nopcomp novj novjccomp child-timeout 60 )
username_ppp0='username@isp.com'  # ADSL login, assigned by your ISP
password_ppp0='password'  # ADSL password, assigned by your ISP

depend_ppp0() {
    need net.nas0
}

# If the kernel modules are not built-in, then they must be loaded
# before starting the RFC2684 bridge: (anyway udev handles this in most cases)
function preup() {
        if [[ "$1" = "nas0" ]] ; then
                modprobe -q ueagle-atm
                return 0
        fi
}

Now that you have configured the ppp0 interface create the script that will handle it

ln -s net.lo /etc/init.d/net.ppp0
ln -s net.lo /etc/init.d/net.nas0

Edit: I had to remove /etc/conf.d/net.ppp0 for the script to pickup /etc/conf.d/net

Connect!

If everything went ok you will be able to start the connection by typing

/etc/init.d/net.ppp0 start

To connect automatically when the pc boots up add the script at the default runlevel

rc-update add net.ppp0 default