✎ ndiswrapper [Wiki ubuntu-fr]

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

{{tag>Trusty réseau matériel windows wifi}}
----

====== NDISWrapper - Pilotes Windows™ sous Linux™======

**NDISWrapper** est un module du [[:kernel|noyau Linux]] qui permet l'utilisation de pilotes Windows® (la plupart du temps pour des cartes réseaux Ethernet et Wifi mais pas uniquement.)

N'hésitez pas à tester toutes les versions des différents pilotes de ce que vous essayez de faire fonctionner. Les pilotes 32 bits pour Windows-XP® semblent être les premiers à tester. N'hésitez pas non plus à essayer les pilotes 64 bits si vous utilisez Windows 64 bits. (même s'il faut parfois aussi essayer les 32 bits ...)

<note help>Gardez à l'esprit que **Ndiswrapper** n'est qu'une solution de remplacement. Malgré le fait qu'il soit très stable et parfaitement utilisable, il est en effet préférable de chercher avant toute excursion dans les méandres de **Ndiswrapper**, de vérifier si un pilote Linux existe en:
  * Essayant la carte sans rien faire, en effet la majeur partie du temps aucun pilote supplémentaire n'est requis;
  * Cherchant sur votre moteur de recherche préféré si un pilote Linux non officiellement présent dans Ubuntu est utilisable.

Si votre [[:wifi_liste_carte|carte Wifi]] ne marche toujours pas (ou si le pilote non officiel est trop difficile à installer), essayez **Ndiswrapper**.</note>

===== Pré-requis =====
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer de préférence d'une connexion à Internet configurée et activée.
  * Toutes les manipulations suivantes vont se faire à l'aide d'un **[[:Terminal]]**. Aussi il est conseillé de suivre les quelques tutoriels pour comprendre comment utiliser efficacement ce **[[:terminal]]**.

==== Identification du pilote ====

**Pour savoir s'il est nécessaire d'installer NDISWrapper**, reportez-vous d'abord à la procédure générale de **[[:wifi|configuration d'une interface réseau Wifi]]**.

