eagle-base Mandrake RPM Package Copyright (C) 2003 Albert Herranz 0. Disclaimer The information contained in this document is provided as is without any guarantees or warranty. Although the author has attempted to verify the correctness of the information provided, the author is not responsible for any damage or losses of any kind caused by the use or misuse of this information. The author is under no obligation to provide support, service, corrections, or upgrades to this documentation. 1. Introduction This document describes how to setup our PPPoE based ADSL connection in Mandrake Linux 9.1 with the Eagle driver rpm package. The configuration tested is the following: - Mandrake Linux 9.1 with kernel 2.4.21-0.13mdk - Kit ADSL USB (Comtrend CT-350) with dynamic IP address by Telefonica 2. Requirements Hardware o A computer with at least one USB port available o Your Eagle based ADSL USB Modem (like the Comtrend CT-350) Software o Mandrake Linux 9.1 with graphical desktop working o UHCI USB controller driver configured and running o drakxtools-newt package installed o eagle-driver Mandrake rpm package o kernel-module-eagle Mandrake rpm package for your kernel version(s) 3. Installation Please, unplug your ADSL USB modem from your computer for now. First, we need to install the eagle-driver and kernel-module-eagle packages. To install the eagle-driver package execute as superuser: # rpm -Uvh /your_rpms/eagle-driver-1.0.4-8mdk.mdk91.i586.rpm We need to install the kernel-module-eagle package that matches our Linux kernel version and processor. To see the running kernel version and processor just type: $ uname -r -p 2.4.21-0.13mdk unknown If the processor is unknown try with i586, the default target for Mandrake. To install the kernel-module-eagle package for kernel 2.4.21-0.13mdk on a i586 execute as superuser: # rpm -ivh /your_rpms/kernel-module-eagle-1.0.4-1mdk.mdk91_2.4.21_0.13mdk.i586.rpm Note that we used -i (install) instead of -U (upgrade) to install the kernel module. This will allow us to install more than one module if we have several kernel versions installed. The installation of the eagle-driver package configures a dummy ethernet interface in your system. It creates an additional ethX alias in /etc/modules.conf and the corresponding ifcfg-ethX configuration file in /etc/sysconfig/network-scripts. Although this is not really needed by the driver it is very useful if we want to use the standard Mandrake network configuration tool 'drakconnect' to configure our ADSL connection. The installation also saves in /usr/local/lib/adiusbadsl all versions of the adiusbadsl kernel module found in the target kernel modules tree and patches slightly the drakxtools-newt package to allow easy configuration of the ADI USB ADSL modem on a PPPoE environment. At this point, if we plug the ADSL USB modem it should get operational. If we look at /var/log/messages we will see messages like these: Sep 24 21:23:42 idle kernel: hub.c: new USB device 00:04.2-2, assigned address 3Sep 24 21:23:42 idle kernel: [adi] New pre-firmware modem detected Sep 24 21:23:42 idle kernel: [adi] Uploading firmware.. Sep 24 21:23:44 idle kernel: [adi] Binding Hardware to USB 001/003 Sep 24 21:23:44 idle kernel: usb.c: USB disconnect on device 00:04.2-2 address 3Sep 24 21:23:44 idle kernel: [adi] Modem removed Sep 24 21:23:46 idle kernel: hub.c: new USB device 00:04.2-2, assigned address 4Sep 24 21:23:47 idle kernel: [adi] New USB ADSL device detected, waiting for DSP code... Sep 24 21:23:47 idle kernel: [adi] created proc entry at : /proc/driver/adimodem/001-004 Sep 24 21:23:48 idle /etc/hotplug/usb.agent: Setup adiusbadsl for USB product 1110/9010/4000 Sep 24 21:23:49 idle /etc/hotplug/usb.agent: Setup adiusbfirmware for USB product 1110/9010/4000 Sep 24 21:23:49 idle /etc/hotplug/usb.agent: Module setup adiusbfirmware for USB product 1110/9010/4000 Sep 24 21:23:51 idle /etc/hotplug/usb.agent: Setup adiusbadsl acm for USB product 1110/900f/4004 Sep 24 21:23:52 idle /etc/hotplug/usb.agent: Setup adiusbdsp for USB product 1110/900f/4004 Sep 24 21:23:52 idle /etc/hotplug/usb.agent: Module setup adiusbdsp for USB product 1110/900f/4004 Sep 24 21:23:52 idle kernel: [adi] ioctl ADIUSBADSLOPTIONS received Sep 24 21:23:52 idle kernel: [adi] Reassembly buffer size set to 1536 Sep 24 21:23:52 idle kernel: [adi] ioctl ADIUSBADSLDSP received Sep 24 21:23:52 idle kernel: [adi] Loading DSP code to device... Sep 24 21:23:52 idle kernel: [adi] DSP code successfully loaded to device Sep 24 21:24:09 idle kernel: [adi] Modem operational !! Sep 24 21:24:09 idle kernel: [adi] Modem ethernet interface is 'eth1' (mtu 1500)Sep 24 21:24:09 idle /etc/hotplug/net.agent: invoke ifplugd eth1 Sep 24 21:24:09 idle ifplugd[2369]: Warning: Could not get interface address. Sep 24 21:24:09 idle ifplugd[2369]: Using interface eth1/00:30:DA:1E:1F:67 Sep 24 21:24:09 idle ifplugd[2369]: ETHTOOL_GLINK failed: Inappropriate ioctl for device Sep 24 21:24:09 idle ifplugd[2369]: SIOCGMIIPHY failed: Inappropriate ioctl for device Sep 24 21:24:09 idle ifplugd[2369]: SIOCDEVPRIVATE failed: Inappropriate ioctl for device Sep 24 21:24:09 idle ifplugd[2369]: Executing '/etc/ifplugd/ifplugd.action eth1 up'. Sep 24 21:24:11 idle ifplugd[2369]: Program executed successfully. Sep 24 21:24:11 idle ifplugd[2369]: Exit. 2. Configuration Once the ADSL USB modem is operational we need to create the necessary network configuration to use it. For this purpose we will use the 'drakconnect' tool which comes standard with Mandrake Linux. To launch the network configuration tool execute as superuser from a graphical desktop command line: # drakconnect We will see the "Network & Internet Configuration" dialog. Then, please, - In the "Welcome to The Network Configuration Wizard" - unset "Use autodetection" - press the "Next ->" button - In the "Choose the connection you want to configure" step, - select "ADSL connection" - press the "Next ->" button - In the "The most common way to connect with adsl is ..." step, - select "use pppoe" - press the "Next ->" button - In the "Please fill or check the field bellow" step, - enter a descriptive name for your provider (for example, Telefonica) - (do not enter dns info unless your provider asks you to) - enter the account login for this account (for example, adslppp@telefonicanetpa) - enter the account password for this account (for example, adslppp) - press the "Next ->" button - In the "Please choose which network adapter ..." step, - select the dummy ethernet interface created during the installation (it has the word adiusbadsl between parenthesis on the right) - press the "Next ->" button - In the "Do you want to start the connection at boot?" step, - choose Yes or No - press the "Next ->" button - In the "Do you want to try to connect to the Internet now?" step, - choose No (it is important to choose No now) - press the "Next ->" button - In the "Congratulations, the network and the ..." step, - press the "Finish" button At this point the necessary network configuration is created. Please, unplug and plug again your ADSL USB modem, and wait for the modem light to become stable again. You may use the "net_monitor" tool to activate your ADSL connection. The installation creates a menu icon called Network Monitor under Networking to make things easier. Just click on it, enter the root password and click on the Connect button (the one with the green planet and the yellow star). Or if you prefer, execute as root: # /etc/sysconfig/network-scripts/net_cnx_pg Hope this helps! Albert Herranz