EagleConnect v. 0.8 
(rev. 3 du 11/04/2004)

(Documentation ralise avec OpenOffice 1.1.0)



Sommaire

 
Prambule ......................................................................2

Prsentation ...................................................................2

	les nouveauts de la version 0.8 .........................................3

Paquetages ou logiciels requis .................................................4

Installer le driverEagle .......................................................4

Installer EagleConnect .........................................................6

	suppression de l'ancienne version d'EagleConnect..........................6
	rcupration et installation des fichiers d'EagleConnect..................6
	modifier le fichier /etc/sudoers..........................................7

Utiliser EagleConnect ..........................................................8

	premier lancement d'EagleConnect..........................................9
	dcouverte d'EagleConnect................................................10
	modifier la langue de l'interface........................................11

Evolutions attendues ..........................................................12

Remerciements .................................................................12

Licence .......................................................................13

Disclaimer ....................................................................13

























I)Prambule

EagleConnect, avant d'tre un logiciel, est d'abord un hommage. C'est l'expression d'un grand remerciement que j'adresse  tous les dveloppeurs qui ont travaill sur le pilote Eagle-usb, ses outils et sa documentation pour grer le modem Sagem Fast 800 et ses drivs sous Linux. 
Il ont permis  de simples utilisateurs, dont je fais partie, de pouvoir bnficier de leur connexion ADSL sous ce magnifique systme d'exploitation. 

Je remercie donc, dans l'ordre : 
- Benot Audouard (Baud123, concepteur du module "Eaglediag", testeur et Webmaster du 
site consacr au driver eagle : http://eagle-usb.ath.cx/pub/sommaire.php3)
- Olivier Borowski (Tux, gestion des packages et scripts install/init)
- Christian Casteyde (Correcteur du driver Eagle-usb fourni par Sagem/Free)
- Stphane Collet (Sco35, ex Webmaster de l'ancien site, eagle-usb.fr.st)
- Jrme Marant (Dveloppeur de eagleconfig.pl, un configurateur graphique pour le driver) 
- Cyril Martin (Mcoolive, packaging Debian)
- Roland Mas (Packaging Debian)
- Frdrick Ros (Sleeper, dveloppeur du driver, gestion des packages, scripts install/init et packages ebuild)
et toux ceux dont je n'ai pas les noms mais qui ont grandement contribu au projet.

EagleConnect a ensuite t cr pour les besoins de mes proches qui n'avaient pas l'habitude de Linux, et pour lesquels un front-end graphique au driver et ses utilitaires s'imposait. 





II) Prsentation

EagleConnect est une interface graphique, ralise en langage tcl/tk, destine  permettre aux utilisateurs de base de se connecter simplement sous Linux avec leur modem Sagem Fast 800 ou assimil. 
EagleConnect n'est videmment qu'un front-end :  savoir que sans les outils dvelopps par toute l'quipe de Eagle-usb, ce logiciel n'aurait pas grande utilit. Au travers de quelques boutons de base, l'utilisateur communique en ralit avec les modules fctStartAdsl, fctStopAdsl, eaglediag, eaglestat et eaglectrl qui permettent, respectivement, de se connecter  l'Internet, de s'en dconnecter, d'effectuer un diagnostic systme,  d'afficher les statistiques rseau et le statut (oprationnel / non oprationnel)  du modem, ou encore de rinitialiser ce dernier.















Les nouveauts de la version 0.8 par rapport  la prcdente version (0.2) :

- La dtection de la prsence d'une connexion n'est plus base sur les seuls pings. Elle se fonde  prsent sur 2 mthodes  :

1- Via les rsultats fournis par l'utilitaire Eaglediag au dmarrage de l'interface et lorsqu'on appuie sur le bouton Lancer la connexion ADSL Avantage : EagleConnect est plus rapide au dmarrage, et la dtection repose sur un diagnostic plus fiable.
2- Via la comparaison du nombre de paquets reus (grce  l'utilitaire Eaglestat) et la dtection de leur incrmentation (chaque minute). Cette mthode est galement utlise par l'applet (voir plus bas).


- Une interface graphique  l'utilitaire EagleDiag. Deux modes sont acessibles : un mode normal (commande eaglediag classique sans paramtres), et un mode expert (commande eaglediag -a). Des fentres comportant des conseils pour l'utilisateur sont galement prsentes (incomplet en mode expert pour le moment).

- Une interface graphique  l'utilitaire Eaglestat, qui tient compte des modifications du rseau toutes les 5 secondes environ.

- Un panneau (sommaire) des prfrences utilisateur. Ce dernier doit y entrer pour l'instant les commandes (fctStartAdsl, fctStopAdsl, eaglediag, eaglestat, eaglectrl) et leur chemin qui peut diffrer d'un environnement  l'autre (constat sur le forum).

- Une applet, sommaire galement : ici, point de possibilit  de l'ancrer au panneau KDE ou GNOME. Dpose sur le bureau, elle indique seulement le nombre de paquets reus et transmis, et le statut de la connexion (qui se base sur la seconde mthode de dtection cite plus haut) .

- Enfin, l'interface existe  prsent en franais ... et en anglais. La langue change en fait selon l'environnement de l'utilisateur. Il est d'ailleurs possible d'ajouter d'autres langues, un fichier, x.msg ayant t cr   cet effet en anglais afin de rendre le portage plus ais. 


EagleConnect en est donc  sa seconde version (0.8) et tourne sous la Linux Mandrake 9.2. N'hsitez pas  le tester sous d'autres distributions pour m'indiquer s'il tourne correctement.























III) Paquetages ou logiciels requis

J'ai labor ce front-end sous la Mandrake 9.2. Nanmoins, je pense qu'il devrait fonctionner assez facilement avec les autres versions de la Linux Mandrake puisqu'il n'y a pas de compilation du programme  effectuer, et peu de dpendances  rsoudre.
Pour pouvoir utiliser EagleConnect, vous devez avoir, sur votre machine : 
la bibliothque TCL/TK (version 8.4.2-1.mdk) 
le Driver Eagle 1.9.6,  que vous trouverez aux adresses suivantes :
http://baud123.free.fr/eagle/eagle-usb-1.9.6.tar.bz2
http://tbasic.free.fr/eagle/1.9.6/
mais EagleConnect fonctionne galement avec les drivers Eagle 1.9.5 et 1.9.3.




IV) Installer le driver Eagle sur la Mandrake  9.2

