1dc4815c0SBenjamin Close.\" Copyright (c) 2004-2007 2dc4815c0SBenjamin Close.\" Damien Bergamini <damien.bergamini@free.fr>. All rights reserved. 3dc4815c0SBenjamin Close.\" Benjamin Close <Benjamin.Close@clearchain.com>. All rights reserved. 4dc4815c0SBenjamin Close.\" 5dc4815c0SBenjamin Close.\" Redistribution and use in source and binary forms, with or without 6dc4815c0SBenjamin Close.\" modification, are permitted provided that the following conditions 7dc4815c0SBenjamin Close.\" are met: 8dc4815c0SBenjamin Close.\" 1. Redistributions of source code must retain the above copyright 9dc4815c0SBenjamin Close.\" notice unmodified, this list of conditions, and the following 10dc4815c0SBenjamin Close.\" disclaimer. 11dc4815c0SBenjamin Close.\" 2. Redistributions in binary form must reproduce the above copyright 12dc4815c0SBenjamin Close.\" notice, this list of conditions and the following disclaimer in the 13dc4815c0SBenjamin Close.\" documentation and/or other materials provided with the distribution. 14dc4815c0SBenjamin Close.\" 15dc4815c0SBenjamin Close.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16dc4815c0SBenjamin Close.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17dc4815c0SBenjamin Close.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18dc4815c0SBenjamin Close.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19dc4815c0SBenjamin Close.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20dc4815c0SBenjamin Close.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21dc4815c0SBenjamin Close.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22dc4815c0SBenjamin Close.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23dc4815c0SBenjamin Close.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24dc4815c0SBenjamin Close.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25dc4815c0SBenjamin Close.\" SUCH DAMAGE. 26dc4815c0SBenjamin Close.\" 27dc4815c0SBenjamin Close.\" $FreeBSD$ 28dc4815c0SBenjamin Close.\" 2977a62bf5SSam Leffler.Dd October 5, 2008 30dc4815c0SBenjamin Close.Dt WPI 4 31aa12cea2SUlrich Spörlein.Os 32dc4815c0SBenjamin Close.Sh NAME 33dc4815c0SBenjamin Close.Nm wpi 34dc4815c0SBenjamin Close.Nd "Intel 3945ABG Wireless LAN IEEE 802.11 driver" 35dc4815c0SBenjamin Close.Sh SYNOPSIS 36dc4815c0SBenjamin CloseTo compile this driver into the kernel, 37dc4815c0SBenjamin Closeplace the following lines in your 38dc4815c0SBenjamin Closekernel configuration file: 39dc4815c0SBenjamin Close.Bd -ragged -offset indent 40dc4815c0SBenjamin Close.Cd "device wpi" 41b032f27cSSam Leffler.Cd "device wpifw" 42dc4815c0SBenjamin Close.Cd "device pci" 43dc4815c0SBenjamin Close.Cd "device wlan" 44b5ad081cSBenjamin Close.Cd "device wlan_amrr" 45dc4815c0SBenjamin Close.Cd "device firmware" 46dc4815c0SBenjamin Close.Ed 47dc4815c0SBenjamin Close.Pp 48dc4815c0SBenjamin CloseAlternatively, to load the driver as a 49b032f27cSSam Lefflermodule at boot time, place the following line in 50dc4815c0SBenjamin Close.Xr loader.conf 5 : 51dc4815c0SBenjamin Close.Bd -literal -offset indent 52dc4815c0SBenjamin Closeif_wpi_load="YES" 53dc4815c0SBenjamin Close.Ed 54dc4815c0SBenjamin Close.Sh DESCRIPTION 55dc4815c0SBenjamin CloseThe 56dc4815c0SBenjamin Close.Nm 57b032f27cSSam Lefflerdriver provides support for the 58dc4815c0SBenjamin Close.Tn Intel 59*50d922a0SGlen Barber3945ABG Wireless network adapter. 60dc4815c0SBenjamin Close.Nm 61b032f27cSSam Lefflersupports 62b032f27cSSam Leffler.Cm station , 63b032f27cSSam Leffler.Cm adhoc , 64b032f27cSSam Lefflerand 65b032f27cSSam Leffler.Cm monitor 66b032f27cSSam Lefflermode operation. 67b032f27cSSam LefflerOnly one virtual interface may be configured at any time. 68dc4815c0SBenjamin CloseFor more information on configuring this device, see 69dc4815c0SBenjamin Close.Xr ifconfig 8 . 70dc4815c0SBenjamin Close.Pp 71b032f27cSSam LefflerThis driver requires the firmware built with the 72b032f27cSSam Leffler.Nm wpifw 73b032f27cSSam Lefflermodule to work. 74dc4815c0SBenjamin Close.Sh FILES 75dc4815c0SBenjamin Close.Bl -tag -width ".Pa /usr/share/doc/legal/intel_wpi/LICENSE" -compact 76dc4815c0SBenjamin Close.It Pa /usr/share/doc/legal/intel_wpi/LICENSE 77dc4815c0SBenjamin Close.Nm 78dc4815c0SBenjamin Closefirmware license 79dc4815c0SBenjamin Close.El 80dc4815c0SBenjamin Close.Sh EXAMPLES 81dc4815c0SBenjamin CloseJoin an existing BSS network (i.e., connect to an access point): 82b032f27cSSam Leffler.Bd -literal -offset indent 833e460b60SGleb Smirnoffifconfig wlan0 create wlandev wpi0 inet 192.168.0.20 \e 84b032f27cSSam Leffler netmask 0xffffff00 85b032f27cSSam Leffler.Ed 86dc4815c0SBenjamin Close.Pp 87dc4815c0SBenjamin CloseJoin a specific BSS network with network name 88dc4815c0SBenjamin Close.Dq Li my_net : 89dc4815c0SBenjamin Close.Pp 903e460b60SGleb Smirnoff.Dl "ifconfig wlan0 create wlandev wpi0 ssid my_net up" 91dc4815c0SBenjamin Close.Pp 92b032f27cSSam LefflerJoin a specific BSS network with 64-bit WEP encryption: 93dc4815c0SBenjamin Close.Bd -literal -offset indent 943e460b60SGleb Smirnoffifconfig wlan0 create wlandev wpi0 ssid my_net \e 95b032f27cSSam Leffler wepmode on wepkey 0x1234567890 weptxkey 1 up 96dc4815c0SBenjamin Close.Ed 97dc4815c0SBenjamin Close.Pp 98b032f27cSSam LefflerJoin a specific BSS network with 128-bit WEP encryption: 99dc4815c0SBenjamin Close.Bd -literal -offset indent 1003e460b60SGleb Smirnoffifconfig wlan0 create wlandev wpi0 wlanmode adhoc ssid my_net \e 101dc4815c0SBenjamin Close wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 102dc4815c0SBenjamin Close.Ed 103dc4815c0SBenjamin Close.Sh DIAGNOSTICS 104dc4815c0SBenjamin Close.Bl -diag 105b032f27cSSam Leffler.It "wpi%d: could not load firmware image '%s'" 106b032f27cSSam LefflerThe driver failed to load the firmware image using the 107dc4815c0SBenjamin Close.Xr firmware 9 108dc4815c0SBenjamin Closesubsystem. 109b032f27cSSam LefflerVerify the 110b032f27cSSam Leffler.Xr wpifw 11177a62bf5SSam Lefflerfirmware module is installed. 112dc4815c0SBenjamin Close.It "wpi%d: fatal firmware error" 113dc4815c0SBenjamin CloseAn unknown error has occurred in the uploaded firmware, you may have to 114dc4815c0SBenjamin Closeunload/reload the driver to continue. 1159920732cSChristian Brueffer.It "wpi%d: Radio transmitter is switched off" 116dc4815c0SBenjamin CloseThe hardware switch controlling the radio is currently turned off. 1179920732cSChristian BruefferData transmission is not possible in this state. 118e7d6c4e7SChristian Brueffer.El 119dc4815c0SBenjamin Close.Sh SEE ALSO 120b032f27cSSam Leffler.Xr wpifw 4 , 121dc4815c0SBenjamin Close.Xr pci 4 , 122dc4815c0SBenjamin Close.Xr wlan 4 , 123b032f27cSSam Leffler.Xr wlan_ccmp 4 , 124b032f27cSSam Leffler.Xr wlan_tkip 4 , 125b032f27cSSam Leffler.Xr wlan_wep 4 , 126b032f27cSSam Leffler.Xr ifconfig 8 , 127*50d922a0SGlen Barber.Xr wpa_supplicant 8 128dc4815c0SBenjamin Close.Sh AUTHORS 1299920732cSChristian Brueffer.An -nosplit 130b032f27cSSam LefflerThe original 131dc4815c0SBenjamin Close.Nm 132b032f27cSSam Lefflerdriver was written for 133b032f27cSSam Leffler.Ox 134b032f27cSSam Lefflerby 135b032f27cSSam Leffler.An Damien Bergamini Aq damien.bergamini@free.fr . 136b032f27cSSam Leffler.An Benjamin Close Aq benjsc@FreeBSD.org 137b032f27cSSam Lefflerported 138b032f27cSSam Leffler.Nm 139b032f27cSSam Lefflerto 140b032f27cSSam Leffler.Fx . 1410afc94c1SUlrich Spörlein.Sh BUGS 1420afc94c1SUlrich SpörleinNot all the error messages are documented here. 1430afc94c1SUlrich Spörlein.Pp 1440afc94c1SUlrich SpörleinBackground scanning is not currently supported. 145