Ce document décrit l'installation du driver eagle-usb sur une machine équipée de Debian GNU/Linux.
Depuis le noyau 2.6.15, préférer ueagle-atm à eagle-usb et voir cette documentation : http://atm.eagle-usb.org/wakka.php?wiki=UeagleAtmDocFr

Ce document est initialement une copie de http://mcoolive.free.fr/eagle-usb/mcoolive-doc-eagle.html.

Il a été recopié sur wiki afin de permettre à tout le monde de le complèter et de le corriger.
Pour cela il suffit de double cliquer, c'est simple. Toutes les modifications sont logguées, donc vous ne pouvez pas faire de grosses bétises, n'ayez pas peur ;-).

Environnements gérés

Les instructions données dans ce documents supposent que vous utilisez une des trois versions courantes de Debian : sarge, la version stable, connue aussi sous le nom de « Debian GNU/Linux 3.1 » ; etch ou testing, la version de test ; sid ou unstable, la version de développement.

Si vous utilisez une version antérieure à woody, il est fortement recommandé que vous mettiez votre système à jour. Vous trouverez toutes les informations sur le site de Debian.

Versions du noyau Linux

Le driver eagle-usb requiert un noyau Linux offrant le support de l'usb, et de l'hotplug (probablement vous aurez aussi besoin de ppp, cf. plus bas). Si votre noyau est antérieur à la version 2.4.18, nous vous conseillons de le mettre à jour. La configuration et la compilation du noyau sont expliquées en annexe à la fin de ce document.

Prérequis

Les paquets suivants, ainsi que toutes leurs dépendances, sont requis pour installer et utiliser le driver eagle-usb :

• ppp,
  le gestionnaire du protocole point à point (vous en aurez besoin seulement si vous utilisez une connexion ppp, renseignez vous sur votre FAI) ;
  
• dhcp3-client,
  un client dhcp (facultatif si vous possédez une IP fixe, ou bien si vous utilisez une connexion ppp) ;
  
• hotplug,
  le gestionnaire des périphériques hotplug (USB compris) ;
  
• gcc,
  le compilateur ;
  
• libc6-dev,
  bibliothèques et en-têtes GNU C ;
  
• linux-kernel-headers,
  en-têtes du noyau Linux pour le développement ;
  
• kernel-headers-{version},
  les fichiers d'en-têtes de votre noyau ; remplacer version par le numéro de version de votre noyau (inutile si vous avez compilé votre propre noyau) ;
  
• make,
  un programme d'aide à la compilation ;
  
• module-assistant,
  outil debian pour compiler et ajouter de nouveaux modules noyaux ;
  
• debhelper

Si vous n'avez pas encore d'accès à l'Internet

Si vous avez un accès à l'Internet depuis votre Debian, vous pouvez récupérer et installer ces paquets en utilisant les outils apt.


Si vous n'avez pas encore Internet (cas probable), les CD d'installation de la Debian peuvent aussi servir de source pour les outils apt. Pour ajouter un cdrom à votre liste de sources de paquets, il faut insérer le cd puis écrire :
Ensuite les commandes sont les mêmes que ci-dessus.

S'il vous manque encore des paquets, alors vous devrez les récupérer sur l'Internet depuis un autre système (à votre travail, depuis Windows, etc). Vous pouvez effectuer une recherche sur le site Debian. Nous rappelons que l'on installe un package grâce à la commande dpkg. Par exemple pour installer le package linux-kernel-headers contenu dans le fichier linux-kernel-headers_2.6.13+0rc3-1.1_i386.deb, il faut écrire :

Compilation et installation des drivers eagle-usb

Nous recensons deux méthodes pour installer les pilotes eagle-usb sur votre système Debian : soit vous utilisez les paquets Debian eagle-usb-*, soit vous utilisez le tarball disponible sur le site eagle-usb.org

L'utilisation des paquets Debian est très simple et la seconde méthode ne concernent donc que ceux qui n'en seront pas satisfaits.

Les derniers paquets sont disponibles à http://download.gna.org/eagleusb/eagle-usb-2.1.0/ mais on peut aussi récupérer des versions éventuellement moins fraîches via apt-get. Il faut pour cela déclarer la source Debian unstable ou la source www.linex.org dans /etc/apt/sources.list :

# Debian unstable provides eagle-usb
deb http://ftp.fr.debian.org/debian/ unstable main contrib non-free

# Woody and sarge repositories for gnuLinEx, the Extremadura distro based on
# Debian installed in more than 70.000 computers in this region's high schools
#deb http://www.linex.org/sources/linex/debian/ woody linex
deb http://www.linex.org/sources/linex/debian/ sarge linex

Attention toutefois à ajuster le cas échéant les priorités des sources dans /etc/apt/preferences afin de ne prendre dans ces dépôts que les paquets manquant dans sa distribution.

1ère méthode - installation des paquets debian eagle-usb

Les paquets suivants, ainsi que toutes leurs dépendances, sont requis :

• eagle-usb-data,
  les fichiers contenant les code DSP du modem ;
  
