✎ materiel:ueagle-atm [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

====== 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 [[http://kaella.linux-azur.org/index.php#telechargement|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 :
  * [[http://perso.orange.fr/j.m.e/ueagle-data_1.1-0ubuntu0_all.deb]],
  * [[http://perso.orange.fr/j.m.e/installemodem_0.0.2-0ubuntu1_i386.deb]].
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)====
  - Vous pouvez récupérer //l'archive pour l'installation// [[http://www.bde.enseeiht.fr/~adamf/ubuntu/fast_800_install.tar.bz2|ici]] et l'archive contenant le firmware __ueagle-data-1.1.tar.gz__ [[http://eagle-usb.org/ueagle-atm/non-free/|ici]].
  - 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 [[http://forum.ubuntu-fr.org/viewtopic.php?pid=377565|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 [[http://forum.ubuntu-fr.org/viewtopic.php?pid=377565|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:
<code>uname -r</code>

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:

<code> apt-get install linux-image linux-headers </code>

Ensuite, télécharger le driver sur [[http://download.gna.org/ueagleatm/|ueagle-svn]]. (ueagle-atm à télécharger)

Puis compiler et installer le driver ueagle-atm et la bibliothèque usbatm par
<code>
tar -zxvf ueagle-atm-x.y.tar.gz
cd ueagle-x.y/
make
sudo make install
</code>

Puis suivre le tutorial [[http://atm.eagle-usb.org/wakka.php?wiki=UeagleAtmDoc|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 [[http://www.fedora-france.org/modules/wiwimod/index.php?page=Eagle%20:%20configuration%20des%20modems%20USB|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 
<code>$ svn co svn://svn.gna.org/svn/ueagleatm/trunk/ueagle-atm ueagle-atm</code> (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 :

<code>$sudo lsmod | grep eagle</code>

Si le terminal retourne quelque chose, il faut désinstaller les modules eagle-usb par :

<code>$sudo modprobe -r eagle-usb</code>

Rechercher //usbatm.ko// et //eagle-usb.ko// (il y a 4 noyaux disponibles sur cet exemple): 
<code>$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
</code>

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.

<code>$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
</code>

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 : 
<code>$uname -r</code>
Le terminal vous repond quelque chose comme : 
<code>$2.6.15-21-386</code>
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) : 
<code>$sudo apt-cdrom add /media/cdrom</code>

On lance l'installation des modules nécessaire à la compilation par :

<code>$sudo apt-get install gcc make build-essential linux-headers-`uname -r`</code>

=== 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 :

<code>$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</code>

Si vous listez le dossier /lib/modules/2.6.15-21-386/extra ; vous devrez trouver les fichiers usbatm.ko et ueagle-atm.ko :

<code>$ls  /lib/modules/`uname -r`/extra</code>

== les Firmwares ==

L'installation des Firmwares se fait de la façon suivante :

//Décompression de l'archive ueagle-data-1.1.tar.gz//
<code>$cp /làoùsetrouvelefichier/ueagle-data-1.1.tar.gz /tmp && cd /tmp
$tar -zxvf ueagle-data-1.1.tar.gz
</code>
//Création du répertoire /lib/firmware/ueagle-atm et copie des modules//
<code>
$sudo mkdir /lib/firmware/ueagle-atm
$cd ueagle-data-1.1
$sudo cp -a * /lib/firmware/ueagle-atm</code>

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 :

<code>$sudo modprobe ueagle-atm</code>

Ca clignote et les deux diodes s'allument, cool : GAGNÉ. Pour en être sûr, entrez :

<code>$dmesg | grep ueagle</code>

Vous devriez avoir quelque chose comme :

<code>[4294707.683000] usb 1-1: [ueagle-atm] modem operational
[4294707.691000] usb 1-1: [ueagle-atm] ATU-R firmware version : 44e2ea17</code>

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 à [[ueagle-atm#suite_pour_les_connexions_chez_free_en_zone_degroupee|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 :

<code>$gksudo gedit /etc/ppp/peers/ueagle-atm</code>
(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 :
<code>
user "meuh"
plugin pppoatm.so 8.35
noipdefault
usepeerdns
defaultroute
persist
noauth
</code>
Puis modifiez le fichier /etc/ppp/chap-secrets:
<code>$gksudo gedit /etc/ppp/chap-secrets </code>
**Attention**, à l'ouverture, il peut ou non se présenter comme ceci :
<code>
"" * "" *
</code>
vous le transformez de la façon suivante :
<code>
"meuh" * "meuhmeuh" *
</code>

===  7 ème étape : L'instant magique: la connexion ===

Pour lancer la connexion, faites :

<code>$sudo modprobe pppoatm
$sudo pppd call ueagle-atm
plugin pppoatm.so loaded
</code>

Vérification de la configuration:
<code>$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)</code>

__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 :

<code>$sudo pppd call ueagle-atm
plugin pppoatm.so loaded </code>

Un peu pénible. Il faut donc créer un shell script nommé, par exemple, depart_adsl : 
<code>sudo gedit /usr/bin/depart_adsl</code>

et contenant les lignes suivantes :
<code>#!/bin/bash
pppd call ueagle-atm</code>

**Sous Edgy eft** les lignes de commandes sont:

<code>#!/bin/bash
pon ueagle-atm</code>

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 :

<code>$sudo chmod +x /usr/bin/depart_adsl</code>

Ensuite :

<code>gksudo gedit /etc/modules</code>

vous rajoutez à la dernière ligne

<code>pppoatm</code>

puis vous lancez :

<code>$sudo modprobe pppoatm</code>

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 [[http://forum.ubuntu-fr.org/viewtopic.php?id=43971|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 [[http://atm.eagle-usb.org/wakka.php?wiki=TutorielFreeDegroup|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:
<code>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 </code>

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 [[http://forum.ubuntu-fr.org/viewtopic.php?pid=363097#p363097|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. [[http://www3.keohosting.net/blaireaux/progs_linux/easyfast800.tar.bz2|easy_f@st_800]]

==== Version retravaillée ====

//Par [[utilisateurs:id2ndr|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. 
[[#installation_automatisee|procédure d'installation du modem sagen Fast 800]]

==== éditions ====
//Par [[utilisateurs:DEoT|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 [[utilisateurs:gene69|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 [[utilisateurs:Cathou|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.

Merci de recopier le code ci-contre pour prouver que vous êtes humain : Q X P W U Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported