Translation(s): English


Périphériques Prism 2/2.5/3 (hostap)

Cette page décrit comment utiliser, sur les systèmes Debian, les périphériques WiFi USB basés sur les chipsets Prism 2/2.5/3 avec le pilote Host AP.

Pilote

Le pilote Host AP fournit la prise en charge des chipsets WiFi 802.11b Prism 2/2.5/3 d'Intersil (maintenant Conexant) :

<!> Les périphériques USB ne sont pas pris en charge, voir linux-wlan-ng.

{i} Les chipsets 802.11g Prism54 sont pris en charge par les pilotes p54.

Le pilote Host AP est inclus dans le noyau Linux (depuis la version 2.6.14). Il était auparavant empaqueté pour Debian dans le paquet source hostap-driver (retiré voir 423247). Parmi les avantages de ce pilote, on trouve :

Le pilote utilise un firmware enregistré dans la mémoire flash du périphérique. Comme les périphériques Prism 3 SSF (Small Serial Flash) n'ont pas de firmware dans la mémoire flash, il faut télécharger le firmware avant de les faire fonctionner.

Installation

Le pilote Host AP fait partie du noyau Linux ; il est inclus comme module dans les images du noyau Debian.

  1. Installez les paquets hostap-utils et wireless-tools :

    aptitude install hostap-utils wireless-tools

    Notez que l'installation du paquet hostap-utils blacklistera les pilotes orinoco.

  2. Si ce n'est pas déjà fait, connectez votre périphérique. Le module du noyau nécessaire est automatiquement chargé pour les périphériques pris en charge.

  3. Vérifiez que votre périphérique a une interface disponible :

    iwconfig
  4. Mettez en route l'interface pour activer le WiFi, par exemple :

    ifconfig wlan0 up
  5. Configurez l'interface de votre réseau sans fil. Voir aussi firmware.

Dépannage

Voir ci-dessous firmware.

Firmware

L'utilitaire prism2_srec peut être utilisé pour vérifier et télécharger les images du firmware dans les périphériques Prism 2/2.5/3 dans les systèmes Linux. Il est fourni par le paquet hostap-utils.

On trouvera plus d'informations sur le flashage du firmware de ces périphériques (avec cet utilitaire ou d'autres) dans le mini-HOWTO de Jun Sun sur le flashage des chipsets Prism d'Intersil.

On peut se procurer ces firmware sur les pages http://linux.junsun.net/intersil-prism/firmware/ ou http://www.red-bean.com/~proski/firmware/

Vérifications

Vous pouvez vérifier la version des firmware primaire et de la station (ou secondaire) de votre périphérique en examinant le "ring buffer" (liste circulaire) du noyau (dmesg(1)):

wifi0: NIC: id=0x800c v1.0.0
wifi0: PRI: id=0x15 v1.1.0
wifi0: STA: id=0x1f v1.4.9

... ou en utilisant l'utilitaire hostap_diag :

$ su
# hostap_diag wlan0
Host AP driver diagnostics information for 'wlan0'

NICID: id=0x800c v1.0.0 (PRISM II (2.5) PCMCIA (SST parallel flash))
PRIID: id=0x0015 v1.1.0
STAID: id=0x001f v1.4.9 (station firmware)

Prism 3 SSF

Il faut fournir un firmware aux périphériques Prism 3 SSF (Small Serial Flash) dans la mesure où il n'est pas stocké dans la mémoire flash du périphérique. Le paquet hostap-utils fournit l'aide d'ifupdown(8) à cet effet : fw_primary et fw_secondary.

Exemple de fichier de configuration /etc/network/interfaces utilisant ces options de commande :

iface wlan0 inet dhcp
    wpa-ssid foo
    wpa-psk barbazqux
    fw_primary /lib/firmware/pm010102.hex
    fw_secondary /lib/firmware/rf010800.hex

Avant que l'interface ne se lance, prism2_srec demandera le chargement des images des primaire et de la station (ou secondaire) dans la mémoire volatile du périphérique.

