Clé USB wifi "Hercules HWNU-300" sous Ubuntu
Cet article a été publié par jeanyves
le 02-03-09 à 10:56 dans la catégorie Trucs - Astuces
Tags :
- Libre
- TrucsAstuces
- Tutoriel
- Ubuntu
J'ai récemment acquis une clef WiFi Hercules HWNU-300 (disponible un peu partout) apparemment de bonne facture... sous Windows. Aucune procédure de la part du fabriquant n'étant -évidemment- précisée pour la faire fonctionner sous GNU/Linux, voici la démarche à suivre.

Après avoir testé en vain NdisWrapper et différents pilotes (drivers pour anglophiles), j'ai contacté le constructeur Hercules et il s'est avéré que le chipset de cette carte était bien un Ralink 2870... Ralink publie des pilotes officiels sous GPL pour ses cartes sans-fils sous GNU/Linux.
La démarche qui va suivre fonctionne autant pour le 32 bits que pour 64.
Pour faire fonctionner cette carte, il vous faut donc les sources du dernier pilote Ralink (prenez donc "RT2870USB", actuellement la version 2.2.0.0).
Compiler à ce stade ne servirait pas à grand chose pour utiliser cette carte, puisque le pilote ne la prend pas encore en compte. On va donc appliquer un patch, permettant d'une part d'activer le support de cette carte et d'autre part d'activer le support du WPA.
4. Installez "patch" si nécessaire (si vous n'avez pas d'accès à internet sur votre machine, le *.deb pour Ubuntu se trouve sur le live CD dans le dossier pool/main/p/patch/). La compilation se fait en root car elle nécessite la création d'un dossier (inutile ?) à la racine.
5. Chargez ce pilote :
6. Vous pouvez maintenant configurer votre carte par votre gestionnaire de connexion favori et aux petits oignons via le fichier /etc/Wireless/RT2870STA/RT2870STA.dat
2. Copier cette archive dans votre dossier personnel, et décompressez-la là.
3. Ouvrez un terminal (faire ALT-F2 puis taper "xterm" ou choisissez celui de votre choix) et copiez-y :
5. Chargez ce pilote :
6. Vous pouvez maintenant configurer votre carte par votre gestionnaire de connexion favori et aux petits oignons via le fichier /etc/Wireless/RT2870STA/RT2870STA.dat
La démarche qui va suivre fonctionne autant pour le 32 bits que pour 64.
Démarche
Attention, comme toute compilation, cette opération est relativement risquée.Pour faire fonctionner cette carte, il vous faut donc les sources du dernier pilote Ralink (prenez donc "RT2870USB", actuellement la version 2.2.0.0).
Compiler à ce stade ne servirait pas à grand chose pour utiliser cette carte, puisque le pilote ne la prend pas encore en compte. On va donc appliquer un patch, permettant d'une part d'activer le support de cette carte et d'autre part d'activer le support du WPA.
Vous pouvez télécharger ce patch en annexe à ce billet (pour la version 2.2.0.0).
Attention : si vous utilisez une distribution se basant sur le noyau 2.6.31 (ex.: Ubuntu 9.10), suivez la seconde procédure.
Note 1 : pour connaître la version de votre noyau, entrez dans un terminal : ''uname -r''
Note 2 : si vous avez installé Ubuntu par Wubi (Ubuntu comme un programme Windows), cette démarche ne fonctionnera pas.
Note 3 : il existe une version mini de cette carte, la HWNUm 300. Cette dernière utilise un autre chipset, et donc un autre pilote (Realtek RTL8191S). Ne suivez pas ce tutoriel.
Note 4 : lorsque vous devrez tapez votre mot de passe root, il est normal qu'il n'apparaîsse pas (pour la sécurité). Appuyez juste sur
2. Ouvrez un terminal (faire ALT-F2 puis taper "xterm" ou choisissez celui de votre choix)
3. Dans ce terminal, copiez :
Attention : si vous utilisez une distribution se basant sur le noyau 2.6.31 (ex.: Ubuntu 9.10), suivez la seconde procédure.
Note 1 : pour connaître la version de votre noyau, entrez dans un terminal : ''uname -r''
Note 2 : si vous avez installé Ubuntu par Wubi (Ubuntu comme un programme Windows), cette démarche ne fonctionnera pas.
Note 3 : il existe une version mini de cette carte, la HWNUm 300. Cette dernière utilise un autre chipset, et donc un autre pilote (Realtek RTL8191S). Ne suivez pas ce tutoriel.
Note 4 : lorsque vous devrez tapez votre mot de passe root, il est normal qu'il n'apparaîsse pas (pour la sécurité). Appuyez juste sur
enterune fois le mot de passe entré.
Première procédure : votre noyau est plus ancien que le 2.6.31
1. Placez l'archive du pilote, ainsi que le patch dans votre dossier personnel. Décompressez l'archive (Clic droit - Extraire ici) et copiez dans le dossier décompressé le patch (il se peut qu'il y ait une deuxième archive à décompresser).2. Ouvrez un terminal (faire ALT-F2 puis taper "xterm" ou choisissez celui de votre choix)
3. Dans ce terminal, copiez :
cd *RT2870_Linux_STA*
patch -p0 < hwnu300.patch sudo make && sudo make install4. Installez "patch" si nécessaire (si vous n'avez pas d'accès à internet sur votre machine, le *.deb pour Ubuntu se trouve sur le live CD dans le dossier pool/main/p/patch/). La compilation se fait en root car elle nécessite la création d'un dossier (inutile ?) à la racine.
5. Chargez ce pilote :
sudo modprobe rt2870sta6. Vous pouvez maintenant configurer votre carte par votre gestionnaire de connexion favori et aux petits oignons via le fichier /etc/Wireless/RT2870STA/RT2870STA.dat
Seconde procédure : votre noyau est le 2.6.31
1. On va utiliser une version un peu plus ancienne du pilote (juste un rien) qui a déjà été patchée pour supporter la clé et le noyau. Téléchargez ici la version 2.1.2.0 du pilote.2. Copier cette archive dans votre dossier personnel, et décompressez-la là.
3. Ouvrez un terminal (faire ALT-F2 puis taper "xterm" ou choisissez celui de votre choix) et copiez-y :
cd 2009_0521_RT2870_Linux_STA_V2.1.2.0
sudo make && sudo make install5. Chargez ce pilote :
sudo modprobe rt2870sta6. Vous pouvez maintenant configurer votre carte par votre gestionnaire de connexion favori et aux petits oignons via le fichier /etc/Wireless/RT2870STA/RT2870STA.dat
Conclusion
Votre clef devrait être prise en charge par votre système d'exploitation, à chaque démarrage. En cas de mise à jour du noyau, n'oubliez pas de recompiler. En cas de problème lors des mises à jour, regardez si dans votre fichier/etc/network/interfacesne manque pas une ligne
auto ra0.

Commentaires
Merci pour ton tuto.
Le noyau Linux contient un driver pour ce chipset, mais celui-ci est (pour l'instant) à l'état expérimental. Voir cette discussion pour plus d'informations : http://rt2x00.serialmonkey.com/phpBB/viewtopic.php?f=5&t=5121
Utiliser un driver livré avec le noyau simplifie les choses ; ainsi il n'y a plus besoin de compiler le driver à chaque changement de noyau.
Cordialement.
Salut, quel noyau intègre ces drivers ? Le dernier que j'ai essayé ne reconnaissait (2.6.27) pas ma carte, malheureusement.
Salut et merci pour le tuto, j'ai une clé wifi sagem mais impossible de la faire marcher sous mon ubuntu du coups je l'ai laissé aux oubliettes, mais je vais essayer de ta méthode an espérant que ça marche...
J'aimerai savoir si tout ceci n'est pas automatisable dans un script (???)
Hello,
Le principe est simple, il suffit de rajouter les références 'usb' de ta carte dans le fichier rt2870 pour qu'elle soit reconnue par le driver.
Un script permettant d'installer tout ça... J'en vois pas trop l'intérêt au fait, puisqu'au final il n'y a que quelques étapes à faire..
Bonne journée.
Re.
J'ignore à partir de quel noyau ces drivers sont intégrés.
Les drivers Linux pour les chipsets Ralink sont écrits par Serialmonkey : http://rt2x00.serialmonkey.com
Recherche par là-bas, en particulier sur le forum.
Pour ma part, j'ai une carte wifi (sur port PCI) utilisant un chipset Ralink RT2500, et ce chipset est maintenant reconnu par le noyau linux directement, c'est-à-dire que le pilote est déjà dans le noyau ! Cela simplifie beaucoup les choses ! :-)
Bonne continuation.
bonsoir,
le noyau 2.6.27 intègre déjà le driver rt2870 pour ce chipset (en tout cas je l'ai trouvé dans la distribution mandriva 2009 avec ce noyau) mais ce n'est pas encore au point. Apparemment, avec un noyau 2.6.28 ça irait déjà un peu mieux, j'ai pu utiliser ma clé USB wifi D-link DWA 140 avec le driver rt2870 (sur une distribution de backtrack, la 4 notamment). mais la encore c'est pas au point. Mon seul espoir réside dans Mandriva 2009 avec un noyau 2.6.28. pensez-vous qu'il serait préférable d'installer directement le paquet (driver rt2870) qui se trouve dans la distrib ou vaut-il mieux l'installer "manuellement"? merci pour vos avis et commentaires
cordialement.
Et ensuite une fois que l'on a modifié les fichiers on en fait quoi ? =/
Je suis pas trés fort et j'avoue avoir complètement zappé a l'étape 4
A l'aide !!
3 premières étapes franchies sans problème, mais après : ????
Pourriez-vous consacrer 2 minutes aux novices en expliquant point par point l'étape n°4.
Je suis désolé mais je ne vais pas pouvoir vous aider à ce sujet car je ne suis pas l'auteur de cet article (en temps normal je réponds à mes commentaires). Je vais contacter l'auteur et lui demander de vous répondre:)
Mis à jour.
J'ai tout fait mais ma Clé Wifi ne s'allume pas donc le tuto marche pas chez moi, je voudrais obtenir de l'aide içi : Gotrenks93@hotmail.fr
Merci de m'avoir aidez maintenant sa marche.
De meme,j'ai tout fait et Hercule HWNU-300 ne s'allumme pas ou plutot l'interface reseau n'est pas reconnue.
Moi aussi j'aurais besoin d'une petite aide:nidgeek-sprt@live.fr
Pourrais-tu faire la modification avec la mini car je ne comprend rien a ce qui faut faire j'ai ubuntu que depuis qq jours et je chercher a avoir internet jme suis renseigné mais je trouve rien qui m'explique correctement SVp help me :(
Need de l'aide pour HWNUm-300 à l'adresse : thekillersofthesea@hotmail.fr merci !
Bonsoir,
Je crois que j'ai franchit les étapes avec succès pour un novice (récemment installé sous Karmic Koala 9.10 sur un acer aspire revo 3600) mais le dongle USB HWNU-300 ne fonctionne toujours pas. Tout s'est bien passé grâce ton tuto, mais lorsque je tente la dernière "sudo modprobe..." il me demande mon mot de passe, je le tape mais rien ne s'affiche et rien ne se passe en le tapant dans le vide... Que faire ?
Merci pour votre aide !
djeuff@gmail.com
Bonjour,
Je possède cette clé et je n'ai pas réussi à la faire fonctionner avec Karmic, contrairement à Jaunty avec votre tuto.
Si vous avez une solution je suis preneur
Salut !
A ceux qui utilisent Karmic, c'est maintenant mis à jour.
La procédure a été mise à jour pour Ubuntu 9.10 et co.
yep,bonjour à tous,je voulais savoir de quel patch tu parles pour karmic,le driver est deja patché pour la deuxieme procédure...
jamais eu de gros problèmes pour compiler ce driver sur les versions précédentes "8.04 et 9.04",mais là je suis face a un mur,idem pour les versions "rt" des noyaux linux...ca compile mais aucune reconnaissance dans les ifconfig et iwconfig et bien entendu clé éteinte...j'ai essayé l'ancienne démarche,modifier moi-même les fichiers avant de compiler...rien..j'ai ensuite trouvé le tuto ci dessus pour les noyaux plus récents,essayé et rien non plus.
Peut-être un paquetage manquant? build-essential est là...je sais pas..
Salut,
Je suis la démarche expliquée sur ton forum mais étant débutant j'ai un petit soucis...
je suis sous ubuntu 9.10 donc j'utilise la deuxième version
après avoir fait sudo modprobe rt2870sta
il me dit nico@nico-desktop:~/2009_0521_RT2870_Linux_STA_V2.1.2.0$ sudo modprobe rt2870staWARNING: All config files need .conf: /etc/modprobe.d/ndiswrapper, it will be ignored in a future release.
est-ce qu'il y a un soucis, que dois je faire ensuite...
Merci pour votre aide
Nicowonto
Salut,
Je suis sous Karmic. J'ai bien fait tout le tuto, réinstallé ma machine, mais rien n'y fait, ma clé HWNU-300 ne se connecte pas. Je la vois bien en faisant un lsusb, j'ai bien chargé le rt2870sta, j'ai bien blacklisté le rt2800usb. J'ai essayé avec Karmic en 32 et 64 bits, rien ne change. Si qq1 a une idée sur ce que j'oublie ou que je ne fais pas correctement ?
Merci
bonjour, je débarque dans Ubuntu et dans ce forum....ce message m'intéresse mais je souhaite qqs explications ...et surprise...en voulant mettre mon commentaire...je ne vois plus le texte...curieux...
bref ...quel référence de la carte ou de la clé faut il mettre et dans quel dossier RT2870 ?
merci d'avance..
reprise car mon précédant commentaire devait être difficile à comprendre.....il fait suite à cela:
Le 02-03-09, 21:12 par kouskous
Hello,
Le principe est simple, il suffit de rajouter les références 'usb' de ta carte dans le fichier rt2870 pour qu'elle soit reconnue par le driver.
Un script permettant d'installer tout ça... J'en vois pas trop l'intérêt au fait, puisqu'au final il n'y a que quelques étapes à faire..
Bonne journée.
bonjour, je débarque dans Ubuntu et dans ce forum....ce message m'intéresse mais je souhaite qqs explications ...et surprise...en voulant mettre mon commentaire...je ne vois plus le texte...curieux...
bref ...quel référence de la carte ou de la clé faut il mettre et dans quel dossier RT2870 ?
merci d'avance..
Je me suis mal expliqué.
Dans une console, entre 'lsusb' et regarde le résultat, et observe le fichier .patch ci-dessus.
Au final, ces manip's fonctionnent pour toute clé USB utilisant ce chipset.
@kouskous : merci pour la réponse...j'ai effectivement compris que le patch initialise aussi le nom du produit...mais ma clé n'est toujours pas reconnue...
j'ai une autre clé Zd1211 qui elle est reconnue mais c'est une 54Mb et le rayonnement est moins bon (40%) d'où vitesse très réduite... quand çà ne décroche pas...
je continu de chercher...tétu le vieux...
derniere nouvelle...après bien des déboires...
j'ai la version 2.6.31 Ubuntu et il semble qu'il y a une anomalie dans les fichiers de la version V2.3.0.0 de RT2870 .
le fichier contenant la table des fournisseurs (rtusb-dev_id.c) est dans le dossier "common" alors qu 'il est attendu dans le dossier "os"... le déplacement a résolu le problème...
merci a tous pour les infos diffusées sur les forums mais pour un bleu, vu le nombre de versions tant de Linux que de drivers il y a de quoi être perdu ...
a+
bonjour,
j'ai suivi la procédure 2 car mon noyau est un 2.6.32. mais il y a une erreur. Voici le message que j'ai eu.
root@marie-desktop:/home/marie# cd 2009_0521_RT2870_Linux_STA_V2.1.2.0 sudo make && sudo make install
make -C /home/marie/2009_0521_RT2870_Linux_STA_V2.1.2.0/os/linux -f Makefile.6 install
make1: entrant dans le répertoire « /home/marie/2009_0521_RT2870_Linux_STA_V2.1.2.0/os/linux »
rm -rf /etc/Wireless/RT2870STA
mkdir /etc/Wireless/RT2870STA
cp /home/marie/2009_0521_RT2870_Linux_STA_V2.1.2.0/RT2870STA.dat /etc/Wireless/RT2870STA/.
install -d /lib/modules/2.6.32-21-generic/kernel/drivers/net/wireless/
install -m 644 -c rt2870sta.ko /lib/modules/2.6.32-21-generic/kernel/drivers/net/wireless/
install: ne peut évaluer `rt2870sta.ko': Aucun fichier ou dossier de ce type
make1: *** install Erreur 1
Si vous pouviez m'aider ce serait super car je suis un ptit nouveau avec linux.
Jeromeauguste
Comment que l'on charge le pilote sudo modprobe rt2870sta ? S'il vous plait, merci !
je débute avec linux ubuntu... et une clé wifi HWNUm-300 et une version 2.6.35.28
j'ai du mal à tout comprendre quelqu'un peut me venir en aide SVP