WI(4)                     OpenBSD Programmer's Manual                    WI(4)

NAME
     wi - Lucent Technologies WaveLAN/IEEE 802.11DS PCMCIA driver

SYNOPSIS
     wi* at pcmcia? function ?

DESCRIPTION
     The wi driver provides support for WaveLAN/IEEE and compatible pcmcia
     adapters (also known as WaveLAN II cards) which support IEEE 802.11 Di-
     rect Sequence.  The compatible cards supported are:

           3Com AirConnect Wireless LAN
           Corega Wireless LAN PCC-11
           Corega Wireless LAN PCCA-11
           Intersil Prism II
           Samsung MagicLAN SWL-2000N
           SMC 2632 EZ Connect Wireless PC Card
           NANOSPEED ROOT-RZ2000 WLAN Card
           XI300 Wireless LAN
           Compaq Agency NC5004 Wireless Card
           Contec FLEXLAN/FX-DS110-PCC
           TDK LAK-CD011WL
           NEC Wireless Card CMZ-RT-WP
           NTT-ME 11Mbps Wireless LAN PC Card
           Addtron AWP-100
           Cabletron RoamAbout
           I-O DATA WN-B11/PCM
           Linksys WPC11

     Note that while Lucent sells both ISA and PCMCIA WaveLAN/IEEE devices,
     the ISA product is actually a PCMCIA card in an ISA to PCMCIA bridge
     adapter. Consequently, the wi driver is required for both the ISA and
     PCMCIA NICs. The original WaveLAN/IEEE cards (2Mbps), the WaveLAN/IEEE
     Turbo (6Mbps), the WaveLAN/IEEE Bronze Turbo (8Mbps), and the Wave-
     LAN/IEEE Silver/Gold (11Mbps) adapters are supported.

     The core of the WaveLAN/IEEE is the Lucent Hermes controller. All
     host/device interaction is via programmed I/O with the Hermes. The Hermes
     supports 802.11 and 802.3 frames, power management, BSS, WDS and ad-hoc
     operation modes. The wi driver encapsulates all IP and ARP traffic as
     802.11 frames, however it can receive either 802.11 or 802.3 frames.
     Transmit speed is selectable between 1Mbps fixed, 2Mbps fixed, 2Mbps with
     auto fallback, 6Mbps, 8Mbps, or 11Mbps depending on your hardware (see
     above).  The Gold and Silver cards also have support for encryption.
     Silver adapters will do 64bit encryption and Gold adapters will do 128bit
     encryption.  To enable the encryption, use the wicontrol(8) utility to
     set your keys.

     By default, the wi driver configures the WaveLAN card for BSS operation.
     In this mode, stations can communicate among each other without the aid
     of an access point. To join a service set, the driver must be set for BSS
     mode using the wicontrol(8) utility.

     For more information on configuring this device, see ifconfig(8)

DIAGNOSTICS
     wi%d: init failed  The WaveLAN failed to come ready after an initializa-
     tion command was issued.

     wi%d: failed to allocate %d bytes on NIC  The driver was unable to allo-
     cate memory for transmit frames in the NIC's on-board RAM.

     wd%d: device timeout  The WaveLAN failed to generate an interrupt to ac-
     knowledge a transmit command.

SEE ALSO
     an(4), arp(4), netintro(4), ifconfig(8), wicontrol(8)

     HCF Light programming specification, http://www.wavelan.com.

HISTORY
     The wi device driver first appeared in FreeBSD 3.0. OpenBSD support was
     added in OpenBSD 2.6.

AUTHORS
     The wi driver was written by Bill Paul <wpaul@ctr.columbia.edu> and port-
     ed to OpenBSD by Niklas Hallqvist <niklas@appli.se>.

CAVEATS
     Lucent WaveLAN cards are usually default to channel 3 for operation,
     while some non-Lucent cards have different default channel (11 for Ad-
     dtron cards, for example). See wicontrol(8) for information on how to
     change the channel.

BUGS
     Addtron cards do not seem to work in infrastructure mode with Lucent base
     station with current driver source.

OpenBSD 2.9                     April 21, 1999                               2
