Installing a TP-Link TL-WN725N Wireless Adapter on a RaspberryPi

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