La Mandrake 9.2  est fournie avec le driver eagle-usb 1.0.4 stable, mais des problmes subsistent en cas de dgroupage. Pour cette raison, il est prfrable de passer  la version du driver la plus rcente.
Une fois le nouveau driver install, il ne faut plus utiliser l'utilitaire graphique Drakconnect prsent dans la distribution, sous peine de  voir l'ancien driver craser le nouveau frachement install.
Par ailleurs, vous trouverez une liste des changements effectus depuis la version 1.0.4 du driver sur cette page : http://eagle-usb.ath.cx/eagledev/wakka.php?wiki=DeveloppementIntegration , avec, notamment, la disparition du service adiusbadsl.
Enfin, si ncessaire, vous trouverez de l'aide sur le forum  l'adresse suivante : 
http://eagle-usb.ath.cx/forum/

Avant de procder  l'installation, rendez-vous  l'adresse suivante :
http://eagle-usb.ath.cx/pub/article.php3?id_article=23
et relevez les paramtres de votre fournisseur d'accs internet. Ils vous seront utiles ultrieurement.

a)

Aprs avoir tlcharg le fichier eagle-usb-1.9.6.tar.bz2 sur votre disque dur (par exemple dans le rpertoire /usr/local/src), vous passerez d'abord en mode root en tapant dans un terminal la commande su , puis vous dcompacterez le fichier en tapant  la commande suivante : 
 tar jxvf eagle-usb-1.9.6.tar.bz2
Vous obtiendrez alors le rpertoire eagle-usb-1.9.6.



b) 
Ensuite, entrez dans ce rpertoire en tapant dans le mme terminal :
cd eagle-usb-1.9.6
et installez enfin le driver eagle-usb en tapant :
./configure
make uninstall
make clean
make
make install
eagleconfig

Notez qu' l'tape de la commande eagleconfig , un tableau apparatra et vous demandera votre mthode de connexion : vous devrez slectionner  votre fournisseur d'accs dans la liste (voir la page http://eagle-usb.ath.cx/pub/article.php3?id_article=23) , en prenant en compte si vous tes dgroup ou non.
Votre identifiant de connexion  internet (par exemple  : toto@clubadsl1) et votre mot de passe vous seront ensuite demands.
Une dernire option vous proposera par ailleurs, si vous le souhaitez, la connexion ADSL au dmarrage.

c)
Enfin, vous pourrez finalement vous connecter en tapant la commande :
startadsl   
(stopadsl pour vous dconnecter)

Pour toute information complmentaire, je vous invite galement  vous rendre  l'adresse suivante :
http://eagle-usb.ath.cx/pub/article.php3?id_article=33  



















