Avant de continuer vous devez connaître la marque et le modèle exacts de votre carte Wi-Fi, ce qui pourra être utile en cas de CD de pilote "multi-modèles". Voir [[:wifi#identifier_sa_carte_reseau_wi-fi|ce chapitre]] pour vous permettre de l'identifier. Reportez-vous également à [[:wifi_liste_carte|la liste des cartes Wi-Fi]] vous voir ce qui est requis au sujet de votre matériel.

Avant de pouvoir installer les pilotes Windows avec **NDISWrapper**, vous devez les télécharger ou utiliser ceux fournis sur le CD d'installation de votre carte réseau. En général il est aussi donné sur le site de la marque de votre carte Wi-Fi ou de votre ordinateur sous le nom de "Pilote de carte réseau local sans fil".

<note>Vous pouvez trouver quelques pilotes Windows NDIS testés sous Linux sur la [[http://www.linuxant.com/driverloader/|page de Linuxant]] (lien //Windows Drivers// à gauche).</note>

==== Récupération du fichier .inf du pilote Wi-Fi ====

<note important>Choisissez impérativement la version 32 bits du pilote pour Windows (même si vous utilisez Linux ou Windows 64 bits) pour ne pas avoir un pilote 64 bits (qui est incompatible avec Ndiswrapper, même sous Linux 64 bits).\\
Si votre pilote est incompatible changer légèrement le modèle de votre ordinateur pour pouvoir essayer d'autres pilotes</note>

Commençons par créer un dossier **install_wifi** dans votre dossier personnel.\\

Le fichier que nous cherchons est un fichier **.inf**, mais il est rarement disponible directement sous cette forme.\\
Quand vous ouvrez votre CD d'installation du pilote, ou si le pilote est sous forme d'un dossier compressé, vous trouverez peut-être un dossier Drivers, ou pilote, avec à l'intérieur plusieurs dossiers dans le style : Windows Me, Windows 2000, Windows XP. Dans ce cas prenez tous les fichiers du dossier Windows XP (ou windows 2000 si vous n'avez pas de dossier Windows XP), et déplacez-les dans votre dossier **install_wifi** fraîchement créé.

<note important>**Prenez bien garde à prendre tous les fichiers contenus dans le même dossier que le fichier .inf dans votre déplacement de fichiers !!**\\
Le fichier **.inf** n'étant qu'un fichier texte faisant référence aux autres fichiers contenus dans le même dossier que lui !</note>

Si vous ne trouvez pas de dossier comprenant de fichiers **.inf** dans votre CD d'installation, ou en téléchargement sur le site du constructeur, le pilote doit être contenu à l'intérieur même du fichier .exe du pilote. Déplacez donc ce .exe dans le dossier **install_wifi** ...

=== Décompression du fichier .exe pour obtenir le .inf ===
//Si vous avez déjà le fichier .inf, cette étape est donc inutile, vous pouvez directement passer à l'installation.//

Si vous ne disposez que d'un .exe comme pilote sans fichier **.inf**, vous devez le décompresser pour obtenir le .inf nécessaire à l'installation du pilote.
  - [[:tutoriel:comment_installer_un_paquet|installez les paquets]] **[[apt>cabextract,unshield|cabextract et unshield]]**
  - Se positionner dans le dossier **install_wifi** que vous aviez créé précédemment à l'aide de la commande **[[:console#cd|cd]]**: Pour cela, ouvrez un **[[terminal]]** et tapez la [[:commande_shell|commande]] :<code>cd ~/install_wifi</code> 
  - Décompressez le fichier .exe en tapant dans le même [[:terminal]] ceci: <code>cabextract <nom_du_fichier.exe></code>
    * Si aucun fichier n'apparaît dans votre dossier install_wifi, essayez de taper ceci après:<code>unshield x <nom_du_fichier.exe></code>
    * Si rien n'apparaît non plus après ceci, il vous reste l'ultime méthode:\\ Cette méthode consiste à installer le pilote avec [[:Wine]], puis de se rendre dans le dossier : **~/.wine/drive_c/windows/inf** et de récupérer les fichiers qui s'y trouvent pour les mettre dans votre dossier install_wifi, allez ensuite dans le dossier: **~/.wine/drive_c/windows/system32/drivers** et copiez aussi le contenu dans install_wifi.
  - Ensuite allez dans votre dossier **install_wifi** et faites un peu de rangement si vous avez des dossiers résultants de la décompression du .exe, déplacez tous les fichiers contenus dans ces dossiers directement dans install_wifi. \\ Ne faites pas ça pour les sous-dossiers (les dossiers dans les dossiers), mais seulement pour les dossiers.

Garder ce dossier **install_wifi** précieusement, car il vous sera utile dans le cas d'une réinstallation, ou d'une mise à jour importante de votre distribution.

===== Installation=====

[[tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>ndiswrapper]]**.

===Connexion internet non opérationnelle====

Pour ceux qui n'ont aucune possibilité de se connecter à internet, ces paquets se trouvent sur le [[:tutoriel:obtenir_cd_ubuntu|média d'installation d'Ubuntu (desktop dvd, alternate, liveUSB)]] de votre [[:versions|version d'Ubuntu]]. Dans ce cas,
  - Insérer le [[:tutoriel:obtenir_cd_ubuntu|média d'installation d'Ubuntu]] dans son lecteur (ou port USB pour un liveUSB):
  - [[depots#ajouter_un_cd-rom_comme_depot|Ajouter le cd-rom comme dépôt]];
  - Si cela n'est pas fait automatiquement: [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|rechargez la liste de vos paquets]];
  - [[tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt>ndiswrapper]]**.

Vous pouvez aussi copier ces fichiers Ndiswrapper du [[:tutoriel:obtenir_cd_ubuntu|média d'installation d'Ubuntu]] dans votre dossier personnel et lancer la [[:commande_shell|commande]] <code>sudo dpkg -i ndiswrapper*.deb</code>

===== Configuration de NDISWrapper =====

Deux choix s'offrent à vous :

==== Procédure manuelle ====

Premièrement, nous allons charger dans le système le pilote Windows que nous avons récupéré ([[#Récupération du fichier .inf du pilote Wi-Fi|cf. supra]]). Pour cela, ouvrez un [[:terminal]], positionnez-vous à l'aide de la commande **[[:console#cd|cd]]** dans le dossier où se trouvent les pilotes (avec les fichiers .sys etc., pas uniquement le fichier .inf) et tapez (le nom du fichier .inf dépend de votre pilote) :
<code>cd <dossier_où_se_trouve_le_pilote></code>
Si vous avez suivi la documentation ça devrait être :
<code>cd ~/install_wifi</code>

<note help> Pour la [[commande_shell|commande]] ndiswrapper il se peut que la syntaxe soit légèrement différente, pour cela taper dans un [[:terminal]] ''**ndiswr**'' puis demander une [[:console#optimiser_la_console_auto-completion|auto-complétion]] en appuyant plusieurs fois sur la touche <TAB>.</note>

<code>sudo ndiswrapper -i votre_pilote.inf</code>

<note importante> Le nom du fichier .inf est sensible à la casse ! N'hésitez pas à utiliser la [[:console#optimiser_la_console_auto-completion|touche <Tab> pour compléter automatiquement le nom du fichier]].</note>

Pour vérifier que NDISWrapper a bien installé votre pilote, tapez la [[:commande_shell|commande]] suivante:<code>ndiswrapper -l</code>
Vous devriez voir un message dans le genre de celui-ci :
<code>
Installed ndis drivers:
(votre_pilote) driver present, hardware present
</code>

Ensuite, nous allons créer un module pour le charger dans le [[:kernel|noyau Linux]]. Ce module sera créé à partir du pilote Windows que nous avons chargé précédemment. Pour faire ceci, utilisez la [[:commande_shell|commande]] suivante dans un [[:terminal]]:
<code>sudo ndiswrapper -m</code>

==== Procédure graphique ====

Il existe un utilitaire qui se nomme **[[:ndisgtk]]** et qui effectue la procédure ci-dessus de manière graphique. Pour e lancer faites une recherche dans [[:unity#tableau_de_bord_dash|le tableau de bord Unity]] avec le mot clé **Windows Wireless Drivers**.

===== Passer la main à NDISWrapper =====

==== Décharger le module par défaut et charger NDISWrapper ====

Étape supplémentaire avant de pouvoir goûter aux joies du nomadisme (limité) , décharger le module qui gère par défaut votre carte Wi-Fi. Même si vous avez correctement configuré NDISWrapper cette étape est nécessaire. En effet imaginez deux personnes (module par défaut et ndiswrapper) voulant manger avec une cuillère (Wi-Fi) et en même temps !

Pour décharger le module par défaut d'abord le connaître :
Vous êtes donc invité à l'étudier dans [[:ndiswrapper#cas_particuliers|cette partie de la documentation]] ou sur le forum Ubuntu.

Une fois que vous savez lequel c'est, il vous faut entrer la [[:commande_shell|commande]] suivante pour décharger ce module :
<code>sudo modprobe -r nom_du_module_à_blacklister</code>
Par exemple pour le chipset bcm43xx
<code>sudo modprobe -r bcm43xx</code>
Les commandes ci-dessus déchargent les modules pour la session en cours et il faut qu'au prochain démarrage ces modules ne se chargent pas. Il faut donc les blacklister [[:ndiswrapper#cas_particuliers| voir la partie cas particuliers]]

Nous allons maintenant tester si le module que nous venons de créer fonctionne. Pour cela, on va le charger dynamiquement dans le noyau avec la [[commande_shell|commande]] suivante :
<code>sudo modprobe ndiswrapper</code>

Si tout s'est bien passé, vous devriez avoir une interface //eth1// ou //wlan0// existante. Vous pouvez vérifier cela en tapant //iwconfig// dans un [[:terminal]] ou en allant dans le menu **Système -> Administration -> Réseau**.

<note> Si ce n'est pas le cas, essayez de décharger le module et rechargez-le : ''sudo modprobe -r ndiswrapper'' puis ''sudo modprobe ndiswrapper''.</note>
<note>Sur [[:precise|Ubuntu Precise 12.04]], vous risquez d'avoir ce message d'erreur : **FATAL: Module ndiswrapper not found**. Dans ce cas, installez le paquet ndiswrapper-dkms puis rechargez le module :<code>sudo apt-get install ndiswrapper-dkms
sudo modprobe ndiswrapper</code></note>

=== Charger automatiquement NDISWrapper au démarrage du système ===

Pour que NDISWrapper se charge à chaque démarrage, il suffit d'ajouter une ligne contenant **ndiswrapper** à la fin du fichier « /etc/modules ». Faites-le manuellement ou exécutez la [[:commande_shell|commande]] suivante dans un [[terminal]]: :
<code>echo "ndiswrapper"|sudo tee -a /etc/modules</code>

Ou bien lancer le chargement du module NDISwrapper en utilisant le script de démarrage **/etc/rc.local**. Pour ce faire:
  - [[:tutoriel:comment_modifier_un_fichier|éditer]] le fichier **/etc/rc.local**; 
  - Insérer la commande<file>/sbin/modprobe ndiswrapper &</file>Devant la commande <file>exit 0</file>
  - Enregister et fermer le fichier.

===== Vérification de l'installation =====
==== L'ordre d'exécution des commandes ====
Ceci est peut-être trivial mais il vous faut respecter cet ordre (à adapter en fonction des cas), en résumé :
  - installer le logiciel NDISWrapper
  - référencer le pilote pour Windows dans NDISWrapper :\\ ''sudo ndiswrapper -i //chemin_complet_du_pilote.inf//''
  - créer l'interface réseau associée à NDISWrapper : ''sudo ndiswrapper -m''
  - décharger le pilote pour Linux :\\ ''sudo modprobe -r //nom_du_module_a_backlister//''
  - bloquer le chargement automatique du pilote pour Linux :\\ ''echo "blacklist //module_a_backlister//"|sudo tee -a /etc/modprobe.d/blacklist.conf''
  - charger NDISWrapper comme nouveau pilote pour Linux :\\ ''sudo modprobe ndiswrapper''
  - forcer le chargement automatique de NDISWrapper au démarrage:\\ ''echo "ndiswrapper" | sudo tee -a /etc/modules''
==== Les réponses des commandes ====
La [[:commande_shell|commande]] magique **''ndiswrapper -l''** n'est pas là pour faire jolie, c'est elle qui vous indique que l'installation du pilote s'est bien passée **ou pas**. Si la réponse est : \\
Installed ndis drivers: \\
(votre_pilote) driver present, hardware present \\
Bravo votre pilote est installé sinon ceci veut dire que le pilote ( .inf ) est incompatible. Il vous faut en chercher un autre mais ceci veut également dire qu'il vous faut désinstaller le pilote qui vient de causer problème (voir la partie [[:ndiswrapper#desinstallation|désinstaller le pilote]] ).

Enfin la commande de confirmation est sans aucun doute iwconfig. 
<code>~$ iwconfig
lo        no wireless extensions.

eth1      no wireless extensions.

eth0      IEEE 802.11g  ESSID:"ssid"  
          Mode:Managed  Frequency:2.417 GHz  Access Point: xx:xx:xx:xx:xx   
          Bit Rate=5.5 Mb/s   Tx-Power:32 dBm   
          RTS thr:2347 B   Fragment thr:2346 B   
          Power Management:off
          Link Quality:26/100  Signal level:-79 dBm  Noise level:-96 dBm
          Rx invalid nwid:0  Rx invalid crypt:0  Rx invalid frag:0
          Tx excessive retries:12766  Invalid misc:559650   Missed beacon:0
</code>
eth0 est donc l'interface Wi-Fi qui est reconnue !

**Vous pouvez maintenant configurer l'interface sans fil. Pour cela, rendez-vous sur [[:wifi|cette page]].**
<note>La page [[:WiFi]] n'explique pas quel utilitaire de connexion utiliser avec ndiswrapper, celui par défaut ne fonctionnant pas.
Il faut donc ajouter une section ici afin d'achever la procédure d'installation du module--- //[[:utilisateurs:doc83|doc83]] Le 27/10/2012, 18:27//</note>

===== Désinstallation =====

==== Suppression du pilote ====
Depuis un [[terminal]] avec les [[commande_shell|commandes]] suivantes:
  - On désinstalle le pilote :<code>sudo ndiswrapper -r <nomdudriver></code>
  - et Puis, on décharge le module du noyau :<code>sudo modprobe -r ndiswrapper</code>

==== Désinstaller NDISWrapper ====
  - [[:tutoriel:comment_modifier_un_fichier|Éditez le fichier]] « /etc/modules » en mode [[:sudo|super-utilisateur]] et supprimez **ndiswrapper** à la fin du fichier.
  - Depuis un [[:terminal]] avec les [[:commande_shell|commandes]] suivantes on désinstalle **NDISWrapper**: <code>sudo modprobe -r ndiswrapper
sudo apt-get remove ndiswrapper-utils --purge</code>

==== Suppression des traces résiduelles ====
[[:tutoriel:comment_supprimer_un_paquet|Supprimez le paquet]] **ndiswrapper-utils, ndiswrapper-utils-1.9** selon votre version d'Ubuntu.

Enfin, supprimez les "résidus" d'installation avec les [[commande_shell|commandes]] suivantes siasies dans un [[:terminal]]:<code>sudo rm -r /etc/ndiswrapper/ 
sudo rm -r /etc/modprobe.d/ndiswrapper
sudo rm -r /etc/modprobe.d/ndiswrapper.conf
sudo rm /lib/modules/`uname -r`/kernel/drivers/net/ndiswrapper/ndiswrapper.ko</code>

Maintenant, il ne devrait rester aucune trace de NDISWrapper dans votre système.

===== Problèmes et solutions =====

==== Carte « aveugle » ====

Il se peut que la carte ainsi configurée semble marcher mais ne voit jamais aucun réseau. Dans ce cas la [[:commande_shell|commande]] <code>sudo iwlist wlan0 scan</code> retourne <code>Aucun résultat</code>

<note important>Cette erreur peut très bien ne pas être systématique ! C'est-à-dire que vous pouvez avoir un truc qui marche plusieurs fois, et qui se met à ne plus marcher un jour, pour un bon moment. </note>

Une solution qui marche plutôt bien pour régler ce problème est de rajouter l'option ''**irqpoll**'' au démarrage.
pour ce faire [[:tutoriel/comment_modifier_un_fichier|éditer le fichier]] ''/etc/default/grub'' avec les [[:sudo|droits d'administration]] et rajouter ''irqpoll'' à la fin de la ligne ''**GRUB_CMDLINE_LINUX_DEFAULT**''((voir le tutoriel [[:tutoriel:grub2_parametrage_manuel#fichieretcdefaultgrub|grub2 : parametrage manuel]] pour plus d'informations)).
<file >GRUB_CMDLINE_LINUX_DEFAULT="quiet splash irqpoll"</file>

Ensuite, il faut régénérer le menu grub avec la commande :
<code>sudo update-grub</code>

Puis redémarrer Ubuntu et revérifier la détection des réseaux.

Si cela ne fonctionne toujours pas, essayer avec les options ''**pnpbios=off**'' et ''**acpi=force**'' en plus de irqpoll :
<file>GRUB_CMDLINE_LINUX_DEFAULT="quiet splash pnpbios=off acpi=force irqpoll"</file>
===== Cas particuliers =====

Maintenant  que NDISWrapper a pris en charge votre carte Wi-Fi, il faut désactiver le module/pilote par défaut pour éviter un conflit au prochain redémarrage. Ceci se résume à écrire une seule ligne dans un fichier.

Si votre carte n'est pas listée en dessous, faites une recherche sur le module par défaut gérant la wifi de votre ordinateur. La commande [[:diagnostic_outil|lsmod]] sera utile.

==== Accès au Wi-Fi via un adaptateur USB Netgear ====

Vous trouverez la procédure sur [[:wifi_realtek_rtl8187#blacklister_les_pilotes_qui_posent_probleme|cette page]].

==== Broadcom Corporation ====

[[:wifi_broadcom_BCM43xx|Page sur les bcm43xx en général, suivant différentes méthodes]]

===Chipset  BCM4318===

Il faut éditer le fichier /etc/modprobe.d/blacklist.conf et rajouter une ligne, le code suivant effectue cette manipulation automatiquement.
<code>echo -e "blacklist ssb\nblacklist b43"| sudo tee -a /etc/modprobe.d/blacklist.conf</code>

Puis de même pour le fichier /etc/modprobe.d/ndiswrapper
<code>echo 'install ndiswrapper modprobe -r ssb; modprobe --ignore-install ndiswrapper $CMDLINE_OPTS; modprobe ssb'| sudo tee -a /etc/modprobe.d/ndiswrapper</code>

Après un redémarrage votre carte devrait fonctionner.

==== Chipset Atheros AR5006EG ====
(Rencontré sur un Toshiba P200-12V et un Asus X51R)
De la même manière que pour le chipset BCM4318 ci-dessus, il faut éditer le fichier /etc/modprobe.d/blacklist.conf et rajouter à la fin
<code># Atheros AR5006EG
blacklist ath_pci</code>
Et redémarrer ensuite.
En effet, le pilote madwifi qui gère généralement les chipsets de la marque Atheros ne prend pas en charge ce chipset...

==== Carte Linksys WPC54G ====

Si la commande ''sudo ndiswrapper -i #driver#.inf'' vous a renvoyé des lignes du type:
<file>
Forcing parameter RadioState|0 to RadioState|1
</file>

Ouvrez tous les fichiers .conf du répertoire « /etc/ndiswrapper » en mode super-utilisateur et remplacez ''RadioState|1'' par ''RadioState|0'' puis sauvegardez les modifications.

==== Chipset ACX100 ====

Si vous ne pouvez pas utiliser le pilote libre (incompatibilité ou WPA ...), avant d'installer le pilote windows via NDISWrapper, il faut désactiver le pilote libre, comme indiqué sur cette page: [[:wifi_chipset_ti_acx|Pilote ACX]]

==== Carte NETGEAR PCMIA MA521 ====

Se rendre sur le site constructeur http://firmware.netgear-forum.com/index.php?produit=MA521 (5.175).

De là décompresser l'archive (ma521_5_175_1204_2006.zip), on obtient un 'setup.exe'. En l'installant via [[:wine|wine]], il suffit de se rendre dans le dossier :
~/.wine/drive_c/windows/inf/MA521_patch et récupérer les fichiers **NETMA521.inf** et **MA521nd5.sys** (il vous faut ces deux fichiers).

Un autre lien pour récupérer ces deux fichiers (archive tar.gz) : http://www.clicksources.com/netgear_MA521.tar.gz ( [[utilisateurs:McPeter]] )

==== Si les ESSID ne s'affichent pas ====

Ouvrir en mode super-utilisateur le fichier « /etc/network/interfaces » puis sauvegarder sans rien modifier.

===== Exemples de cartes =====

* [[:livebox]]
  * [[:wifi_trendnet_tew-423pi]]
  * [[:wifi_belkin_f5d6020|carte Wifi PCMCIA Belkin F5D6020]]
  * Stick USB sans fil (802.11g) Olitec

===== Liens utiles =====
  * **(en)** [[http://ndiswrapper.sourceforge.net/mediawiki/index.php/Installation|guide d'installation sur le site officiel]]
  * **(en)** [[https://help.ubuntu.com/community/WifiDocs/Driver/Ndiswrapper|Guide d'installation sur le wiki anglophone]].

----
/ Contributeurs : [[utilisateurs:ostaquet]], [[utilisateurs:chuckychuck]], [[utilisateurs:DidRocks]], [[utilisateurs:Lestat_the_vampire|Lestat the vampire]], [[utilisateurs:McPeter]], Dav999, [[utilisateurs:owintwist|OwInTwIsT]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : S Y D I G 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