Differences between revisions 1 and 51 (spanning 50 versions)
Revision 1 as of 2005-01-11 11:21:45
Size: 361
Editor: anonymous
Comment:
Revision 51 as of 2010-04-20 17:59:42
Size: 9231
Editor: GeoffSimmons
Comment: Add Squeeze module build procedure, load module after NDIS driver installation, drop insert/hotplug section from configuration.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## Auto-converted by kwiki2moinmoin v2005-10-07
["WiFi"]
#language en
||<tablestyle="width: 100%;" style="border: 0px hidden">~-Translation(s): [[fr/NdisWrapper|French]]||<style="text-align: right;border: 0px hidden"> (!) [[/Discussion|Discussion]]||
Line 4: Line 4:
Some vendors do not release specifications of the hardware or provide a linux driver for their wireless network cards. This project provides a linux kernel module that loads and runs Ndis (Windows network driver API) drivers supplied by the vendors. = NDISwrapper =
This page describes how to install NDISwrapper on Debian systems.
<<TableOfContents(3)>>
== Introduction ==
Some vendors do not release hardware specifications and do not provide a Linux driver for their devices.
Line 6: Line 10:
The [[http://ndiswrapper.sourceforge.net/|NDISwrapper]] project provides a Linux kernel module that loads and runs Windows kernel API and NDIS ([[WikiPedia:Network_Driver_Interface_Specification|Network Driver Interface Specification]]) API drivers supplied by the vendors within the Linux kernel. A Windows driver is then linked to this implementation so that the driver runs natively, as though it is in Windows, without binary emulation.
Line 7: Line 12:
See : NDISwrapper uses Windows XP driver files - which may have been supplied with your hardware - to operate your device. This driver wrapper is ''only'' available for use on the x86 and x86-64 architectures (Debian [[i386]] and [[DebianAMD64|AMD64]] ports respectively).
Line 9: Line 14:
 * http://ndiswrapper.sourceforge.net/ While NDISwrapper is intended for use with [[WiFi]] devices, it may alternatively be used for other hardware classes, such as Ethernet adapters or USB-to-serial converters. This page assumes use of a wireless LAN device.

<!> 16-bit PC Card (PCMCIA) devices are not supported. WikiPedia:Cardbus devices are supported.

== Installation Overview ==

 1. Install the NDISwrapper kernel module and supporting applications.

 1. Install the relevant NDIS driver for your device.

 1. Configure the wireless interface.

== Module Installation ==

=== Lenny ===
## Note: m-a will download 'ndiswrapper-source' and install the relevant 'ndiswrapper-utils-*' package (during apt's installation of 'ndiswrapper-modules-*', to fulfil package dependencies). You don't need to explicitly install these packages prior to invoking m-a a-i!
 1. Install the DebianPkg:module-assistant and DebianPkg:wireless-tools packages: {{{
aptitude install module-assistant wireless-tools
}}}
 1. Build and install a ndiswrapper-modules-* package for your system using [[ModuleAssistant]]: {{{
m-a a-i ndiswrapper
}}}
 1. Add {{{ndiswrapper}}} to the list of kernel modules to load at boot time: {{{
echo ndiswrapper >> /etc/modules
}}}

More information on building the NDISwrapper kernel module is described within {{{/usr/share/doc/ndiswrapper-source/README.Debian}}}.

After installation, [[#ndis|install a NDIS driver]] and [[#configure|configure your wireless interface]].

=== Squeeze ===
## nb. APT installs recommended packages by default since Lenny; ndiswrapper-dkms is included as a result.
/* linux-headers-* is currently required to be installed before dkms due to DebianBug:560822. */

 1. Install the relevant linux-headers, [[DebianPkg:ndiswrapper-utils-1.9]] and DebianPkg:wireless-tools packages: {{{
aptitude update
aptitude install linux-headers-2.6-$(uname -r | sed 's,.*-,,') ndiswrapper-utils-1.9 wireless-tools
}}}
 This will also install the recommended DebianPkg:ndiswrapper-dkms package. DKMS will build the NDISwrapper module for your system.

 1. Add {{{ndiswrapper}}} to the list of kernel modules to load at boot time: {{{
echo ndiswrapper >> /etc/modules
}}}

After installation, [[#ndis|install a NDIS driver]] and [[#configure|configure your wireless interface]].

<<Anchor(ndis)>>
== NDIS Driver ==
{i} '''Windows XP''' drivers are required to be used. NDISwrapper does not support [[WikiPedia:Network_Driver_Interface_Specification|NDIS]] 6 (Windows Vista) at this time.

You are required to provide the appropriate driver for your device. The first place you should check is the [[http://ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/id,list/|NDISwrapper compatibility list]] ([[http://burnthesorbonne.com/?page_id=32|archive 1]], [[http://web.archive.org/web/20080113194857/ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/id,list/|archive 2]]). It lists many models of wireless devices that are usable with NDISwrapper and the driver that works best.

If you can't find it there, the [[http://www.linuxant.com/driverloader/drivers.php|Linuxant Windows Driver]] page has many drivers that work with NDISwrapper. It also has drivers for some 64-bit devices that don't offer native 64-bit drivers on the manufacturer's web page.

The final place you should examine is your driver CD or the manufacturer's web page. These often work, but sometimes they're broken or don't offer you full functionality. It's best to go with the ones listed on the NDISwrapper web page.

The driver you find may be packaged as a ZIP (.zip) archive or a self-extractable {{{.zip}}} inside a [[WikiPedia:Portable_Executable|Portable Executable]] (.exe) format. Such self-extractable .exe are ZIP archive encapsulated inside a .exe, you can run the {{{unzip}}} de-archiver (provided by the DebianPkg:unzip package) to extract its contents.

Other .exe files may be !InstallShield installers or other installer formats. These require the use of utilities such as DebianPkg:unshield or DebianPkg:orange to extract the contents within.

If your drivers are within the [[WikiPedia:Cabinet_(file_format)|cabinet file format]] (.cab), install DebianPkg:cabextract and run {{{cabextract}}} on a file of interest, typically named {{{data2.cab}}}.

=== Installation ===
<!> The following procedure is specific to the "Dell Wireless Card 1390" (man: 14e4, dev: 4311) device and is provided as an '''example only'''. Consult the [[http://ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/id,list/|NDISwrapper compatibility list]] ([[http://burnthesorbonne.com/?page_id=32|archive 1]], [[http://web.archive.org/web/20080113194857/ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/id,list/|archive 2]]) for information on your specific device.

 1. Install the DebianPkg:unzip package: {{{
aptitude install unzip
}}}
 1. Acquire an archive containing the NDIS driver from Dell's FTP site: {{{
wget http://ftp.us.dell.com/network/R151517.EXE
}}}
 1. Extract its contents: {{{
unzip -a R151517.EXE
}}}
 1. Install the NDIS driver: {{{
ndiswrapper -i DRIVER/bcmwl5.inf
}}}
 1. To verify NDIS driver installation, list the currently installed drivers: {{{
ndiswrapper -l
}}} You should receive the following output: {{{
bcmwl5 : driver installed
        device (14E4:4311) present
}}}

Refer to the NDISwrapper manual page for more information: [[DebianMan:8/ndiswrapper-1.9|ndiswrapper-1.9(8)]]

You can alternatively use DebianPkg:ndisgtk to install drivers to the system.

=== Uninstallation ===
To remove a previously installed NDIS driver from your system: {{{
ndiswrapper -e <driver>
}}}
For example: {{{
ndiswrapper -e bcmwl5
}}}

You can alternatively use DebianPkg:ndisgtk to uninstall drivers from the system.

<<Anchor(configure)>>
== Configuration ==

 1. Insert the NDISwrapper module into the kernel: {{{
modprobe ndiswrapper
}}}
 1. Verify your device has an available interface: {{{
iwconfig
}}}
 1. Raise the interface to activate the radio, for example: {{{
ifconfig wlan0 up
}}}
 1. [[WiFi/HowToUse|Configure]] your wireless interface as appropriate.

== Other Notes ==

NDISwrapper only supports managed and ad-hoc device operating modes.<<FootNote([[http://web.archive.org/web/20071230045909/http://ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/id,faq/#is_master_mode_or_promiscuous_mode_supported|"Is master mode or promiscuous mode supported?" - NDISwrapper FAQ]])>>

== See Also ==
 * DebianPkg:ndisgtk - A graphical frontend for ndiswrapper (available since Lenny).
 * DebianPkg:cabextract - a program to extract Microsoft Cabinet files
 * DebianPkg:orange - extracts CAB files from self-extracting installers
 * DebianPkg:unshield - extracts CAB files from !InstallShield installers
 * [[WiFi/HowToUse|How to use a WiFi interface]]

== External Links ==
 * [[http://ndiswrapper.sourceforge.net/|NDISwrapper homepage]];
  * [[http://ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/|Wiki]] ([[http://web.archive.org/web/20080113194857/ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/|Internet Archive]])
   * [[http://ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/id,list/|NDISwrapper compatibility list]] ([[http://burnthesorbonne.com/?page_id=32|Burn the Sorbonne archive]], [[http://web.archive.org/web/20080113194857/ndiswrapper.sourceforge.net/joomla/index.php?/component/option,com_openwiki/Itemid,33/id,list/|Internet Archive]])
 * NDISwrapper manual pages: [[DebianMan:8/ndiswrapper-1.9|ndiswrapper-1.9(8)]]
 * [[irc://irc.freenode.net/%23ndiswrapper|#ndiswrapper]] - [[IRC]] channel

----
## This page is referenced from http://www.debian.org/doc/FAQ/ch-software.html
CategoryHardware | CategoryWireless | CategoryPermalink

Translation(s): French

(!) ?Discussion


NDISwrapper

This page describes how to install NDISwrapper on Debian systems.

Introduction

Some vendors do not release hardware specifications and do not provide a Linux driver for their devices.

The NDISwrapper project provides a Linux kernel module that loads and runs Windows kernel API and NDIS (Network Driver Interface Specification) API drivers supplied by the vendors within the Linux kernel. A Windows driver is then linked to this implementation so that the driver runs natively, as though it is in Windows, without binary emulation.

NDISwrapper uses Windows XP driver files - which may have been supplied with your hardware - to operate your device. This driver wrapper is only available for use on the x86 and x86-64 architectures (Debian i386 and AMD64 ports respectively).

While NDISwrapper is intended for use with WiFi devices, it may alternatively be used for other hardware classes, such as Ethernet adapters or USB-to-serial converters. This page assumes use of a wireless LAN device.

<!> 16-bit PC Card (PCMCIA) devices are not supported. Cardbus devices are supported.

Installation Overview

  1. Install the NDISwrapper kernel module and supporting applications.
  2. Install the relevant NDIS driver for your device.
  3. Configure the wireless interface.

Module Installation

Lenny

  1. Install the module-assistant and wireless-tools packages:

    aptitude install module-assistant wireless-tools
  2. Build and install a ndiswrapper-modules-* package for your system using ModuleAssistant:

    m-a a-i ndiswrapper
  3. Add ndiswrapper to the list of kernel modules to load at boot time:

    echo ndiswrapper >> /etc/modules

More information on building the NDISwrapper kernel module is described within /usr/share/doc/ndiswrapper-source/README.Debian.

After installation, install a NDIS driver and configure your wireless interface.

Squeeze

  1. Install the relevant linux-headers, ndiswrapper-utils-1.9 and wireless-tools packages:

    aptitude update
    aptitude install linux-headers-2.6-$(uname -r | sed 's,.*-,,') ndiswrapper-utils-1.9 wireless-tools

    This will also install the recommended ndiswrapper-dkms package. DKMS will build the NDISwrapper module for your system.

  2. Add ndiswrapper to the list of kernel modules to load at boot time:

    echo ndiswrapper >> /etc/modules

After installation, install a NDIS driver and configure your wireless interface.

NDIS Driver

{i} Windows XP drivers are required to be used. NDISwrapper does not support NDIS 6 (Windows Vista) at this time.

You are required to provide the appropriate driver for your device. The first place you should check is the NDISwrapper compatibility list (archive 1, archive 2). It lists many models of wireless devices that are usable with NDISwrapper and the driver that works best.

If you can't find it there, the Linuxant Windows Driver page has many drivers that work with NDISwrapper. It also has drivers for some 64-bit devices that don't offer native 64-bit drivers on the manufacturer's web page.

The final place you should examine is your driver CD or the manufacturer's web page. These often work, but sometimes they're broken or don't offer you full functionality. It's best to go with the ones listed on the NDISwrapper web page.

The driver you find may be packaged as a ZIP (.zip) archive or a self-extractable .zip inside a Portable Executable (.exe) format. Such self-extractable .exe are ZIP archive encapsulated inside a .exe, you can run the unzip de-archiver (provided by the unzip package) to extract its contents.

Other .exe files may be InstallShield installers or other installer formats. These require the use of utilities such as unshield or orange to extract the contents within.

If your drivers are within the cabinet file format (.cab), install cabextract and run cabextract on a file of interest, typically named data2.cab.

Installation

<!> The following procedure is specific to the "Dell Wireless Card 1390" (man: 14e4, dev: 4311) device and is provided as an example only. Consult the NDISwrapper compatibility list (archive 1, archive 2) for information on your specific device.

  1. Install the unzip package:

    aptitude install unzip
  2. Acquire an archive containing the NDIS driver from Dell's FTP site:

    wget http://ftp.us.dell.com/network/R151517.EXE
  3. Extract its contents:

    unzip -a R151517.EXE
  4. Install the NDIS driver:

    ndiswrapper -i DRIVER/bcmwl5.inf
  5. To verify NDIS driver installation, list the currently installed drivers:

    ndiswrapper -l

    You should receive the following output:

    bcmwl5 : driver installed
            device (14E4:4311) present

Refer to the NDISwrapper manual page for more information: ndiswrapper-1.9(8)

You can alternatively use ndisgtk to install drivers to the system.

Uninstallation

To remove a previously installed NDIS driver from your system:

ndiswrapper -e <driver>

For example:

ndiswrapper -e bcmwl5

You can alternatively use ndisgtk to uninstall drivers from the system.

Configuration

  1. Insert the NDISwrapper module into the kernel:

    modprobe ndiswrapper
  2. Verify your device has an available interface:

    iwconfig
  3. Raise the interface to activate the radio, for example:

    ifconfig wlan0 up
  4. Configure your wireless interface as appropriate.

Other Notes

NDISwrapper only supports managed and ad-hoc device operating modes.1

See Also


CategoryHardware | CategoryWireless | CategoryPermalink