V) Installer EagleConnect

a)				
Suppression de l'ancienne version d'EagleEconnect

Avant d'installer EagleConnect v. 0.8,  pensez d'abord  supprimer  (via Konqueror, par exemple) les fichiers lis  l'ancienne version (v. 0.2) : EagleConnect.tcl, aide.gif et les fichiers de documentation (EagleConnectDocumentation.html, .sxw, .rtf, .pdf et .doc). Supprimez galement le rpertoire EagleConnect  (ou eagleconnect) s'il existe.

b)
Rcupration et installation des fichiers d'EagleConnect

Pour pouvoir bnficier de l'interface graphique EagleConnect, installez au pralable  les bibliothques tcl-8.4.2-1.mdk et tk-8.4.2-1.mdk prsentes dans la distribution Mandrake 9.2 sous forme de fichiers rpm.
Pour savoir si ces bibliothques sont dj installes sur votre systme Mandrake 9.2, tapez dans un terminal les commandes : 
rpm -qi tcl
rpm -qi tk

Si les paquetages ne sont pas installs,  tapez  cet effet dans un terminal (en tant que root) :
rpm -ivh  tcl-8.4.2-1mdk.i586.rpm
rpm -ivh  tk-8.4.2-1mdk.i586.rpm
Notez cependant qu'il est possible qu'EagleConnect fonctionne tout de mme avec des versions de tcl / tk antrieures  la 8.4.2 (non test).

c)
Rcuprez ensuite EagleConnect  l'adresse suivante :
 http://www.membres.lycos.fr/eyves/connexion/ 
Vous le trouverez sous la forme d'un fichier archive  dcompacter, eagleconnect.tgz. 
Tlchargez ce fichier et copiez le dans votre rpertoire  utilisateur (exemple : /home/emmanuel).
En tant tant que simple utilisateur (et non en root), dcompactez-le en tapant dans un terminal la commande suivante :
tar -xzvf eagleconnect.tgz
Vous avez  prsent un rpertoire eagleconnect dans votre rpertoire utilisateur.  Ne lancez pas EagleConnect pour l'instant. Passez  pour l'instant  l'tape suivante ci-dessous.



















d)

IMPORTANT

EagleConnect doit tre exclusivement lanc en tant que simple utilisateur ne possdant pas les droits root (dans le cas contraire, voir plus bas). A cet effet,  il faut modifier au pralable le fichier /etc/sudoers en ajoutant  la fin :
votreloginsimpleuser ALL=NOPASSWD:/usr/local/sbin/nom de la commande  lancer
ou 
votreloginsimpleuser ALL=NOPASSWD:/usr/sbin/nom de la commande  lancer 
selon l'emplacement des utilitaires installs sur votre machine (fctStartAdsl, fctStopAdsl, eaglediag, eaglestat, eaglectrl etc...). Pour connatre simplement cet emplacement, tapez simplement dans un terminal  :
whereis  fctStartAdsl
Exemple :
[emmanuel@localhost eagleconnect]$ whereis  fctStartAdsl
fctStartAdsl: /usr/local/sbin/fctStartAdsl

Passons  la modification du fichier /etc/sudoers proprement dit :

Exemple dans le cas o fctStartAdsl, fctStopAdsl (etc) sont installs dans /usr/local/sbin 

Pour pouvoir modifier le fichier /etc/sudoers, vous devrez l'ouvrir avec votre diteur de textes prfr en tant que root.
Prenons l'exemple d'un utilisateur nomm emmanuel sur le systme. Vous ajouterez alors   la fin du fichier /etc/sudoers  :
emmanuel ALL=NOPASSWD:/usr/local/sbin/fctStartAdsl
emmanuel ALL=NOPASSWD:/usr/local/sbin/fctStopAdsl -sf
emmanuel ALL=NOPASSWD:/usr/local/sbin/eaglediag
emmanuel ALL=NOPASSWD:/usr/local/sbin/eaglectrl -w

Surtout, veillez  ne pas ajouter le signe  # avant chacune de ces lignes, ce signe servant uniquement  ouvrir des commentaires.
L'utilitaire Eaglestat , quant--lui, pouvant tre lanc en tant que simple  utilisateur, il n'est pas ncessaire de l'ajouter  la liste.



