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 associating 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 mechanism 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
-nosplit 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.