====== Configuration du Wifi : méthode facile ======

===== Introduction =====

Pour installer le Wifi sur Linux, deux méthodes sont possibles :

    * Utiliser un module du noyau Linux spécifique à votre carte Wifi.
    * Utiliser le module NDISwrapper qui utilisera un pilote Windows. 

Nous ne traitons ici que de l'utilisation d'un module du noyau Linux spécifique à votre carte. NDISwrapper fera l'objet d'une autre documentation. 

Pour utiliser un module spécifique du noyau Linux, il faut :

    - Connaître son matériel Wifi.
    - Savoir quel module correspond à sa carte Wifi.
    - Installer ce module, ainsi que le firmware de la carte qui y correspond.
    - Configurer sa connexion au point d'accès.
    - Se connecter, et surfer !

L'outil Netbox de SliTaz permet d'effectuer les 3 dernières étapes en quelques clics. Il est aussi possible de configurer le Wifi simplement en ligne de commande.

===== Utilitaire graphique Wifibox/Netbox =====

Avec //netbox// ou //wifibox// vous pouvez configurer votre Wifi en seulement quelques clics de souris. Si vous savez déjà de quel module vous avez besoin, il est facile à utiliser //wifibox// :
<code>
$ subox wifibox
</code>
//Wifibox// va installer tous les logiciels nécessaires, puis lancera le Wifi. Vous n'aurez pas à installer manuellement votre Wifi.

Voici les étapes nécessaires pour //Wifibox// :

    * Tout d'abord, allez sur l'onglet Pilotes, et installez le module dont vous avez besoin. SliTaz va charger le firmware (si nécessaire), le module du noyau, configurer votre Wifi, et se connecter au point d'accès.
    * Ensuite, allez dans "//Configuration//", et commencez la configuration. Si vous ne savez pas comment faire, jetez un oeil à /etc/network.conf - Wifibox utilise les mêmes paramètres. Cliquez sur "//Start//"
    * Si tout va bien, vous pouvez commencer à surfer !

===== Configurer manuellement votre Wifi =====

Si vous voulez comprendre comment le Wifi fonctionne dans SliTaz, alors vous pouvez essayer de configurer votre Wifi manuellement.

Mais si vous voulez savoir comment fonctionne généralement Wifi sous Linux, ou si votre module de noyau n'est pas sur cette liste, vous devriez plutôt regarder la [[fr:guides:wifi-hard|configuration du Wifi pas à pas]]. 

Voici un résumé rapide des étapes nécessaires : 

    * Connaître votre carte Wifi
    * Vérifier si votre carte Wifi a besoin d'un firmware, par exemple b43, et l'installer
    * Charger le module du noyau spécifique à votre carte Wifi
    * Vérifier que la carteWwifi est détectée et le module chargé
    * Configurer /etc/network.conf
    * Démarrer l'interface Wifi
    * Lancer /etc/init.d/network.sh

Les commandes suivantes font toutes les étapes ci-dessus. C'est aussi la méthode la plus facile : 

<code>
# tazhw detect-pci --get-firmware
# /etc/init.d/network.sh restart
</code>

Maintenant, pour des instructions plus détaillées : 

===== Instructions détaillées =====
===== Connaître son matériel (Identifier sa carte Wifi) ===

Certaines commandes lancées dans un terminal permettent de lister le matériel installé sur son ordinateur. Cela permet d'identifier sa carte Wifi. 

Si vous avez une carte Wifi intégrée : 
<code>
$ lspci | grep -i network
</code>

Si la carte est reliée par USB, il faut l'outil //lsusb// disponible dans le paquet //usbutils// :
<code>
# tazpkg get-install usbutils
$ lsusb
</code>

Dans les deux cas, vous aurez une ligne du genre :

<code>
02:02.0 Network controller: Intel Corporation PRO/Wireless LAN 2100 3B Mini PCI Adapter (rev 04)
</code>

Nous obtenons ainsi des informations sur la carte Wifi :

    * Le fabricant de la carte Wifi : //Intel Corporation//.
    * Le modèle de la carte : //Pro/Wireless Lan 2100 3B//.
    * Le chipset de la carte : //IPW 2100 (Intel Pro Wireless 2100)//.
    * L'interface : //Mini PCI//.

=== Déterminer le module du noyau et le firmware nécessaires ===

Le noyau Linux de SliTaz est volontairement allégé. Certains modules, notamment ceux permettant de reconnaître les cartes Wifi, ne sont pas présents par défaut, mais doivent être chargées par l'utilisateur.

Beaucoup de cartes Wifi fonctionneront si vous chargez le module correct. Le plus facile est de laisser SliTaz auto-detecter votre matériel. 

Pour les cartes Wifi intégrées :
<code>
# tazhw detect-pci
</code>

Pour les cartes USB :
<code>
# tazhw detect-usb
</code>

Parfois, cependant, le module ne suffit pas. Certains types de cartes (Intel par exemple) ont également besoin du firmware. Ce firmware n'est pas un logiciel libre, nous ne pouvons pas le distribuer en tant qu'élément de SliTaz. Vous devrez peut-être aller chercher le firmware sur le site Web du fabricant de votre carte et le télécharger dans ///lib/firmware//. Mais vous allez voir que SliTaz peut parfois le faire pour vous !

=== Pour les modules du noyau b43, b43legacy, ipw2100 ou ipw2200 ===

Si le module du noyau dont vous avez besoin est b43, b43legacy, ipw2100 ou ipw2200, vous devriez également installer le paquet : get-wifi-firmware. Installez-le comme ceci :
<code>
# tazpkg get-install get-wifi-firmware
</code>

=== Démarrer le Wifi ===

get-wifi-firmware va installer des commandes nommées get-"//un module//"-firmware. Pour voir la liste :
<code>
# ls /usr/bin/get-*-firmware
</code>
Lancez le logiciel qui correspond à votre module (ipw2100 dans l'exemple précédent) :
<code>
# get-my_module-firmware
</code>

Par exemple, supposons que votre module est ipw2200, vous pouvez taper :

<code>
# get-ipw2200-firmware
</code>

Cette commande va :

    * Télécharger le firmware correspondant à "//mon_module//", créer le paquet "//mon_module-firmware//", et l'installer.
    * Télécharger les logiciels nécessaires au support du Wifi (iwconfig, wpa_supplicant si nécessaire. ..)
    * Charger le module "//mon_module//" dans le noyau Linux.
    * Appeler ///etc/init.d/network.sh restart//, qui lance le Wifi.

Si ///etc/network.conf// est correctement configuré, vous pouvez surfer !

La façon la plus facile de le faire est de télécharger le firmware graphiquement en utilisant Wifibox (SliTaz Wireless Manager). Effectivement, le gestionnaire du sans-fil en mode graphique de SliTaz (Wifibox) peut réaliser ces étapes dans l'onglet Driver (après avoir choisi le module correct, soit ipw2200, appuyez sur install).

===== Dépanner votre Wifi =====

Voici un bref résumé des étapes nécessaires (résumé répété à nouveau pour la compréhension) :

    * Connaître votre carte Wifi
    * Vérifier si votre carte Wifi a besoin d'un firmware, par exemple b43, et l'installer
    * Charger le module du noyau spécifique à votre carte Wifi
    * Vérifier que la carte Wifi est détectée et le module chargé
    * Configurer /etc/network.conf
    * Démarrer l'interface Wifi
    * Lancer /etc/init.d/network.sh

Les commandes suivantes exécutent toutes les étapes ci-dessus mentionnées. C'est également la meilleure manière de résoudre les problèmes. Pour obtenir une aide maximale sur les forums, veuillez svp inclure la sortie de chacune de ces commandes.

<code bash> 
lspci | grep -i network
modprobe your_module
dmesg | tail 
lsmod 
nano /etc/network.conf
ifconfig eth1 up 
ifconfig -a 
iwconfig 
/etc/init.d/network.sh restart 
ifconfig -a 
</code>

===== Configuration de /etc/network.conf =====

SliTaz démarre le Wifi à l'aide du script /etc/init.d/network.sh. Ce script se sert du fichier de configuration ///etc/network.conf//. Vous devez d'abord modifier votre fichier de configuration en suivant les exemples d'instructions données dans /etc/network.conf.
 Vous trouverez des explications détaillées sur /etc/init.d/network.sh [[fr:guides:network-script|ici]].

Votre module doit cependant être chargé à chaque démarrage. Pour cela, ajouter  « //mon_module// » à la ligne //LOAD_MODULES// dans ///etc/rcS.conf// :

<code>
# geany /etc/rcS.conf
</code>

<file>
LOAD_MODULES="nls_utf8 mon_module"
</file>


===== Aide à la configuration de /etc/network.conf =====

<code bash>
# démarrer ou pas le Wifi au démarrage : "yes" ou "no"
WIFI="yes"
 
#interface wifi, indiquée par iwconfig (généralement "wlan0" ou "eth0")
WIFI_INTERFACE="wlan0"
 
 
# ESSID de son point d'accès : "mon_essid" ou "any"
# si "any" est choisi, SliTaz se connecte au premier point d'accès ouvert disponible.
# attention :
# en France, il n'est pas légal de se connecter au point d'accès d'un particulier,
# même si celui-ci ne prend pas soin de le sécuriser. 
WIFI_ESSID="any" 
 
 
# modes de connexion
# les divers modes possibles sont :
# ad-hoc : la carte peut se connecter à un réseau d'une seule cellule sans point
 d'accès, sert à monter un petit réseau point à point
# managed : la carte peut se connecter à un réseau d'une ou plusieurs cellules
#         avec point d'accès
# master : la carte joue le rôle d'un point d'accès maître
# repeater : la carte joue le rôle d'un répéteur entre différents noeuds.
#          Cette méthode peut être utilisée pour transmettre une connexion Wifi
#          sur de longues distances
# secondary : la carte joue le rôle d'un backup pour Master ou Repeater
# monitor : la carte est passive et ne fait que recevoir les messages
# Le mode managed convient pour les utilisations courantes
# (maison, cyber-café, bureau, fac...)
WIFI_MODE="managed"
 
 
# clef de chiffrement
WIFI_KEY="ma8clef8de8chiffrement8difficilement8déchiffrable"
 
 
# type de clef de chiffrement : wep ou wpa ou any ou none
# si vous utilisez WPA-EAP (par exemple pour le wifi d'une entreprise),
# indiquez any.
WIFI_KEY_TYPE="wpa"
 
 
# driver permettant à wpa_supplicant de communiquer avec la carte Wifi.
# ce driver dépend du module du noyau utilisé.
# les drivers possibles sont :
#  wext = Linux wireless extensions (generique, convient dans la plupart des cas
)
#  hostap = Host AP driver (Intersil Prism2/2.5/3)
#  atmel = ATMEL AT76C5XXx (USB, PCMCIA)
#  wired = wpa_supplicant wired Ethernet driver
WPA_DRIVER="wext"
 
 
# canal wifi. Laissez vide, si vous ne savez pas à quoi cela correspond.
WIFI_CHANNEL=""
 
 
# autres arguments à passer à la commande iwconfig.
# voir la page man d'iwconfig pour plus d'informations.
#       par exemple, un utilisateur de portable désirant économiser sa batterie,
#       devrait indiquer "txpower off" pour que le wifi soit configuré, mais déb
ranché.
#       la commande : iwconfig txpower on rebranchera le wifi à la demande.
WIFI_IWCONFIG_ARGS=""

</code>

===== Informations supplémentaires =====
Pour des instructions plus détaillées : 
premièrement faire « lspci » pour connaître la carte Wifi que vous avez. Une fois que vous savez quelle carte vous avez, vous pouvez lancer une recherche sur Internet pour trouver quel est le module dont vous avez besoin, et si un firmware spécial est nécessaire. Pour vous aider, voici quelques liens utiles :

    * [[http://linux-wless.passys.nl/|Linux wireless LAN support]] (La colonne de droite, indique où trouver le firmware, le cas échéant)
    * [[http://doc.ubuntu-fr.org/wifi|Documentation Wifi Ubuntu]] (Site Web d'Ubuntu, page wifi)
    * [[http://www.google.com/|Google]] avec « //le nom de votre carte wifi// » « //modprobe// » ou « //linux// »
Si ces liens ne sont pas utiles, vous pouvez demander au [[http://forum.slitaz.org/|forum SliTaz]]

Par exemple, nous pouvons apprendre que le //Intel Corporation PRO/Wireless LAN 2100 3B Mini PCI Adapter// fonctionne avec le module //ipw2100//  et que le firmware est disponible à http://ipw2100.sourceforge.net/.

----
\\
^   Section Révision de la page  ^^ 
|Qualité| Bonne  |
|Revue|  |
|Priorité|  |
|Problèmes| |
|Comment améliorer|  |


\\
----