Si vous dsirez modifier le fichier /etc/sudoers avec l'diteur de textes vi, procdez comme suit  :
Ouvrez un terminal, loggez vous en root, et tapez :
vi /etc/sudoers
Appuyez sur la touche Inser puis sur la touche Entre pour pouvoir modifier le fichier et ajouter les lignes mentionnes ci-dessus.
Une fois ceci fait, appuyez successivement sur les  cinq touches  (ne tenez pas compte des virgules) :
Echap , : (deux points) , w, q, ! (point d'exclamation)
Voil, votre fichier est sauvegard.

Nota 

Pour les utilisateurs dsirant cependant lancer EagleConnect en root, il faut alors supprimer l'appel  sudo dans les scripts EagleConnect.tcl, diagnostic.tcl, reseau.tcl et parameeagleconnect.tcl, et ne laisser que la commande exec suivie de la variable qui contient le nom de la commande et son emplacement. Ainsi, 
exec sudo  $recupdiag
devient alors : 
exec $recupdiag










VI) Utiliser EagleConnect

a)  

Premier lancement d'EagleConnect

Pour lancer le programme, placez vous  dans le rpertoire eagleconnect nouvellement cr, tapez dans un terminal :
cd eagleconnect 
et tapez enfin dans un terminal la commande : 
EagleConnect.tcl

Lorsque vous lancez EagleConnect pour la premire fois, le programme vous informe que vous devez au pralable entrer dans la fentre ddie les paramtres de connexion. Il s'agit simplement des commandes et de leur emplacement.
Dans le premier champ, par exemple, si la commande fctStartAdsl se trouve dans le rpertoire   /usr/local/sbin, alors vous inscrirez : 
/usr/local/sbin/fctStartAdsl
Si le path est diffrent, qu'il s'agit de /usr/sbin, alors vous inscrirez :
usr/sbin/fctStartAdsl
Vous ferez de mme pour les autres programmes (eaglediag, eaglestat etc ...), sans ajouter videmment les options propres  ces utilitaires (comme : eaglediag -a, n'ajoutez surtout pas le -a, inscrivez simplement eaglediag).

Une fois ceci fait, sauvegardez vos prfrences. Le fichier des prfrences utilisateur sera alors cr dans le rpertoire eagleconnect sous le nom d'eagleconnect.pref. A tout moment, vous pourrez le modifier si ncessaire via l'interface EagleConnect en allant dans le menu Aide >> Configurer EagleConnect  (qui appelle en fait le programme parameeagleconnect.tcl).

































b)

Dcouverte d'EagleConnect

Le programme n'est pas trs complexe, il est compos d'un champ, de six boutons principaux et d'une petite icne situe en haut  droite du menu Aide : 

1) Le champ situ au-dessus des boutons indique si la connexion est active ou non. Lorsque vous lancez EagleConnect, ce dernier vrifie d'emble si vous tes connect en effectuant la commande Eaglediag dont le rsultat est redirig vers un fichier externe. Si tous les paramtres (module loaded, modem operational, pppd launched, service for connection, ping ip et test DND) sont  OK, alors vous tes dans  conditions optimales pour surfer :-)  Dans le cas contraire, le programme vous informe que la connexion est inactive. Si tel est le cas,  cliquez alors sur le bouton Diagnostic du systme de l'interface pour connatre la nature du problme auquel vous tes confront.
Par ailleurs, une fonction de dtection d'incrmention des paquets reus (base sur Eaglestat) met  jour chaque minute l'tat du champ. Si le nombre de  paquets reus augmente effectivement, alors la connexion est active.

2) Le bouton "Etat du rseau", est bas sur l'utilitaire Eaglestat. Il permet de connatre l'tat du rseau et le statut du modem : oprationnel ou non. Ce bouton lance l'interface reseau.tcl qui rcupre les valeurs transmises par Eaglestat toutes les cinq secondes environ.

3) Le bouton Diagnostic du systme est bas sur l'utilitaire Eaglediag. Il lance l'interface diagnostic.tcl qui comporte deux modes :
mode normal : l'utilitaire Eaglediag est lanc sans option de ligne de commande. C'est la commande par dfaut. Elle vous permet nanmoins de dresser un tat des lieux sur les paramtres de votre connexion. La fentre Conseils vous donne galement quelques astuces si l'un de ces paramtres ne semble pas fonctionner correctement.
mode expert :  l'utilitaire Eaglediag est lanc avec l'option de ligne de commande -a, o tout est affich.  Notez que la rubrique Conseils est  pour l'instant incomplte.

