Ceci est une ancienne révision du document !
Pilote ueagle-atm pour le modem Sagem F@ST 800 sous Dapper
Introduction
Pour faire fonctionner le modem Sagem F@ST 800 sous Dapper, il est fortement conseillé d'utiliser le driver ueagle-atm. Attention, la version installée en standard ne fonctionne pas.
L'utilisation du driver ueagle-atm peut être étendu aux versions d'Ubuntu dont la version du noyau est supérieure à 2.6.10 comme recommandé sur le site eagleusb : http://atm.eagle-usb.org/wakka.php?wiki=PagePrincipale
Il est cependant possible de continuer à utiliser le pilote eagle-usb si celui-ci a été installé pour Ubuntu 5.10 "breezy" et que vous avez procédé à la mise à jour par le web vers "dapper". Attention cette possibilité est inconfortable (le modem ne s'initialise plus seul, la connection ne se lance plus seule, le modem ne s'arrête plus…) mais peut dépanner lorsqu'on n'a pas fini de migrer. Si vous êtes intéréssé par un système "à jour" vous ne devriez pas utiliser cette possibilité.
Certains liveCD comme Kaella 2.1 reconnaissent nativement modem Sagem FAST 800. Pourquoi ne pas graver un cd, au cas ou?
ATTENTION : Dans le cas d'un modem F@ST 800 E4, il est inutile d'aller plus loin, car pour le moment ce modem n'est pas du tout pris en charge sous Linux, toutes distributions confondues. Pour s'assurer que l'on ne se trouve pas dans ce cas défavorable, il suffit d'examiner l'étiquette au dos du modem..
Installation automatisée
Première méthode
N.B. : Cette première méthode est expérimentale au sens où elle semble marcher mais n'a encore été testée que par quelques personnes, l'auteur serait donc gréé à toute personne l'utilisant de faire un bref compte rendu de sa tentative – réussié ou non – d'installation sur le forum : http://forum.ubuntu-fr.org/viewtopic.php?id=85242.
Installation graphique en quelques clics.
Télécharger, rapatrier – avec une disquette, clef USB, CD, … – et installer – en double cliquant dessus – les deux paquets suivants :
Un raccourci est alors créé dans Système → Administration → Internet ADSL qui vous permet d'installer votre modem en quelques clics.
Ancienne version pour Dapper (en un seul paquet) : http://perso.orange.fr/j.m.e/installemodem_0.0.1-0ubuntu7_i386.deb.
OU
Deuxième méthode
methode (deuxième méthode)
- Décompressez alors l'archive pour l'installation, et placez l'archive contenant le firmware dans le dossier de l'installation.
- Lancez alors install.sh en double-cliquant dessus, puis en choisissant l'option Lancer.
- Suivez les indications à l'écran
Vous avez utilisé ce script ? Alors merci de faire part de vos retours sur la discussion suivante du forum (problèmes et/ou commentaires).
Limitations connues (deuxième méthode)
- La partie pour configurer les paramètres de la connexion n'est pas adaptée à free dégroupé (devrait changer).
- La connection n'est pas effectuée au démarrage ou au branchement. Il faut lancer la commande $ pppd call ueagle-atm à chaque fois (devrait changer).
- Nécessite l'outil zenity qui n'est installé que sur Ubuntu. Les utilisateurs de Kunbuntu peuvent me donner des informations sur un outils précu pour KDE sur le forum.
- Il faut relancer le script lors d'une mise à jour du noyau (problème commun à tous les modules rajoutés par l'utilisateur)
Installation manuelle
Méthode d'installation résumée
Il faut commencer par supprimer toutes traces du pilote eagle-usb, qui est l'ancien pilote et qui ne va plus être supporté dans les noyaux à venir, et de la bibliothèque usbatm. Note : le signe $ ne doit jamais être tapé sur la console.
Pour connaître la version de votre noyau actuel:
uname -r
Avant toute compilation, assurez vous d'avoir installé les sources de votre noyau, Il faut installer la même version que celui de votre noyau actuel:
apt-get install linux-image linux-headers
Ensuite, télécharger le driver sur ueagle-svn. (ueagle-atm à télécharger)
Puis compiler et installer le driver ueagle-atm et la bibliothèque usbatm par
tar -zxvf ueagle-atm-x.y.tar.gz cd ueagle-x.y/ make sudo make install
Puis suivre le tutorial ueagle-atm-doc, qui va vous expliquer comment installer les firmwares usuels.
Enfin, la configuration de la connexion internet en soi est bien expliquée dans le tutorial Fedora France.
Méthode d'installation détaillée
1ère étape : Téléchargement des fichiers
Il vous faut, au préalable, télécharger et enregistrer sur le disque dur ou un CD les fichiers suivants :
- ueagle-atm-1.3.tar.gz que vous trouverez soit ici http://download.gna.org/ueagleatm/ (téléchargement possible à partir de tout SE)
soit sur un serveur svn en tapant la ligne de commande
$ svn co svn://svn.gna.org/svn/ueagleatm/trunk/ueagle-atm ueagle-atm
(cela suppose que vous êtes sous Ubuntu dans une version antérieure à Dapper et que votre connexion internet fonctionne)
- ueagle-data-1.1.tar.gz ici : http://eagle-usb.org/ueagle-atm/non-free/
2ème étape : Désinstallation des modules eagle-usb et usbatm préinstallé
Lors de l'installation de Dapper, le modem étant branché, des modules ont été installés, mais ils ne fonctionnent pas. Pour en être sûr, taper :
$sudo lsmod | grep eagle
Si le terminal retourne quelque chose, il faut désinstaller les modules eagle-usb par :
$sudo modprobe -r eagle-usb
Rechercher usbatm.ko et eagle-usb.ko (il y a 4 noyaux disponibles sur cet exemple):
$locate eagle-usb.ko /lib/modules/2.6.15-21-386/kernel/drivers/usb/net/eagle/eagle-usb.ko /lib/modules/2.6.15-25-k7/kernel/drivers/usb/net/eagle/eagle-usb.ko /lib/modules/2.6.15-23-k7/kernel/drivers/usb/net/eagle/eagle-usb.ko /lib/modules/2.6.15-26-k7/kernel/drivers/usb/net/eagle/eagle-usb.ko
Puis effacer de la mémoire les fichiers usbatm.ko et eagleusb.ko de la façon suivante, à adapter en fonction de vos résultats.
$sudo rm /lib/modules/`uname -r`/kernel/drivers/usb/atm/usbatm.ko $sudo rm /lib/modules/`uname -r`/kernel/drivers/usb/net/eagle/eagle-usb.ko
Il peut être intéressant de garder intacte une configuration fonctionnelle sur les noyaux précédents inutilisés. Actuellement cette possibilité n'est pas documentée.
3ème étape : Préparation de la compilation des sources du pilote
Via le gestionnaire de paquets Synaptic
Normalement il suffit d'insérer le cdrom live de Dapper et une boîte de dialogue va apparaître demandant si l'on désire lancer le gestionnaire de paquets. Cliquer sur OK.
Si l'exécution automatique ne marche pas, vous pouvez aussi faire : Système > Administration > Gestionnaire de paquets Synaptic Puis "Édition > Ajouter un CD-ROM" pour ajouter le CD-ROM comme source de paquets.
Cherchez via Ctrl + F les paquets suivants :
- gcc
- make
- build-essential
Cochez la case. Synaptic vous demandera si vous voulez aussi ajouter certaines dépendances. Acceptez. Cliquez sur "Appliquer".
Il nous reste un dernier paquet à installer, mais il vous faut connaître la version de votre noyau. Ouvrez un terminal (mais ne quittez pas Synaptic) et tapez :
$uname -r
Le terminal vous repond quelque chose comme :
$2.6.15-21-386
Il se peut que la version de votre noyau ne soit pas 2.6.15-21-386 mais une autre déclinaison. Si tel est le cas, chaque fois que vous verrez 2.6.15-21-386 dans ce tuto, vous devrez le remplacer par la version de votre noyau à vous ;)
Retournez dans Synaptic et installez (comme pour les autre paquets) :
- linux-headers-2.6.15-21-386
Ou via le terminal
On ajoute le CD-ROM d'installation d'Ubuntu comme source de paquets (le CD-ROM doit être inséré dans le lecteur de CD-ROM afin que la commande fonctionne) :
$sudo apt-cdrom add /media/cdrom
On lance l'installation des modules nécessaire à la compilation par :
$sudo apt-get install gcc make build-essential linux-headers-`uname -r`
4ème étape : Compilation et Installation
DEBRANCHEZ VOTRE MODEM de façon à vider la mémoire.
le pilote
L'installation du pilote se fait en décompressant et compilant l'archive ueagle-atm-1.3.tar.gz de la façon suivante :
$cp /làoùsetrouvelefichier/ueagle-atm-1.3.tar.gz /tmp && cd /tmp $tar -zxvf ueagle-atm-1.3.tar.gz $cd ueagle-atm-1.3 $sudo make $sudo make install
Si vous listez le dossier /lib/modules/2.6.15-21-386/extra ; vous devrez trouver les fichiers usbatm.ko et ueagle-atm.ko :
$ls /lib/modules/`uname -r`/extra
les Firmwares
L'installation des Firmwares se fait de la façon suivante :
Décompression de l'archive ueagle-data-1.1.tar.gz
$cp /làoùsetrouvelefichier/ueagle-data-1.1.tar.gz /tmp && cd /tmp $tar -zxvf ueagle-data-1.1.tar.gz
Création du répertoire /lib/firmware/ueagle-atm et copie des modules
$sudo mkdir /lib/firmware/ueagle-atm $cd ueagle-data-1.1 $sudo cp -a * /lib/firmware/ueagle-atm
Pour la plupart des FAI (Fournisseurs D'Accès Internet), l'installation des Firmwares ne pose pas de problèmes, cependant, si vous rencontrez des difficultés à ce niveau, jetez un oeil ici : http://atm.eagle-usb.org/wakka.php?wiki=UeagleAtmDoc Exemple : pour Wanadoo/Orange en France, 8.35
REBRANCHEZ VOTRE MODEM
5ème étape : la première synchronisation
Lancez :
$sudo modprobe ueagle-atm
Ca clignote et les deux diodes s'allument, cool : GAGNÉ. Pour en être sûr, entrez :
$dmesg | grep ueagle
Vous devriez avoir quelque chose comme :
[4294707.683000] usb 1-1: [ueagle-atm] modem operational [4294707.691000] usb 1-1: [ueagle-atm] ATU-R firmware version : 44e2ea17
Si vous avez des problèmes à ce niveau, éditez via gedit le fichier README que vous trouverez dans le répertoire /tmp/ueagle-atm-1.3
A l'issue de cette étape, le pilote ueagle-atm a été installé avec succès.
Si vous êtes utilisateur de Free et que vous êtes en zone dégroupée, allez directement à ce paragraphe.
6ème étape : Paramétrage de l'identifiant et du mot de passe
Le Fournisseur d'Accès Internet (feu-Wanadoo, Free, Alice, le 9…) a fourni les indications (fictives) suivantes :
Votre identifiant de connexion: meuh
Votre mot de passe de connexion: meuhmeuh
Vous aurez, d'autre part, besoin de la valeur dite VP.VC propre à votre FAI que vous trouverez ici : http://www.eagle-usb.org/article.php3?id_article=23
Dans mon cas, VP.VC vaut 8.35 (colonne VPI/colonne VCI), comme la plupart des FAI français.
Il nous faut créer un fichier contenant les caractéristiques de connexions appelé ueagle-atm et stocké dans le répertoire /etc/ppp/peers/ via l'éditeur de texte gedit. Pour ce faire :
$gksudo gedit /etc/ppp/peers/ueagle-atm
(Pour les utilisateurs de Kubuntu, il faut remplacer à chaque fois gedit par nano. Par exemple ici : sudo nano /etc/ppp/peers/ueagle-atm)
et entrez le texte suivant suivant :
user "meuh" plugin pppoatm.so 8.35 noipdefault usepeerdns defaultroute persist noauth
Puis modifiez le fichier /etc/ppp/chap-secrets:
$gksudo gedit /etc/ppp/chap-secrets
Attention, à l'ouverture, il peut ou non se présenter comme ceci :
"" * "" *
vous le transformez de la façon suivante :
"meuh" * "meuhmeuh" *
7 ème étape : L'instant magique: la connexion
Pour lancer la connexion, faites :
$sudo modprobe pppoatm $sudo pppd call ueagle-atm plugin pppoatm.so loaded
Vérification de la configuration:
$ifconfig lo Lien encap:Boucle locale inet adr:127.0.0.1 Masque:255.0.0.0 ad inet6: ::1/128 Scope:Hôte UP LOOPBACK RUNNING MTU:16436 Metric:1 Packets reçus:11 erreurs:0 :0 overruns:0 frame:0 TX packets:11 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 lg file transmission:0 Octets reçus:572 (572.0 b) Octets transmis:572 (572.0 b) ppp0 Lien encap:Protocole Point-à-Point inet adr:86.213.195.131 P-t-P:86.213.195.1 Masque:255.255.255.255 UP POINTOPOINT RUNNING NOARP MULTICAST MTU:1500 Metric:1 Packets reçus:1716 erreurs:0 :0 overruns:0 frame:0 TX packets:1456 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 lg file transmission:3 Octets reçus:2110237 (2.0 MiB) Octets transmis:106610 (104.1 KiB)
l0: est la boucle locale qui vous permet d'adresser votre machine en tant que localhost ou 127.0.0.1
inet6: votre serviteur se tait
ppp0: represente votre modem
souvent il y a en plus eth0 et eth1 qui désignent deux connexions éthernets supplementaires (ethernet/fireWire en fait)
NB: une note est à rajouter pour passer le MTU (Maximum Trame Unit) à 1492, ce qui est la longueur de trame optimisée pour générer aucune fragmentation côté FAI du modem, et donc améliorer la performance.
8ème étape : Automatisation de la connexion
Pour le moment, la connexion n'est lancée que si vous rentrez cette ligne de commande :
$sudo pppd call ueagle-atm plugin pppoatm.so loaded
Un peu pénible. Il faut donc créer un shell script nommé, par exemple, depart_adsl :
sudo gedit /usr/bin/depart_adsl
et contenant les lignes suivantes :
#!/bin/bash pppd call ueagle-atm
Sous Edgy eft les lignes de commandes sont:
#!/bin/bash pon ueagle-atm
D'autre part le fichier depart_adsl peut être sauvegardé dans le répertoire /usr/local/
Vous l'enregistrez et le rendez exécutable de la façon suivante :
$sudo chmod +x /usr/bin/depart_adsl
Ensuite :
gksudo gedit /etc/modules
vous rajoutez à la dernière ligne
pppoatm
puis vous lancez :
$sudo modprobe pppoatm
Ainsi les fois suivantes (après un redémarrage), plus besoin de modprobe, car le module a été ajouté dans la liste à démarrer au lancement du système.
Autre chose à faire - et c'est fini - est d'inclure le programme depart_adsl dans la liste des programmes à lancer au démarrage :
Système / Préférences / Session / Programmes au démarrage (sous Gnome).
Pour Kubuntu, je vous déconseille d'utiliser ou d'installer autostart (il y a un bug), il suffit de mettre un lien entre notre fichier depart_adsl et le répertoire de démarrage de KDE : ln /usr/bin/depart_adsl ~/.kde/Autostart/depart_adsl
Suite pour les connexions chez Free en zone dégroupée
Les freenautes en dégroupé ont une adresse IP statique, ce qui a l'avantage de simplifier notablement leur configuration réseau.
Il existe dans le forum un HowTo spécifique au cas de Free dégroupé, sous Dapper.
S'il ne donne pas les résultats voulus, on peut s'inspirer du tutorial non officiel du projet ueagle qui se trouve ici
Maintenance de ueagle-atm et mise à jour du noyau
Quand on réalise une opération d'upgrade du kernel le modem est à nouveau inopérationnel à moins de prendre certaines précautions. C'est l'objet de ce paragraphe.
1ère Possibilité:
Vous avez upgradé, fait un tour sur la toile … et vous êtes déconnecté. Au reboot suivant le modem n'est plus opérationnel. Il vous faut de nouveau désinstaller tout ie repartir à la 2ème Etape jusquà la 5ème de la méthode de Teofifil en tenant compte des changements intervenus. Vous pouvez aussi supprimer les fichiers usbatm.ko et ueagle-atm.ko dans le répertoire /lib/modules/ancienneversion/extra par les commandes:
sudo rm /lib/modules/2.6.15-21-386/extra/usbatm.ko sudo rm /lib/modules/2.6.15-21-386/extra/ueagle-atm.ko
Une fois toutes les étapes accomplies ne vous inquiétez pas le modem n'est vraissemblablement pas opérationel. Il ne le devient que lors du prochain reboot.
2ème Possibilité:
La méthode décrite dans ce post du forum est un peu pénible mais elle a le mérite de réussir systématiquement.
Notes de versions
Version initiale
Par narcotix88
Le script que j'ai réalisé avec l'aide de ce tuto, il peut aussi servir pour une première installation. A exécuter après chaque mise à jour du noyau. Assurez vous d'avoir installé les paquets build-essential et linux-headers au préalable. Pour lancer le script, décompressez l'archive et exécutez le fichier "Installation_automatique" par un double-clic. easy_f@st_800
Version retravaillée
Par Id2ndR
J'ai repris le script de narcotix88 pour pouvoir installer complètement le modem, c'est-à-dire jusqu'a la configuration du login et mot de passe de la connexion. procédure d'installation du modem sagen Fast 800
éditions
Par DEoT
le 06/06/2006: Il y a quelques modifications pour permettre une installation au plus grand nombre. Je vous invite à vous rendre sur ce lien http://forum.ubuntu-fr.org/viewtopic.php?id=43448 pour plus de détails
Par gene69
le 16/07/2006: réorganisation mineure de l'arborescene, ajout d'un paragraphe, et d'une note sur le MTU.
le 17/07/2006: réorganisation majeure du document, plus hiérarchisé et cohérent. fond identique.
Par Cathou
le 21/07/2006: ajout d'un lien vers HowTo pour Free dégroupé.
le 26/07/2006: suppression de l'ancienne procédure pour Free dégroupé (elle ne menait à rien) et ajout d'une méthode de maintenance en cas de mise à jour de noyau (lien vers le forum).
Toute amélioration de cette aide est la bienvenue.