1.\" Copyright (c) 1997, 1998, 1999 2.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by Bill Paul. 15.\" 4. Neither the name of the author nor the names of any co-contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 29.\" THE POSSIBILITY OF SUCH DAMAGE. 30.\"
| 1.\" Copyright (c) 1997, 1998, 1999 2.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by Bill Paul. 15.\" 4. Neither the name of the author nor the names of any co-contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 29.\" THE POSSIBILITY OF SUCH DAMAGE. 30.\"
|
31.\" $FreeBSD: head/share/man/man4/wi.4 139097 2004-12-21 01:09:34Z brueffer $
| 31.\" $FreeBSD: head/share/man/man4/wi.4 140517 2005-01-20 17:48:01Z imp $
|
32.\" $OpenBSD: wi.4tbl,v 1.14 2002/04/29 19:53:50 jsyn Exp $ 33.\" 34.Dd February 17, 2003 35.Dt WI 4 36.Os 37.Sh NAME 38.Nm wi 39.Nd "Lucent Hermes, Intersil PRISM and Spectrum24 IEEE 802.11 driver" 40.Sh SYNOPSIS 41.Cd "device wi" 42.Cd "device wlan" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for wireless network adapters based around 47the Lucent Hermes, Intersil PRISM-II, Intersil PRISM-2.5, Intersil 48Prism-3, and Symbol Spectrum24 chipsets. 49All five chipsets provide a similar interface to the driver. 50.Pp 51Supported features include 802.11 and 802.3 frames, power management, BSS, 52IBSS, WDS and old-style Lucent ad-hoc operation modes. 53Cards based on the Intersil PRISM chips also support a host-based 54access point mode which allows a card to act as a normal access point 55(with some assistance from the 56.Nm 57driver). 58The Lucent Hermes and Symbol Spectrum24 chipsets do not contain this 59functionality. 60The PRISM family of chips do not support the WDS functionality. 61All host/device interaction is via programmed I/O, even on those cards 62that support a DMA interface. 63.Pp 64The 65.Nm 66driver encapsulates all IP and ARP traffic as 802.11 frames, however 67it can receive either 802.11 or 802.3 frames. 68Transmit speed is selectable between 1Mbps, 2Mbps, 5.5 Mbps and 11Mbps 69depending on your hardware. 70Most hardware supports 11Mbps where the signal quality allows, but 71falls back to slower speeds when it does not. 72Except for the Lucent WaveLAN Bronze cards, all cards supported by the 73.Nm 74driver support WEP for encryption. 75To enable encryption, use 76.Xr ifconfig 8 77as shown below. 78.Pp 79By default, the 80.Nm 81driver configures the card for BSS operation (aka infrastructure 82mode). 83This mode requires the use of an access point (base station). 84.Pp 85The 86.Nm 87driver also supports a point-to-point mode 88where stations can communicate amongst themselves without the 89aid of an access point. 90Note that there are two possible point-to-point modes. 91One mode, referred to as 92.Dq "ad-hoc demo mode" , 93or 94.Dq "legacy Lucent ad-hoc mode" , 95predates the IEEE 802.11 specification and so may not interoperate 96with cards from different vendors. 97The standardized point-to-point mode is called IBSS (or confusingly 98just ad-hoc mode), but is not supported by cards with very old 99firmware revisions. 100If your cards supports IBSS mode, it is recommended that you use it in 101preference to the 102.Dq "ad-hoc demo mode" 103in new installations. 104.Pp 105Cards supported by the driver based on the Intersil PRISM family of chips also 106have a host-based access point mode which allows the card to 107act as an access point (base station). 108Access points are different than operating in IBSS mode. 109They operate in BSS mode. 110They allow for easier roaming and bridge all Ethernet traffic such 111that machines connected via an access point appear to be on the local 112Ethernet segment. 113.Pp 114For more information on configuring this device, see 115.Xr ifconfig 8 . 116.Pp 117Cards supported by the 118.Nm 119driver come in a variety of packages, though the most common 120are of the PCMCIA type. 121In many cases, the PCI version of a wireless card is simply 122a PCMCIA card bundled with a PCI adapter. 123The PCI adapters come in two flavors: true PCMCIA bridges and 124dumb PCMCIA bridges. 125A true PCMCIA bridge (such as those sold by Lucent) will attach 126as a real PCMCIA controller. 127The wireless card will then attach to the PCMCIA bus. 128Wireless cards in PCMCIA slots may be inserted and ejected on the fly. 129.Pp 130A dumb bridge, on the other hand, does not show up as a true PCMCIA bus. 131The wireless card will simply appear to the host as a normal PCI 132device and will not require any PCMCIA support. 133Cards in this type of adapter should only be removed when the 134machine is powered down. 135.Pp 136The following cards are among those supported by the 137.Nm 138driver: 139.Pp 140.Bl -column -compact "Linksys Instant Wireless WPC11 2.5" "Spectrum24" "PCI or PCMCIA" 141.Em "Card Chip Bus" 1423Com AirConnect 3CRWE737A Spectrum24 PCMCIA 1433Com AirConnect 3CRWE777A Prism-II PCI 144Accton airDirect WN3301 PCMCIA 145ACTIONTEC HWC01170 Prism-2.5 PCMCIA 146Addtron AWP-100 Prism-II PCMCIA 147Adtec Adlink/340C Prism-II PCMCIA 148Airvast WN 100 Prism-3 PCMCIA 149Airway 802.11 Adapter PCMCIA 150Agere Orinoco Hermes PCMCIA 151Allied Telesis WR211PCM Prism-II PCMCIA 152ArTem OnAir Prism? PCMCIA 153Asus WL100 Prism-2.5 PCMCIA 154Avaya Wireless Prism-II PCMCIA 155Bay eMobility 11B Prism-2.5? PCMCIA 156Blue Concentric Circle WL-379F Prism-II CF 157BreezeNet Wireless Prism-II PCMCIA 158Buffalo WLI-PCM-S11 Prism-II PCMCIA 159Buffalo WLI-PCM-L11G Hermes PCMCIA 160Buffalo WLI-CF-S11G Prism-II CF 161Buffalo WLI2-CF-S11G Prism 2.5 CF 162Cabletron RoamAbout Hermes PCMCIA 163Compaq Agency NC5004 Prism-II PCMCIA 164Compaq WL100 Prism-II PCMCIA 165Compaq WL110 Hermes PCMCIA 166Compaq WL200 Prism-II PCMCIA 167Contec FLEXLAN/FX-DS110-PCC Prism-II PCMCIA 168Corega PCC-11 Prism-II PCMCIA 169Corega PCCA-11 Prism-II PCMCIA 170Corega PCCB-11 Prism-II PCMCIA 171Corega CGWLPCIA11 Prism-II PCI 172Dell TrueMobile 1150 Hermes PCMCIA 173Dlink Air 660 Prism-II PCMCIA 174Dlink DWL520 Prism-2.5 PCI 175Dlink DWL650 Prism-2.5 PCMCIA 176ELECOM Air@Hawk/LD-WL11/PCC PCMCIA 177ELSA MC-11 PCMCIA 178ELSA XI300 Prism-II PCMCIA 179ELSA XI800 Prism-II CF 180EMTAC A2424i Prism-II PCMCIA 181Ericsson Wireless LAN CARD C11 Spectrum24 PCMCIA 182Farallon Skyline Prism-II PCMCIA 183Gemtek WL-311 Prism-2.5 PCMCIA 184Hawking Technology WE110P Prism-2.5 PCMCIA 185Home Wireless Networks Prism-II PCMCIA 186IBM High Rate Wireless Hermes PCMCIA 187ICOM SL-1100 Prism-II PCMCIA 188I-O DATA WN-B11/PCM Prism-II PCMCIA 189Intel PRO/Wireless 2011 Spectrum24 PCMCIA 190Intersil Prism II Prism-II PCMCIA 191Intersil Mini-PCI Prism-2.5 PCI 192Laneed Wireless PCMCIA 193Linksys Instant Wireless WPC11 Prism-II PCMCIA 194Linksys Instant Wireless WPC11 2.5 Prism-2.5 PCMCIA 195Linksys Instant Wireless WPC11 3.0 Prism-3 PCMCIA 196Linksys WCF11 Prism-3 PCMCIA 197Linksys WCF12 Prism-3 CF 198Lucent WaveLAN Hermes PCMCIA 199Melco Airconnect Prism-II PCMCIA 200Microsoft MN-520 WLAN Prism-II PCMCIA 201NANOSPEED ROOT-RZ2000 Prism-II PCMCIA 202NCR WaveLAN/IEEE 802.11 PCMCIA 203NDC/Sohoware NCP130 Prism-II PCI 204NEC CMZ-RT-WP Prism-II PCMCIA 205NEC PK-WL001 Lucent PCMCIA 206NEC PC-WL/11C Prism-II PCMCIA 207Netgear MA311 Prism-2.5 PCI 208Netgear MA401 Prism-II/2.5 PCMCIA 209Netgear MA401RA Prism-II PCMCIA 210Netgear MA701 Prism-II CF 211NOKIA C020 WLAN Prism-II PCMCIA 212NOKIA C110 WLAN Prism-2.5 PCMCIA 213NTT-ME 11Mbps Wireless LAN Prism-II PCMCIA 214Planex GeoWave/GW-NS110 Prism-II PCMCIA 215Planex GW-NS11H Prism-II PCMCIA 216Proxim Harmony Prism-II PCMCIA 217Proxim RangeLAN-DS Prism-II PCMCIA 218Samsung MagicLAN SWL-2000N Prism-II PCMCIA
| 32.\" $OpenBSD: wi.4tbl,v 1.14 2002/04/29 19:53:50 jsyn Exp $ 33.\" 34.Dd February 17, 2003 35.Dt WI 4 36.Os 37.Sh NAME 38.Nm wi 39.Nd "Lucent Hermes, Intersil PRISM and Spectrum24 IEEE 802.11 driver" 40.Sh SYNOPSIS 41.Cd "device wi" 42.Cd "device wlan" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for wireless network adapters based around 47the Lucent Hermes, Intersil PRISM-II, Intersil PRISM-2.5, Intersil 48Prism-3, and Symbol Spectrum24 chipsets. 49All five chipsets provide a similar interface to the driver. 50.Pp 51Supported features include 802.11 and 802.3 frames, power management, BSS, 52IBSS, WDS and old-style Lucent ad-hoc operation modes. 53Cards based on the Intersil PRISM chips also support a host-based 54access point mode which allows a card to act as a normal access point 55(with some assistance from the 56.Nm 57driver). 58The Lucent Hermes and Symbol Spectrum24 chipsets do not contain this 59functionality. 60The PRISM family of chips do not support the WDS functionality. 61All host/device interaction is via programmed I/O, even on those cards 62that support a DMA interface. 63.Pp 64The 65.Nm 66driver encapsulates all IP and ARP traffic as 802.11 frames, however 67it can receive either 802.11 or 802.3 frames. 68Transmit speed is selectable between 1Mbps, 2Mbps, 5.5 Mbps and 11Mbps 69depending on your hardware. 70Most hardware supports 11Mbps where the signal quality allows, but 71falls back to slower speeds when it does not. 72Except for the Lucent WaveLAN Bronze cards, all cards supported by the 73.Nm 74driver support WEP for encryption. 75To enable encryption, use 76.Xr ifconfig 8 77as shown below. 78.Pp 79By default, the 80.Nm 81driver configures the card for BSS operation (aka infrastructure 82mode). 83This mode requires the use of an access point (base station). 84.Pp 85The 86.Nm 87driver also supports a point-to-point mode 88where stations can communicate amongst themselves without the 89aid of an access point. 90Note that there are two possible point-to-point modes. 91One mode, referred to as 92.Dq "ad-hoc demo mode" , 93or 94.Dq "legacy Lucent ad-hoc mode" , 95predates the IEEE 802.11 specification and so may not interoperate 96with cards from different vendors. 97The standardized point-to-point mode is called IBSS (or confusingly 98just ad-hoc mode), but is not supported by cards with very old 99firmware revisions. 100If your cards supports IBSS mode, it is recommended that you use it in 101preference to the 102.Dq "ad-hoc demo mode" 103in new installations. 104.Pp 105Cards supported by the driver based on the Intersil PRISM family of chips also 106have a host-based access point mode which allows the card to 107act as an access point (base station). 108Access points are different than operating in IBSS mode. 109They operate in BSS mode. 110They allow for easier roaming and bridge all Ethernet traffic such 111that machines connected via an access point appear to be on the local 112Ethernet segment. 113.Pp 114For more information on configuring this device, see 115.Xr ifconfig 8 . 116.Pp 117Cards supported by the 118.Nm 119driver come in a variety of packages, though the most common 120are of the PCMCIA type. 121In many cases, the PCI version of a wireless card is simply 122a PCMCIA card bundled with a PCI adapter. 123The PCI adapters come in two flavors: true PCMCIA bridges and 124dumb PCMCIA bridges. 125A true PCMCIA bridge (such as those sold by Lucent) will attach 126as a real PCMCIA controller. 127The wireless card will then attach to the PCMCIA bus. 128Wireless cards in PCMCIA slots may be inserted and ejected on the fly. 129.Pp 130A dumb bridge, on the other hand, does not show up as a true PCMCIA bus. 131The wireless card will simply appear to the host as a normal PCI 132device and will not require any PCMCIA support. 133Cards in this type of adapter should only be removed when the 134machine is powered down. 135.Pp 136The following cards are among those supported by the 137.Nm 138driver: 139.Pp 140.Bl -column -compact "Linksys Instant Wireless WPC11 2.5" "Spectrum24" "PCI or PCMCIA" 141.Em "Card Chip Bus" 1423Com AirConnect 3CRWE737A Spectrum24 PCMCIA 1433Com AirConnect 3CRWE777A Prism-II PCI 144Accton airDirect WN3301 PCMCIA 145ACTIONTEC HWC01170 Prism-2.5 PCMCIA 146Addtron AWP-100 Prism-II PCMCIA 147Adtec Adlink/340C Prism-II PCMCIA 148Airvast WN 100 Prism-3 PCMCIA 149Airway 802.11 Adapter PCMCIA 150Agere Orinoco Hermes PCMCIA 151Allied Telesis WR211PCM Prism-II PCMCIA 152ArTem OnAir Prism? PCMCIA 153Asus WL100 Prism-2.5 PCMCIA 154Avaya Wireless Prism-II PCMCIA 155Bay eMobility 11B Prism-2.5? PCMCIA 156Blue Concentric Circle WL-379F Prism-II CF 157BreezeNet Wireless Prism-II PCMCIA 158Buffalo WLI-PCM-S11 Prism-II PCMCIA 159Buffalo WLI-PCM-L11G Hermes PCMCIA 160Buffalo WLI-CF-S11G Prism-II CF 161Buffalo WLI2-CF-S11G Prism 2.5 CF 162Cabletron RoamAbout Hermes PCMCIA 163Compaq Agency NC5004 Prism-II PCMCIA 164Compaq WL100 Prism-II PCMCIA 165Compaq WL110 Hermes PCMCIA 166Compaq WL200 Prism-II PCMCIA 167Contec FLEXLAN/FX-DS110-PCC Prism-II PCMCIA 168Corega PCC-11 Prism-II PCMCIA 169Corega PCCA-11 Prism-II PCMCIA 170Corega PCCB-11 Prism-II PCMCIA 171Corega CGWLPCIA11 Prism-II PCI 172Dell TrueMobile 1150 Hermes PCMCIA 173Dlink Air 660 Prism-II PCMCIA 174Dlink DWL520 Prism-2.5 PCI 175Dlink DWL650 Prism-2.5 PCMCIA 176ELECOM Air@Hawk/LD-WL11/PCC PCMCIA 177ELSA MC-11 PCMCIA 178ELSA XI300 Prism-II PCMCIA 179ELSA XI800 Prism-II CF 180EMTAC A2424i Prism-II PCMCIA 181Ericsson Wireless LAN CARD C11 Spectrum24 PCMCIA 182Farallon Skyline Prism-II PCMCIA 183Gemtek WL-311 Prism-2.5 PCMCIA 184Hawking Technology WE110P Prism-2.5 PCMCIA 185Home Wireless Networks Prism-II PCMCIA 186IBM High Rate Wireless Hermes PCMCIA 187ICOM SL-1100 Prism-II PCMCIA 188I-O DATA WN-B11/PCM Prism-II PCMCIA 189Intel PRO/Wireless 2011 Spectrum24 PCMCIA 190Intersil Prism II Prism-II PCMCIA 191Intersil Mini-PCI Prism-2.5 PCI 192Laneed Wireless PCMCIA 193Linksys Instant Wireless WPC11 Prism-II PCMCIA 194Linksys Instant Wireless WPC11 2.5 Prism-2.5 PCMCIA 195Linksys Instant Wireless WPC11 3.0 Prism-3 PCMCIA 196Linksys WCF11 Prism-3 PCMCIA 197Linksys WCF12 Prism-3 CF 198Lucent WaveLAN Hermes PCMCIA 199Melco Airconnect Prism-II PCMCIA 200Microsoft MN-520 WLAN Prism-II PCMCIA 201NANOSPEED ROOT-RZ2000 Prism-II PCMCIA 202NCR WaveLAN/IEEE 802.11 PCMCIA 203NDC/Sohoware NCP130 Prism-II PCI 204NEC CMZ-RT-WP Prism-II PCMCIA 205NEC PK-WL001 Lucent PCMCIA 206NEC PC-WL/11C Prism-II PCMCIA 207Netgear MA311 Prism-2.5 PCI 208Netgear MA401 Prism-II/2.5 PCMCIA 209Netgear MA401RA Prism-II PCMCIA 210Netgear MA701 Prism-II CF 211NOKIA C020 WLAN Prism-II PCMCIA 212NOKIA C110 WLAN Prism-2.5 PCMCIA 213NTT-ME 11Mbps Wireless LAN Prism-II PCMCIA 214Planex GeoWave/GW-NS110 Prism-II PCMCIA 215Planex GW-NS11H Prism-II PCMCIA 216Proxim Harmony Prism-II PCMCIA 217Proxim RangeLAN-DS Prism-II PCMCIA 218Samsung MagicLAN SWL-2000N Prism-II PCMCIA
|
| 219SENAO SL-2511CD Prism-3 PCMCIA
|
219Siemens SpeedStream SS1021 Prism-II PCMCIA 220SMC 2602 EZ Connect (3.3V) Prism-II PCI or PCMCIA 221SMC 2632 EZ Connect Prism-II PCMCIA 222Socket Low Power WLAN-CF Prism-II CF 223Sony PCWA-C100 Lucent PCMCIA 224Sony PEGA-WL110 Prism-2.5 PCMCIA 225Symbol Spectrum24 Spectrum24 PCMCIA 226Symbol LA-4100 Spectrum24 CF 227TDK LAK-CD011WL Prism-II PCMCIA 228Toshiba Wireless LAN Card Prism-II PCMCIA 229U.S.\& Robotics Wireless Card 2410 Prism-II PCMCIA 230YIS YWL-11B Prism-II PCMCIA 231.El 232.Pp 233Several vendors sell PCI adapters built around the PLX Technology 9050 234or 9052 chip. 235The following such adapters are supported or expected to work: 236.Pp 237.Bl -item -compact 238.It 2393Com AirConnect 3CRWE777A (3.3V) 240.It 241Belkin F5D6000 (a rebadged WL11000P) 242.It 243Eumitcom WL11000P 244.It 245Global Sun Technology GL24110P (untested) 246.It 247Global Sun Technology GL24110P02 248.It 249LinkSys WDT11 (a rebadged GL24110P02) 250.It 251Netgear MA301 252.It 253US Robotics 2415 (rebadged WL11000P) 254.It 255Wisecom Wireless LAN PCI Adapter 256.El 257.Pp 258The following adapters have the same model numbers as those listed 259above, but might not work if the actual card is after the change away 260from the Prism family: 261.Pp 262.Bl -item -compact 263.It 264DLink DWL520 265.El 266.Sh EXAMPLES 267Join an existing BSS network (ie: connect to an access point): 268.Pp 269.Dl "ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00" 270.Pp 271Join a specific BSS network with network name 272.Dq Li my_net : 273.Pp 274.Dl "ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net" 275.Pp 276Join a specific BSS network with WEP encryption: 277.Bd -literal -offset indent 278ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 279 wepmode on wepkey 0x8736639624 280.Ed 281.Pp 282Join a Lucent legacy demo ad-hoc network with network name 283.Dq Li my_net : 284.Bd -literal -offset indent 285ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 286 media DS/11Mbps mediaopt adhoc,link0 287.Ed 288.Pp 289Join/create an IBSS network with network name 290.Dq Li my_net : 291.Bd -literal -offset indent 292ifconfig wi0 inet 192.168.0.22 netmask 0xffffff00 ssid my_net \e 293 media DS/11Mbps mediaopt adhoc 294.Ed 295.Pp 296Create a host-based access point (Prism only): 297.Bd -literal -offset indent 298ifconfig wi0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e 299 media DS/11Mbps mediaopt hostap 300.Ed 301.Pp 302Create a host-based access point with WEP enabled (Prism only): 303.Bd -literal -offset indent 304ifconfig wi0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e 305 wepmode on wepkey 0x1234567890 media DS/11Mbps \e 306 mediaopt hostap 307.Ed 308.Pp 309Create a host-based wireless bridge to fxp0 (Prism only): 310.Bd -literal -offset indent 311Add BRIDGE to the kernel config. 312ifconfig wi0 inet up ssid my_ap media DS/11Mbps mediaopt hostap 313sysctl net.link.ether.bridge.enable=1 314sysctl net.link.ether.bridge.config="wi0 fxp0" 315sysctl net.inet.ip.check_interface=0 316.Ed 317.Pp 318This will give you the same functionality as an access point. 319.Sh DIAGNOSTICS 320.Bl -diag 321.It "wi%d: init failed" 322The WaveLAN card failed to become ready after an initialization command 323was issued. 324.It "wi%d: failed to allocate %d bytes on NIC" 325The driver was unable to allocate memory for transmit frames in the 326NIC's on-board RAM. 327This can also be an indication of an incorrectly configured interrupt. 328.It "wi%d: device timeout" 329The WaveLAN card failed to generate an interrupt to acknowledge a transmit 330command. 331.El 332.Sh SEE ALSO 333.Xr an 4 , 334.Xr arp 4 , 335.Xr ath 4 , 336.Xr card 4 , 337.Xr netintro 4 , 338.Xr pccard 4 , 339.Xr pccbb 4 , 340.Xr pcic 4 , 341.Xr wlan 4 , 342.Xr ifconfig 8 , 343.Xr wicontrol 8 344.Rs 345.%T HCF Light programming specification 346.%O http://www.wavelan.com 347.Re 348.Sh HISTORY 349The 350.Nm 351device driver first appeared in 352.Fx 3.0 . 353.Sh AUTHORS 354The 355.Nm 356driver was written by 357.An Bill Paul Aq wpaul@ctr.columbia.edu . 358This man page comes from 359.Ox . 360.Sh CAVEATS 361Different regulatory domains have different default channels for adhoc 362mode. 363See 364.Xr ifconfig 8 365for information on how to change the channel. 366See 367.Xr wicontrol 8 368for information on different regulatory domains. 369.Pp 370The Intersil Prism family of chips' host-based access point mode has 371bugs for station firmware versions prior to 0.8.3. 372The driver currently precludes hostap functionality with older station 373firmware. 374The best version of the station firmware for the Prism family of chips 375seems to be 1.4.9. 376Some users of Prism-II and 2.5 based cards report that station firmware 377version 1.3.4 works better for them in hostap than 1.4.9. 378Older versions of the Prism station firmware have a number of issues 379with hostap mode. 380The IBSS/adhoc mode appears to work well on station firmware 1.3.1 and 381later. 382The IBSS/adhoc mode appears to have problems for some people with 383older versions of station firmware. 384.Pp 385Lucent cards prior to firmware version 6.0.6 do not support IBSS 386mode. 387These cards support only the pre-802.11 mode known as 388.Dq "demo ad-hoc mode" 389which does not interoperate with stations in IBSS mode. 390.Pp 391Prism cards prior to version 0.8.0 do not support IBSS mode. 392.Pp 393Symbol cards prior to version 2.50.00 do not support IBSS mode. 394.Sh BUGS 395Not all the new messages are documented here, and many of them are 396indications of transient errors that are not indications of serious 397problems. 398.Pp 399WL200 PCI wireless cards are based on a Cirrus Logic CL-PD6729 bridge 400chips glued to an Intersil Prism-II PCMCIA chipset w/o the PC Card 401form factor being present. 402These chips are special and require special care to use properly. 403One must set 404.Va hw.pcic.pd6729_intr_path Ns = Ns Qq Li 2 405in 406.Pa /boot/loader.conf . 407This tells the PC Card system to use PCI interrupts for this odd beast. 408It is not possible to know automatically which kind of interrupts to use. 409OLDCARD devices 410.Xr ( pcic 4 411and 412.Xr card 4 ) 413support this device. 414NEWCARD devices 415.Xr ( pccbb 4 416and 417.Xr pccard 4 ) 418do not support it at this time.
| 220Siemens SpeedStream SS1021 Prism-II PCMCIA 221SMC 2602 EZ Connect (3.3V) Prism-II PCI or PCMCIA 222SMC 2632 EZ Connect Prism-II PCMCIA 223Socket Low Power WLAN-CF Prism-II CF 224Sony PCWA-C100 Lucent PCMCIA 225Sony PEGA-WL110 Prism-2.5 PCMCIA 226Symbol Spectrum24 Spectrum24 PCMCIA 227Symbol LA-4100 Spectrum24 CF 228TDK LAK-CD011WL Prism-II PCMCIA 229Toshiba Wireless LAN Card Prism-II PCMCIA 230U.S.\& Robotics Wireless Card 2410 Prism-II PCMCIA 231YIS YWL-11B Prism-II PCMCIA 232.El 233.Pp 234Several vendors sell PCI adapters built around the PLX Technology 9050 235or 9052 chip. 236The following such adapters are supported or expected to work: 237.Pp 238.Bl -item -compact 239.It 2403Com AirConnect 3CRWE777A (3.3V) 241.It 242Belkin F5D6000 (a rebadged WL11000P) 243.It 244Eumitcom WL11000P 245.It 246Global Sun Technology GL24110P (untested) 247.It 248Global Sun Technology GL24110P02 249.It 250LinkSys WDT11 (a rebadged GL24110P02) 251.It 252Netgear MA301 253.It 254US Robotics 2415 (rebadged WL11000P) 255.It 256Wisecom Wireless LAN PCI Adapter 257.El 258.Pp 259The following adapters have the same model numbers as those listed 260above, but might not work if the actual card is after the change away 261from the Prism family: 262.Pp 263.Bl -item -compact 264.It 265DLink DWL520 266.El 267.Sh EXAMPLES 268Join an existing BSS network (ie: connect to an access point): 269.Pp 270.Dl "ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00" 271.Pp 272Join a specific BSS network with network name 273.Dq Li my_net : 274.Pp 275.Dl "ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net" 276.Pp 277Join a specific BSS network with WEP encryption: 278.Bd -literal -offset indent 279ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 280 wepmode on wepkey 0x8736639624 281.Ed 282.Pp 283Join a Lucent legacy demo ad-hoc network with network name 284.Dq Li my_net : 285.Bd -literal -offset indent 286ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 287 media DS/11Mbps mediaopt adhoc,link0 288.Ed 289.Pp 290Join/create an IBSS network with network name 291.Dq Li my_net : 292.Bd -literal -offset indent 293ifconfig wi0 inet 192.168.0.22 netmask 0xffffff00 ssid my_net \e 294 media DS/11Mbps mediaopt adhoc 295.Ed 296.Pp 297Create a host-based access point (Prism only): 298.Bd -literal -offset indent 299ifconfig wi0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e 300 media DS/11Mbps mediaopt hostap 301.Ed 302.Pp 303Create a host-based access point with WEP enabled (Prism only): 304.Bd -literal -offset indent 305ifconfig wi0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e 306 wepmode on wepkey 0x1234567890 media DS/11Mbps \e 307 mediaopt hostap 308.Ed 309.Pp 310Create a host-based wireless bridge to fxp0 (Prism only): 311.Bd -literal -offset indent 312Add BRIDGE to the kernel config. 313ifconfig wi0 inet up ssid my_ap media DS/11Mbps mediaopt hostap 314sysctl net.link.ether.bridge.enable=1 315sysctl net.link.ether.bridge.config="wi0 fxp0" 316sysctl net.inet.ip.check_interface=0 317.Ed 318.Pp 319This will give you the same functionality as an access point. 320.Sh DIAGNOSTICS 321.Bl -diag 322.It "wi%d: init failed" 323The WaveLAN card failed to become ready after an initialization command 324was issued. 325.It "wi%d: failed to allocate %d bytes on NIC" 326The driver was unable to allocate memory for transmit frames in the 327NIC's on-board RAM. 328This can also be an indication of an incorrectly configured interrupt. 329.It "wi%d: device timeout" 330The WaveLAN card failed to generate an interrupt to acknowledge a transmit 331command. 332.El 333.Sh SEE ALSO 334.Xr an 4 , 335.Xr arp 4 , 336.Xr ath 4 , 337.Xr card 4 , 338.Xr netintro 4 , 339.Xr pccard 4 , 340.Xr pccbb 4 , 341.Xr pcic 4 , 342.Xr wlan 4 , 343.Xr ifconfig 8 , 344.Xr wicontrol 8 345.Rs 346.%T HCF Light programming specification 347.%O http://www.wavelan.com 348.Re 349.Sh HISTORY 350The 351.Nm 352device driver first appeared in 353.Fx 3.0 . 354.Sh AUTHORS 355The 356.Nm 357driver was written by 358.An Bill Paul Aq wpaul@ctr.columbia.edu . 359This man page comes from 360.Ox . 361.Sh CAVEATS 362Different regulatory domains have different default channels for adhoc 363mode. 364See 365.Xr ifconfig 8 366for information on how to change the channel. 367See 368.Xr wicontrol 8 369for information on different regulatory domains. 370.Pp 371The Intersil Prism family of chips' host-based access point mode has 372bugs for station firmware versions prior to 0.8.3. 373The driver currently precludes hostap functionality with older station 374firmware. 375The best version of the station firmware for the Prism family of chips 376seems to be 1.4.9. 377Some users of Prism-II and 2.5 based cards report that station firmware 378version 1.3.4 works better for them in hostap than 1.4.9. 379Older versions of the Prism station firmware have a number of issues 380with hostap mode. 381The IBSS/adhoc mode appears to work well on station firmware 1.3.1 and 382later. 383The IBSS/adhoc mode appears to have problems for some people with 384older versions of station firmware. 385.Pp 386Lucent cards prior to firmware version 6.0.6 do not support IBSS 387mode. 388These cards support only the pre-802.11 mode known as 389.Dq "demo ad-hoc mode" 390which does not interoperate with stations in IBSS mode. 391.Pp 392Prism cards prior to version 0.8.0 do not support IBSS mode. 393.Pp 394Symbol cards prior to version 2.50.00 do not support IBSS mode. 395.Sh BUGS 396Not all the new messages are documented here, and many of them are 397indications of transient errors that are not indications of serious 398problems. 399.Pp 400WL200 PCI wireless cards are based on a Cirrus Logic CL-PD6729 bridge 401chips glued to an Intersil Prism-II PCMCIA chipset w/o the PC Card 402form factor being present. 403These chips are special and require special care to use properly. 404One must set 405.Va hw.pcic.pd6729_intr_path Ns = Ns Qq Li 2 406in 407.Pa /boot/loader.conf . 408This tells the PC Card system to use PCI interrupts for this odd beast. 409It is not possible to know automatically which kind of interrupts to use. 410OLDCARD devices 411.Xr ( pcic 4 412and 413.Xr card 4 ) 414support this device. 415NEWCARD devices 416.Xr ( pccbb 4 417and 418.Xr pccard 4 ) 419do not support it at this time.
|