On doit donc fournir les images du firmware adaptées au périphérique. Le firmware Prism 3 se trouve sur les pages http://linux.junsun.net/intersil-prism/firmware/ et http://www.red-bean.com/~proski/firmware/

Voir aussi renommer l'interface du réseau.

Télécharger en mémoire vive

{i} La procédure suivante peut être utilisé pour mettre à jour de façon provisoire le firmware secondaire (de station) dans la version 1.7.4 ou ultérieure qui est nécessaire pour la prise en charge du WPA.

Les firmware primaire et secondaire peuvent être téléchargés dans la mémoire volatile (mémoire vive) pendant la configuration de l'interface (voir Prism 3 SSF plus haut). On peut aussi le faire avec les périphériques où le firmware est en mémoire pour mettre à jour provisoirement les firmware primaire et secondaire jusqu'à l'extinction du périphérique.

Le script /etc/network/if-pre-up.d/hostap-utils fournit par le paquet hostap-utils présume l'utilisation d'un périphérique Prism 3 SSF. Une petite modification est nécessaire pour permettre le téléchargement du firmware secondaire (dev station) sur les autres périphériques Prism 2/2.5/3.

Ouvrez le fichier /etc/network/if-pre-up.d/hostap-utils avec un éditeur de texte et commentez les lignes 27 et 30 :

load_secondary()
{
#        if ! grep -q pri_only=1 /proc/net/hostap/$1/debug; then
                echo "Downloading secondary (station) firmware $2 to interface $1"
                $PRISM2_SREC -rp $1 $2
#        fi

        return 0
}

Cette modification réalisée, utilisez les options de commande fw_primary et fw_secondary. Par exemple, la définition d'interface suivante dans /etc/network/interfaces téléchargera les firmware primaire, v1.1.4, et secondaire (de station), v1.7.4, dans la mémoire vive d'un périphérique "Microsoft Wireless Notebook Adapter MN-520" :

iface wlan0 inet dhcp
    wpa-ssid foo
    wpa-psk barbazquz
    fw_primary /lib/firmware/ak010104.hex
    fw_secondary /lib/firmware/rf010704.hex

Après avoir activé l'interface (ifup wlan0), on peut utiliser hostap_diag pour vérifier la version des firmware utilisés :

# hostap_diag wlan0
Host AP driver diagnostics information for 'wlan0'

NICID: id=0x800c v1.0.0 (PRISM II (2.5) PCMCIA (SST parallel flash))
PRIID: id=0x0015 v1.1.4
STAID: id=0x001f v1.7.4 (station firmware)

Voir aussi Renommer l'interface du réseau.

Télécharger en mémoire flash

{i} La procédure suivant peut être utilisée pour mettre à jour, de façon permanente, le firmware secondaire (de station) dans sa version 1.7.4 ou ultérieure qui est nécessaire pour la prise en charge du WPA.

Les images du firmware peuvent aussi être téléchargées dans la mémoire flash, non-volatile, qui pourra mettre à jour le firmware enregistré sur le périphérique. Cela peut être réalisé en utilisant prism2_srec. Ce n'est pas possible avec les périphériques Prism 3 SSF.

<!> Attention : Une utilisation incorrecte de cet utilitaire peut rendre votre périphérique inutilisable.

Cette fonctionnalité nécessite la prise en charge du téléchargement du firmware Host AP non-volatile, qui est désactivé dans les versions standards des images noyau de Debian :

$ grep HOSTAP_FIRMWARE_NVRAM /boot/config-`uname -r`
# CONFIG_HOSTAP_FIRMWARE_NVRAM is not set

Voir HowToRebuildAnOfficialDebianKernelPackage pour compiler un noyau personnalisé avec l'option CONFIG_HOSTAP_FIRMWARE_NVRAM activée. L'option spécifique pour l'activation se trouve dans la configuration du noyau :

Device Drivers  --->
 Network device support  --->
  Wireless LAN  --->
   IEEE 802.11 for Host AP (Prism 2/2.5/3 and WEP/TKIP/CCMP)
    Support for downloading firmware images with Host AP driver
     Support for non-volatile firmware download

