xref: /freebsd/share/man/man4/bwn.4 (revision 45d9abdbc3d36e8cd12533130ba124aa749ecea9)
145d9abdbSWeongyo Jeong.\" Copyright (c) 2009 Christian Brueffer
245d9abdbSWeongyo Jeong.\" All rights reserved.
345d9abdbSWeongyo Jeong.\"
445d9abdbSWeongyo Jeong.\" Redistribution and use in source and binary forms, with or without
545d9abdbSWeongyo Jeong.\" modification, are permitted provided that the following conditions
645d9abdbSWeongyo Jeong.\" are met:
745d9abdbSWeongyo Jeong.\" 1. Redistributions of source code must retain the above copyright
845d9abdbSWeongyo Jeong.\"    notice, this list of conditions and the following disclaimer.
945d9abdbSWeongyo Jeong.\" 2. Redistributions in binary form must reproduce the above copyright
1045d9abdbSWeongyo Jeong.\"    notice, this list of conditions and the following disclaimer in the
1145d9abdbSWeongyo Jeong.\"    documentation and/or other materials provided with the distribution.
1245d9abdbSWeongyo Jeong.\"
1345d9abdbSWeongyo Jeong.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1445d9abdbSWeongyo Jeong.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1545d9abdbSWeongyo Jeong.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1645d9abdbSWeongyo Jeong.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
1745d9abdbSWeongyo Jeong.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
1845d9abdbSWeongyo Jeong.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
1945d9abdbSWeongyo Jeong.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2045d9abdbSWeongyo Jeong.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2145d9abdbSWeongyo Jeong.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2245d9abdbSWeongyo Jeong.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2345d9abdbSWeongyo Jeong.\" SUCH DAMAGE.
2445d9abdbSWeongyo Jeong.\"
2545d9abdbSWeongyo Jeong.\" $FreeBSD$
2645d9abdbSWeongyo Jeong.\"
2745d9abdbSWeongyo Jeong.Dd February 15, 2010
2845d9abdbSWeongyo Jeong.Dt BWN 4
2945d9abdbSWeongyo Jeong.Os
3045d9abdbSWeongyo Jeong.Sh NAME
3145d9abdbSWeongyo Jeong.Nm bwn
3245d9abdbSWeongyo Jeong.Nd Broadcom BCM43xx IEEE 802.11b/g wireless network driver
3345d9abdbSWeongyo Jeong.Sh SYNOPSIS
3445d9abdbSWeongyo JeongTo compile this driver into the kernel,
3545d9abdbSWeongyo Jeongplace the following lines in your
3645d9abdbSWeongyo Jeongkernel configuration file:
3745d9abdbSWeongyo Jeong.Bd -ragged -offset indent
3845d9abdbSWeongyo Jeong.Cd "device siba_bwn"
3945d9abdbSWeongyo Jeong.Cd "device bwn"
4045d9abdbSWeongyo Jeong.Cd "device wlan"
4145d9abdbSWeongyo Jeong.Cd "device wlan_amrr"
4245d9abdbSWeongyo Jeong.Cd "device firmware"
4345d9abdbSWeongyo Jeong.Ed
4445d9abdbSWeongyo Jeong.Pp
4545d9abdbSWeongyo JeongAlternatively, to load the driver as a
4645d9abdbSWeongyo Jeongmodule at boot time, place the following line in
4745d9abdbSWeongyo Jeong.Xr loader.conf 5 :
4845d9abdbSWeongyo Jeong.Bd -literal -offset indent
4945d9abdbSWeongyo Jeongif_bwn_load="YES"
5045d9abdbSWeongyo Jeong.Ed
5145d9abdbSWeongyo Jeong.Sh DESCRIPTION
5245d9abdbSWeongyo JeongThe
5345d9abdbSWeongyo Jeong.Nm
5445d9abdbSWeongyo Jeongdriver provides support for Broadcom BCM43xx based
5545d9abdbSWeongyo JeongPCI/CardBus network adapters.
5645d9abdbSWeongyo Jeong.Pp
5745d9abdbSWeongyo JeongIt supports
5845d9abdbSWeongyo Jeong.Cm station
5945d9abdbSWeongyo Jeongand
6045d9abdbSWeongyo Jeong.Cm monitor
6145d9abdbSWeongyo Jeongmode operation.
6245d9abdbSWeongyo JeongOnly one virtual interface may be configured at any time.
6345d9abdbSWeongyo JeongFor more information on configuring this device, see
6445d9abdbSWeongyo Jeong.Xr ifconfig 8 .
6545d9abdbSWeongyo Jeong.Pp
6645d9abdbSWeongyo JeongThis driver requires firmware to be loaded before it will work.
6745d9abdbSWeongyo JeongThe
6845d9abdbSWeongyo Jeong.Pa ports/net/bwn-firmware-kmod
6945d9abdbSWeongyo Jeongport needs to be installed before
7045d9abdbSWeongyo Jeong.Xr ifconfig 8
7145d9abdbSWeongyo Jeongwill work.
7245d9abdbSWeongyo Jeong.Sh HARDWARE
7345d9abdbSWeongyo JeongThe
7445d9abdbSWeongyo Jeong.Nm
7545d9abdbSWeongyo Jeongdriver supports Broadcom BCM43xx based wireless devices, including:
7645d9abdbSWeongyo Jeong.Pp
7745d9abdbSWeongyo Jeong.Bl -column -compact "Apple Airport Extreme" "BCM4306" "Mini PCI" "a/b/g" -offset 6n
7845d9abdbSWeongyo Jeong.It Em "Card	Chip	Bus	Standard"
7945d9abdbSWeongyo Jeong.It "Apple Airport Extreme	BCM4306	PCI	b/g"
8045d9abdbSWeongyo Jeong.It "Apple Airport Extreme	BCM4318	PCI	b/g"
8145d9abdbSWeongyo Jeong.It "ASUS WL-138g	BCM4318	PCI	b/g"
8245d9abdbSWeongyo Jeong.It "Buffalo WLI-CB-G54S	BCM4318	CardBus	b/g"
8345d9abdbSWeongyo Jeong.It "Buffalo WLI-PCI-G54S	BCM4306	PCI	b/g"
8445d9abdbSWeongyo Jeong.It "Compaq R4035 onboard	BCM4306	PCI	b/g"
8545d9abdbSWeongyo Jeong.It "Dell Wireless 1470	BCM4318	Mini PCI	b/g"
8645d9abdbSWeongyo Jeong.It "Dell Truemobile 1400	BCM4309	Mini PCI	b/g"
8745d9abdbSWeongyo Jeong.It "HP nx6125	BCM4319	PCI	b/g"
8845d9abdbSWeongyo Jeong.It "Linksys WPC54G Ver 3	BCM4318	CardBus	b/g"
8945d9abdbSWeongyo Jeong.It "Linksys WPC54GS Ver 2	BCM4318	CardBus	b/g"
9045d9abdbSWeongyo Jeong.It "TRENDnet TEW-401PCplus	BCM4306	CardBus	b/g"
9145d9abdbSWeongyo Jeong.It "US Robotics 5411	BCM4318	CardBus	b/g"
9245d9abdbSWeongyo Jeong.El
9345d9abdbSWeongyo Jeong.Sh EXAMPLES
9445d9abdbSWeongyo JeongJoin an existing BSS network (i.e., connect to an access point):
9545d9abdbSWeongyo Jeong.Pp
9645d9abdbSWeongyo Jeong.Bd -literal -offset indent
9745d9abdbSWeongyo Jeongifconfig wlan create wlandev bwn0 inet 192.168.0.20 \e
9845d9abdbSWeongyo Jeong    netmask 0xffffff00
9945d9abdbSWeongyo Jeong.Ed
10045d9abdbSWeongyo Jeong.Pp
10145d9abdbSWeongyo JeongJoin a specific BSS network with network name
10245d9abdbSWeongyo Jeong.Dq Li my_net :
10345d9abdbSWeongyo Jeong.Pp
10445d9abdbSWeongyo Jeong.Dl "ifconfig wlan create wlandev bwn0 ssid my_net up"
10545d9abdbSWeongyo Jeong.Pp
10645d9abdbSWeongyo JeongJoin a specific BSS network with 64-bit WEP encryption:
10745d9abdbSWeongyo Jeong.Bd -literal -offset indent
10845d9abdbSWeongyo Jeongifconfig wlan create wlandev bwn0 ssid my_net \e
10945d9abdbSWeongyo Jeong        wepmode on wepkey 0x1234567890 weptxkey 1 up
11045d9abdbSWeongyo Jeong.Ed
11145d9abdbSWeongyo Jeong.Sh SEE ALSO
11245d9abdbSWeongyo Jeong.Xr arp 4 ,
11345d9abdbSWeongyo Jeong.Xr cardbus 4 ,
11445d9abdbSWeongyo Jeong.Xr intro 4 ,
11545d9abdbSWeongyo Jeong.Xr pci 4 ,
11645d9abdbSWeongyo Jeong.Xr wlan 4 ,
11745d9abdbSWeongyo Jeong.Xr wlan_amrr 4 ,
11845d9abdbSWeongyo Jeong.Xr ifconfig 8 ,
11945d9abdbSWeongyo Jeong.Xr wpa_supplicant 8
12045d9abdbSWeongyo Jeong.Sh HISTORY
12145d9abdbSWeongyo JeongThe
12245d9abdbSWeongyo Jeong.Nm
12345d9abdbSWeongyo Jeongdriver first appeared in
12445d9abdbSWeongyo Jeong.Fx 8.0 .
12545d9abdbSWeongyo Jeong.Sh AUTHORS
12645d9abdbSWeongyo Jeong.An -nosplit
12745d9abdbSWeongyo JeongThe
12845d9abdbSWeongyo Jeong.Nm
12945d9abdbSWeongyo Jeongdriver was written by
13045d9abdbSWeongyo Jeong.An Weongyo Jeong
13145d9abdbSWeongyo Jeong.Aq weongyo@FreeBSD.org .
13245d9abdbSWeongyo Jeong.\".Sh BUGS
13345d9abdbSWeongyo Jeong.\"Some card based on the BCM4306 and BCM4309 chips do not work properly
13445d9abdbSWeongyo Jeong.\"on channel 1, 2 and 3.
135