Difference between revisions of "Rtl8187 wireless"

From ArchWiki
Jump to: navigation, search
(contained only general information, the driver itself "should just work" or the general informations are enough)
(43 intermediate revisions by 15 users not shown)
Line 1: Line 1:
[[Category:Communication and network (English)]]
+
#REDIRECT [[Wireless Setup]]
[[Category:HOWTOs (English)]]
+
This page describes how to get the '''rtl8187''' wifi-driver working
+
 
+
Note: The rtl8187 driver is included in vanilla 2.6.23!
+
 
+
 
+
The rtl8187 chip is made for usb-cards/dongles
+
 
+
It supports 802.11(a)/b/g and the following encryptions:  WEP and WPA -
+
At the time of this writing, I don't know if WPA2 is supported or not.
+
 
+
The driver's source is released under the GPL
+
 
+
= Installing the driver =
+
 
+
If you are on 2.6.23 you have to enable CONFIG_RTL8187 in your kernel-config
+
 
+
If you are using anything lower than 2.6.23 you can choose between the following methods
+
 
+
== Compiling the module from the source-code ==
+
 
+
No HOWTO yet
+
 
+
== Patch your 2.6.22 kernel ==
+
 
+
Note: if you are already running 2.6.23 or later this is not necessary anymore - just enable the Realtek 8187 USB support in your kernel-config
+
 
+
At first you have to get the kernel-sources
+
After that you'll need to download two patches: one for the rtl8187 driver and one for EEPROM_93CX6 (rtl8187 requires EEPROM_93CX6-support)
+
 
+
Save the following link as EEPROM_93CX6.patch (download it to your harddisk with wget -O EEPROM_93CX6.patch $URL):
+
 
+
[http://git.kernel.org/?p=linux%2Fkernel%2Fgit%2Ftorvalds%2Flinux-2.6.git;a=commitdiff_plain;h=9467d64b0e88763914c01f71ddf591b166c4f526;hp=7dcca30a32aadb0520417521b0c44f42d09fe05c  EEPROM_93CX6.patch]
+
 
+
Then save the following link as rtl8187.patch (download it to your harddisk with wget -O rtl8187.patch $URL):
+
 
+
[http://git.kernel.org/?p=linux%2Fkernel%2Fgit%2Ftorvalds%2Flinux-2.6.git;a=commitdiff_plain;h=605bebe23bf6ac66c0a717e663a7baa2f981294d;hp=4b914dc0493edff19ff698a18198a173a14ba9d2 rtl8187.patch]
+
 
+
Now extract your kernel sources, cd into the kernel-source directory
+
and run
+
patch -Np1 -i $path/to/EEPROM_93CX6.patch
+
patch -Np1 -i $path/to/rtl8187.patch
+
 
+
make menuconfig
+
Now activate: <pre> Device Drivers  ---> Misc devices  ---> EEPROM 93CX6 support </pre> (I compiled it directly into the kernel with [*])
+
 
+
Then go to: <pre> Device Drivers  ---> Network device support  ---> Wireless LAN  ---> Wireless LAN (IEEE 802.11) -> Realtek 8187 USB support </pre>
+
(I compiled this as module [m])
+
 
+
What if you can't find "Realtek 8187 USB support" in the kernel config menu?
+
Don't panic - make sure you activated EEPROM 93CX6 support <pre> Device Drivers  ---> Misc devices  ---> EEPROM 93CX6 support </pre> and the Generic IEEE 802.11 Networking Stack (mac80211) <pre> Networking  ---> Wireless  ---> Generic IEEE 802.11 Networking Stack (mac80211) </pre>
+
 
+
 
+
Now you can save your kernel-config and start compiling
+
After a reboot the module rtl8187 should be available.
+
You can load it like this:
+
modprobe rtl8187
+
You can also add rtl8187 to the MODULES-section in your rc.conf
+
 
+
If you want to add rtl8187 support 'The Arch-Way' make sure to add "patch -Np1 -i ../foo.bar" to your kernel-PKGBUILD
+
 
+
=Using and testing the driver/Troubleshooting=
+
 
+
Make sure that you have loaded the rtl8187 module with
+
modprobe rtl8187
+
Then run
+
dmesg | grep rtl8187
+
You should see some output like this <pre> usbcore: registered new interface driver rtl8187 </pre>
+
If you see that line everything should be OK
+
 
+
== Using the driver ==
+
 
+
If everything is right, you should have two new interfaces: wlan0 and wmaster0
+
If you don't see wlan0 just run
+
ifconfig wlan0 up
+
 
+
To list all available wifi-networks just run
+
iwlist wlan0 scan
+
 
+
For more information about configuring your wifi-network see here: [http://wiki.archlinux.org/index.php/Wireless_Setup#Setup_and_Boot http://wiki.archlinux.org/index.php/Wireless_Setup#Setup_and_Boot]
+
 
+
== What to do if you connection always times out? ==
+
 
+
The solution can be found in this thread: http://bbs.archlinux.org/viewtopic.php?pid=299642
+
 
+
Just set the rate to 5.5
+
iwconfig wlan0 rate 5.5M auto
+
 
+
=Misc Links=
+
*[http://rtl-wifi.sourceforge.net/ Project-page of the rtl-wifi driver project]
+

Revision as of 22:30, 3 August 2013

Redirect to: