UGREEN AX900 WiFi Adapter (AICSemi AIC 8800D80) - [02.12.2024]¶

Introduction¶

This guide walks you through installing and fixing the driver for the UGREEN AX900 WiFi Adapter on Linux systems.

Prerequisites / Tools¶

sudo apt update
sudo apt install -y sudo unzip build-essential linux-headers-$(uname -r)

Step 1 - Download the Driver¶

Visit the official download page: UGREEN AX900 WiFi Driver

Step 2 - Unpack and Patch the Driver¶

The current V1.2 release of the CM762-35264 driver fails to build on kernel 6.4 and newer, because ieee80211_amsdu_to_8023s gained a mesh_hdr parameter (see linux.git commit 986e43b19ae9). This may already be fixed in newer driver releases.

Step 2.1 - Unpack¶

unzip CM762-35264.zip -d CM762

Step 2.2 - Fix Driver¶

Note

Only needed if your kernel is 6.4 or newer and the driver is V1.2 (or older).

cd CM762/Linux/linux_driver_package/
dpkg-deb -R aic8800d80fdrvpackage.deb tmp

Modify line 471 in tmp/usr/src/AIC8800/drivers/aic8800/aic8800_fdrv/rwnx_rx.c.

OLD:

        ieee80211_amsdu_to_8023s(skb, &list, rwnx_vif->ndev->dev_addr,
                                 RWNX_VIF_TYPE(rwnx_vif), 0, NULL, NULL);

NEW:

        ieee80211_amsdu_to_8023s(skb, &list, rwnx_vif->ndev->dev_addr,
                                 RWNX_VIF_TYPE(rwnx_vif), 0, NULL, NULL, false);

Step 2.3 - Repack the Driver¶

dpkg-deb -b tmp fixed-driver.deb

Step 3 - Install Driver¶

dpkg -i fixed-driver.deb

The driver for the UGREEN AX900 should now be installed and functional. You can verify the installation by checking your network settings or running:

iwconfig
dmesg | grep aic