• eagle-usb-utils,
  installe les outils servant à manipuler le modem et s'exécutant dans l'espace utilisateur (pppoa, eaglectrl, les scripts hotplug et les scripts de connexions) ;
  
• eagle-usb-modules-source,
  le code source du driver eagle-usb.

Sous le compte root, tapez les commandes suivantes :


L'installation du paquet eagle-usb-utils vous demande de saisir les paramètres de votre connexion. Si vous commettez une erreur, il est possible de recommencer en tapant (root) dans un terminal :


C'est fini :-) !

2nd méthode - installation du tarball eagle-usb

Avant de commencer l'installation vous devez prendre sur l'Internet tout ce dont vous aurez besoin. Nous utilisons ici la méthode prévue par les concepteurs du driver eagle-usb. Aussi la plupart des consignes qui suivent est commune à toutes les distributions de GNU / Linux.

Pour fonctionner correctement, un module et le noyau doivent correspondre. Pour compiler un module on a besoin des entêtes de son noyau et on doit utiliser le même compilateur que celui qui a servi à compiler son noyau (c'est à dire la même version de gcc).

Pour connaître le compilateur ayant compilé votre noyau Linux actuel, écrivez : cat /proc/version. Pour connaître la version de gcc que vous utilisez, écrivez : gcc -v. Si les versions ne concordent pas, alors vous devrez soit recompiler votre noyau, soit plus simplement choisir le bon compilateur avant de compiler le module eagle-usb (par exemple : export CC=gcc-2.95).


C'est fini :-) !

Configurer votre connection à l'Internet

Maintenant que tout est installé correctement, il vous reste à configurer votre connexion à l'Internet. Toutes les instructions qui suivent doivent être effectuer sous le compte root.

Le driver eagle-usb est distribué avec un utilitaire permettant de configurer facilement sa connexion Internet. Pour l'utiliser, taper la commande :

Toutefois, si vous avez installé le paquet debian eagle-usb-utils, préférez l'utilisation de la commande :

Dans un cas, comme dans l'autre, on vous posera une succession de questions sur les paramètres de votre connexion. Vous trouverez les informations pertinantes auprès de votre providers ou bien ici http://www.eagle-usb.org/article.php3?id_article=23.

Il ne vous reste plus qu'à lancer la connexion.

Se connecter à l'Internet

Pour vous connecter à l'Internet, loguez vous en root et tapez la commande :
Si vous utilisez une connexion ppp, tous les utilisateurs du groupe dip (il existe quelques problèmes de droit avec la version tarball) peuvent lancer la connexion en tapant :

Pour tester votre connexion, faites dans un terminal

C'est l'adresse IP de www.free.fr. Si vous obtenez une réponse positive, bienvenue ! Vous êtes connecté « au reste du monde » ;-).

Pour utiliser Internet vous avez aussi besoin d'une configuration correcte des DNS. Afin de la tester, faites dans un terminal :

Si vous obtenez une réponse positive, c'est gagné !

Pour vous déconnecter, loguez vous en root et tapez la commande :
Si vous utilisez une connexion ppp, tous les utilisateurs du groupe dip peuvent stopper la connexion en tapant :

Bon surf :-).

Si ça ne marche pas :-(

Quelques conseils au cas où votre connexion ne fonctionne pas

• Relire entièrement ce document, vous avez peut-être négligé certains passages.
• Vérifier que vous avez configuré correctement les paramétres spécifiques à votre fournisseur d'accès Internet.
• Si vous utilisez un firewall, vérifier ses paramètres.
• Vérifier que vous utilisez la dernière version des drivers sur http://www.eagle-usb.org
• Lire la FaqEagle.
• Demander de l'aide sur le forum de support en indiquant votre ISP / modem et en fournissant le résultat de eaglediag -msc

Désinstallation du driver eagle-usb

Si vous aviez installé les paquets Debian, loguez vous en root et tapez :
La désinstallation est simple, rapide et efficace ;-)

Si vous aviez installé tarball, c'est un peu plus compliqué car vous avez besoin des sources.
Loguez vous en root et écrivez :

Mise à jour du driver eagle-usb

Pourquoi on peut souhaiter une mise-à-jour ?

• car vous aimez être à jour,
• car les drivers que vous utilisez ne fonctionnent pas très bien.

Pourquoi on peut ne pas vouloir de mise-à-jour ?

• car votre connexion Internet fonctionne parfaitement et que vous avez peur de la perdre.

Si vous utilisez les paquets Debian :

Si vous avez utilisez le tarball :

Annexes

Nous avons placer en Annexe des informations qu'il peut-être utile de connaître pour l'installation du driver eagle-usb mais qui ne sont pas indispensables, de manière à ne pas surcharger les explications données dans la partie principale de ce documents.

« Les annexes » rappellent brièvement les différentes méthodes pour compiler un noyau sur un système Debian GNU / Linux et les options indispensables pour faire fonctionner votre modem avec votre futur noyau.

Configuration et installation du noyau

En général, les noyaux fournis avec les distributions GNU / Linux incluent tout ce dont nous avons besoin. Cette section vous sera utile si vous n'avez pas de chance (un matériel un peu exotique), ou bien si vous aimez compiler votre noyau ;-).

