[WIP] TP-Link Archer AX50 v1 – LTS kernel (6.12) experimental build

Hi everyone,

I'd like to share an experimental build of OpenWrt 25.12 master/current running on the lts 6.12 kernel for the TP-Link Archer AX50 v1.

This build features reimplemented drivers based on the GPL source code provided by TP-Link.


Official Support Status

Please keep in mind that the TP-Link Archer AX50 is not officially supported by the OpenWrt


Releases & Downloads


Current Hardware & Feature Status

Working reliably:

  • Ethernet switch (WAN and LAN interfaces)
  • USB
  • LEDs
  • Buttons
  • Internal PCIe bus for wifi card

Work in progress / Known issues:

  • Wi-Fi: Highly unstable. The firmware runs on the chip, clients can associate, and encryption works, but there are still many stability and performance issues to track down and fix.
  • Hardware acceleration: No hardware data path acceleration is implemented yet; traffic relies entirely on software offloading.
  • cgroups: Currently disabled because they trigger kernel freezes.

Installation & Environment

Warning: This is an early, non-production work-in-progress build. Flash at your own risk. I will not be providing a beginner-friendly walkthrough. If you are not comfortable working over serial and U-Boot, do not flash this image.

  • Flashing: The firmware must be written to slot B. I currently flash it via TFTP through UART using U-Boot commands.

U-Boot bootargs and bootcmd settings:

bootargs=console=ttyLTQ0,115200 cca=5 ubi.mtd=system_sw ubi.block=0,rootfsB root=/dev/ubiblock0_3 rootfstype=squashfs ro init=/etc/preinit active_bank=B maxcpus=4 print-fatal-signals=1 clocksource=gptc-timer panic=0
bootcmd=ubi part system_sw; ubi read 0x80800000 kernelB; bootm 0x80800000

Collaboration & Feedback

Any help is more than welcome! If you have this hardware and some kernel/driver debugging experience, feel free to test, submit PRs, or open issues on GitHub. All feedback, bug reports, and testing results are greatly appreciated.


Disclaimer: You are using this software entirely at your own risk. I am not responsible for bricked devices or any damage caused by flashing this firmware.

If you want a stable future with the easy option to integrate it in OpenWrt once operational I would build this based on the actual main code which is kernel 6.18 for now.

Openwrt 25.12 “main” is already a dead end spinoff from main code. Next month the 25.12 project will be pretty much cold and buried when something probably named 26.12 will dropoff from main, especially for developers.

That is my end goal. I intentionally avoided main and the 6.18 kernel for the initial work just to eliminate potential instabilities and rule out unrelated userspace issues while bringing up the hardware.