Une fois que la prise en charge du téléchargement du firmware Host AP non-volatile est activée, exécuter prism2_srec pour télécharger le firmware approprié dans la mémoire flash du périphérique.

<!> Comme il est dit dans le mini-HOWTO de Jun Sun sur le flashage des chipsets Intersil Prism, n'essayez pas d'enregistrer le firmware primaire sans le firmware de la station (ou secondaire).

Par exemple, assurez-vous que les fichiers fournis sont compatibles, puis exécutez un téléchargement du firmware non-volatile :

# prism2_srec wlan0 pk010101.hex sf010704.hex
srec summary for pk010101.hex
Component: 0x0015 1.1.1 (primary firmware)

srec summary for sf010704.hex
Component: 0x001f 1.7.4 (station firmware)


Verifying update compatibility and combining data:
Plug record length mismatch (PDR=0x0001): 14 != 16
==> extend from default
PRI: old iface 1:4-4 new iface 1:4-4
Allowing S3 overlap due to CRC-16 signature at 0x007e17fe (was: ffff)
OK.

(l'installation continue seulement si le firmware est considéré comme compatible, c'est-à-dire "OK")

# prism2_srec -f wlan0 pk010101.hex sf010704.hex
srec summary for pk010101.hex
Component: 0x0015 1.1.1 (primary firmware)

srec summary for sf010704.hex
Component: 0x001f 1.7.4 (station firmware)


Verifying update compatibility and combining data:
Plug record length mismatch (PDR=0x0001): 14 != 16
==> extend from default
PRI: old iface 1:4-4 new iface 1:4-4
Allowing S3 overlap due to CRC-16 signature at 0x007e17fe (was: ffff)
OK.

Downloading to non-volatile memory (flash).
Note! This can take about 30 seconds. Do _not_ remove card during download.
OK.
Components after download:
  NICID: 0x800c v1.0.0
  PRIID: 0x0015 v1.1.1
  STAID: 0x001f v1.7.4

Voir aussi ci-dessous renommer l'interface réseau.

Renommer l'interface du réseau (network interface)

On peut recevoir le message suivant quand on utilise prism2_srec avec une interface Host AP :

# prism2_srec wlan1 rf010704.hex
srec summary for rf010704.hex
Included file name: RF010704.HEX
Component: 0x001f 1.7.4 (station firmware)

Could not read wlan PDA. This requires PRISM2_DOWNLOAD_SUPPORT definition in
driver/module/hostap_config.h.

Comme CONFIG_HOSTAP_FIRMWARE est activé dans les noyaux standards de Debian, cette erreur est causée par le renommage par udev de l'interface assigné par le noyau à wlan1 (ou une autre adresse):

udev: renamed network interface wlan0 to wlan1

... Cependant, /proc/net/hostap/wlan0/ demeurera alors que les utilitaires du pilote Host AP tenteront d'utiliser /proc/net/hostap/wlan1/ qui n'existe pas. Cela affecte toutes les opérations de chargement de firmware.

Pour résoudre le problème, modifiez les règles /etc/udev/rules.d/70-persistent-net.rules et réassignez les règles pour s'assurer que le bon pilote Host AP est assigné à l'interface wlan0. Exécutez udevadm trigger pour appliquer immédiatement ces modifications.

Une fois que c'est résolu, utilisez prism2_srec avec l'interface wlan0 :

# prism2_srec wlan0 rf010704.hex
srec summary for rf010704.hex
Included file name: RF010704.HEX
Component: 0x001f 1.7.4 (station firmware)


Verifying update compatibility and combining data:
OK.

Périphériques pris en charge

hostap_cs

La page HowToIdentifyADevice/PC_Card explique comment identifier un périphérique PCMIA Card.

