Differences between revisions 1 and 37 (spanning 36 versions)
Revision 1 as of 2009-01-04 13:31:41
Size: 6235
Editor: GeoffSimmons
Comment: Initial revision.
Revision 37 as of 2013-05-05 05:35:09
Size: 6627
Editor: GeoffSimmons
Comment: Update supported devices.
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from rtl-wifi
Line 2: Line 3:
||<tablestyle="width: 100%;" style="border: 0px hidden">~-[:DebianWiki/EditorGuide#translation:Translation(s)]: none-~||<style="text-align: right;border: 0px hidden"> (!) [:/Discussion:Discussion]|| ~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[fr/rtl818x|Français]] -~
Line 4: Line 5:
= Realtek wireless devices =
This page describes how to enable support for !WiFi devices based on Realtek chipsets on Debian systems.
= Realtek RTL8180L, RTL8185L, RTL8187L, RTL8187B, RTL8187SE devices =
Line 7: Line 7:
[[TableOfContents(2)]] This page describes how to enable support for !WiFi devices based on Realtek 802.11a/bg chipsets on Debian systems.

<<TableOfContents(2)>>
Line 11: Line 13:
rtl-wifi is a project to develop drivers for Realtek wireless LAN chipsets, a fork of the rtl8180-sa2400 project. These drivers were introduced into the mainline Linux kernel at various stages. rtl8180, rtl8187, rtl8187se are drivers for Realtek 802.11b and 802.11a/bg wireless LAN chipsets, included in the mainline Linux kernel.
Line 13: Line 15:
The driver modules are: The produced kernel modules are:
Line 15: Line 17:
 * rtl8180 (PCI devices)
  * Support for RTL8180 chipsets was introduced in kernel 2.6.25.
  * Support for RTL8185 chipsets was introduced in kernel 2.6.25.
 * rtl8187 (USB devices)
  * Support for RTL8187 chipsets was introduced in kernel 2.6.23.
  * Support for some RTL8187B chipsets was introduced in kernel 2.6.27.
 * rtl8180 ([[#supported-rtl8180|supported devices]])
  * Supports PCI devices based on the RTL8180L and RTL8185L chipsets.
  * Introduced in Linux 2.6.25,<<FootNote([[http://git.kernel.org/linus/f653211197f3841f383fa9757ef8ce182c6cf627|"Add rtl8180 wireless driver" - git.kernel.org - linux/kernel/git/torvalds/linux-2.6.git/commitdiff]])>> enabled at [[DebianPts:linux-2.6]] [[http://packages.debian.org/changelogs/pool/main/l/linux-2.6/current/changelog#version2.6.25-1|2.6.25-1]].
 * rtl8187 ([[#supported-rtl8187|supported devices]])
  * Supports USB devices based on the RTL8187L and RTL8187B chipsets.
  * Introduced in Linux 2.6.23,<<FootNote([[http://git.kernel.org/linus/605bebe23bf6ac66c0a717e663a7baa2f981294d|"[PATCH] Add rtl8187 wireless driver" - git.kernel.org - linux/kernel/git/torvalds/linux-2.6.git/commitdiff]])>> enabled at linux-2.6 [[http://packages.debian.org/changelogs/pool/main/l/linux-2.6/current/changelog#version2.6.23-1|2.6.23-1]].
  * RTL8187B-based devices are supported since Linux 2.6.27.
 * r8187se ([[#supported-r8187se|supported devices]])
  * Supports PCIe devices based on the RTL8187SE chipset.
  * Introduced in Linux 2.6.29,<<FootNote([[http://git.kernel.org/linus/c8d86be38785705aca77e33933298c320a1bf2a5|"Staging: add rtl8187se driver" - git.kernel.org - linux/kernel/git/torvalds/linux-2.6.git/commitdiff]])>> enabled at linux-2.6 [[http://packages.debian.org/changelogs/pool/main/l/linux-2.6/current/changelog#version2.6.29-1|2.6.29-1]].
  * Module renamed to r8187se at Linux 2.6.33.<<FootNote([[http://git.kernel.org/linus/ad988ba5c024ef5c96eed0387ff37e63b8c9f7e0|"Staging: rtl8187se: Rename staging driver to avoid name conflict with mainline driver" - git.kernel.org - linux/kernel/git/torvalds/linux-2.6.git/commitdiff]])>>
Line 22: Line 29:
The RTL8187SE chipset is not supported by the project at this time. An experimental [#rtl8187se vendor driver] is available. For all drivers, no firmware from userspace is required for device operation.

<!> rtl8187se is a staging driver and only available for the x86 and x86-64 architectures (Debian [[i386]] and [[DebianAMD64|AMD64]] ports respectively) at this time.

{i} Realtek 802.11n devices are supported by [[rtl819x|different drivers]].
Line 26: Line 37:
<!> [:DebianEtch:Etch] users:
 * For RTL8187 chipset support, install an [:EtchAndAHalf:] kernel: {{{apt-cache search linux-image-2.6.24-etchnhalf}}} and install a package appropriate for your system. Restart your system with this kernel before continuing.
 * For RTL8180 and RTL8185 chipset support, install a 2.6.26 kernel from [:Backports:Debian Backports]. Once your sources are configured: {{{apt-cache search linux-image-2.6.26}}} and install a package appropriate for your system. Restart your system with this kernel before continuing.
 1. Connect the device to your system. The necessary kernel module is [[Modules|automatically loaded]] for supported devices.
 1. [[WiFi/HowToUse|Configure]] your wireless interface as appropriate.
Line 30: Line 40:
<!> [:DebianTesting:Testing] and [:DebianUnstable:unstable] users:
 * For RTL8187B chipset support, install a 2.6.27 (or later) [wiki:Self:DebianKernel#snapshots Debian Kernel snapshot]. Restart your system with this kernel before continuing.
----
 1. Install the DebPkg:wireless-tools package: {{{
$ su
# aptitude update
# aptitude install wireless-tools
}}}
 1. If your device uses USB, physically connect it to your system.
 1. The necessary kernel module should be [:Modules:automatically loaded]. If necessary, it can be manually loaded via either: {{{
# modprobe rtl8180
}}} ''or'' {{{
# modprobe rtl8187
}}}
 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.
<<Anchor(supported)>>
== Supported Devices ==
## DO NOT REMOVE : these paragraphs are required for search-engines !
Line 52: Line 44:
[[Anchor(rtl8187se)]]
== RTL8187SE ==
<<Anchor(supported-rtl8180)>>
=== rtl8180 ===
The page [[HowToIdentifyADevice/PCI]] explains how to identify a PCI device.
Line 55: Line 48:
The Realtek RTL8187SE is an IEEE 802.11b/g single-chip wireless LAN integrated circuit, with a PCI Express interface. This can be found in the [:DebianEeePC/Model/701SD:Asus EeePC 701SD]. The following list is based on the ''alias'' fields of {{{modinfo rtl8180}}} in Debian 3.2.0 (3.2.41-2) kernel images.
## list generated with: http://www.klabs.be/~fpiat/linux/hardware/modinfo-devnames/
##TAG:LIST_1_START
 ~- {{{
PCI: 10EC:8180 Realtek Semiconductor Co., Ltd. RTL8180L 802.11b MAC
PCI: 10EC:8185 Realtek Semiconductor Co., Ltd. RTL-8185 IEEE 802.11a/b/g Wireless LAN Controller
PCI: 1186:3300 D-Link System Inc DWL-510 / DWL-610 802.11b [Realtek RTL8180L]
PCI: 1799:6001 Belkin F5D6001 Wireless PCI Card [Realtek RTL8180]
PCI: 1799:6020 Belkin F5D6020 v3000 Wireless PCMCIA Card [Realtek RTL8180]
PCI: 1799:700F Belkin F5D7000 v7000 Wireless G Desktop Card [Realtek RTL8185]
PCI: 1799:701F Belkin F5D7010 v7000 Wireless G Notebook Card [Realtek RTL8185]
}}} -~
##TAG:LIST_1_END
Line 57: Line 62:
A driver from Realtek is available for initial device support on Linux systems.
 . {X} The vendor driver is '''experimental'''. Expect stability, performance and/or latency issues.
<<Anchor(supported-rtl8187)>>
=== rtl8187 ===
The page [[HowToIdentifyADevice/USB]] explains how to identify a USB device.
Line 60: Line 66:
=== Installation === The following list is based on the ''alias'' fields of {{{modinfo rtl8187}}} in Debian 3.2.0 (3.2.41-2) kernel images.
## list generated with: http://www.klabs.be/~fpiat/linux/hardware/modinfo-devnames/
##TAG:LIST_2_START
 ~- {{{
USB: 03F0:CA02 Hewlett-Packard (Device name unknown)
USB: 050D:705E Belkin Components F5D7050 Wireless G Adapter v5000 [Realtek RTL8187B]
USB: 0769:11F2 Surecom Technology Corp. EP-9001-g 802.11g 54M WLAN Adapter
USB: 0789:010C Logitec Corp. Realtek RTL8187 Wireless 802.11g 54Mbps Network Adapter
USB: 0846:4260 NetGear, Inc. WG111v3 54 Mbps Wireless [realtek RTL8187B]
USB: 0846:6100 NetGear, Inc. (Device name unknown)
USB: 0846:6A00 NetGear, Inc. WG111v2 54 Mbps Wireless [RealTek RTL8187L]
USB: 0B05:171D ASUSTek Computer, Inc. (Device name unknown)
USB: 0BDA:8187 Realtek Semiconductor Corp. RTL8187 Wireless Adapter
USB: 0BDA:8189 Realtek Semiconductor Corp. RTL8187B Wireless 802.11g 54Mbps Network Adapter
USB: 0BDA:8197 Realtek Semiconductor Corp. RTL8187B Wireless Adapter
USB: 0BDA:8198 Realtek Semiconductor Corp. RTL8187B Wireless Adapter
USB: 0DF6:000D Sitecom Europe B.V. WL-168 Wireless Network Adapter 54g
USB: 0DF6:0028 Sitecom Europe B.V. (Device name unknown)
USB: 0DF6:0029 Sitecom Europe B.V. (Device name unknown)
USB: 114B:0150 Sphairon Access Systems GmbH Turbolink UB801RE Wireless 802.11g 54Mbps Network Adapter [RTL8187]
USB: 1371:9401 CNet Technology Inc. CWD-854 Wireless 802.11g 54Mbps Network Adapter [RTL8187]
USB: 13D1:ABE6 A-Max Technology Macao Commercial Offshore Co. Ltd. Wireless 802.11g 54Mbps Network Adapter [RTL8187]
USB: 1737:0073 Linksys WUSB54GC v2 802.11g Adapter [Realtek RTL8187B]
USB: 18E8:6232 Qcom Wireless 802.11g 54Mbps Network Adapter [RTL8187]
USB: 1B75:8187 Ovislink Corp. AirLive WL-1600USB 802.11g Adapter [Realtek RTL8187L]
}}} -~
##TAG:LIST_2_END
Line 62: Line 94:
==== Debian Packages ==== <<Anchor(supported-r8187se)>>
=== r8187se ===
The page [[HowToIdentifyADevice/PCI]] explains how to identify a PCI device.
Line 64: Line 98:
Packages of vendor driver revision 1016.0716.2008 have been prepared by Martin Filtenborg[[FootNote([http://www.martinfiltenborg.dk/debian/debian.html#hw])]]. The following list is based on the ''alias'' fields of {{{modinfo rtl8187se}}} in Debian 3.2.0 (3.2.41-2) kernel images.
## list generated with: http://www.klabs.be/~fpiat/linux/hardware/modinfo-devnames/
##TAG:LIST_3_START
 ~- {{{
PCI: 10EC:8199 Realtek Semiconductor Co., Ltd. RTL8187SE Wireless LAN Controller
}}} -~
##TAG:LIST_3_END
Line 66: Line 106:
===== Pre-Built Module =====

Only available for [:DebianTesting:testing] users on the i386 architecture.
## depmod isn't currently called during package postinst
 1. Install the DebPkg:wireless-tools package: {{{
$ su
# aptitude update
# aptitude install wireless-tools
# exit
}}}
 1. Acquire and install the rtl8187se-modules package: {{{
$ wget http://www.martinfiltenborg.dk/debian/rtl8187se-modules-2.6.26-1-686_1016.0716.2008+2.6.26-10_i386.deb
# su
# dpkg -i ./rtl8187se-modules-2.6.26-1-686_1016.0716.2008+2.6.26-10_i386.deb
# depmod -a
}}}
 1. Continue to [#rtl8187se_configure configuration].

===== Module Assistant =====

## depmod isn't currently called during package postinst
 1. Install the DebPkg:bzip2, DebPkg:debhelper, DebPkg:module-assistant and DebPkg:wireless-tools packages: {{{
$ su
# aptitude update
# aptitude install bzip2 debhelper module-assistant wireless-tools
# exit
}}}
 1. Acquire and install the rtl8187se-source package: {{{
$ wget http://www.martinfiltenborg.dk/debian/rtl8187se-source_1016.0716.2008_all.deb
$ su
# dpkg -i ./rtl8187se-source_1016.0716.2008_all.deb
}}}
 1. Build and install a rtl8187se-* modules package within your system: {{{
# m-a prepare
# m-a a-i rtl8187se
# depmod -a
}}}
 1. Continue to [#rtl8187se_configure configuration].

==== From Source ====
## Comment or remove this section when Martin Filtenborg (or other third-party) has the latest upstream version packaged
The latest revision of this driver (1023.1118.2008) requires to be compiled from source.
## depmod is called in rtl8185 and ieee80211 Makefiles
 1. Install the DebPkg:build-essential, relevant linux-headers and and DebPkg:wireless-tools packages: {{{
$ su
# aptitude update
# aptitude install build-essential linux-headers-$(uname -r) wireless-tools
# exit
}}}
 1. Acquire the vendor driver: {{{
$ wget http://launchpadlibrarian.net/20052864/rtl8187se_linux_26.1023.1118.2008.tar.gz
}}}
 1. Extract the tarball's contents: {{{
$ tar xvf rtl8187se_linux_26.1023.1118.2008.tar.gz
}}}
 1. Compile and install the driver: {{{
$ cd rtl8187se_linux_26.1023.1118.2008
$ make
$ su
# make install
}}}
 1. Continue to [#rtl8187se_configure configuration].

[[Anchor(rtl8187se_configure)]]
=== Configuration ===
 1. Load the r8180 module: {{{
# modprobe r8180
}}}
 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.
== See Also ==
 * [[WiFi/HowToUse|How to use a WiFi interface]]
Line 143: Line 110:
 * http://wireless.kernel.org/en/users/Drivers/rtl8187
Line 144: Line 112:
 * http://rtl-wifi.sf.net/ - project homepage
 * http://wireless.kernel.org/en/users/Drivers/rtl8187 - driver page on Linux Wireless
 * http://rtl8180-sa2400.sf.net/ - old project homepage
 * http://launchpadlibrarian.net/20052864/rtl8187se_linux_26.1023.1118.2008.tar.gz - RTL8187SE vendor driver

== See Also ==

 * ["DebianEeePC/Model/701SD"] - additional RTL8187SE information
 * [:WiFi/HowToUse:HowToUse] !WiFi adapter
Line 154: Line 113:
CategoryHardware CategoryHardware | CategoryWireless

Translation(s): English - Français


Realtek RTL8180L, RTL8185L, RTL8187L, RTL8187B, RTL8187SE devices

This page describes how to enable support for WiFi devices based on Realtek 802.11a/bg chipsets on Debian systems.

Drivers

rtl8180, rtl8187, rtl8187se are drivers for Realtek 802.11b and 802.11a/bg wireless LAN chipsets, included in the mainline Linux kernel.

The produced kernel modules are:

  • rtl8180 (supported devices)

    • Supports PCI devices based on the RTL8180L and RTL8185L chipsets.
    • Introduced in Linux 2.6.25,1 enabled at linux-2.6 2.6.25-1.

  • rtl8187 (supported devices)

    • Supports USB devices based on the RTL8187L and RTL8187B chipsets.
    • Introduced in Linux 2.6.23,2 enabled at linux-2.6 2.6.23-1.

    • RTL8187B-based devices are supported since Linux 2.6.27.
  • r8187se (supported devices)

    • Supports PCIe devices based on the RTL8187SE chipset.
    • Introduced in Linux 2.6.29,3 enabled at linux-2.6 2.6.29-1.

    • Module renamed to r8187se at Linux 2.6.33.4

For all drivers, no firmware from userspace is required for device operation.

<!> rtl8187se is a staging driver and only available for the x86 and x86-64 architectures (Debian i386 and AMD64 ports respectively) at this time.

{i} Realtek 802.11n devices are supported by different drivers.

Installation

  1. Connect the device to your system. The necessary kernel module is automatically loaded for supported devices.

  2. Configure your wireless interface as appropriate.

Supported Devices

rtl8180

The page HowToIdentifyADevice/PCI explains how to identify a PCI device.

The following list is based on the alias fields of modinfo rtl8180 in Debian 3.2.0 (3.2.41-2) kernel images.

  • PCI: 10EC:8180 Realtek Semiconductor Co., Ltd. RTL8180L 802.11b MAC
    PCI: 10EC:8185 Realtek Semiconductor Co., Ltd. RTL-8185 IEEE 802.11a/b/g Wireless LAN Controller
    PCI: 1186:3300 D-Link System Inc DWL-510 / DWL-610 802.11b [Realtek RTL8180L]
    PCI: 1799:6001 Belkin F5D6001 Wireless PCI Card [Realtek RTL8180]
    PCI: 1799:6020 Belkin F5D6020 v3000 Wireless PCMCIA Card [Realtek RTL8180]
    PCI: 1799:700F Belkin F5D7000 v7000 Wireless G Desktop Card [Realtek RTL8185]
    PCI: 1799:701F Belkin F5D7010 v7000 Wireless G Notebook Card [Realtek RTL8185]

rtl8187

The page HowToIdentifyADevice/USB explains how to identify a USB device.

The following list is based on the alias fields of modinfo rtl8187 in Debian 3.2.0 (3.2.41-2) kernel images.

  • USB: 03F0:CA02 Hewlett-Packard (Device name unknown)
    USB: 050D:705E Belkin Components F5D7050 Wireless G Adapter v5000 [Realtek RTL8187B]
    USB: 0769:11F2 Surecom Technology Corp. EP-9001-g 802.11g 54M WLAN Adapter
    USB: 0789:010C Logitec Corp. Realtek RTL8187 Wireless 802.11g 54Mbps Network Adapter
    USB: 0846:4260 NetGear, Inc. WG111v3 54 Mbps Wireless [realtek RTL8187B]
    USB: 0846:6100 NetGear, Inc. (Device name unknown)
    USB: 0846:6A00 NetGear, Inc. WG111v2 54 Mbps Wireless [RealTek RTL8187L]
    USB: 0B05:171D ASUSTek Computer, Inc. (Device name unknown)
    USB: 0BDA:8187 Realtek Semiconductor Corp. RTL8187 Wireless Adapter
    USB: 0BDA:8189 Realtek Semiconductor Corp. RTL8187B Wireless 802.11g 54Mbps Network Adapter
    USB: 0BDA:8197 Realtek Semiconductor Corp. RTL8187B Wireless Adapter
    USB: 0BDA:8198 Realtek Semiconductor Corp. RTL8187B Wireless Adapter
    USB: 0DF6:000D Sitecom Europe B.V. WL-168 Wireless Network Adapter 54g
    USB: 0DF6:0028 Sitecom Europe B.V. (Device name unknown)
    USB: 0DF6:0029 Sitecom Europe B.V. (Device name unknown)
    USB: 114B:0150 Sphairon Access Systems GmbH Turbolink UB801RE Wireless 802.11g 54Mbps Network Adapter [RTL8187]
    USB: 1371:9401 CNet Technology Inc. CWD-854 Wireless 802.11g 54Mbps Network Adapter [RTL8187]
    USB: 13D1:ABE6 A-Max Technology Macao Commercial Offshore Co. Ltd. Wireless 802.11g 54Mbps Network Adapter [RTL8187]
    USB: 1737:0073 Linksys WUSB54GC v2 802.11g Adapter [Realtek RTL8187B]
    USB: 18E8:6232 Qcom Wireless 802.11g 54Mbps Network Adapter [RTL8187]
    USB: 1B75:8187 Ovislink Corp. AirLive WL-1600USB 802.11g Adapter [Realtek RTL8187L]

r8187se

The page HowToIdentifyADevice/PCI explains how to identify a PCI device.

The following list is based on the alias fields of modinfo rtl8187se in Debian 3.2.0 (3.2.41-2) kernel images.

  • PCI: 10EC:8199 Realtek Semiconductor Co., Ltd. RTL8187SE Wireless LAN Controller

See Also


CategoryHardware | CategoryWireless