1.\"- 2.\" SPDX-License-Identifier: BSD-2-Clause 3.\" 4.\" Copyright (c) 2004-2006 5.\" Damien Bergamini <damien.bergamini@free.fr>. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice unmodified, this list of conditions, and the following 12.\" disclaimer. 13.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" notice, this list of conditions and the following disclaimer in the 15.\" documentation and/or other materials provided with the distribution. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 18.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" 29.Dd October 17, 2024 30.Dt IWN 4 31.Os 32.Sh NAME 33.Nm iwn 34.Nd Intel IEEE 802.11n wireless network driver 35.Sh SYNOPSIS 36To compile this driver into the kernel, 37include the following lines in your 38kernel configuration file: 39.Bd -ragged -offset indent 40.Cd "device iwn" 41.Cd "device pci" 42.Cd "device wlan" 43.Cd "device firmware" 44.Ed 45.Pp 46You also need to select a firmware for your device. 47Choose one from: 48.Bd -ragged -offset indent 49.Cd "device iwn1000fw" 50.Cd "device iwn100fw" 51.Cd "device iwn105fw" 52.Cd "device iwn135fw" 53.Cd "device iwn2000fw" 54.Cd "device iwn2030fw" 55.Cd "device iwn4965fw" 56.Cd "device iwn5000fw" 57.Cd "device iwn5150fw" 58.Cd "device iwn6000fw" 59.Cd "device iwn6000g2afw" 60.Cd "device iwn6000g2bfw" 61.Cd "device iwn6050fw" 62.Ed 63.Pp 64Or you can use 65.Bd -ragged -offset indent 66.Cd "device iwnfw" 67.Ed 68.Pp 69to include them all. 70.Pp 71Alternatively, to load the driver as a 72module at boot time, place the following lines in 73.Xr loader.conf 5 : 74.Bd -literal -offset indent 75if_iwn_load="YES" 76iwn1000fw_load="YES" 77iwn100fw_load="YES" 78iwn105fw_load="YES" 79iwn135fw_load="YES" 80iwn2000fw_load="YES" 81iwn2030fw_load="YES" 82iwn4965fw_load="YES" 83iwn5000fw_load="YES" 84iwn5150fw_load="YES" 85iwn6000fw_load="YES" 86iwn6000g2afw_load="YES" 87iwn6000g2bfw_load="YES" 88iwn6050fw_load="YES" 89.Ed 90.Sh DESCRIPTION 91The 92.Nm 93driver supports 94.Cm station 95and 96.Cm monitor 97mode operation. 98Only one virtual interface may be configured at any time. 99For more information on configuring this device, see 100.Xr ifconfig 8 . 101.Pp 102This driver requires the firmware built with the 103.Nm iwnfw 104module to work. 105.Sh HARDWARE 106The 107.Nm 108driver provides support for: 109.Pp 110.Bl -bullet -compact 111.It 112Intel Centrino Advanced-N 6200 113.It 114Intel Centrino Advanced-N 6205 115.It 116Intel Centrino Advanced-N 6230 117.It 118Intel Centrino Advanced-N 6235 119.It 120Intel Centrino Advanced-N + WiMAX 6250 121.It 122Intel Centrino Ultimate-N 6300 123.It 124Intel Centrino Wireless-N 100 125.It 126Intel Centrino Wireless-N 105 127.It 128Intel Centrino Wireless-N 130 129.It 130Intel Centrino Wireless-N 135 131.It 132Intel Centrino Wireless-N 1000 133.It 134Intel Centrino Wireless-N 1030 135.It 136Intel Centrino Wireless-N 2200 137.It 138Intel Centrino Wireless-N 2230 139.It 140Intel Centrino Wireless-N 4965 141.It 142Intel Centrino Wireless-N 5100 143.It 144Intel Centrino Wireless-N 6150 145.It 146Intel Centrino Wireless-N 6200 147.It 148Intel Centrino Wireless-N 6250 149.It 150Intel Centrino Wireless-N + WiMAX 6150 151.It 152Intel Ultimate N WiFi Link 5300 153.It 154Intel Wireless WiFi Link 4965 155.It 156Intel WiFi Link 5100 157.It 158Intel WiMAX/WiFi Link 5150 159.It 160Intel WiMAX/WiFi Link 5350 161.El 162.Sh EXAMPLES 163Join an existing BSS network (i.e., connect to an access point): 164.Bd -literal -offset indent 165# ifconfig wlan create wlandev iwn0 inet 192.168.0.20 \e 166 netmask 0xffffff00 167.Ed 168.Pp 169Join a specific BSS network with network name 170.Ql my_net : 171.Pp 172.Dl # ifconfig wlan create wlandev iwn0 ssid my_net up 173.Pp 174Join a specific BSS network with 64-bit WEP encryption: 175.Bd -literal -offset indent 176# ifconfig wlan create wlandev iwn0 ssid my_net \e 177 wepmode on wepkey 0x1234567890 weptxkey 1 up 178.Ed 179.Pp 180Join a specific BSS network with 128-bit WEP encryption: 181.Bd -literal -offset indent 182# ifconfig wlan create wlandev iwn0 wlanmode adhoc ssid my_net \e 183 wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 184.Ed 185.Sh DIAGNOSTICS 186.Bl -diag 187.It "iwn%d: device timeout" 188The driver will reset the hardware. 189This should not happen. 190.It "iwn%d: firmware error" 191The onboard microcontroller crashed for some reason. 192The driver will reset the hardware. 193This should not happen. 194.It "iwn%d: timeout waiting for firmware initialization to complete" 195The onboard microcontroller failed to initialize in time. 196This should not happen. 197.It "iwn%d: could not load firmware image '%s'" 198The driver failed to load the firmware image using the 199.Xr firmware 9 200subsystem. 201Verify the 202.Xr iwnfw 4 203firmware module is present. 204.It "iwn%d: could not load boot firmware" 205An attempt to upload the boot firmware image to the onboard microcontroller 206failed. 207This should not happen. 208.It "iwn%d: could not load microcode" 209An attempt to upload the microcode image to the onboard microcontroller failed. 210This should not happen. 211.It "iwn%d: could not load main firmware" 212An attempt to upload the main firmware image to the onboard microcontroller 213failed. 214This should not happen. 215.El 216.Sh SEE ALSO 217.Xr iwnfw 4 , 218.Xr pci 4 , 219.Xr wlan 4 , 220.Xr wlan_ccmp 4 , 221.Xr wlan_tkip 4 , 222.Xr wlan_wep 4 , 223.Xr networking 7 , 224.Xr ifconfig 8 , 225.Xr wpa_supplicant 8 226.Sh AUTHORS 227The original 228.Nm 229driver was written by 230.An Damien Bergamini Aq Mt damien.bergamini@free.fr . 231