tagline: From openSUSE
- 1 Why (and why not) NDISwrapper
- 2 Getting NDISwrapper
- 3 Obtaining the Windows driver
- 4 Installing your drivers
- 5 Configuring your card in YaST
- 6 Potential conflicts & issues
- 7 Hardware specific information
- 8 See also
- 9 External links
Why (and why not) NDISwrapper
Some vendors do not release specifications of the hardware or provide a Linux driver for their wireless network cards. The NDISwrapper project implements Windows kernel API and NDIS (Network Driver Interface Specification) API within the Linux kernel. A Windows driver for wireless network card is then linked to this implementation so that the driver runs natively, as though it is in Windows, without binary emulation.
However please note that you should use native wireless driver (such as b43, ath9k, etc) provided by the kernel whenever possible. NDISwrapper works by bridging Windows drivers into kernel space; for kernel developers this is a violation of the GPL license of the kernel. Furthermore, NDISwrapper does not work with standard kernel features, such as 4K stacks, and exposes the user to binary-only drivers in kernel space that the user cannot modify or fix. Furthermore, NDISwrapper does not work at all without the Windows drivers, which 1) are not redistributable and 2) are not open source. In addition, because NDISwrapper is tied to the kernel, bugs in the Windows's wireless drivers have the potential to cause kernel panic even thought the same bugs may not cause problems in Windows. Thus there is stability issue to consider as well. A further problem is that if you encounter a kernel bug that results in an oops, most kernel developers will ask you to reproduce the problem without tainting the kernel without loading any non-GPL drivers.
The better solution to NDISWrapper
What it comes down to is NDISWrapper is a solution of last resort. If your wifi card does not have a free software compatible Linux driver (and firmware) consider purchasing a new one. Be aware that most places selling Linux compatible cards do not support Linux and the chipsets are likely not free software compatible.
This means the cards won't be supported by the free software community and you are at the mercy of the chipset manufacturer for support. You may find your card no longer works when the card is discontinued or doesn't work at all with your distribution of choice.
There are few places you can get cards from which clearly indicate the chipset or free software support. At the moment the only clear source for free software compatible cards is ThinkPenguin.com.
Alternatively it is possible to find free software compatible cards based on the chipset. This is a bit more difficult and generally users find challenging as documented chipsets don't match the model numbers as indicated on available lists found online. This is because manufacturers change chipsets without changing model numbers.
From openSUSE media
Ndiswrapper is included with your openSUSE installation CDs/DVD. Use the software management utility in YaST and make sure the following packages are installed:
Choose the proper kernel module package (kmp) for your architecture. To find out which kernel you're running:
From driver:wireless repository
You can obtain the latest version of NDISwrapper from the driver:wireless repository.
- First, check the version of the kernel you're running by:
- Then, obtain root permission by running
- Depending on your openSUSE version, you must add the correct repository:
kernel 3.4.6-2.10 i586/x86_64 GNU/Linux (openSUSE 12.2)
zypper ar http://download.opensuse.org/repositories/driver:/wireless/openSUSE_12.2 ndiswrapper
kernel 3.7.10-1.1 i586/x86_64 GNU/Linux (openSUSE 12.3)
zypper ar http://download.opensuse.org/repositories/driver:/wireless/openSUSE_12.3 ndiswrapper
kernel 3.10.5-20.g4e0ffc2 i586/x86_64 GNU/Linux (openSUSE Tumbleweed)
zypper ar http://download.opensuse.org/repositories/driver:/wireless/openSUSE_Tumbleweed ndiswrapper
- After you have added the repositories you can run the command to install NDISwrapper depending on the kernel you have:
If you have "desktop" kernel:
zypper in ndiswrapper ndiswrapper-kmp-desktop
If you have "default" kernel:
zypper in ndiswrapper ndiswrapper-kmp-default
If you have "pae" kernel:
zypper in ndiswrapper ndiswrapper-kmp-pae
If you have "xen" kernel:
zypper in ndiswrapper ndiswrapper-kmp-xen
- After done installing, you can remove the repository by running:
zypper rr ndiswrapper
From source code
You can also download and compile the latest versions directly from the ndiswrapper site.
Obtaining the Windows driver
You may be able to determine which driver you need by looking for your specific hardware in the ndiswrapper compatiblity list
If you are running a 64-bit Linux kernel, you MUST find the 64-bit Windows driver (which is somewhat harder to find than the 32-bit Windows driver)! So, if you can't find the 64-bit Windows driver, you'd need to install the 32-bit version of openSUSE instead, if you plan to use ndiswrapper!
From your Windows partition
If you have a dual-boot machine and you have your card properly working in Windows, then one way to get your driver is to get it from the Windows partition itself. [Remember that if your Windows installation is 32bit, your driver will be 32bit and likewise for 64bit Windows, your driver will be 64bit]
Under Windows, go to the Device Manager and find your wireless card under "Network adapters". Right-click on this and go to Properties->Driver->'Driver Details...'. Here you should find the path to a *.sys file, usually located in your C:\windows\system32\drivers\ directory.
Now you will use the Windows "Search" functionality to find the corresponding *.inf file, which is nothing more than a simple text file (try opening one!) with a list of all the required driver's files. So a sample search query in Windows would be:
|All of part of the file name:||*.inf|
|A word or phrase in the file:||<the *.sys path found above>|
|Look in:||Local Hard Drives (C:)|
This search may take a while! When you've found it, look inside the *.inf file with a text editor and see if you need to find any more files. If you're lucky, everything should be in a single directory (for example C:\Program Files\Atheros\Drivers\). Copy all these files to a single location (e.g. in /home/myuser sub-tree) or to an external USB drive which is accessible to your Linux system.
From the driver installation software
There are several places where you can try to find your drivers, listed here in order of preference:
- The "download" page/section of your PC or card manufacturer's support web site
- the installation CD that came with your hardware
- by searching for your .sys file with Google (Advanced, if you didn't try previous two ways yet, you don't even know the name of the .sys file)
If you're best lucky, you will find the proper .inf/.sys and associated files very easily. (Although most of the times you're of very bad luck)
Most of the times, you will need to extract drivers from an .exe or .cab file by yourself. Below will teach you how, example taken from Netgear WNA3100 (BCM43231).
Extracting drivers is a trival work. Because there're two formats for .exe/.cab under Windows: Normal, and those createdby InstallShield, they both have a same suffix.
Go to http://downloadcenter.netgear.com/en/, search "WNA3100" and download Windows drivers (WNA3100_V126.96.36.199.zip 108MB)
Create drivers' directory, copy and unzip:
mkdir ~/bcm43231 mv ./WNA3100_V188.8.131.52.zip ~/bcm43231 unzip WNA3100_V184.108.40.206.zip
We just need drivers, the "Genie Setup" is an utility installer to setup your card under Windows, you don't need that stuff.
Now we're facing a Setup.exe driver, let's try using `cabextract` (Command Line Utility) to test if it's a self-extracting Cab file.
sudo zypper in cabextract
If you met:
Setup.exe: no valid cabinets found
Then it proves that this .exe is not a self-extracting Cab, but a .exe installer created by InstallShield. There's no programs that can uncompress this format, so we need to use a Windows open source utility Universal Extractor to do that: You can run Windows directly or indirectly under a Virtual Machine, or you can use `wine`. We use wine here:
sudo zypper in wine wine ./UniExtract.exe
So using Universal Extractor we successfully uncompressed a Disk1 directory. There's still no drivers inside, but a data1.cab and a data2.cab file.
If you met:
WARNING; found InstallShield header. This is probably an InstallShield file. Use UNSHIELD from www.synce.org to unpack it.
Then it proves it's still a Cab created by InstallShield instead of a normal Windows self-extracting Cab. cabextract suggests us to uncompress it using `unishield`:
sudo zypper in unishield mkdir data1 unishield -d ./data1 x data1.cab mkdir data2 unishield -d ./data2 x data2.cab
Now data1 and data2 directories were filled with contents, let's find if there's .inf inside:
find ./data1 -name "*.inf" ./data1/Win8_x86/bcmwlhigh6.inf ./data1/Win8_x64/bcmwlhigh6.inf
Congrats! Copy those two directories Win8_x86 and Win8_x64 to somewhere your Linux can read and it's done!
Dealing with multiple *.inf files
If there's two or more .inf files don't panic, each one is for a different version of windows. My driver's disc has two:
bcmwl5a.inf and bcmwl5.inf
The first is for win98 the second is for Win2K, Me, and XP. In my case, the win 98 driver works and the xp didn't.
Installing your drivers
- Open up a console window and obtain the root permission: (if you don't know what that is, the su command means "substitute user" which can be the super user root. It will ask you the root password)
- Now type:
ndiswrapper -i /path/to/drivers/bcmwl5a.inf
Be sure to include the actual path to your .inf file.
Tips: Instead of typing the absolute path, you might prefer to change directory (cd) to the folder containing the .inf file first before running the command. If the way to this folder (the pathname) contains white spaces, e.g. "Program Files", it is sometimes easier for newbies to cd to the folder containing the required .inf file first:
cd '/home/where the/inf file is'
and after that you can install the driver by just using the .inf filename:
- If all goes well, type:
- If you installed a valid/compatible Windows-driver, ndiswrapper will display something like this:
<driver-name> : driver installed device (xxxx:xxxx) present (alternate driver: <native-driver-name>)
Where <driver-name> shows the name of the windows driver installed with ndiswrapper and <native-driver-name> is the name of the Linux native driver being overridden.
This native driver may need to be 'blacklist'ed if it is installed and is being detected, as indicated in the logfile: '/var/log/messages'. Blacklisting prevents the native driver from trying to operate the hardware, since we want ndiswrapper's driver to operate it. To blacklist a native driver, add a line to the file '/etc/modprobe.d/blacklist' that reads:
where <native-driver> is the actual name of the driver to be blacklisted.
- If ndiswrapper says "invalid driver" then you need to uninstall that driver and try a different one.
- To uninstall a driver, you need to type:
ndiswrapper -r <then the name of the driver to uninstall>
- An additional check can be to look at
if a directory named as the installed driver is there available.
USB WLAN stick
If you have a USB WLAN Stick there is an extra step that you need to do to properly install the driver. You need to provide NDISwrapper the VendorID and the ProductID of your USB WLAN stick with the -d option. Look for the id's in YaST Hardware Information category USB. Alternatively you can also run:
Which you should be able to get two four-characters/digits numbers like 168c and 0013.
To link the USBID to the driver you have to type:
ndiswrapper -d xxxx:xxxx <then the name of the driver>
have a look with the command:
dmesg | tail
for successfully loading/connecting the driver.
If it works you can write the alias for the ndiswrapper in the modules.conf with
Load NDISwrapper with the command
after that you can configure it with Yast
Configuring your card in YaST
If you have problem getting the wireless card being detected by (K)NetworkManager, you may need additional steps to configure the network card.
Since openSUSE 11.1 you can no longer edit the network setting in YaST when the network is controlled by NetworkManager. If you have problems with (K)NetworkManager, see http://en.opensuse.org/NDISwrapper#Conflicts_with_NetworkManager for more information
There are many possible configurations possible. Here is only a typical example:
- Start YaST's network configuration: Network Devices → Network Card
- Go to the "Overview" tab
- Choose: "Add" button in lower half
- Device Type: "Wireless"
- Configuration Name: "0" (or whatever :))
- Hardware Configuration Name: "static-0"
- Module Name: "ndiswrapper"
- Options: "" (keep empty)
- Do not select "PCMCIA" nor "USB"
- ... and finally "Next"
- On next screen select DHCP in "Hostname and Name Server" and in "Advanced → DHCP Options", then click "Next"
- In "Wireless Network Card Configuration"-window choose (= keep the defaults):
- Operation Mode: "Managed"
- Network Name (ESSID): "" (keep empty)
- Authentication Mode: "Open"
- Input Type: "Passphrase"
- Encryption Key: "" (keep empty)
- .. . and finally "Next"
- the kwallet manager might open -- give him your password and ignore this opening (it doesn't do anything)
- ignore the warning that "Encryption is doing on own risk"
- back in "Network Card Configuration Overview" choose "Next"
Your card is configured.
You might now open the Network Manager in your taskbar (kicker) and select one of the found networks. Disable your wire connection (if connected), and access the internet.
If your SSID (wireless network name) is not broadcasted, you can select an own, specific one in the Network Manager.
Potential conflicts & issues
Once you have ndiswrapper working you will see that the LED for the wireless card lights up with network start, i.e. at boot or in response to the command
You will be able to see the available networks via the KDE network manager or by issuing the command issued as root:
su -c 'iwlist wlan0 scan'
You may need to change wlan0 to match your wireless interface
So you find your preferred network and attempt to connect. However, there are few pitfalls to avoid...
The release notes for openSUSE 11.1 state that there is no out of the box support for channels 12-14 inclusive. By default, the WLAN channels 12, 13, and 14 are disabled because it is not allowed to use these channels everywhere. If you want to use them in your region, see http://en.opensuse.org/Tracking_down_wireless_problems for more information.
So make sure your router isn't using these channels unless you have manually enabled them as described in the URL above.
I have also found problems with channels 1,2 and 3 on my Netgear DG834PN and with a Thompson Speedtouch from BeThere. I found that connection was near impossible with WPA-PSK enabled and really unreliable without encryption. The signal kept dropping and habitually fell back to 11Kbps.
What I would recommend is to disable all security. Place the laptop physically next to the router and check the reported signal strength. Channels with problems will be reported as less than 100%. For example, I found with my laptop, that channel 1 only reported 70% when the laptop and router were within millimeters of one another.
Once you have a channel that reports 100% try connecting. Only once the connection is working reliably without security should you enable it, for say WPA-PSK.
NDISwrapper is not loaded
You can check whether the NDISwrapper kernel module is loaded by running
lsmod | grep ndiswrapper
If the command return no output, you need to load NDISwrapper. Run
to obtain root permission, and then
After modprobe has run, if you've configured your card in YaST, then you can run
that is the same as (just lesser typing)
to restart your network manager and the card should activate correctly.
Loading NDISwrapper at boot
One method that can work is to edit your network script in /etc/init.d/network.
Add in a line that says
modprobe ndiswrapper before it gets to the actual
networking script so that ndiswrapper is loaded prior to the script running.
Note, this should not be required if you configure your wireless interface with YaST
and enter 'ndiswrapper' in the 'module name' field. This should load the ndiswrapper kernel
module at boot.
Another method is to edit the config file /etc/sysconfig/kernel, by adding
MODULES_LOADED_ON_BOOT section (e.g.:
In some cases (USB wlan?) configuring the wireless interface with YaST, does not load the ndiswrapper module automatically. To get you wlan card to work at boot time, you have to edit your network script in /etc/init.d/network (as described above).
Compiling from source with 1.46 and above
Ndiswrapper 1.46 and above require a 2.6.17 or higher kernel in order to compile properly. Only OpenSUSE version 10.2 and newer ship with 2.6.17+ kernels; users of previous SUSE versions will need to either upgrade their kernel or use a version equal to or older than 1.45. Naturally, users who opt for the precompiled ndiswrapper-kmp-<flavor> packages that ship with the CDs/DVDs can ignore this issue.
Conflicts with NetworkManager
If you are unable to connect to wireless network using NetworkManager, you may be able to connect using ifup to configure the wireless connection (IP address, encryption, authenication, etc) via YaST.
Hardware specific information
If you have Atheros based card it is recommended that you try madwifi first. If you can't get madwifi to work then NDISwrapper will most likely do the job, although you may experience some minor issues. See Atheros madwifi for more information.
For the AR5005G (frequently used in laptops) you will need a more recent of the windows drivers. If you have access to the installation under windows you can copy the drivers from C:\Program Files\Atheros\Driver
You can also try to extract it from the Windows Driver CD or you can download the 32bit Atheros wireless driver here (This is provided as last-resort if you have no other ways to get the driver.) If you are using the 64bit version of openSUSE (x86_64), you will need the driver for 64 bit Windows.