Skip to content

Instantly share code, notes, and snippets.

@darth-veitcher

darth-veitcher/rtl8188eus-on-raspi.md

Last active September 8, 2023 17:14
Show Gist options
  • Save darth-veitcher/1ec92074e268a16d51cb6fdb2a10b8ad to your computer and use it in GitHub Desktop.
Save darth-veitcher/1ec92074e268a16d51cb6fdb2a10b8ad to your computer and use it in GitHub Desktop.
Download ZIP
Installing a TP-Link TL-WN725N Wireless Adapter on a RaspberryPi
Raw
rtl8188eus-on-raspi.md

This was a proper pain... Turns out there's a whole host of issues with the rtl8188eus driver.

Steps to fix (on Debian / RaspberryPi OS).

1. Install build tools

sudo apt install -y \
  build-essential \
  git \
  linux-headers \
  dkms
  • dkms is a framework that allows kernel modules to be dynamically built and loaded.
  • build-essential contains a list of packages which are considered essential for building Ubuntu packages including gcc compiler, make and other required tools.
  • git is a version control system which we'll use to copy the code required to build the drivers from a remote location.
  • linux-headers is needed so that we have access to the definitions of the interfaces for the linux kernel. See here

2. Blacklist other versions of the driver

Blacklist and reboot.

echo 'blacklist r8188eu'|sudo tee -a '/etc/modprobe.d/realtek.conf'
sudo shutdown -r now

3. Clone the aircrack-ng version of the drivers

At time of writing this fork was actually the most uip to date but I'd expect that get's fixed shortly.

git clone https://github.com/gglluukk/rtl8188eus.git

3. Make and Install

cd rtl8188eus
make
sudo make install
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment