Installation d'un carte Wifi USB basée sur le chipset zd1211

Toutes versions
Testé sous Dapper. Inutile sous edgy

Rédigée et maintenue par Id2ndR.

Cette page indique comment installer une carte Wifi basée sur le chipset zd1211 de ZyDAS. Les manipulations indiquées ont été testées avec le modèle Peabird Wlan USB.

Les pilotes fournis avec Dapper (et antérieur) sont sources de problèmes car très vieux (bug #37795).

Pour la version edgy, les pilotes ont été intégrés au noyau et la suite devient inutiles !

Vous êtes sont invités à utiliser les nouveaux pilotes. Les utilisateurs de live-cd ou n’ayant pas la possibilité de télécharger les nouveaux pilotes pourront essayer cette méthode.

Si vous ne savez pas si votre clef Wifi USB est basée sur le chipset ZyDAS 1211, vous pouvez le savoir par l'un des moyens suivant.

Lorsque vous l'avez vérifié, passez à l’étape suivante.

Ouvrez Système → Administration → Gestionnaire de périphériques.

Cherchez alors dans la liste à gauche le périphérique USB qui correspond à votre clef Wifi. Dans mon cas il s’appelle USB2.0 WLAN.

Cliquez alors sur l’onglet Advance dans la partie droite.

1. cherchez les ligne usb_device.vendeur_id et usb_device.product_id et relevez leurs valeurs entre paranthèses (sans tenir compte du 0x). Dans mon cas les valeurs sont 0ace et 1211.
2. Comparez alors ces valeurs à la colonne USB ID disponible à l’adresse http://zd1211.ath.cx/. La colone est de la forme <vendeur_id>:<product_id>.

• Ouvrez un terminal (Applications → Accessoires → Terminal) puis listez les infos des périphériques USB :

  $ lsusb

• Cherchez la ligne correspondant à votre clef wifi. Si vous ne la trouvez pas au premier coup d’oeil procédez par élimination en “éliminant” les périphériques identifiés ; cherchez alors si l’ID d’un périphérique correspond à la colonne USB ID disponible à l’adresse http://zd1211.ath.cx/.

Un module du noyau est un pilote qui va vous permettre d'utiliser votre matériel.

J'ai compilé le pilote et le met à disposition sur internet pour plus de souplesse. Néanmoins vous pouvez recompiler une nouvelle version si vous n'êtes pas dans une configuration standard (architecture différente par exemple).

• Téléchargez le bon module (voir remarque plus bas) dans votre Dossier personnel:
  1. ubuntu 6.06 LTS (2.6.15 386) : cette version est la plus standard.
  2. ubuntu 6.06 LTS (2.6.15 686)
  3. Autre architecture ou version du noyau : il vous faut recompiler les sources du module.

Remarque : Ce module a été compilé avec la version 2.6.15-23 du noyau. Néanmoins elle marche sur la version actuelle (la 2.6.15-25). Elle devrait marcher sans problème pour toutes les versions de la série 2.6.15.

Il faut maintenant remplacer le module du noyau par la version téléchargée.
Important : A chaque fois que vous mettez à jour le noyau, il vous faudra remplacer à nouveau le module avec la manipulation ci-dessous.

• Ouvrez un terminal et exécutez :

$ sudo rmmod zd1211
$ sudo mv /lib/modules/`uname -r`/kernel/drivers/usb/net/zd1211/zd1211.ko /lib/modules/`uname -r`/kernel/drivers/usb/net/zd1211/zd1211.ko.bak
$ sudo cp ~/zd1211.ko /lib/modules/`uname -r`/kernel/drivers/usb/net/zd1211/

Remarque : uname -r est une commande système permettant de déterminer l'architecture de système ainsi que la version du noyau utilisé. Le module à utilisé doit avoir été compilé pour votre architecture.

Je suppose que votre clef wifi correspond à l’interface réseau wlan0 (ce qui est le cas si vous n’avez pas d’autres périphériques wifi)

Vous pouvez utiliser l’environnement graphique ou la commande :

• Sous environement graphique : suivez la procédure standard d'installation du Wifi.
• En ligne de commande :
  1. Activez l’interface réseau par

     $ sudo ifconfig wlan0 up

  2. Configurez le nom du réseau et la clef wep

     $ sudo iwconfig wlan0 essid <nom_du_réseau> [key <clef_wep>]

Après avoir suivi une des deux méthodes, votre interface réseau wlan0 est active et configurée avec le nom du réseau (et la clef wep éventuelle).

Maintenant votre clef wifi est connectée au réseau sans fil. Malgré celà vous n’avez pas accès au réseau.

En fait la configuration ip n’est pas effective. Je vous invite donc à reprendre le tutoriel général sur le réseau à cette étape.

Consultez la documentation pour la configuration du WPA.

Remarque : si votre réseau est caché, il peut être utile de spécifier le nom du réseau (essid) dans les réglages du réseau (ou avec iwconfig) : voir Aucune sécurité ou WEP. Attention : ne mettez pas de clef wep !

Ouvrez un terminal, et effectuez les commandes suivantes:

• Listez les réseaux disponibles :

  $ sudo iwlist wlan0 scanning

• Vérifiez ensuite que tout fonctionne : l’adresse MAC du point d’accès indiquée par la commande suivant ne doit pas être 00:00:00:00:00:00 (adresse invalide) :

  $ iwconfig wlan0 | grep 'Access Point:'

Merci à Cyril 42 pour avoir contribué à cette documentation en me faisant part des problèmes qu'il a rencontré par mail, et en rédigeant la base de ce qui suit.

Normalement, vous devriez voir l'interface wlan0 dans le réseau avant de suivre la procédure de cette documentation.

Néanmoins, si wlan0 n'apparait pas, et que votre carte utilise bien le module zd1211, le module zd1211 ne se recharge pas quand on rebranche la clé.

Dans ce cas en suivant la procédure de cette documentation, au moment de l'installation, vous avez observé :

$ sudo rmmod zd1211

renvoit

ERROR : Modules zd1211 doen't exist in /proc/modules 

• Test

Comment régler le probleme : en rechargeant le module avec

$ sudo modprobe zd1211

Vérifiez alors que vous avez l'interface wlan0.

• Automatisation

Pour éviter de le faire à chaque démarrage, éditez le fichier /etc/modules :

$ sudo gedit /etc/modules

puis ajoutez à la fin du fichier zd1211. Enregistrez et quittez.