This is an experience to build the RTL8812AU driver in Raspberry-Pi OS at 2025/07.

get 8812au driver from github

$ git clone https://github.com/morrownr/8812au-20210820

build

$ sudo apt install -y build-essential
$ sudo apt install -y dkms
$ sudo apt install -y bc
$ cd 8812au-20210820
$ make build

install and use the driver

run the script install-driver.sh to install the modules. the install-driver.sh will also set the modprobe settings.

$ sudo bash install-driver.sh
$ modprobe rtl8812au
$ ip addr
...
wlan1   # <- 8812au

error at build

In my case, Errors were shown in make.log

undefined kasan_hw_tag_enabled

recent Raspberry-Pi OS enable the KASAN but the kernel header package is corrupted. (?)

to fix it, edit the headers to fit the kernel status.

edit the kasan-enable.h in kernel-common/include/linux/kasan.h

static inline bool kasan_hw_tags_enabled(void) {
    return true;
}

WiFi Error or stall after several hours

use the broadcom driver clone: https://github.com/morrownr/8812au-20210820 .

I met the WiFi errors `` after several hours from boot with the community driver https://github.com/lwfinger/rtw88 .

kasan.hの現象は、kernel-header展開中に
overlayfs適用してしまっておかしくなった？