La liste suivante est extraite du fichier hostap_cs.conf fourni dans la page hostap-driver-0.4.9 (ancienne version stable).

  • 3Com AirConnect PCI 777A
    Addtron AWP-100 11Mbps WLAN Card
    Airvast WL100
    Allied Telesyn AT-WCL452
    ASUS WL-100 8011b WLAN PC Card
    Belkin 802.11b WLAN PCMCIA
    BroMax Freeport 11Mbps WLAN Card
    Buffalo WLI-CF-S11G
    Compaq WL100 11Mb/s WLAN Card
    Compaq WL200
    corega WL PCCL-11
    D-Link DRC-650 11Mbps WLAN Card
    D-Link DWL-650 11Mbps WLAN Card
    D-Link DWL-650 Rev. P1
    EMTAC A2424i 11Mbps WLAN Card
    Fulbond Airbond XI-300B
    Intersil PRISM2 Reference Design 11Mb/s WLAN Card
    Level-One WPC-0100
    Linksys WCF12 Wireless CompactFlash Card
    Linksys WPC11 11Mbps WLAN Card
    Linksys WPC11 Ver 2.5 11Mbps WLAN Card
    Linksys WPC11 Ver 3 11Mbps WLAN Card
    Longshine LCR-8531 11Mbps WLAN PCMCIA CARD
    Microsoft Wireless Notebook Adapter MN-520 1.0.3
    Netgear MA401
    NETGEAR MA401RA
    Philips 802.11b WLAN PCMCIA
    Proxim RangeLAN
    Sagem
    Samsung SWL2000-N 11Mb/s WLAN Card
    SanDisk ConnectPlus
    Senao NL-2011CD PLUS Ext2 Mercury
    Senao SL-2011CD/SL-2011CDPLUS
    SMC 2632W 11Mbps WLAN Card
    SonicWALL Long Range Wireless Card
    U.S. Robotics IEEE 802.11b PC-CARD
    WLAN PRISM PCMCIA CARD 37300P RevB6
    Zcomax XI-325H 200mW
    Z-Com XI300 11Mb/s WLAN Card
    ZoomAir 4100 11Mb/s WLAN Card
    ZyXel Zyair B-101 802.11b WLAN card

hostap_pci

La page fr/HowToIdentifyADevice/PCI explique comment identifier un périphérique PCI.

La liste suivante est basée sur les champs alias de modinfo hostap_pci des images noyau de Debian 2.6.32 (2.6.32-45).

  • PCI: 1260:3872 Intersil Corporation ISL3872 [Prism 3]
    PCI: 1260:3873 Intersil Corporation ISL3874 [Prism 2.5]/ISL3872 [Prism 3]
    PCI: 167D:A000 Samsung Electro-Mechanics Co., Ltd. MagicLAN SWL-2210P 802.11b [Intersil ISL3874]

hostap_plx

La page fr/HowToIdentifyADevice/PCI explique comment identifier un périphérique PCI.

La liste suivante est basée sur les champs alias de modinfo hostap_plx des images noyau de Debian 2.6.32 (2.6.32-45).

  • PCI: 10B7:7770 3Com Corporation 3CRWE777 PCI(PLX) Wireless Adaptor [Airconnect]
    PCI: 111A:1023 Efficient Networks, Inc (Device name unknown)
    PCI: 126C:8030 Northern Telecom (Device name unknown)
    PCI: 1385:4100 Netgear MA301 802.11b Wireless PCI Adapter
    PCI: 1562:0001 Symbol Technologies (Device name unknown)
    PCI: 15E8:0130 National Datacomm Corp Wireless PCI Card
    PCI: 15E8:0131 National Datacomm Corp NCP130A2 Wireless NIC
    PCI: 1638:1100 Standard Microsystems Corp [SMC] SMC2602W EZConnect / Addtron AWA-100 / Eumitcom PCI WL11000
    PCI: 16AB:1100 Global Sun Technology Inc GL24110P
    PCI: 16AB:1101 Global Sun Technology Inc PLX9052 PCMCIA-to-PCI Wireless LAN
    PCI: 16AB:1102 Global Sun Technology Inc PCMCIA-to-PCI Wireless Network Bridge
    PCI: 16AB:1103 Global Sun Technology Inc (Device name unknown)
    PCI: 16EC:3685 U.S. Robotics Wireless Access PCI Adapter Model 022415
    PCI: EC80:EC00 Belkin Corporation F5D6000

Voir aussi

Liens Externes


CategoryHardware | CategoryWireless