/share/man/man4/bwi.4

  1.\" Copyright (c) 2009 Christian Brueffer
  2.\" 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.\"
 13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 23.\" SUCH DAMAGE.
 24.\"
 25.\" $FreeBSD$
 26.\"
 27.Dd February 6, 2011
 28.Dt BWI 4
 29.Os
 30.Sh NAME
 31.Nm bwi
 32.Nd Broadcom BCM43xx IEEE 802.11b/g wireless network driver
 33.Sh SYNOPSIS
 34To compile this driver into the kernel,
 35place the following lines in your
 36kernel configuration file:
 37.Bd -ragged -offset indent
 38.Cd "device bwi"
 39.Cd "device wlan"
 40.Cd "device wlan_amrr"
 41.Cd "device firmware"
 42.Ed
 43.Pp
 44Alternatively, to load the driver as a
 45module at boot time, place the following line in
 46.Xr loader.conf 5 :
 47.Bd -literal -offset indent
 48if_bwi_load="YES"
 49.Ed
 50.Sh DESCRIPTION
 51The
 52.Nm
 53driver provides support for Broadcom BCM43xx based
 54PCI/CardBus network adapters.
 55.Pp
 56It supports
 57.Cm station
 58and
 59.Cm monitor
 60mode operation.
 61Only one virtual interface may be configured at any time.
 62For more information on configuring this device, see
 63.Xr ifconfig 8 .
 64.Pp
 65This driver requires firmware to be loaded before it will work.
 66The
 67.Pa ports/net/bwi-firmware-kmod
 68port needs to be installed before
 69.Xr ifconfig 8
 70will work.
 71.Sh HARDWARE
 72The
 73.Nm
 74driver supports Broadcom BCM43xx based wireless devices, including:
 75.Bl -column "Apple Airport Extreme" "BCM4306" "Mini PCI" "a/b/g" -offset 6n
 76.It Em "Card" Ta Em "Chip" Ta Em "Bus" Ta Em "Standard"
 77.It "Apple Airport Extreme	BCM4306	PCI	b/g"
 78.It "Apple Airport Extreme	BCM4318	PCI	b/g"
 79.It "ASUS WL-138g	BCM4318	PCI	b/g"
 80.It "Buffalo WLI-CB-G54S	BCM4318	CardBus	b/g"
 81.It "Buffalo WLI-PCI-G54S	BCM4306	PCI	b/g"
 82.It "Compaq R4035 onboard	BCM4306	PCI	b/g"
 83.It "Dell Wireless 1390	BCM4311	Mini PCI	b/g"
 84.It "Dell Wireless 1470	BCM4318	Mini PCI	b/g"
 85.It "Dell Truemobile 1300 r2	BCM4306	Mini PCI	b/g"
 86.It "Dell Truemobile 1400	BCM4309	Mini PCI	b/g"
 87.It "HP nx6125	BCM4319	PCI	b/g"
 88.It "Linksys WPC54G Ver 3	BCM4318	CardBus	b/g"
 89.It "Linksys WPC54GS Ver 2	BCM4318	CardBus	b/g"
 90.It "TRENDnet TEW-401PCplus	BCM4306	CardBus	b/g"
 91.It "US Robotics 5411	BCM4318	CardBus	b/g"
 92.El
 93.Pp
 94The
 95.Nm
 96driver uses the older v3 version of Broadcom's firmware.
 97While this older firmware does support most BCM43xx parts, the
 98.Xr bwn 4
 99driver works better for the newer chips it supports.
100You must use the
101.Nm
102driver if you are using older Broadcom chipsets (BCM4301, BCM4303 and
103BCM4306 rev 2).
104The v4 version of the firmware that
105.Xr bwn 4
106uses does not support these chips.
107.Sh EXAMPLES
108Join an existing BSS network (i.e., connect to an access point):
109.Bd -literal -offset indent
110ifconfig wlan create wlandev bwi0 inet 192.168.0.20 \e
111    netmask 0xffffff00
112.Ed
113.Pp
114Join a specific BSS network with network name
115.Dq Li my_net :
116.Pp
117.Dl "ifconfig wlan create wlandev bwi0 ssid my_net up"
118.Pp
119Join a specific BSS network with 64-bit WEP encryption:
120.Bd -literal -offset indent
121ifconfig wlan create wlandev bwi0 ssid my_net \e
122        wepmode on wepkey 0x1234567890 weptxkey 1 up
123.Ed
124.Sh SEE ALSO
125.Xr arp 4 ,
126.Xr cardbus 4 ,
127.Xr intro 4 ,
128.Xr pci 4 ,
129.Xr wlan 4 ,
130.Xr wlan_amrr 4 ,
131.Xr ifconfig 8 ,
132.Xr wpa_supplicant 8
133.Sh HISTORY
134The
135.Nm
136driver first appeared in
137.Fx 8.0 .
138.Sh AUTHORS
139.An -nosplit
140The
141.Nm
142driver was written for DragonFly BSD by
143.An Sepherosa Ziehau
144and subsequently ported to
145.Fx .
146.Sh BUGS
147Some card based on the BCM4306 and BCM4309 chips do not work properly
148on channel 1, 2 and 3.