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

NAME
     atu - Atmel AT76C50x USB IEEE 802.11b wireless network device

SYNOPSIS
     atu* at uhub? port ?

DESCRIPTION
     The atu driver provides support for wireless network adapters based
     around the Atmel AT76C503, AT76C503A, AT76C505, and AT76C505A USB
     chipsets and four companion radio chipsets.

     The atu driver encapsulates all IP and ARP traffic as 802.11 frames,
     though it can receive either 802.11 or 802.3 frames.

     These are the modes the atu driver can operate in:

     BSS mode       Also known as infrastructure mode, this is used when asso-
                    ciating with an access point, through which all traffic
                    passes.  This mode is the default.

     IBSS mode      Also known as IEEE ad-hoc mode or peer-to-peer mode.  This
                    is the standardized method of operating without an access
                    point.  Stations associate with a service set.  However,
                    actual connections between stations are peer-to-peer.

     The atu driver can be configured to use hardware Wired Equivalent Privacy
     (WEP).  It is strongly recommended that WEP not be used as the sole mech-
     anism to secure wireless communication, due to serious weaknesses in it.

     The atu driver can be configured at runtime with ifconfig(8) or on boot
     with hostname.if(5).

HARDWARE
     The following devices are known to be supported by the atu driver:

           3Com 3CRSHEW696
           AboCom BWU613
           Accton 2664W
           Acer Peripherals AWL300
           Acer Peripherals AWL400
           Actiontec 802UAT1
           Addtron AWU120
           Aincomm AWU2000B
           Askey Computer Voyager 1010
           Askey Computer WLL013 (Intersil Radio)
           Askey Computer WLL013 (RFMD Radio)
           Atmel AT76C503 (Intersil Radio)
           Atmel AT76C503 (RFMD Radio)
           Atmel AT76C505 (RFMD Radio)
           Atmel AT76C505 (RFMD 2958 Radio)
           Atmel AT76C505A (RFMD 2958 Radio)
           Atmel AT76C505AS (RFMD 2958 Radio)
           Belkin F5D6050
           Bluetake BW002
           Compaq iPAQ h54xx/h55xx Internal WLAN
           Conceptronic C11U
           Conceptronic WL210
           Corega WLAN USB Stick 11
           Dick Smith Electronics CHUSB 611G
           Dick Smith Electronics WL200U
           Dick Smith Electronics WL240U
           Dick Smith Electronics XH1153
           D-Link DWL-120 rev E
           Geowave GW-US11S
           Gigabyte GN-WLBM101
           Gigaset WLAN
           Hewlett-Packard HN210W
           Intel AP310 AnyPoint II
           I/O DATA USB WN-B11
           Lexar 2662W-AR
           Linksys WUSB11 802.11b
           Linksys WUSB11 802.11b v2.8
           MSI WLAN
           Netgear MA101
           Netgear MA101 rev B
           OQO model 01 WiFi
           Ovislink AirLive WL-1120USB
           OvisLink AirLive WL-1130USB
           Planex Communications GW-US11S
           Samsung SWL2100W
           Siemens WLL013
           SMC EZ Connect 11Mbps (SMC2662w)
           SMC EZ Connect 11Mbps v2 (SMC2662wV2)
           Tekram U-300C
           TRENDnet TEW-229UB
           W-Buddie WN210
           Z-Com M4Y-750

FILES
     The adapter needs some firmware files, which are loaded on demand by the
     driver when the device is attached:

           /etc/firmware/atu-at76c503-i3863-int
           /etc/firmware/atu-at76c503-i3863-ext
           /etc/firmware/atu-at76c503-rfmd-acc-int
           /etc/firmware/atu-at76c503-rfmd-acc-ext
           /etc/firmware/atu-at76c505-rfmd-int
           /etc/firmware/atu-at76c505-rfmd-ext
           /etc/firmware/atu-intersil-int
           /etc/firmware/atu-intersil-ext
           /etc/firmware/atu-rfmd-int
           /etc/firmware/atu-rfmd-ext
           /etc/firmware/atu-rfmd2958-int
           /etc/firmware/atu-rfmd2958-ext
           /etc/firmware/atu-rfmd2958smc-int
           /etc/firmware/atu-rfmd2958smc-ext

EXAMPLES
     The following hostname.if(5) example configures atu0 to join whatever
     network is available on boot, using WEP key ``0x1deadbeef1'', channel 11,
     obtaining an IP address using DHCP:

           dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11

     Configure atu0 for WEP, using hex key ``0x1deadbeef1'':

           # ifconfig atu0 nwkey 0x1deadbeef1

     Return atu0 to its default settings:

           # ifconfig atu0 -bssid -chan media autoselect \
                   nwid "" -nwkey

     Join an existing BSS network, ``my_net'':

           # ifconfig atu0 192.168.0.2 netmask 0xffffff00 nwid my_net

SEE ALSO
     arp(4), ifmedia(4), intro(4), netintro(4), usb(4), hostname.if(5),
     ifconfig(8)

AUTHORS
     The atu driver was written by Daan Vreeken and ported to OpenBSD by Theo
     de Raadt and David Gwynne.

CAVEATS
     The atu driver does not support a lot of the functionality available in
     the hardware.  More work is required to properly support the IBSS, power
     management, and selectable transmission rate features.

OpenBSD 4.7                    September 2, 2009                             3
