if_wpi (4)

Leading comments

 Copyright (c) 2004-2007
	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
	Benjamin Close <Benjamin.Close@clearchain.com>. All rights reserved.
 Copyright (c) 2016 Andriy Voskoboinyk <avos@FreeBSD.org>
 All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 1. Redistributions of source code must retain the above copyright
    notice unmodified, this list of condi...

(The comments found at the beginning of the groff file "man4/if_wpi.4freebsd".)

NAME

wpi - Intel 3945ABG Wireless LAN IEEE 802.11 driver

SYNOPSIS

To compile this driver into the kernel, place the following lines in your kernel configuration file:

device wpi device wpifw device pci device wlan device wlan_amrr device firmware

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf5:

if_wpi_load="YES"

DESCRIPTION

The ifconfig driver provides support for the Intel 3945ABG Wireless network adapter. ifconfig supports station adhoc and monitor 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 wpifw module to work.

FILES

/usr/share/doc/legal/intel_wpi/LICENSE

ifconfig firmware license

EXAMPLES

Join an existing BSS network (i.e., connect to an access point):

ifconfig wlan0 create wlandev wpi0 inet 192.168.0.20 \
    netmask 0xffffff00

Join a specific BSS network with network name ``my_net ''

"ifconfig wlan0 create wlandev wpi0 ssid my_net up"

Join a specific BSS network with 64-bit WEP encryption:

ifconfig wlan0 create wlandev wpi0 ssid my_net \
        wepmode on wepkey 0x1234567890 weptxkey 1 up

Join a specific BSS network with 128-bit WEP encryption:

ifconfig wlan0 create wlandev wpi0 wlanmode adhoc ssid my_net \
    wepmode on wepkey 0x01020304050607080910111213 weptxkey 1

DIAGNOSTICS

"wpi%d: could not load firmware image '%s'"

The driver failed to load the firmware image using the firmware(9) subsystem. Verify the wpifw firmware module is installed.

"wpi%d: fatal firmware error"

An unknown error has occurred in the uploaded firmware, you may have to unload/reload the driver to continue.

"wpi%d: Radio transmitter is switched off"

The hardware switch controlling the radio is currently turned off. Data transmission is not possible in this state.

SEE ALSO

wpifw(4), pci(4), wlan(4), wlan_ccmp4, wlan_tkip4, wlan_wep4, ifconfig(8), wpa_supplicant8

AUTHORS

An -nosplit The original ifconfig driver was written for Ox by An Damien Bergamini Aq damien.bergamini@free.fr . An Benjamin Close Aq benjsc@FreeBSD.org ported ifconfig to Fx .

BUGS

Not all the error messages are documented here.

Background scanning is not currently supported.