xref: /freebsd/share/man/man4/iwn.4 (revision c7ea7c4618afa577df5832172f83f492425b7e6f)
13971d07bSSam Leffler.\" Copyright (c) 2004-2006
23971d07bSSam Leffler.\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
33971d07bSSam Leffler.\"
43971d07bSSam Leffler.\" Redistribution and use in source and binary forms, with or without
53971d07bSSam Leffler.\" modification, are permitted provided that the following conditions
63971d07bSSam Leffler.\" are met:
73971d07bSSam Leffler.\" 1. Redistributions of source code must retain the above copyright
83971d07bSSam Leffler.\"    notice unmodified, this list of conditions, and the following
93971d07bSSam Leffler.\"    disclaimer.
103971d07bSSam Leffler.\" 2. Redistributions in binary form must reproduce the above copyright
113971d07bSSam Leffler.\"    notice, this list of conditions and the following disclaimer in the
123971d07bSSam Leffler.\"    documentation and/or other materials provided with the distribution.
133971d07bSSam Leffler.\"
143971d07bSSam Leffler.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
153971d07bSSam Leffler.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
163971d07bSSam Leffler.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
173971d07bSSam Leffler.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
183971d07bSSam Leffler.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
193971d07bSSam Leffler.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
203971d07bSSam Leffler.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
213971d07bSSam Leffler.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
223971d07bSSam Leffler.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
233971d07bSSam Leffler.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
243971d07bSSam Leffler.\" SUCH DAMAGE.
253971d07bSSam Leffler.\"
263971d07bSSam Leffler.\" $FreeBSD$
273971d07bSSam Leffler.\"
28c7ea7c46SRebecca Cran.Dd February 8, 2010
293971d07bSSam Leffler.Os
303971d07bSSam Leffler.Dt IWN 4
313971d07bSSam Leffler.Sh NAME
323971d07bSSam Leffler.Nm iwn
33c7ea7c46SRebecca Cran.Nd Intel Wireless WiFi Link 4965/1000/5000/5150/5300/6000/6050
34c7ea7c46SRebecca CranIEEE 802.11n driver
353971d07bSSam Leffler.Sh SYNOPSIS
363971d07bSSam LefflerTo compile this driver into the kernel,
373971d07bSSam Lefflerinclude the following lines in your
383971d07bSSam Lefflerkernel configuration file:
393971d07bSSam Leffler.Bd -ragged -offset indent
403971d07bSSam Leffler.Cd "device iwn"
413971d07bSSam Leffler.Cd "device pci"
423971d07bSSam Leffler.Cd "device wlan"
433971d07bSSam Leffler.Cd "device firmware"
443971d07bSSam Leffler.Ed
453971d07bSSam Leffler.Pp
46613628c4SChristian BruefferYou also need to select a firmware for your device.
47613628c4SChristian BruefferChoose one from:
482267cb3dSRui Paulo.Bd -ragged -offset indent
492267cb3dSRui Paulo.Cd "device iwn4965fw"
50c7ea7c46SRebecca Cran.Cd "device iwn1000fw"
512267cb3dSRui Paulo.Cd "device iwn5000fw"
52c7ea7c46SRebecca Cran.Cd "device iwn5150fw"
53c7ea7c46SRebecca Cran.Cd "device iwn6000fw"
542267cb3dSRui Paulo.Ed
552267cb3dSRui Paulo.Pp
562267cb3dSRui PauloOr you can use
572267cb3dSRui Paulo.Bd -ragged -offset indent
582267cb3dSRui Paulo.Cd "device iwnfw"
592267cb3dSRui Paulo.Ed
602267cb3dSRui Paulo.Pp
612267cb3dSRui Pauloto include them all.
622267cb3dSRui Paulo.Pp
633971d07bSSam LefflerAlternatively, to load the driver as a
64613628c4SChristian Brueffermodule at boot time, place the following lines in
653971d07bSSam Leffler.Xr loader.conf 5 :
663971d07bSSam Leffler.Bd -literal -offset indent
673971d07bSSam Lefflerif_iwn_load="YES"
682267cb3dSRui Pauloiwn4965fw_load="YES"
69c7ea7c46SRebecca Craniwn1000fw_load="YES"
702267cb3dSRui Pauloiwn5000fw_load="YES"
71c7ea7c46SRebecca Craniwn5150fw_load="YES"
72c7ea7c46SRebecca Craniwn6000fw_load="YES"
733971d07bSSam Leffler.Ed
743971d07bSSam Leffler.Sh DESCRIPTION
753971d07bSSam LefflerThe
763971d07bSSam Leffler.Nm
773971d07bSSam Lefflerdriver provides support for
783971d07bSSam Leffler.Tn Intel
79c7ea7c46SRebecca CranWireless WiFi Link 4965, 1000, 5000 and 6000 series of
80c7ea7c46SRebecca CranPCI-Express network adapters.
813971d07bSSam Leffler.Nm
823971d07bSSam Lefflersupports
833971d07bSSam Leffler.Cm station ,
843971d07bSSam Leffler.Cm adhoc ,
853971d07bSSam Lefflerand
863971d07bSSam Leffler.Cm monitor
873971d07bSSam Lefflermode operation.
883971d07bSSam LefflerOnly one virtual interface may be configured at any time.
893971d07bSSam LefflerFor more information on configuring this device, see
903971d07bSSam Leffler.Xr ifconfig 8 .
913971d07bSSam Leffler.Pp
923971d07bSSam LefflerThis driver requires the firmware built with the
933971d07bSSam Leffler.Nm iwnfw
943971d07bSSam Lefflermodule to work.
953971d07bSSam Leffler.Sh EXAMPLES
963971d07bSSam LefflerJoin an existing BSS network (i.e., connect to an access point):
973971d07bSSam Leffler.Pp
983971d07bSSam Leffler.Bd -literal -offset indent
993971d07bSSam Lefflerifconfig wlan create wlandev iwn0 inet 192.168.0.20 \e
1003971d07bSSam Leffler    netmask 0xffffff00
1013971d07bSSam Leffler.Ed
1023971d07bSSam Leffler.Pp
1033971d07bSSam LefflerJoin a specific BSS network with network name
1043971d07bSSam Leffler.Dq Li my_net :
1053971d07bSSam Leffler.Pp
1063971d07bSSam Leffler.Dl "ifconfig wlan create wlandev iwn0 ssid my_net up"
1073971d07bSSam Leffler.Pp
1083971d07bSSam LefflerJoin a specific BSS network with 64-bit WEP encryption:
1093971d07bSSam Leffler.Bd -literal -offset indent
1103971d07bSSam Lefflerifconfig wlan create wlandev iwn0 ssid my_net \e
1113971d07bSSam Leffler	wepmode on wepkey 0x1234567890 weptxkey 1 up
1123971d07bSSam Leffler.Ed
1133971d07bSSam Leffler.Pp
1143971d07bSSam LefflerJoin a specific BSS network with 128-bit WEP encryption:
1153971d07bSSam Leffler.Bd -literal -offset indent
1163971d07bSSam Lefflerifconfig wlan create wlandev iwn0 wlanmode adhoc ssid my_net \e
1173971d07bSSam Leffler    wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
1183971d07bSSam Leffler.Ed
1193971d07bSSam Leffler.Sh DIAGNOSTICS
1203971d07bSSam Leffler.Bl -diag
1213971d07bSSam Leffler.It "iwn%d: device timeout"
1223971d07bSSam LefflerThe driver will reset the hardware.
1233971d07bSSam LefflerThis should not happen.
1243971d07bSSam Leffler.It "iwn%d: firmware error"
1253971d07bSSam LefflerThe onboard microcontroller crashed for some reason.
1263971d07bSSam LefflerThe driver will reset the hardware.
1273971d07bSSam LefflerThis should not happen.
1283971d07bSSam Leffler.It "iwn%d: timeout waiting for firmware initialization to complete"
1293971d07bSSam LefflerThe onboard microcontroller failed to initialize in time.
1303971d07bSSam LefflerThis should not happen.
1313971d07bSSam Leffler.It "iwn%d: could not load firmware image '%s'"
1323971d07bSSam LefflerThe driver failed to load the firmware image using the
1333971d07bSSam Leffler.Xr firmware 9
1343971d07bSSam Lefflersubsystem.
1353971d07bSSam LefflerVerify the
1363971d07bSSam Leffler.Xr iwnfw 4
137f057099fSSam Lefflerfirmware module is present.
1383971d07bSSam Leffler.It "iwn%d: could not load boot firmware"
1393971d07bSSam LefflerAn attempt to upload the boot firmware image to the onboard microcontroller
1403971d07bSSam Lefflerfailed.
1413971d07bSSam LefflerThis should not happen.
1423971d07bSSam Leffler.It "iwn%d: could not load microcode"
1433971d07bSSam LefflerAn attempt to upload the microcode image to the onboard microcontroller failed.
1443971d07bSSam LefflerThis should not happen.
1453971d07bSSam Leffler.It "iwn%d: could not load main firmware"
1463971d07bSSam LefflerAn attempt to upload the main firmware image to the onboard microcontroller
1473971d07bSSam Lefflerfailed.
1483971d07bSSam LefflerThis should not happen.
1493971d07bSSam Leffler.El
1503971d07bSSam Leffler.Sh SEE ALSO
1513c29ede0SSam Leffler.Xr iwnfw 4 ,
1523971d07bSSam Leffler.Xr pci 4 ,
1533971d07bSSam Leffler.Xr wlan 4 ,
1543971d07bSSam Leffler.Xr wlan_ccmp 4 ,
1553971d07bSSam Leffler.Xr wlan_tkip 4 ,
1563971d07bSSam Leffler.Xr wlan_wep 4 ,
1573971d07bSSam Leffler.Xr ifconfig 8 ,
158dec7a1d5SChristian Brueffer.Xr wpa_supplicant 8
1593971d07bSSam Leffler.Sh AUTHORS
1603971d07bSSam LefflerThe original
1613971d07bSSam Leffler.Nm
1623971d07bSSam Lefflerdriver was written by
1633971d07bSSam Leffler.An Damien Bergamini Aq damien.bergamini@free.fr
164