1.\" $OpenBSD: an.4,v 1.16 2001/07/03 22:19:28 millert Exp $ 2.\" 3.\" Copyright (c) 1997, 1998, 1999 4.\" Bill Paul <wpaul@ee.columbia.edu>. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Bill Paul. 17.\" 4. Neither the name of the author nor the names of any co-contributors 18.\" may be used to endorse or promote products derived from this software 19.\" without specific prior written permission. 20.\" 21.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 25.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 26.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 27.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 29.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 30.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 31.\" THE POSSIBILITY OF SUCH DAMAGE. 32.\" 33.\" $FreeBSD: src/share/man/man4/an.4,v 1.5 2000/03/02 14:53:45 sheldonh Exp $ 34.\" 35.Dd September 10, 1999 36.Dt AN 4 37.Os 38.Sh NAME 39.Nm an 40.Nd Aironet Communications 4500/4800 IEEE 802.11DS wireless network adapter 41.Sh SYNOPSIS 42.Cd "an* at pcmcia? function ?" 43.Cd "an* at pci? dev ? function ?" 44.Sh DESCRIPTION 45The 46.Nm 47driver provides support for the Aironet Communications 4500, 4800 48(aka Cisco 340), and Cisco 350 49IEEE 802.11 Direct Sequence wireless network adapters. 50This includes the ISA, PCI, and PCMCIA varieties. 51The 4500 series adapters operate at 1 and 2Mbps while 52the 4800 and 350 series can operate at 1, 2, 5.5, and 11Mbps. 53The ISA, PCI, 54and PCMCIA devices are all based on the same core PCMCIA modules 55and all have the same programming interface. 56However, unlike the 57Lucent WaveLAN/IEEE cards, the ISA and PCI cards appear to the 58host as normal ISA and PCI devices and do not require any pcmcia 59support. 60.Pp 61ISA cards can either be configured to use ISA Plug and Play 62or to use a particular I/O address and IRQ 63by properly setting the DIP switches on the board. 64(The default switch setting is for plug and play.) 65The 66.Nm 67driver has Plug and Play support and will work in either configuration, 68however when using a hard-wired I/O address and IRQ, the driver 69configuration and the NIC's switch settings must agree. 70PCI cards 71require no switch settings of any kind and will be automatically 72probed and attached. 73.Pp 74All host/device interaction with the Aironet cards is via programmed I/O. 75The Aironet devices support 802.11 and 802.3 frames, power management, 76BSS (infrastructure), and IBSS (ad-hoc) operation modes. 77The 78.Nm 79driver encapsulates all IP and ARP traffic as 802.11 frames, however, 80it can receive either 802.11 or 802.3 frames. 81Transmit speed is 82selectable between 1Mbps, 2Mbps, 5.5Mbps, 11Mbps or 83"auto" (the NIC automatically chooses the best speed). 84.Pp 85By default, the 86.Nm 87driver configures the Aironet card for BSS operation with an SSID 88of "". 89In this mode, 90stations can communicate among each other without the aid of an access 91point. 92To join a service set, the driver must be set for BSS mode using 93the 94.Xr ancontrol 8 95utility. 96.Pp 97For more information on configuring this device, see 98.Xr ifconfig 8 . 99.Sh DIAGNOSTICS 100.Bl -diag 101.It "an%d: init failed" 102The Aironet card failed to come ready after an initialization command was 103issued. 104.It "an%d: failed to allocate %d bytes on NIC" 105The driver was unable to allocate memory for transmit frames in the 106NIC's on-board RAM. 107.It "an%d: device timeout" 108The Aironet card failed to generate an interrupt to acknowledge a transmit 109command. 110.El 111.Sh SEE ALSO 112.Xr arp 4 , 113.Xr netintro 4 , 114.Xr wi 4 , 115.Xr ancontrol 8 , 116.Xr ifconfig 8 117.Sh HISTORY 118The 119.Nm 120device driver first appeared in 121.Fx 4.0 . 122.Ox 123support was added in 124.Ox 2.7 . 125.Sh AUTHORS 126The 127.Nm 128driver was written by Bill Paul <wpaul@ee.columbia.edu> and ported to 129.Ox 130by Michael Shalayeff <mickey@openbsd.org>. 131