lwfinger / rtl8188eu

Repository for stand-alone RTL8188EU driver.
Other
1.69k stars 599 forks source link

IMPORTANT - PLEASE READ:

Beginning on November 4, 2019, I will NO LONGER support people that have downloaded the source as a zip file. Using git has much more flexibility. In addition, there is much less likelihood that a user will contact me with a problem that is ALREADY fixed.

If your system says that /lib/modules/...../build does not exist, you have not installed the kernel headers, you have done it incorrectly, or you are not running the kernel for which the headers have been installed. The necessary steps are dependent on which distro you are using. Creating a new issue and asking at GitHub will not be productive.

Your kernel configuration MUST have CONFIG_WIRELESS_EXT set.

Unsolicited E-mail sent to my private address will be ignored!!

If a build fails that previously worked, perform a 'git pull' and retry before reporting a problem. As noted, if you had downloaded the source in zip form, then you would need to get an entirely new source file. That is why using git, which downloads only the changed lines, is required.

rtl8188eu

Repository for the stand-alone RTL8188EU driver.

Compiling & Building

Dependencies

To compile the driver, you need to have make and a compiler installed. In addition, you must have the kernel headers installed. If you do not understand what this means, consult your distro.

Compiling

make all

Installing

sudo make install

Submitting Issues

Frequently asked Questions

The network manager says: "Device is not ready"!

Make sure you copied the firmware (rtl8188eufw.bin) to /lib/firmware/rtlwifi/

NetworkManager does not list SSID

NetworkManager changes the Wi-Fi MAC address during scanning to improve privacy but this adapter does not support it. To address this issue, please create /etc/NetworkManager/conf.d/80-wifi.conf with content:

[device]
wifi.scan-rand-mac-address=no

and run systemctl restart NetworkManager