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 140519 2005-01-20 18:33:07Z imp $
| 31.\" $FreeBSD: head/share/man/man4/wi.4 147872 2005-07-10 02:00:35Z 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
| 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
|
| 146Adaptech ANW-8030 Prism-3 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
192Intersil ISL37100P Prism-3 PCMCIA
193Intersil ISL37110P Prism-3 PCMCIA
194Intersil ISL37300P Prism-3 PCMCIA
195Laneed Wireless PCMCIA
196Linksys Instant Wireless WPC11 Prism-II PCMCIA
197Linksys Instant Wireless WPC11 2.5 Prism-2.5 PCMCIA
198Linksys Instant Wireless WPC11 3.0 Prism-3 PCMCIA
199Linksys WCF11 Prism-3 PCMCIA
200Linksys WCF12 Prism-3 CF
201Lucent WaveLAN Hermes PCMCIA
202Melco Airconnect Prism-II PCMCIA
203Microsoft MN-520 WLAN Prism-II PCMCIA
204NANOSPEED ROOT-RZ2000 Prism-II PCMCIA
205NCR WaveLAN/IEEE 802.11 PCMCIA
206NDC/Sohoware NCP130 Prism-II PCI
207NEC CMZ-RT-WP Prism-II PCMCIA
208NEC PK-WL001 Lucent PCMCIA
209NEC PC-WL/11C Prism-II PCMCIA
210Netgear MA311 Prism-2.5 PCI
211Netgear MA401 Prism-II/2.5 PCMCIA
212Netgear MA401RA Prism-II PCMCIA
213Netgear MA701 Prism-II CF
214NOKIA C020 WLAN Prism-II PCMCIA
215NOKIA C110 WLAN Prism-2.5 PCMCIA
216NTT-ME 11Mbps Wireless LAN Prism-II PCMCIA
217Planex GeoWave/GW-NS110 Prism-II PCMCIA
218Planex GW-NS11H Prism-II PCMCIA
219Proxim Harmony Prism-II PCMCIA
220Proxim RangeLAN-DS Prism-II PCMCIA
221Samsung MagicLAN SWL-2000N Prism-II PCMCIA
222SENAO SL-2511CD Prism-3 PCMCIA
223Siemens SpeedStream SS1021 Prism-II PCMCIA
224SMC 2602 EZ Connect (3.3V) Prism-II PCI or PCMCIA
225SMC 2632 EZ Connect Prism-II PCMCIA
226Socket Low Power WLAN-CF Prism-II CF
227Sony PCWA-C100 Lucent PCMCIA
228Sony PEGA-WL110 Prism-2.5 PCMCIA
229Symbol Spectrum24 Spectrum24 PCMCIA
230Symbol LA-4100 Spectrum24 CF
231TDK LAK-CD011WL Prism-II PCMCIA
232Toshiba Wireless LAN Card Prism-II PCMCIA
233U.S.\& Robotics Wireless Card 2410 Prism-II PCMCIA
234YIS YWL-11B Prism-II PCMCIA
235.El
236.Pp
237Several vendors sell PCI adapters built around the PLX Technology 9050
238or 9052 chip.
239The following such adapters are supported or expected to work:
240.Pp
241.Bl -item -compact
242.It
2433Com AirConnect 3CRWE777A (3.3V)
244.It
245Belkin F5D6000 (a rebadged WL11000P)
246.It
247Eumitcom WL11000P
248.It
249Global Sun Technology GL24110P (untested)
250.It
251Global Sun Technology GL24110P02
252.It
253LinkSys WDT11 (a rebadged GL24110P02)
254.It
255Netgear MA301
256.It
257US Robotics 2415 (rebadged WL11000P)
258.It
259Wisecom Wireless LAN PCI Adapter
260.El
261.Pp
262The following adapters have the same model numbers as those listed
263above, but might not work if the actual card is after the change away
264from the Prism family:
265.Pp
266.Bl -item -compact
267.It
268DLink DWL520
269.El
270.Sh EXAMPLES
271Join an existing BSS network (ie: connect to an access point):
272.Pp
273.Dl "ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00"
274.Pp
275Join a specific BSS network with network name
276.Dq Li my_net :
277.Pp
278.Dl "ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net"
279.Pp
280Join a specific BSS network with WEP encryption:
281.Bd -literal -offset indent
282ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
283 wepmode on wepkey 0x8736639624
284.Ed
285.Pp
286Join a Lucent legacy demo ad-hoc network with network name
287.Dq Li my_net :
288.Bd -literal -offset indent
289ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
290 media DS/11Mbps mediaopt adhoc,link0
291.Ed
292.Pp
293Join/create an IBSS network with network name
294.Dq Li my_net :
295.Bd -literal -offset indent
296ifconfig wi0 inet 192.168.0.22 netmask 0xffffff00 ssid my_net \e
297 media DS/11Mbps mediaopt adhoc
298.Ed
299.Pp
300Create a host-based access point (Prism only):
301.Bd -literal -offset indent
302ifconfig wi0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e
303 media DS/11Mbps mediaopt hostap
304.Ed
305.Pp
306Create a host-based access point with WEP enabled (Prism only):
307.Bd -literal -offset indent
308ifconfig wi0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e
309 wepmode on wepkey 0x1234567890 media DS/11Mbps \e
310 mediaopt hostap
311.Ed
312.Pp
313Create a host-based wireless bridge to fxp0 (Prism only):
314.Bd -literal -offset indent
315Add BRIDGE to the kernel config.
316ifconfig wi0 inet up ssid my_ap media DS/11Mbps mediaopt hostap
317sysctl net.link.ether.bridge.enable=1
318sysctl net.link.ether.bridge.config="wi0 fxp0"
319sysctl net.inet.ip.check_interface=0
320.Ed
321.Pp
322This will give you the same functionality as an access point.
323.Sh DIAGNOSTICS
324.Bl -diag
325.It "wi%d: init failed"
326The WaveLAN card failed to become ready after an initialization command
327was issued.
328.It "wi%d: failed to allocate %d bytes on NIC"
329The driver was unable to allocate memory for transmit frames in the
330NIC's on-board RAM.
331This can also be an indication of an incorrectly configured interrupt.
332.It "wi%d: device timeout"
333The WaveLAN card failed to generate an interrupt to acknowledge a transmit
334command.
335.El
336.Sh SEE ALSO
337.Xr an 4 ,
338.Xr arp 4 ,
339.Xr ath 4 ,
340.Xr card 4 ,
341.Xr netintro 4 ,
342.Xr pccard 4 ,
343.Xr pccbb 4 ,
344.Xr pcic 4 ,
345.Xr wlan 4 ,
346.Xr ifconfig 8 ,
347.Xr wicontrol 8
348.Rs
349.%T HCF Light programming specification
350.%O http://www.wavelan.com
351.Re
352.Sh HISTORY
353The
354.Nm
355device driver first appeared in
356.Fx 3.0 .
357.Sh AUTHORS
358The
359.Nm
360driver was written by
361.An Bill Paul Aq wpaul@ctr.columbia.edu .
362This man page comes from
363.Ox .
364.Sh CAVEATS
365Different regulatory domains have different default channels for adhoc
366mode.
367See
368.Xr ifconfig 8
369for information on how to change the channel.
370See
371.Xr wicontrol 8
372for information on different regulatory domains.
373.Pp
374The Intersil Prism family of chips' host-based access point mode has
375bugs for station firmware versions prior to 0.8.3.
376The driver currently precludes hostap functionality with older station
377firmware.
378The best version of the station firmware for the Prism family of chips
379seems to be 1.4.9.
380Some users of Prism-II and 2.5 based cards report that station firmware
381version 1.3.4 works better for them in hostap than 1.4.9.
382Older versions of the Prism station firmware have a number of issues
383with hostap mode.
384The IBSS/adhoc mode appears to work well on station firmware 1.3.1 and
385later.
386The IBSS/adhoc mode appears to have problems for some people with
387older versions of station firmware.
388.Pp
389Lucent cards prior to firmware version 6.0.6 do not support IBSS
390mode.
391These cards support only the pre-802.11 mode known as
392.Dq "demo ad-hoc mode"
393which does not interoperate with stations in IBSS mode.
394.Pp
395Prism cards prior to version 0.8.0 do not support IBSS mode.
396.Pp
397Symbol cards prior to version 2.50.00 do not support IBSS mode.
398.Sh BUGS
399Not all the new messages are documented here, and many of them are
400indications of transient errors that are not indications of serious
401problems.
402.Pp
403WL200 PCI wireless cards are based on a Cirrus Logic CL-PD6729 bridge
404chips glued to an Intersil Prism-II PCMCIA chipset w/o the PC Card
405form factor being present.
406These chips are special and require special care to use properly.
407One must set
408.Va hw.pcic.pd6729_intr_path Ns = Ns Qq Li 2
409in
410.Pa /boot/loader.conf .
411This tells the PC Card system to use PCI interrupts for this odd beast.
412It is not possible to know automatically which kind of interrupts to use.
413OLDCARD devices
414.Xr ( pcic 4
415and
416.Xr card 4 )
417support this device.
418NEWCARD devices
419.Xr ( pccbb 4
420and
421.Xr pccard 4 )
422do not support it at this time.
| 147Addtron AWP-100 Prism-II PCMCIA
148Adtec Adlink/340C Prism-II PCMCIA
149Airvast WN 100 Prism-3 PCMCIA
150Airway 802.11 Adapter PCMCIA
151Agere Orinoco Hermes PCMCIA
152Allied Telesis WR211PCM Prism-II PCMCIA
153ArTem OnAir Prism? PCMCIA
154Asus WL100 Prism-2.5 PCMCIA
155Avaya Wireless Prism-II PCMCIA
156Bay eMobility 11B Prism-2.5? PCMCIA
157Blue Concentric Circle WL-379F Prism-II CF
158BreezeNet Wireless Prism-II PCMCIA
159Buffalo WLI-PCM-S11 Prism-II PCMCIA
160Buffalo WLI-PCM-L11G Hermes PCMCIA
161Buffalo WLI-CF-S11G Prism-II CF
162Buffalo WLI2-CF-S11G Prism 2.5 CF
163Cabletron RoamAbout Hermes PCMCIA
164Compaq Agency NC5004 Prism-II PCMCIA
165Compaq WL100 Prism-II PCMCIA
166Compaq WL110 Hermes PCMCIA
167Compaq WL200 Prism-II PCMCIA
168Contec FLEXLAN/FX-DS110-PCC Prism-II PCMCIA
169Corega PCC-11 Prism-II PCMCIA
170Corega PCCA-11 Prism-II PCMCIA
171Corega PCCB-11 Prism-II PCMCIA
172Corega CGWLPCIA11 Prism-II PCI
173Dell TrueMobile 1150 Hermes PCMCIA
174Dlink Air 660 Prism-II PCMCIA
175Dlink DWL520 Prism-2.5 PCI
176Dlink DWL650 Prism-2.5 PCMCIA
177ELECOM Air@Hawk/LD-WL11/PCC PCMCIA
178ELSA MC-11 PCMCIA
179ELSA XI300 Prism-II PCMCIA
180ELSA XI800 Prism-II CF
181EMTAC A2424i Prism-II PCMCIA
182Ericsson Wireless LAN CARD C11 Spectrum24 PCMCIA
183Farallon Skyline Prism-II PCMCIA
184Gemtek WL-311 Prism-2.5 PCMCIA
185Hawking Technology WE110P Prism-2.5 PCMCIA
186Home Wireless Networks Prism-II PCMCIA
187IBM High Rate Wireless Hermes PCMCIA
188ICOM SL-1100 Prism-II PCMCIA
189I-O DATA WN-B11/PCM Prism-II PCMCIA
190Intel PRO/Wireless 2011 Spectrum24 PCMCIA
191Intersil Prism II Prism-II PCMCIA
192Intersil Mini-PCI Prism-2.5 PCI
193Intersil ISL37100P Prism-3 PCMCIA
194Intersil ISL37110P Prism-3 PCMCIA
195Intersil ISL37300P Prism-3 PCMCIA
196Laneed Wireless PCMCIA
197Linksys Instant Wireless WPC11 Prism-II PCMCIA
198Linksys Instant Wireless WPC11 2.5 Prism-2.5 PCMCIA
199Linksys Instant Wireless WPC11 3.0 Prism-3 PCMCIA
200Linksys WCF11 Prism-3 PCMCIA
201Linksys WCF12 Prism-3 CF
202Lucent WaveLAN Hermes PCMCIA
203Melco Airconnect Prism-II PCMCIA
204Microsoft MN-520 WLAN Prism-II PCMCIA
205NANOSPEED ROOT-RZ2000 Prism-II PCMCIA
206NCR WaveLAN/IEEE 802.11 PCMCIA
207NDC/Sohoware NCP130 Prism-II PCI
208NEC CMZ-RT-WP Prism-II PCMCIA
209NEC PK-WL001 Lucent PCMCIA
210NEC PC-WL/11C Prism-II PCMCIA
211Netgear MA311 Prism-2.5 PCI
212Netgear MA401 Prism-II/2.5 PCMCIA
213Netgear MA401RA Prism-II PCMCIA
214Netgear MA701 Prism-II CF
215NOKIA C020 WLAN Prism-II PCMCIA
216NOKIA C110 WLAN Prism-2.5 PCMCIA
217NTT-ME 11Mbps Wireless LAN Prism-II PCMCIA
218Planex GeoWave/GW-NS110 Prism-II PCMCIA
219Planex GW-NS11H Prism-II PCMCIA
220Proxim Harmony Prism-II PCMCIA
221Proxim RangeLAN-DS Prism-II PCMCIA
222Samsung MagicLAN SWL-2000N Prism-II PCMCIA
223SENAO SL-2511CD Prism-3 PCMCIA
224Siemens SpeedStream SS1021 Prism-II PCMCIA
225SMC 2602 EZ Connect (3.3V) Prism-II PCI or PCMCIA
226SMC 2632 EZ Connect Prism-II PCMCIA
227Socket Low Power WLAN-CF Prism-II CF
228Sony PCWA-C100 Lucent PCMCIA
229Sony PEGA-WL110 Prism-2.5 PCMCIA
230Symbol Spectrum24 Spectrum24 PCMCIA
231Symbol LA-4100 Spectrum24 CF
232TDK LAK-CD011WL Prism-II PCMCIA
233Toshiba Wireless LAN Card Prism-II PCMCIA
234U.S.\& Robotics Wireless Card 2410 Prism-II PCMCIA
235YIS YWL-11B Prism-II PCMCIA
236.El
237.Pp
238Several vendors sell PCI adapters built around the PLX Technology 9050
239or 9052 chip.
240The following such adapters are supported or expected to work:
241.Pp
242.Bl -item -compact
243.It
2443Com AirConnect 3CRWE777A (3.3V)
245.It
246Belkin F5D6000 (a rebadged WL11000P)
247.It
248Eumitcom WL11000P
249.It
250Global Sun Technology GL24110P (untested)
251.It
252Global Sun Technology GL24110P02
253.It
254LinkSys WDT11 (a rebadged GL24110P02)
255.It
256Netgear MA301
257.It
258US Robotics 2415 (rebadged WL11000P)
259.It
260Wisecom Wireless LAN PCI Adapter
261.El
262.Pp
263The following adapters have the same model numbers as those listed
264above, but might not work if the actual card is after the change away
265from the Prism family:
266.Pp
267.Bl -item -compact
268.It
269DLink DWL520
270.El
271.Sh EXAMPLES
272Join an existing BSS network (ie: connect to an access point):
273.Pp
274.Dl "ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00"
275.Pp
276Join a specific BSS network with network name
277.Dq Li my_net :
278.Pp
279.Dl "ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net"
280.Pp
281Join a specific BSS network with WEP encryption:
282.Bd -literal -offset indent
283ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
284 wepmode on wepkey 0x8736639624
285.Ed
286.Pp
287Join a Lucent legacy demo ad-hoc network with network name
288.Dq Li my_net :
289.Bd -literal -offset indent
290ifconfig wi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e
291 media DS/11Mbps mediaopt adhoc,link0
292.Ed
293.Pp
294Join/create an IBSS network with network name
295.Dq Li my_net :
296.Bd -literal -offset indent
297ifconfig wi0 inet 192.168.0.22 netmask 0xffffff00 ssid my_net \e
298 media DS/11Mbps mediaopt adhoc
299.Ed
300.Pp
301Create a host-based access point (Prism only):
302.Bd -literal -offset indent
303ifconfig wi0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e
304 media DS/11Mbps mediaopt hostap
305.Ed
306.Pp
307Create a host-based access point with WEP enabled (Prism only):
308.Bd -literal -offset indent
309ifconfig wi0 inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e
310 wepmode on wepkey 0x1234567890 media DS/11Mbps \e
311 mediaopt hostap
312.Ed
313.Pp
314Create a host-based wireless bridge to fxp0 (Prism only):
315.Bd -literal -offset indent
316Add BRIDGE to the kernel config.
317ifconfig wi0 inet up ssid my_ap media DS/11Mbps mediaopt hostap
318sysctl net.link.ether.bridge.enable=1
319sysctl net.link.ether.bridge.config="wi0 fxp0"
320sysctl net.inet.ip.check_interface=0
321.Ed
322.Pp
323This will give you the same functionality as an access point.
324.Sh DIAGNOSTICS
325.Bl -diag
326.It "wi%d: init failed"
327The WaveLAN card failed to become ready after an initialization command
328was issued.
329.It "wi%d: failed to allocate %d bytes on NIC"
330The driver was unable to allocate memory for transmit frames in the
331NIC's on-board RAM.
332This can also be an indication of an incorrectly configured interrupt.
333.It "wi%d: device timeout"
334The WaveLAN card failed to generate an interrupt to acknowledge a transmit
335command.
336.El
337.Sh SEE ALSO
338.Xr an 4 ,
339.Xr arp 4 ,
340.Xr ath 4 ,
341.Xr card 4 ,
342.Xr netintro 4 ,
343.Xr pccard 4 ,
344.Xr pccbb 4 ,
345.Xr pcic 4 ,
346.Xr wlan 4 ,
347.Xr ifconfig 8 ,
348.Xr wicontrol 8
349.Rs
350.%T HCF Light programming specification
351.%O http://www.wavelan.com
352.Re
353.Sh HISTORY
354The
355.Nm
356device driver first appeared in
357.Fx 3.0 .
358.Sh AUTHORS
359The
360.Nm
361driver was written by
362.An Bill Paul Aq wpaul@ctr.columbia.edu .
363This man page comes from
364.Ox .
365.Sh CAVEATS
366Different regulatory domains have different default channels for adhoc
367mode.
368See
369.Xr ifconfig 8
370for information on how to change the channel.
371See
372.Xr wicontrol 8
373for information on different regulatory domains.
374.Pp
375The Intersil Prism family of chips' host-based access point mode has
376bugs for station firmware versions prior to 0.8.3.
377The driver currently precludes hostap functionality with older station
378firmware.
379The best version of the station firmware for the Prism family of chips
380seems to be 1.4.9.
381Some users of Prism-II and 2.5 based cards report that station firmware
382version 1.3.4 works better for them in hostap than 1.4.9.
383Older versions of the Prism station firmware have a number of issues
384with hostap mode.
385The IBSS/adhoc mode appears to work well on station firmware 1.3.1 and
386later.
387The IBSS/adhoc mode appears to have problems for some people with
388older versions of station firmware.
389.Pp
390Lucent cards prior to firmware version 6.0.6 do not support IBSS
391mode.
392These cards support only the pre-802.11 mode known as
393.Dq "demo ad-hoc mode"
394which does not interoperate with stations in IBSS mode.
395.Pp
396Prism cards prior to version 0.8.0 do not support IBSS mode.
397.Pp
398Symbol cards prior to version 2.50.00 do not support IBSS mode.
399.Sh BUGS
400Not all the new messages are documented here, and many of them are
401indications of transient errors that are not indications of serious
402problems.
403.Pp
404WL200 PCI wireless cards are based on a Cirrus Logic CL-PD6729 bridge
405chips glued to an Intersil Prism-II PCMCIA chipset w/o the PC Card
406form factor being present.
407These chips are special and require special care to use properly.
408One must set
409.Va hw.pcic.pd6729_intr_path Ns = Ns Qq Li 2
410in
411.Pa /boot/loader.conf .
412This tells the PC Card system to use PCI interrupts for this odd beast.
413It is not possible to know automatically which kind of interrupts to use.
414OLDCARD devices
415.Xr ( pcic 4
416and
417.Xr card 4 )
418support this device.
419NEWCARD devices
420.Xr ( pccbb 4
421and
422.Xr pccard 4 )
423do not support it at this time.
|