6
* You need a recent kernel (at least 2.6.0 or 2.4.20) with source.
7
* Make sure there is a link to the source from the modules directory:
8
'/lib/modules/<VERSION>/build' should be a link to the kernel
9
source, where <VERSION> is the version of the kernel you are running.
10
* Some vendors ship ndiswrapper in their distributions. Either use
11
it or make sure you remove it before installing ndiswrapper by
17
If you are upgrading from version 0.4 or earlier make sure you delete any
18
old version of loadndisdriver and any configuration in modules.conf and
19
modprobe.conf since the new commands are not compatible with this release.
24
1. Compile and install
25
----------------------
30
This should compile both the kernel module and the userspace utilities.
32
2. Install your windows driver
33
------------------------------
34
Download the Windows XP drivers, unpack it and locate the .inf for your card.
35
Run ndiswrapper -i to install the driver
37
> ndiswrapper -i </path/to/inffile.inf>
39
This copies all necessary files to /etc/ndiswrapper and creates the config
42
After installing you can run
46
to see the status of your installed drivers. If you have installed the correct
47
driver you should see something like this:
49
Installed ndis drivers:
52
Where "present" means that you have a PCI-device present that can be used with the
57
To load the module type
59
> modprobe ndiswrapper.
61
If you get no error the driver should now be loaded. You can verify
62
this by checking system log (produced by 'dmesg'). If the driver is loaded
63
successfully, you should see a message:
65
ndiswrapper version <version> loaded
67
If you have windows drivers installed earlier (with ndiswrapper -i <inffile>)
68
successfully, ndiswrapper module will load them all. You should then see
69
the following messages in system log:
71
ndiswrapper: driver <driver1> added
74
for each of the driver1, .... If you don't these messages, it usually means
75
that there are no (usable) drivers installed in /etc/ndiswrapper directory.
76
Check if /etc/ndiswrapper directory has one sub-directory for each driver
77
and in each driver's directory, there are inf, sys and conf files. Otherwise,
78
you may need to repeat step 2.
80
If the system has a card that works with one of the loaded drivers, you
81
should see the following message in the system log:
83
wlan0: ndiswrapper ethernet device xx:xx:xx:xx:xx:xx
85
4. Configure interface
86
----------------------
87
Use iwconfig to configure wireless network interface. First, locate
88
the wireless interface:
92
This will print the wireless interface (e.g., wlan0). In
93
the examples below wlan0 is used; replace wlan0 with the interface
94
reported by iwconfig above.
96
Set the operating mode of the interface according to your setup. In
97
most cases, it is Managed:
99
> iwconfig wlan0 mode Managed
101
If you use encryption (WEP), set the key:
103
> iwconfig wlan0 key restricted XXXXXXXX
105
You can use 6 hex digits for 40-bit encryption or 10 hex digits for
106
128-bit encryption. You may need to use 'open' security mode instead
107
of 'restricted' depending on the setup of your AP (access point).
109
Set the network name:
111
> iwconfig wlan0 essid ESSID
113
Replace ESSID with the network name used by your AP.
115
Now, setup the network parameters for the interface wlan0. This varies
116
from distribution to distribution. Refer to your distribution's
117
documents on how to do this. Once this is done, you can use network
118
tools to bring up the network; e.g.,
124
Once everything works fine you can write the correct modeprobe settings to
125
load ndiswrapper automatically by running
131
See ndiswrapper wiki (http://ndiswrapper.sourceforge.net/wiki) on how to
132
use WPA with ndiswrapper.
2
http://ndiswrapper.sourceforge.net/wiki/index.php?Installation