Il existe beaucoup de documents sur l'Internet expliquant comment compiler son noyau. Cette section n'a pas l'ambition d'être exhaustive. Nous voulons simplement vous donnez une vue d'ensemble pour que vous sachiez de quoi vous avez besoin.
Parmi la pléthore de documents existants, je conseille à tous les utilisateurs Debian la lecture de Formation Debian GNU/Linux (http://people.via.ecp.fr/~alexis/formation-linux/formation-linux.html) écrite par Alexis de Lattre.

Vous pouvez récupérer les sources d'un noyau Linux sur www.kernel.org. L'usage commande de placer le code source du noyau dans le répertoire "/usr/src/linux-{version}" et de créer un lien symbolique "/usr/src/linux" vers "/usr/src/linux-{version}".
Et n'oubliez pas, en bon paranoïaque, de vérifier le md5 ;-).

Configurer votre futur noyau Linux

Si vous configurez votre noyau pour la première fois... bon courage :-) !

La configuration de votre futur noyau est résumé dans le fichier "/usr/src/linux-{version}/.config". Pour éditer ce fichier il faut utiliser l'une des commandes make config, make menuconfig ou make xconfig. Le premier est horriblement moche et peu pratique, mais il fonctionne toujours. Le second nécessite les librairies ncurses (comme vim). Le troisième fonctionne sous X.

Ici nous vous rappelons quelques options indispensables pour faire fonctionner votre drivers eagle.

• Loadable module support - - -> Enable loadable module support
• Loadable module support - - -> Enable loadable module support - - - > Module unloading
• Loadable module support - - -> Kernel module loader
• General Setup - - -> Networking Support
• General Setup - - -> Support for hot-pluggable devices
• Plug and Play configuration - - -> Plug and Play support
• Networking options - - -> TCP/IP networking
• Network device support - - -> Network device support
• Network device support - - -> PPP (point-to-point protocol) support
• Network device support - - -> PPP support for async serial ports
• Network device support - - -> PPP support for sync tty ports
• Network device support - - -> PPP deflate compression
• Network device support - - -> PPP BSD-Compress compression
• Character devices - - -> Non-standard serial port support
• Character devices - - -> HDLC line discipline support
• File systems - - -> /proc file system support
• USB support - - -> Support for USB
• USB support - - -> Preliminary USB device filesystem
• Vous devez choisir au moins l'un de ces modules selon la nature de vos controleurs USB. La commande "lspci" vous renseigne sur votre matériel.
  • USB support - - -> UHCI (Intel PIIX4, VIA, ...) support
  • USB support - - -> UHCI (Alternate Driver (JE) support
  • USB support - - -> OHCI (Compaq, iMacs, OPTI, SiS?, ALI, ...) support

Parce que choisir toutes les options est horriblement long, il est conseillé de faire une sauvegarde de votre fichier ".config" (par exemple avant de le modifier si votre précédent noyau fonctionnait). L'usage veut qu'on le copie sous le nom "/boot/config-{kernelVersion}" (ajouter une date de la forme YYYYMMDD pour le différencier si vous en avez plusieurs).
Si vous souhaitez revenir à une ancienne configuration, il est nécessaire de reconstruire tous les fichiers dépendants du fichier .config. Vous devez écrire :

Compiler et Installer un noyau Linux, méthode « classique »

Si vous compilez votre noyau pour la première fois... bah vous allez voir que c'est très facile :-) !

Dans un terminal vous tapez :

Compiler et installer un noyau Linux « à la Debian »

La méthode Debian pour compiler un noyau consiste à créer un package Debian contenant le noyau et ses modules, puis à installer ce package avec la commande dpkg. Assurez-vous pour commencer que vous possédez le paquet kernel-package et toutes ses dépendances.

Dans un terminal vous tapez :


Si vous avez touché à la configuration de lilo (vous n'utilisez plus les liens /vmlinuz et /vmlinuz.old), je vous conseille vivement de vérifier que votre système est toujours amorçable.

Notez qu'il est possible de créer un paquet réunissant votre noyau, l'ensemble de ses modules et tous les modules exterieurs (eagle-usb par exemple). Pour cela taper la commande : make-kpkg --added-modules eagle-usb kernel-image modules

Il est à noter également que la distribution Debian, comme presque toutes les distributions, proposent des noyaux patchés et déjà compilés. Il ne vous reste plus qu'à les installer en utilisant la commande dpkg.

Après avoir installé un noyau « généraliste » Debian, il faut utiliser la commande modconf afin de choisir les modules dont vous avez besoin.

Sous Debian les versions du noyau Linux officiellement gérées sont les suivantes :

• stable : 2.2.20, ,2.4.16, 2.4.18 (le pilote eagle-usb fonctionne à partir de la 2.4.18)
• testing : 2.4.25, 2.4.26, 2.6.5, 2.6.6, 2.6.7
• unstable : 2.4.25, 2.4.26, 2.6.5, 2.6.6, 2.6.7

---