NAME
iwm
—
Intel IEEE 802.11ac wireless network
driver
SYNOPSIS
To compile this driver into the kernel, include the following lines in your kernel configuration file:
device iwm
device pci
device wlan
You also need to select a firmware for your device. Use
device iwmfw
to include them all.
Alternatively, to load the driver as a module at boot time, place the following lines in loader.conf(5):
if_iwm_load="YES" iwm3160fw_load="YES" iwm3168fw_load="YES" iwm7260fw_load="YES" iwm7265fw_load="YES" iwm7265Dfw_load="YES" iwm8000Cfw_load="YES" iwm8265fw_load="YES"
DESCRIPTION
Theiwm
driver provides support for:
- Intel Dual Band Wireless AC 3160
- Intel Dual Band Wireless AC 3165
- Intel Dual Band Wireless AC 3168
- Intel Dual Band Wireless AC 7260
- Intel Dual Band Wireless AC 7265
- Intel Dual Band Wireless AC 8260
- Intel Dual Band Wireless AC 8265
iwm
supports
station
mode operation. Only one virtual interface
may be configured at any time. For more information on configuring this
device, see
ifconfig(8).
This driver requires the firmware built with the
iwmfw
module to work.
LOADER TUNABLES
- hw.iwm.msi.enable
- By default, the driver will use MSI if it is supported. This behavior can be turned off by setting this tunable to 0.
- hw.iwm.power_scheme
- Power management scheme: 1 = active, 2 = balanced (default), 3 = low power
- hw.iwm.lar.disable
- Allows disabling LAR (Location Aware Regulatory) feature: 0 = LAR enabled if available (default), 1 = LAR disabled
EXAMPLES
Join an existing BSS network (i.e., connect to an access point):
ifconfig wlan create wlandev iwm0 inet 192.168.0.20 \ netmask 0xffffff00
Join a specific BSS network with network name
“my_net
”:
ifconfig wlan create wlandev iwm0
ssid my_net up
Join a specific BSS network with 64-bit WEP encryption:
ifconfig wlan create wlandev iwm0 ssid my_net \ wepmode on wepkey 0x1234567890 weptxkey 1 up
Join a specific BSS network with 128-bit WEP encryption:
ifconfig wlan create wlandev iwm0 wlanmode adhoc ssid my_net \ wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
DIAGNOSTICS
- iwm%d: device timeout
- The driver will reset the hardware. This should not happen.
- iwm%d: firmware error
- The onboard microcontroller crashed for some reason. The driver will reset the hardware. This should not happen.
- iwm%d: fw chunk addr 0x%x len %d failed to load
- Timed out waiting for a segment of the firmware to load. This should not happen.
- iwm%d: could not read firmware %s (error %d)
- The driver failed to load the firmware image using the firmware(9) subsystem. Verify the iwmfw(4) firmware module is present.
- iwm%d: Failed to start INIT ucode: %d
- An attempt to upload the INIT firmware image to the onboard microcontroller failed. This should not happen.
- iwm%d: could not load firmware
- An attempt to upload the REGULAR firmware image to the onboard microcontroller failed. This should not happen.
SEE ALSO
iwmfw(4), pci(4), wlan(4), wlan_ccmp(4), wlan_tkip(4), wlan_wep(4), ifconfig(8), wpa_supplicant(8)
HISTORY
The iwm
device driver first appeared in
OpenBSD 5.7.