Launchpad Entry: https://launchpad.net/distros/ubuntu/+spec/usb-adsl-modems
Created: 2006-05-22 by Pandisv
Packages affected: network-admin
This specification aims to make the use of USB ADSL modems with Ubuntu a painless procedure. Such modems usually require the use of non-free firmware. We will attempt to make the firmware installation and modem operation as easy as possible.
Because people like their stuff to work without resorting to the command line :).
- USB Adsl modems are quite common in Europe. I know for one thing that Speedtouch and Accessrunners are popular in Spain, Greece and Poland. Many variants of these modems exist.
- If you have to go through an ISP signup process (1. temporary username/password; 2. visit isp webpage to enter some details etc.; 3. get proper username/password from isp webpage and configure them) you must use the livecd.
- Ensure that the following software is properly packaged and in feisty main, including in udebs as appropriate:
GPL'd Conexant Accessrunner driver: http://sourceforge.net/cvs/?group_id=47406
- Hasn't this been included in the kernel since 2.6.12ish ?
- Yes. We don't need to package this. (Pandisv)
- Hasn't this been included in the kernel since 2.6.12ish ?
Conexant Accessrunner firmware extractor: http://dc.ubuntu-us.org/archive/packages.php?package=cxacrufw&repo=dapper (packaging there is by Nicholas Wheeler), http://accessrunner.sourceforge.net/firmware.shtml (script from Pandisv)
Speedtouch firmware (in restricted): http://www.speedtouch.co.uk/330.asp, select "Windows Driver", "extended reach" driver, now available without onerous restrictions. The directory Bin/ contains firmware blobs for version 1 modems, while Bin/SACHU3/ has firmware blobs for version 2 modems (speedtouch 330). Failing suitably licensed downloads, we can get it from the CD).
Eagle USB kernel driver and utilities (ueagle-atm): http://download.gna.org/ueagleatm/ueagle-atm-1.3.tar.gz
- This is now in the upstream kernel, packaging shouldn't be needed (since 2.6.16 I think) - Pandisv
Eagle USB firmware (from ueagle-atm): http://eagle-usb.org/ueagle-atm/non-free/
- Pieces missing:
- udev rules for usb modem devices which determine whether the firmware is already loaded and load it if appropriate, and then run pppd appropriately
- generalised script for finding appropriate firmware on cd, running the right extraction tool, and storing the firmware in /lib/firmware
- modem-independent interface for setting atm parameters etc.
- network-admin options for
- extracting firmware from the supplied cd (using script mentioned above)
- configuring username, password, and atm parameters (see above)
- KDE network admin options for the same
- ubiquity should be sure to copy all of the relevant network setup including any firmware extracted from cds
- Pieces we may want to reuse parts of or fall back on:
Google SoC 2006 Fedora project for "PPP dialup connections (including Modem, ISDN, DSL, GPRS via Bluetooth and mobile)" in NetworkManager: http://fedoraproject.org/wiki/SummerOfCode/2006/TimNiemueller
Aurox (Polish Linux distr'n) ADSL manager: http://aurox.org/adsl-manager/. In Polish, licence: GPL.
NeoGui - Graphical tool for configuration of Neostrada (Polish ISP using many ADSL modems). Tool is split into backend and frontend, frontend currently is implemented only for Qt, but it should be possible to implement it in Gtk. Implemented in Python. Webpage (in Polish): http://lichota.net/~krzysiek/projects/neogui/ . Latest version to download: http://lichota.net/~krzysiek/projects/neogui/neogui-0.3.1.tgz . Fully i18n-ed, Polish .po file supplied. Licence: GPLv2.
UbuDSL - GUI configuration tool for ADSL modems. Available in Polish, English, French, Russian and other languages. Works with Sagem, Speedtouch, Unicorn, ZXDSL and probably other modems. License: GPL. Written in Qt. Distributes firmware for some modems. Project freezed, latest version for Ubuntu 9.04. http://ubudsl.com
USB ADSL Modem Manager - written in Python. https://edge.launchpad.net/usb-adsl-modem-manager http://www.squeezedonkey.com/wiki/linux/index.php?title=Main_Page
https://launchpad.net/bugs/24355 (reporting that eagle-usb in dapper is broken and old) needs to be marked closed.
It is possible that not all of the functionality can be completely implemented and/or sufficiently debugged for feisty. In this case, subsets of the new functionality will be disabled, as follows:
Subsets which might reasonably be disabled:
- network-admin glue (remove the relevant UI elements); if this is removed, then the other parts may be left functional or semi-functional for users who set it up via the command line
- network admin glue for KDE (as above)
- support for any particular modem (for each unsupported modem, disable the udev rules and the mapping/discovery for the firmware extractor)
- ubiquity proper copying of config and/or firmware (user can work around by redoing the network setup)
In general, we want each modem to either be supported properly via the UI or not at all, so that we don't leave the user with what looks like a half-baked answer.
NetworkManager on a machine with a DSL connection is a bad idea, probably. (Eg, it might try roaming between your DSL and some wireless.)
NetworkManager 0.7 will deal with this, allowing to have multiple connections at once.
Some additional useful notes from Warbo regarding the Eagle USB are at https://help.ubuntu.com/community/UsbAdslModem/EagleUsb and https://help.ubuntu.com/community/UsbAdslModem/ueagle-atm.
Sagem Fast 800 with Wanadoo from Spain and Dapper Flight 7, howto in Spanish: http://www.ubuntu-es.org/node/17125
Firmware extraction is at least obviously entirely moral if not distributed; we don't anticipate legal problems here.
Comment from Marcolinuxx:
I think it is very important including Eagle-Usb drivers into the kernel. In fact many people have a modem needing these drivers; in Ubuntu forums it is possible to find how to install them, but unfortunately it is difficult, so that some people go back to other operative systems. I think it is very easy including these drivers, giving a great help to many first time users.
I hope you will excuse me for my English... I am Italian.
Greetings from Italy to all of you.
Comment from email@example.com:
This is a hugely important project. Almost everyone I know connects to the internet via USB modems (so explaining that "USB is far from the ideal medium for network access" is just not good enough). I have tried for several days and failed to get my AccessRunner modem working in Ubuntu. So this is the main barrier to me starting to use Ubuntu seriously (not having access to the internet takes me back a decade in my computer usage). I don't think I'm alone in this: EasyUsbAdsl will do more to spread use of Ubuntu than anything else I've seen. (If anyone who has successfully connected with an AccessRunner modem could somehow navigate me through it, I'd be happy to spend some hours drafting decent beginner-proof documentation for it, at least as a temporary solution until EasyUsbAdsl is up and running.) Hi Pandisv: when do you think the "connect via USB modem" icon will be ready to click?
I think it should be resolved as quick as possible. I understand that usb modems are not the best medium to deliver broadband connections but ubuntu should make it as easy as possible to install these modems. Right now even if user gets the proper firmware and puts it in the right place he/she has to create custom scripts for pppd and init. When recognized, there should appear a new modem in network preferences waiting for firmware. User should type the password in the gui and choose the vpi and vci numbers from the list of countries/isps (it's not too long) or type them by himself. Now you have to alter some files in console in sudo what is definitely not convenient. If the problem with firmware extraction cannot be resolved, we should concentrate on making easier to setup the driver with firmware.