362 lines
14 KiB
Raw Normal View History

2002-05-28 09:38:20 -04:00
********************** Linux-wlan-ng FAQ **************************
For additions, corrections, and clarifications, send mail to with FAQ in the subject.
Q: What devices does the linux-wlan-ng driver support?
Currently, the linux-wlan-ng driver supports the Intersil
Prism2/2.5/3 chipsets. These chipsets are used in a wide
variety of PCMCIA, PCI, and USB products. If it has a Prism
chip in it, linux-wlan-ng should support it.
Q: Will linux-wlan-ng support some feature or funkiness in
the <pick one> Linux distribution?
Our development target always consists of stock kernels from and stock pcmcia_cs. If a given distribution
chooses to do something funky, we rely on users of that
distribution to contribute patches to deal with their
The quickest way to get some action on this kind of item is to
communicate with any users of the same distribution that you
can find on the linux-wlan-[devel|user] lists about working up
a patch. If it's reasonably sane and doesn't break things for
our development environment or for other distributions, we'll
be more than happy to roll that patch into the next release.
2002-06-21 09:32:06 -04:00
Q: What does "resultcode=implementation_failure" mean?
2002-07-01 09:30:50 -04:00
2002-06-21 09:32:06 -04:00
Complicated Answer:
Each command that can be issued with wlanctl-ng returns a status
called "resultcode". Resultcode is something that we picked up
from the 802.11 MLME definition. In the standard, resultcode
is an enumeration with a fixed set of values. To be able to
report failures that a driver detects that are outside the
context of the 802.11 standard set of resultcode values, we
invented the "implementation_failure" value.
Simple Answer:
Go look in your kernel log for more detailed error information.
Q: I'm trying to use the HostAP/orinoco/aironet/wvlan driver and it
won't work!
2002-05-28 09:38:20 -04:00
That has nothing to do with the linux-wlan-ng driver. Go ask
those responsible for those drivers.
Q: Can I get Debian packages of linux-wlan-ng?
A: Packages of linux-wlan-ng are available in the Debian unstable
and testing trees now, and will eventually be shipped with a stable
Debian release. The Debian packages include support for configuring
linux-wlan-ng interfaces via /etc/network/interfaces, amoung other
things. Complete details about the Debian-specific parts of these
packages, including instructions for building a linux-wlan-ng modules
package for your kernel can be found in the file
2002-07-23 15:36:48 -04:00
Q: Where do I find some RPMS for linux-wlan-ng? The ones on
2002-06-26 09:42:41 -04:00
the ftp are dreadfully out of date!
(Maintained by Tim Miller)
Q: I installed the RPMs/compiled the driver and installed it and it
won't work when I try to run 'ifup wlan0' or whatnot.
2002-05-28 09:38:20 -04:00
2002-07-01 09:39:06 -04:00
First, ensure you're running the most up-to-date version of
the driver. Many problems have been fixed in newer releases.
2002-05-28 09:38:20 -04:00
802.11 wireless networks are much more complex than wired
ethernet networks. They require much more configuration than
an ip address. If you are using pcmcia, edit the file
/etc/pcmcia/wlan-ng.opts to set the network parameters. For
PCI, PLX, or USB adapters, you need to edit /etc/wlan.conf.
You also need to make sure you have the correct settings in
/etc/modules.conf (alias wlan0 prism2_usb).
Might we suggest you read the README file?
2002-05-28 09:38:20 -04:00
Q: When I try to load the driver, I get a whole bunch of errors about
unresolved symbols.
2002-05-28 09:38:20 -04:00
The running kernel does not match the kernel the driver was
compiled for. If you downloaded a RPM, make sure you
downloaded the correct version for your kernel. This should not
happen if you compiled the driver from source -- if it does, the
kernel configuration you compiled against does not match the
running kernel. Probably a screwed-up distro kernel.
Q: I have a DWL-520 and it won't work!
2002-05-28 09:38:20 -04:00
The DWL-520 *requires* a PCI 2.2 compliant motherboard. Only
very new machines support this. Yes, the box lied. Check the
documentation for your system and/or motherboard to see if it is
PCI 2.2 compliant. If not, return the DWL-520 and buy a Linksys
WMP11 istead.
Q: All I see is "Tx attempt prior to association, frame dropped"
2002-05-28 09:38:20 -04:00
You are not associated with an access point. Double-check the
settings in /etc/wlan.conf (USB, PCI, PLX) or /etc/pcmcia/wlan-ng.opts
(for PCMCIA users). If all of these settings are correct (you
did check with your admin, right?) make sure the access point
doesn't have a MAC filter installed or has different WEP settings.
If all of this is verified correct, and are using a PCMCIA
card, try setting the "irq_mode=0" option. See the
documentaiton in the pcmcia-cs sources.
Q: I installed the modules, performed a 'wlanctl-ng wlan0 lnxreq_autojoin'
command, and it still won't work!
2002-05-28 09:38:20 -04:00
You did read the README, didn't you? You need to perform a
"wlanctl-ng wlan0 lnxreq_ifstate ifstate=enable" in order to
torn on the radio. The pcmcia scripts and the /etc/init.d/wlan
script do this for you.
Q: I have a XXX USB 802.11b device, will it work with this driver?
2002-05-28 09:38:20 -04:00
Most 802.11b USB devices use the ATMEL AT76C503A chipset, which
is not supported by the linux-wlan-ng project. However, there
are some prism2.5-based USB adapters, most notably the Linksys
WUSB v2.5. The other versions (1.0, 2.6, 3.0) are based on
2002-09-24 09:54:04 -04:00
ATMEL chipsets. Another supported USB device is the Actiontec
2002-05-28 09:38:20 -04:00
Q: The wlan-ng driver says my ATMEL AT76C503A device is unsupported!
That's because it's not a Prism-based device! Linux-wlan-ng
does not currently support ATMEL chipsets, mainly because ATMEL
has not been forthcoming with technical programming documentation.
However, ATMEL has an unspported binary-only Linux driver
that they make available to their vendors. So please
call/email your vendor (and/or ATMEL) for this driver.
If they get enough requests, they may eventually care about
supporting Linux users.
For more information on the ATMEL boards, see:
2002-07-01 09:30:50 -04:00 (Open source driver) (summary) (driver)
There is a mailing list for the ATMEL driver:
In the mean time, we suggest returning the ATMEL device and
buying one that the linux-wlan-ng driver supports. </plug>
Q: My prism2.5-based USB adapter won't work!
2002-05-28 09:38:20 -04:00
An excellent guide can be found at:
2002-07-12 09:41:21 -04:00
Q: My prism2.5-based USB adapter won't come up if it's plugged in at boot!
2002-05-28 09:38:20 -04:00
Thanks to buggy firmware, it is often necessary to perform a
device reset on initialization. You can perform this by adding
"options prism2_usb prism2_doreset=1" in your /etc/modules.conf
Intersil has released Primary firmware 1.1.2, which seems to
have resolved this problem, at least on our test machines.
Contact your vendor for a firmware update.
2002-05-28 09:38:20 -04:00
To check the firmware version, run: "dmesg |grep ident"
Q: My PC crashes when the USB device is plugged in!
This is a result of the port reset necessitated by buggy firmware.
2002-05-28 09:38:20 -04:00
You are probably using the 'usb-uhci' driver with an intel
chipset. Unfortunately, the crashes happen deep within the USB
core, so there's nothing the linux-wlan-ng driver can do.
In the mean time, try using the 'uhci' host controller driver
instead ("alias usb-controller uhci" in /etc/modules.conf), or
plug the USB device into a hub.
Linux kernel 2.4.19 is known to improve the situation somewhat,
but the right way to fix it is to turn off the port reset
(options prism2_usb prism2_doreset=0). The current firmware
from Intersil alleviates the need to perform the reset.
Q: What's with these "Called from within soft interrupt context" messages?
2002-05-28 09:38:20 -04:00
This is the result of a workaround to avoid a kernel oops in
the USB driver code. You can ignore them.
2002-05-28 09:38:20 -04:00
As of 0.1.15-pre5, a different workaround is in place.
2002-05-28 09:38:20 -04:00
Q: Why doesn't promiscuous mode or monitor mode work under USB?
2002-05-28 09:38:20 -04:00
Promiscuous mode works just fine, as of 0.1.15-pre5.
Monitor mode also works, as of 0.1.14-pre6.
Both modes are likely to be quite unreliable, especially under
2002-06-13 15:24:14 -04:00
higher loads thanks to fundamental bandwidth limitations of the
USB interface.
2002-05-28 09:38:20 -04:00
Q: How come I can't transmit when in monitor mode?
2002-05-28 09:38:20 -04:00
You can't. It's a fundamental "feature" of the hardware.
Q: How come the /proc/net/wireless info isn't updated when in monitor mode?
2002-05-28 09:38:20 -04:00
The definition of "signal quality" refers to the quality of the
link to the associated access point. When you're in monitor
mode, you're not associated, so this information is by defintion
And regardless, the hardware doesn't update the registers we poll to get
this information while in monitor mode.
2002-07-12 09:41:21 -04:00
Q: What do the various monitor mode options do?
enable=[true/false] Turn it on and off. required.
channel=[1-14] Sniff channel. required.
prismheader=[true/false] Optionally preppend a special
radio header on the packet.
Defaults to off.
keepwepflags=[true/false] If you had WEP configured correctly
the card will perform WEP decoding.
Defaults to off.
stripfcs=[true/false] When true, the 802.11 FCS is not
stripped from incoming packets.
Defaults off.
2002-09-24 09:54:04 -04:00
truncate=[number] Truncates the captured frame.
2002-07-12 09:41:21 -04:00
2002-06-20 17:09:39 -04:00
Q: How come iwconfig/iwspy/[random other wireless tool] doesn't work?
linux-wlan-ng only supports a subset of the wireless
extensions; generally read-only things. However, you won't
need any of those tools as wlan-ng comes with its own set of
tools that closely mirror the 802.11 spec. Have a look
through the documentation and supplied scripts.
That said, if full wireless extension support is really
important to you, you're more than welcome to implement it
and submit a patch.
Q: Where can I download updated firmware for my Prism2/2.5/3-based card?
2002-05-28 09:38:20 -04:00
Ask your vendor. Due to legal reasons, we cannot
provide updated frmware with the driver code.
Q: How can I update my firmware under Linux?
2002-05-28 09:38:20 -04:00
Use the 'prism2dl' utility. Note that it has been removed from
newer revisions of the driver sources due to liability reasons --
too many people fried their cards and blamed AVS for it.
Q: Can I use my 802.11b card as an AP under Linux?
2002-05-28 09:38:20 -04:00
Yes, and in the true free software fashion, there are several
a) linux-wlan-ng supports AP operation by using special tertiary
firmware on prism devices. This firmware is not generally
2002-06-13 13:44:01 -04:00
available, however. Contact Intersil for licensing terms.
2002-05-28 09:38:20 -04:00
b) The Prism2 HostAP driver uses the special HostAP mode of the
prism chipsets.
c) The OpenAP project, which involves flashing Linux on access
2002-06-03 10:27:01 -04:00
Q: After a few minutes of use, my card stops responding! I'm using WEP.
2002-06-03 10:27:01 -04:00
There seems to be card lockup problems with newer cards (new
DWL-650 cards, linksys WPC11v3) when WEP is turned on. Since
2002-08-07 12:15:11 -04:00
WEP is done in hardware, there is nothing the driver can do to
resolve this. We suggest you pester your vendor for a firmware
2002-06-03 10:27:01 -04:00
2002-06-13 13:44:01 -04:00
Prism2.5 boards are also known to lock up under heavy use; this
is due to bugs in the WEP engine. Even if you perform a card
reset, the WEP engine remains stuck.
2002-07-29 17:48:42 -04:00
As an alternative, you can try out the host-based WEP present in
2002-09-16 11:01:11 -04:00
0.1.15-pre1 and newer. It is still considered experimental,
but the person typing this uses it on a daily basis.
Intersil claims to have fixed this in firmware 1.4.0:
"Fixed a hang condidion seen on certian hardware designs when
using firmware WEP"
Note there are other bugs in the firmware; as recently as 1.4.5
Intersil included a fix that would "Correct an error that could
cause the driver to no longer be able to communicate with the
Contact your vendor and ask them to release updated firmware.
2002-06-13 13:44:01 -04:00
Q: When using host-based WEP I get these strange intermittent connection
2002-08-07 12:15:11 -04:00
This should be fixed in 0.1.15-pre3. If you are sill having
problems, send a detailed message to the linux-wlan-devel
mailing list.
Q: When using the wlan-ng driver on a multiprocessor machine, I get
packet corruption or random crashes/lockups.
2002-06-03 10:27:01 -04:00
0.1.15-pre2 is the culmination of a major internal restructure
of driver internals. Please give it (or newer) a shot if you're
using a SMP system; we expect it to be much improved even on
uniprocessor systems as we lock out system interrupts for far
less time now.
2002-09-24 09:54:04 -04:00
Q: I have a PCI adapter, and upon resuming from a suspend, the device is not
2002-09-09 18:40:56 -04:00
Much like you need to run some commands to bring the card to life
when the PC is first booted, you also need to perform similar
steps when the card comes out of suspend. Run '/etc/init.d/wlan start'
and all should be well.
2002-09-24 09:54:04 -04:00
You'll need to be running 0.1.15-pre3 or newer for this to work
2002-09-16 11:01:11 -04:00
The prism2.5/3 chipsets do not support PCI power management, so
this is the best we can realistically do.
Q: I have a Linksys WMP11, and under moderate to heavy traffic, I get
errors like "unknown port number" and "invalid frame type"
Make sure you're using the latest firmware avaliable from
Linksys's web site. According to the firmware release notes:
"Changes were made to prevent erroneous data from being
transferred over the PCI bus"
2002-09-28 13:31:47 -04:00
Note that this problem has also beeen confirmed on the D-Link
DWL-520. You will need firmware 1.3.5 or newer to resolve this.
2002-09-24 09:54:04 -04:00
Q: I have a D-Link DWL-650+/520+ card, why doesn't it work with this driver?
Notice the "plus" in the model number? The "plus" series of
cards from D-Link use the Texas Instruments ACX100 chipset. TI
has not been forthcoming with programming information.
Politely ask TI and D-Link for Linux drivers and/or docs.
We've been told that TI will be releaseing binary-only Linux
drivers sometime in December. In the mean time, return the
card and buy one that works with Linux.
2002-07-12 09:41:21 -04:00
Q: What other resources are there for Wireless LANs under Linux?
2002-09-09 18:40:56 -04:00