4)  Rinitialiser le modem, permet de dbloquer le modem  (cette option appelle la commande "eaglectrl -w") aprs avoir stopp une connexion adsl ventuelle ("fctStopAdsl -sf", ces deux options permettant d'utiliser ifconfig et de fermer pppd). Une fois la rinitialisation effectue, vous tes ensuite invit   lancer la connexion.

5)  Lancer la connexion ADSL et 6) Arrter la connection ADSL  



7)  La petite icne situe en haut  droite du menu Aide  vous permet de minimiser EagleConnect et de le faire apparatre sous forme d'applet. Cette dernire comporte deux champs : paquets reus et envoys qui sont actualiss chaque minute. Au lancement de l'applet, ces valeurs n'apparaissent pas instantanment. Il faut attendre une minute afin qu'elles ne s'inscrivent dans les deux champs.   
Ce petit bug sera corrig prochainement.
Pour dplacer l'applet sur le bureau, laissez le bouton droit de la souris appuy dessus. Pour la fermer et rouvrir l'interface EagleConnect, double-cliquez dessus avec le bouton gauche.








c)

Modifier la langue de l'interface

Grce au fichier x.msg que vous trouverez dans le rpertoire eagleconnect, vous pouvez aisment traduire EagleConnect dans la langue de votre choix. Chacun des scripts tcl, en effet, comporte un appel au catalogue de langue (*.msg) correspondant  la langue  du systme de l'utilisateur (dfinie dans $env(LANG)).  EagleConnect tant  la base en anglais, l'interface va donc chercher le fichier fr.msg si   LANG = fr_FR.  
Extrait du fichier fr.msg :
::msgcat::mcset fr "Help" "Aide" 
::msgcat::mcset fr "EagleConnect Manual" "Manuel de EagleConnect" 
::msgcat::mcset fr "About EagleConnect" "A propos de EagleConnect" 
etc...
Le fichier x.msg comportant tous les termes de l'interface en anglais, il ne reste qu' inclure dans ce fichier la traduction de chacune des phrases dans la langue de son choix, en prenant soin de supprimer fr et de mettre, par exemple, es  la place pour la langue espagnole. On renommera alors le fichier x.msg en es.msg.












































VII)  Evolutions attendues

EagleConnect est un logiciel que j'ai l'intention de faire voluer - dans les mesure de mes possibilits et de ma disponibilit - paralllement au fabuleux travail effectu par l'quipe de Eagle-usb.

Dans la prochaine version :

Visualisation des logs dans une fentre lors des diffrents processus
Possibilit d'utiliser EagleConnect en mode root si l'utilisateur le dsire
Apparition de barres de progression pour signaler la prsence de processus en cours (dmarrage de connexion etc).
Amliorations diverses sur le plan de l'esthtique.
Plus ... selon les requtes des utilisateurs :-)


VIII)  Remerciements

Je tiens d'abord  remercier Benot Audouard (Baud123, concepteur du module "Eaglediag") qui m'a guid dans l'laboration de cette interface en me donnant d'inestimables conseils, tant par email qu'au travers des pages wiki consacres au dveloppement du driver eagle-usb et des outils affilis :
http://eagle-usb.ath.cx/eagledev/wakka.php?wiki=PagePrincipale 

Je tiens galement  remercier les utilisateurs qui m'ont adress leurs encouragements et apprciations  par email, ainsi que le personnes rencontres sur le forum du site http://eagle-usb.ath.cx/pub/ , grce auxquelles j'ai pu apporter certaines amliorations  EagleConnect.





































IX)  LICENCE

Copyright (C) 2004 version 0.8  Emmanuel YVES

Ce programme est libre, vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence Publique Gnrale GNU publie par la Free Software Foundation (version 2 ou bien toute autre version ultrieure choisie par vous).

EagleConnect est distribu car potentiellement utile, mais SANS AUCUNE GARANTIE, ni explicite ni implicite, y compris les garanties de commercialisation ou d'adaptation dans un but spcifique. Reportez-vous  la Licence Publique Gnrale GNU pour plus de dtails.

Vous devez avoir reu une copie de la Licence Publique Gnrale GNU en mme temps que ce programme ; si ce n'est pas le cas, crivez  la Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, tats-Unis.


X)  DISCLAIMER

Ce programme en est  sa seconde version. Des bugs tant toujours possibles, vous utilisez donc ce programme en connaissance de cause. Je dgage pour ma part toute responsabilit quant aux dommages ventuels qui pourraient survenir lors de l'utilisation de ce programme.


Merci de bien vouloir me retourner vos remarques et suggestions  l'adresse email suivante :
eyves@club-internet.fr



								
								Paris, le 11 Avril 2004

