English · Русский
Which file to download:
- first installation from the stock firmware: the file ending in
factory.bin; - upgrade from OpenWrt 24.10 / 25.12: the file ending in
squashfs-sysupgrade.itb.
Other cases (OpenWrt 23.05 or older, back to the stock firmware) are described in Installation.
This repository (branch xq-25.12) is a fork of the stable OpenWrt 25.12.6 release (Linux 6.12.112) tailored for the Xiaomi Router AX3200 (RB01) / Redmi Router AX6S (RB03) built on the MediaTek MT7622B + MT7531BE + MT7915E platform (it also carries the MediaTek changes from the remittor tree).
The goal of the build is line-rate 1 Gbps wired and Wi-Fi 6 throughput, low latency, U-Boot NVRAM anti-brick protection and a complete out-of-the-box home router feature set, while staying compatible with the official OpenWrt package repository.
Warning
Wi-Fi is enabled on first boot with the public default password 12345678 and the web interface has no root password. Set both right after flashing (LuCI → System → Administration and Network → Wireless).
Contents: Highlights · Installation · Key changes · Operating modes · Firmware updates · SQM or hardware offloading? · Wi-Fi 160 MHz and VR · Pre-installed packages · Building · Updating to a new release · Research and measurements
- Line-rate routing with almost no CPU load: hardware NAT (PPE) and Wi-Fi offloading (WED) are enabled by default, and kernel fixes keep the per-client traffic statistics and the interface graphs correct with them (section 2). SQM (CAKE) is pre-installed for slower links with bufferbloat (SQM or hardware offloading?).
- Measured for PC VR streaming: a wired PC reaches a 2×2 HE160 client at 1.25–1.35 Gbit/s, and a 200 Mbit/s VR-like stream gets a 1.7 ms median ping (Wi-Fi 160 MHz and VR).
- Operating modes in LuCI: one page, System → Operating mode, switches between setups measured on this router: balanced (default), maximum wired → Wi-Fi throughput with
bridger, low latency for VR and gaming over Wi-Fi, and SQM for slow links (Operating modes). - More stable Wi-Fi: 18 driver fixes from mt76 master (kernel crashes around client connects and radio firmware recovery, adaptive 2.4 GHz sensitivity), defaults tuned for both radios and optional 160 MHz on 5 GHz (section 4, HE160).
- No "6 reboots → orange LED" soft-brick: the U-Boot boot flags are checked on every boot (section 3).
- Official packages work: the kernel is built like the official one, so
kmod-*packages from the official repository install and load (section 7). - Tuned for the Cortex-A53: GCC 15,
-O2with the ARMv8 Crypto and CRC32 instructions, LTO, theschedutilfrequency governor (section 1). - Updates from the web interface: the router looks for new releases of this build by itself, shows a notice on the Overview page and installs an update with one button (Firmware updates).
- Ready to use: LuCI in English and Russian with the Footstrap theme, encrypted DNS (DoH), SQM, UPnP, DDNS, Wake-on-LAN, per-client traffic accounting, statistics graphs and a web terminal (Pre-installed packages).
- Your settings survive upgrades: the build's defaults are applied once per configuration, not on every flash (section 6).
- Verifiable releases: built by GitHub Actions from this repository, with a signed build provenance for every file (Build and release with GitHub Actions).
Important
Read the OpenWrt wiki page for the Xiaomi AX3200 / Redmi AX6S first. It covers backing up the flash partitions, TFTP and UART recovery and hardware-revision specific issues that are not repeated here. Flashing third-party firmware is at your own risk.
Known risks (from the wiki):
- Some newer units have MTD partitions shifted by
-0x20000and can brick on sysupgrade; on others even the factory image may fail. AX3200 units produced after 12/2023 with telnet disabled are reported to be affected. Before the first sysupgrade of a unit installed fromfactory.bin, run the checks from the wiki ("Known Issue #1"):hexdump /dev/mtd8 | headmust start with0000000 0dd0 edfe, andfw_printenv | grep -e ^flag_try -e ^boot_fwmust showboot_fw1=run boot_rd_img;bootm. - The "6 reboots → orange LED" soft-brick is prevented by this build's
bootcountonce OpenWrt has booted (see section 3).
Fallback: going back to the stock firmware and installing this build from there works from almost any state, even when OpenWrt no longer boots; see section F.
Download the images from the latest release (a local build puts them into bin/targets/mediatek/mt7622/):
| File | Purpose |
|---|---|
openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-factory.bin |
First installation from the stock firmware (or from OpenWrt ≤ 23.05). Contains ubi-loader padded to 512 KiB followed by the UBI image. |
openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-squashfs-sysupgrade.itb |
Regular upgrade from OpenWrt 24.10 / 25.12 (UBI layout). |
openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-ubi-loader.itb |
Second-stage U-Boot (ubi-loader) alone. |
openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-initramfs-recovery.itb |
Initramfs recovery image (TFTP). |
Getting an image onto the router. Sections B–E put an image into /tmp on the router in one of two ways:
- Download it on the router, if the router has internet access: the links
https://github.com/Dreyk007/openwrt-ax3200/releases/latest/download/<file>always point to the latest release, andsha256sumsfrom the same place checks the download. The commands are in each section. They usecurl: thewgetof official OpenWrt currently cannot download from GitHub. This build hascurl; on official OpenWrt it has to be installed. - Copy it from your computer: download the file from the latest release and copy it with
scp, which is built into Linux, macOS and Windows 10/11 (on Windows you can also use WinSCP with the SCP protocol). The-Ooption is needed because OpenWrt has no SFTP server.
Commands on the router are run over SSH: ssh root@192.168.1.1 (built into Linux, macOS and Windows 10/11), or PuTTY on Windows with host 192.168.1.1 and user root. The password is the root password set in LuCI; right after flashing there is none. If your router is not at 192.168.1.1, use its address instead. Paste one block of commands at a time: if the last line stays at the prompt after pasting, press Enter.
XMiR-Patcher uses a vulnerability in the stock web interface to get SSH access and flashes the firmware for you. It works on Windows, Linux and macOS.
- Finish the initial setup of the stock firmware (the web interface password is required) and connect your PC to a LAN port of the router. The stock firmware is at
192.168.31.1. - Download XMiR-Patcher (Code → Download ZIP) and unpack it.
- Start it: Windows —
run.bat; Linux/macOS — install Python 3.8+ andopenssl, then./run.sh. - If the router is not at
192.168.31.1, choose1 - Set IP-address. - Choose
2 - Connect to device (install exploit)and enter the web interface password when asked. - Choose
4 - Create full backup. The dumps of all flash partitions are saved to thebackups/folder of XMiR-Patcher — keep them safe: they contain the factory calibration data unique to your unit and are needed to return to stock or recover from a brick. - Download
openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-factory.binfrom the latest release and copy only this file into thefirmware/folder of XMiR-Patcher (no other images in that folder). - Choose
7 - Install firmware (from directory "firmware")and wait until the router reboots. - Open
http://192.168.1.1(userroot, no password), set a root password and change the Wi-Fi password.
If the exploit does not work with your stock firmware version, see the wiki for the alternatives (stock firmware with telnet, netmode 4 methods, UART).
The settings are kept. From r15 on the router can do this by itself: System → AX3200 / AX6S build updates; for earlier releases of this build (r6–r14), use the update command in Firmware updates.
- Download
openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-squashfs-sysupgrade.itbfrom the latest release. - In LuCI open System → Backup / Flash Firmware, click Flash image... under Flash new firmware image, choose the file and click Upload.
- Leave Keep settings and retain the current configuration checked and click Continue. The router writes the image and reboots, which takes a few minutes; do not power it off meanwhile.
Over SSH instead: log in with ssh root@192.168.1.1, download the image on the router and check it (the last command must print OK), then flash it. If the router has no curl, install it first: apk update && apk add curl on OpenWrt 25.12, opkg update && opkg install curl on 24.10.
cd /tmp
F=openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-squashfs-sysupgrade.itb
curl -fLo $F https://github.com/Dreyk007/openwrt-ax3200/releases/latest/download/$F
curl -fsSL https://github.com/Dreyk007/openwrt-ax3200/releases/latest/download/sha256sums | grep -- $F | sha256sum -c -sysupgrade /tmp/openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-squashfs-sysupgrade.itbSince 24.10 this router has a different flash layout: a second-stage bootloader (ubi-loader) followed by one UBI partition with the system. sysupgrade of OpenWrt 23.05 and older cannot switch to it, so the image is written once by hand with mtd. All settings are reset. These are the steps of method 1 from the OpenWrt wiki (section Upgrading from 23.05 and earlier to upcoming 24.10 or snapshot), which also describes a method over TFTP. Another way: back to stock, then XMiR-Patcher (section F).
- Back up your settings: LuCI → System → Backup / Flash Firmware → Generate archive.
- Put the image into
/tmpon the router. If the router has internet access, log in withssh root@192.168.1.1and download it there (the last command must printOK; if there is nocurl, runopkg update && opkg install curlfirst):Otherwise download the file from the latest release, connect your computer to a LAN port with a cable and copy the file:cd /tmp F=openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-factory.bin curl -fLo $F https://github.com/Dreyk007/openwrt-ax3200/releases/latest/download/$F curl -fsSL https://github.com/Dreyk007/openwrt-ax3200/releases/latest/download/sha256sums | grep -- $F | sha256sum -c -
scp -O openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-factory.bin root@192.168.1.1:/tmp/
- Connect your computer to a LAN port with a cable (not over Wi-Fi), log in with
ssh root@192.168.1.1(unless you are logged in already) and run:If the first command reportsmount -o remount,ro / mount -o remount,ro /overlay cd /tmp F=openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-factory.bin dd if=$F bs=1M count=4 | mtd write - kernel dd if=$F bs=1M skip=4 | mtd -r write - ubi
Resource busy, ignore it. The router reboots after the last command. - Open
http://192.168.1.1(userroot, no password). Set a root password and the Wi-Fi password, or restore the archive from step 1: System → Backup / Flash Firmware → Upload archive.... - If you restored the archive, run this over SSH, otherwise the next upgrades (section B) are refused:
The restored settings replace the defaults of this build (HFO, packet steering and others); to apply them on top, see section 6.
uci set system.@system[0].compat_version="2.0" uci commit system
Only if a third-party 24.10 build refuses the image with Cannot find ubinized rootfs in the factory FIT-image
Some third-party 24.10 builds (already with the new flash layout, such as the builds by acdev) refuse openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-squashfs-sysupgrade.itb with Cannot find ubinized rootfs in the factory FIT-image. These builds add this check themselves; OpenWrt does not have it. Do not flash the image past this error (neither Continue in LuCI nor sysupgrade -F).
- Back up your settings: LuCI → System → Backup / Flash Firmware → Generate archive.
- On the acdev builds, according to a report on 4PDA, the upgrade goes through after their
faceinstalservice is stopped. Log in withssh root@192.168.1.1and run:Then flash/etc/init.d/faceinstal stop
openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-squashfs-sysupgrade.itbas in section B, but without keeping the settings (uncheck Keep settings, or usesysupgrade -n): the settings of another build do not fit this one. - If the image is still refused, go back to stock and install the build from there (section F).
sysupgrade does not touch the ubi-loader partition: the router keeps the version that came with factory.bin. To update it to the version from this build:
- Put the image into
/tmpon the router. If the router has internet access, log in withssh root@192.168.1.1and download it there (the last command must printOK):Otherwise download the file from the latest release and copy it:cd /tmp F=openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-ubi-loader.itb curl -fLo $F https://github.com/Dreyk007/openwrt-ax3200/releases/latest/download/$F curl -fsSL https://github.com/Dreyk007/openwrt-ax3200/releases/latest/download/sha256sums | grep -- $F | sha256sum -c -
scp -O openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-ubi-loader.itb root@192.168.1.1:/tmp/
- Log in with
ssh root@192.168.1.1(unless you are logged in already) and run (do not power the router off while it writes):mtd write /tmp/openwrt-mediatek-mt7622-xiaomi_redmi-router-ax6s-ubi-loader.itb ubi-loader reboot
The stock bootloader has a recovery mode that installs the stock firmware from a computer over the network (TFTP). It usually works even when OpenWrt no longer boots. It is also often the simplest way from an old or a third-party build to this one: back to stock, then section A. All settings are reset; if the router still works, back them up first (LuCI → System → Backup / Flash Firmware → Generate archive).
-
Download the stock firmware of your model (the router rejects the firmware of the other one):
- Xiaomi AX3200 (RB01):
miwifi_rb01_firmware_bbc77_1.0.71_INT.binfrom Xiaomi's server, MD5271f2faa9ae6123c99ab3493fa3bbc77; - Redmi AX6S (RB03): from Xiaomi's download page, or version 1.2.7, which the OpenWrt wiki recommends (mirror, MD5
5eedf1632ac97bb5a6bb072c08603ed7).
Check the downloaded file:
md5sum <file>on Linux,md5 <file>on macOS,certutil -hashfile <file> MD5on Windows. - Xiaomi AX3200 (RB01):
-
Connect your computer to a LAN port of the router with a cable and start a DHCP and TFTP server on it:
- Windows: Xiaomi's official MiWiFi Repair Tool (its interface is in Chinese) does this for you: choose the firmware file and the network adapter connected to the router. If the tool does not find the router, give that adapter the address
192.168.31.100with the netmask255.255.255.0by hand. - Manually (on Windows if the Xiaomi tool is unavailable or does not start): give the network adapter connected to the router the static address
192.168.31.100with the netmask255.255.255.0and rename the firmware toC0A81F02.img. The router gets the address192.168.31.2over DHCP and asks for a file named after that address in hex. Then start the server:- Windows: Tftpd64. In the main window choose the folder with the file as Current Directory and the address
192.168.31.100in Server interfaces. In Settings, enable TFTP Server and DHCP Server on the GLOBAL tab, set IP pool start address192.168.31.2, Size of pool1and Mask255.255.255.0on the DHCP tab, click OK and restart Tftpd64. If Windows Firewall asks, allow Tftpd64 network access. - Linux: dnsmasq serves the folder with the file:
sudo dnsmasq -i <interface> -p 0 -d -z --enable-tftp --tftp-root <folder> --tftp-no-fail --dhcp-range 192.168.31.2,192.168.31.2,255.255.255.0,12h
- Windows: Tftpd64. In the main window choose the folder with the file as Current Directory and the address
- Windows: Xiaomi's official MiWiFi Repair Tool (its interface is in Chinese) does this for you: choose the firmware file and the network adapter connected to the router. If the tool does not find the router, give that adapter the address
-
Unplug the router's power, hold the reset button (in the hole on the back) and plug the power back in. When the orange LED blinks quickly (after about 10 seconds), release the button: the router downloads the firmware and installs it.
-
When the LED blinks blue quickly, the stock firmware is installed: unplug the power and plug it back in. A purple blink means that the firmware was rejected (a wrong file or the other model's firmware); start again from step 3.
-
Install this build as described in section A, starting with the initial setup of the stock firmware.
Backing up the flash partitions, TFTP recovery and UART access are described on the OpenWrt wiki page.
The files of every change are listed in UPGRADING.md.
- OpenWrt GCC 15.3.0 toolchain (
CONFIG_GCC_USE_VERSION_15=y) instead of the default GCC 14.3, with better instruction scheduling for the in-order Cortex-A53 pipeline (~241 KB smaller compressed SquashFS). - Compiler flags
-O2 -pipe -mcpu=cortex-a53+crypto+crc: upstream builds use-Os, which disables function/loop/jump alignment. The AX3200 has 128 MB of NAND, so this build trades size for speed with-O2and enables the ARMv8 Crypto Extensions (AES, SHA1/SHA2, GHASH) and CRC32 instructions. - Link-Time Optimization (
CONFIG_USE_LTO=y) and dead code/data elimination (CONFIG_USE_GC_SECTIONS=y) for userland packages. FORTIFY_SOURCE=2(CONFIG_PKG_FORTIFY_SOURCE_2=y) instead of the default level 1. The other hardening options (stack protector for userland and kernel, full RELRO, PIE) andsstrip -zbinary stripping are OpenWrt defaults and are kept as is.schedutilCPU frequency governor by default (target/linux/mediatek/mt7622/config-6.12) instead ofondemand.ondemandsamples the load periodically and ramps up the clock (437.5 MHz → 1.35 GHz) with a delay on traffic bursts;schedutilscales the frequency directly from the scheduler. Measured on the device at idle: 3.8 % CPU load withschedutilvs 6.0 % withondemand.performancegovernor (optional) keeps the CPU at 1.35 GHz all the time: it needs 28 % less CPU per Gbit/s for Wi-Fi → LAN bridging and lowers the idle Wi-Fi round-trip time by about 0.2 ms, but the throughput (limited by Wi-Fi) and the latency under load stay the same, and the router runs about 2 °C warmer.schedutiltherefore stays the default. The Maximum throughput, Low latency and SQM operating modes useperformance, and it can be set alone under Advanced on the same page (Operating modes); the choice is kept across upgrades. Details: RESEARCH.md.
- Hardware Flow Offloading (PPE): the MediaTek Packet Processing Engine (
kmod-nft-offload,flow_offloading='1',flow_offloading_hw='1') handles routing and NAT of established flows in hardware at line rate with almost no CPU load. - Wireless Ethernet Dispatch (
files/etc/modules.conf:options mt7915e wed_enable=Y): offloaded WAN traffic is forwarded by the PPE directly into the DMA rings of the MT7915E (5 GHz Wi-Fi 6) radio, bypassing the CPU. The MT7622 has no WED RX, so only WAN → Wi-Fi traffic bypasses the CPU this way; Wi-Fi → WAN traffic is forwarded by the CPU through the software flow offload path. - Wired → Wi-Fi in hardware (
bridger, off by default): traffic between the LAN ports and Wi-Fi clients is bridged, not routed, so HFO does not cover it and the CPU forwards it: up to ~1.2–1.3 Gbit/s to a 5 GHz client, with one core at its limit.bridgercan install a hardware rule for each pair of hosts that exchange traffic, so that the PPE and WED forward wired → 5 GHz traffic past the CPU: the same ~1.3 Gbit/s (the radio link is the limit) at ~8 % CPU instead of ~70 %. It is off by default: like WED for WAN traffic, the hardware path bypasses the airtime scheduling and the queues of mac80211, so the latency is higher (a 200 Mbit/s stream: median ping 3.0–3.7 ms instead of 1.7 ms) and several busy clients share the air less fairly (three clients: 580–630 Mbit/s in total instead of 790–810, one of them nearly starved). The Maximum throughput operating mode enables it, for bulk transfers to a single busy client (Operating modes). Details: RESEARCH.md. - Without WED (optional): with WED off, all traffic to Wi-Fi clients goes through the airtime scheduling of mac80211. In household tests (a TV streaming 4K, a gamer on Wi-Fi pinging at 50/s, a VR-like stream) it made no difference; only while another Wi-Fi client downloaded at full speed was the gamer's p99 ping lower: ~27 ms instead of ~30 ms, at 6–9 points more CPU. On a gigabit plan the CPU may then limit the Wi-Fi speed. WED is off in the Low latency operating mode (Operating modes). Details: RESEARCH.md.
- Correct traffic statistics with offloading: offloaded traffic bypasses the CPU, and the per-client statistics (
nlbwmon) used to miss part of it or jump by ~4 GB, e.g. for connections that close right after a transfer, after a firewall reload or for Wi-Fi downloads. Kernel fixes make them match the real traffic. Details and measurements: RESEARCH.md. - Interface graphs with offloading: the statistics of
wanandlan1–lan3(graphs in Statistics, LuCI realtime graphs,ip -s link) come from the switch port counters (a backport from Linux 6.16), so they show the real traffic.br-lanand the Wi-Fi interfaces still show only the traffic handled by the CPU. - After a Wi-Fi restart: after
wifi down/up(e.g. on a schedule) the access point interfaces return to the flowtable automatically, so uploads from wireless clients keep the fast path. - HFO bypasses the Linux queueing layer, so it cannot be combined with SQM — see SQM or hardware offloading?.
- Problem: newer stock U-Boot versions increment
flag_try_sys1_failedinu-boot-env(/dev/mtd3) on every boot. After 6 reboots U-Boot fails over to the secondary firmware slot (system 1), which OpenWrt has overwritten with its unified UBI partition — the router soft-bricks with a solid orange LED. - Solution (
target/linux/mediatek/mt7622/base-files/etc/init.d/bootcount): on every boot the values below are checked andfw_setenvis called only for values that differ (no needless NAND writes):flag_try_sys1_failed=0,flag_try_sys2_failed=0,flag_boot_rootfs=0,flag_boot_success=1,flag_last_success=1,boot_fw1="run boot_rd_img;bootm"— the anti-brick part;boot_wait=onanduart_en=1— keep TFTP recovery and the U-Boot serial console usable. Both require physical access to the router.ssh_en(only used by the stock firmware) is not touched.
- Reliable 5 GHz detection on first boot:
77_wirelessruns/sbin/wifi configbefore configuring the radios, so themt7915ePCIe radio is present in/etc/config/wirelesseven if it finished probing late. radio0is the SoC-integrated 2.4 GHz (802.11n) radio,radio1is the PCIe 5 GHz MT7915E (802.11ax) radio. Each radio is configured by itsband:- Regulatory domain: country
PAfor both radios (CONFIG_PACKAGE_MAC80211_COUNTRY="PA"). It allows more channels and higher transmit power than many other domains; set your own country in LuCI if local regulations require it. - 2.4 GHz:
HT20, channel1, WPA2 (psk2+ccmp) for the best IoT compatibility. - 5 GHz:
HE80on the non-DFS channel36(no 1–10 minute DFS/CAC radar drop-outs),noscan='1'(no fallback to a narrower channel because of neighbouring networks), WPA2/WPA3 mixed mode (sae-mixed) withocv='0'(SAE client compatibility), WNM-Sleep Mode (wnm_sleep_mode='1',wnm_sleep_mode_no_keys='1') anddtim_period='3', which let phones sleep longer and save battery. - SSIDs:
<board>-<band>-<radio><last 4 hex digits of the MAC>, e.g.redmi-router-ax6s-2g-0a1b2andredmi-router-ax6s-5g-1a1b2; password12345678.
- Regulatory domain: country
- Settings are applied only if the radio has no Wi-Fi key yet, so they never overwrite a restored configuration.
- Full
wpad-mbedtlsinstead ofwpad-basic-mbedtls, OpenWrt's default for this router. The basic variant already supports WPA3 (SAE), 802.11r and 802.11k; the full one adds 802.11v (WNM), which the WNM-Sleep Mode of the 5 GHz defaults above needs, as well as WPS, WPA2/WPA3-Enterprise (802.1X, built-in RADIUS server), 802.11s mesh and Wi-Fi Easy Connect (DPP). Fast roaming (802.11k/v/r) stays off, as in stock OpenWrt: it only matters when several access points share one SSID. For such a network enable it in the wireless settings and installusteer(apk add usteer luci-app-usteer). - Wi-Fi driver fixes from mt76 master (18 fixes on top of the mt76 of OpenWrt 25.12): kernel crashes around client connects and disconnects and around the recovery of the radio firmware, TX aggregation for voice-priority traffic on 5 GHz, correct HE DCM / VHT STBC client capabilities. On 2.4 GHz the adaptive sensitivity (SCS) of the MT7622 works again (a driver bug had kept it at its default since 2022): on the busy 2.4 GHz channel of the test setup it halved the time the radio considered the channel busy (31 → 15 %) and reduced ping loss to the clients. The threshold never goes above the signal of the weakest connected client. Details: RESEARCH.md.
- Packet steering, mode 2 (
packet_steering='2', Enabled (all CPUs),steering_flows='128'): pins the threaded NAPI workers of the Ethernet (mtk_eth) and Wi-Fi (mt76) drivers to different CPU cores, spreads RPS over both cores and enables RFS with 128 flows. Compared to mode 1 it gives 6–11 % more wired → Wi-Fi throughput to a client receiving more than ~1.2 Gbit/s and shares the load between the cores more evenly, with the same latency in the household tests (RESEARCH.md). The SQM operating mode uses mode 1, which needs less CPU with CAKE (RESEARCH.md).irqbalanceis not installed: it moves only the IRQs, not the NAPI threads that do the packet processing, so it can split the Ethernet IRQs away from their NAPI CPU, and on the device it brought no gain (RESEARCH.md). It can still be added withapk add irqbalance. - Sysctl tuning (
files/etc/sysctl.d/99-bbr.conf):- TCP BBR,
fq_codeland TCP Fast Open (tcp_fastopen=3). They apply to TCP connections terminated on the router itself (LuCI, DoH proxy,iperf3server, package downloads), not to traffic forwarded for LAN clients.fq_codelis the OpenWrt default qdisc anyway. - Larger conntrack table (
nf_conntrack_max=32768) and adjusted TCP/UDP timeouts for P2P and gaming. - Global RFS socket flow table (
net.core.rps_sock_flow_entries=1024). OpenWrt's packet steering only sets the per-queue flow count (steering_flows); without this table RFS stays inactive. It affects only traffic terminated on the router itself.
- TCP BBR,
- Stealth firewall:
input/forwardpolicies of the defaults and thewanzone areDROPinstead ofREJECT, plusdrop_invalid='1'. SSH (dropbear) listens only on the LAN interface (Interface='lan'). - LAN NTP server (
system.ntp.enable_server='1'). zram-swap120 MB withlz4(CONFIG_KERNEL_ZRAM_DEF_COMP_LZ4=y) andvm.swappiness=100,vm.page-cluster=0,vm.vfs_cache_pressure=50.- Services are restarted indefinitely after crashes (procd
respawn_retry='0');https-dns-proxytolerates WAN reconnects (conn_loss_time='30'). - Fixes ahead of OpenWrt 25.12.7:
- Linux kernel, CVE-2026-98432: a TCP connection to the router itself with crafted IPv4 options could crash it or corrupt kernel memory (the fix of Linux 6.12.113);
- no kernel panic when a program that handles traffic through NFQUEUE, such as
nfqwsof zapret, re-injects a packet the kernel does not expect: the packet is dropped and the kernel log shows a warning once (the random reboots of openwrt/openwrt#26151); - the root certificate "emSign ECC Root CA – G3" is no longer trusted: it issued certificates with keys anyone can recover;
- musl, CVE-2026-107891: integer overflows in regular expressions;
- dnsmasq: large hosts files, such as ad-blocking lists, load in seconds instead of minutes.
uci-defaults scripts run on the first boot after every flash, including a sysupgrade that keeps settings. files/etc/uci-defaults/99-custom-settings applies the settings from sections 2 and 5 and the DoH, statistics, DDNS autostart and LuCI theme defaults (see Pre-installed packages) only once per configuration and stores a marker in /etc/config/ax3200. Your own changes (for example HFO disabled in favour of SQM) are therefore preserved across upgrades. Only removing the collectd include of older builds runs on every flash. Three later changes are also applied once to configurations upgraded from earlier builds: bridger off, packet steering mode 2 instead of mode 1 (unless SQM is on), and the dnsmasq server list cleared of the entries https-dns-proxy left there (see Pre-installed packages). The list of LuCI themes is brought in line with the installed themes on every boot (files/etc/init.d/luci-themes), so this also works after restoring a settings backup made on another firmware. To re-apply the build defaults:
uci -q delete ax3200.defaults && uci commit ax3200
sh /rom/etc/uci-defaults/99-custom-settings
rebootvermagic_update.shdownloads the kernelvermagicof the official OpenWrt 25.12.6 release (685dcedeed3538a4cc670fc3fd59eac1) andscripts/getvermagic.shbuilds the kernel with it, sokmod-*packages from the official repository install withoutvermagicmismatch errors.- The kernel configuration matches the official one. A matching
vermagicis not enough on its own: an official module only works if every kernel structure it uses has the same layout. The official buildbot builds withCONFIG_ALL_KMODS=yand withoutKALLSYMS, which changesstruct module,net_device,struct netandsk_buff. This build does the same (CONFIG_ALL_KMODS=y,# CONFIG_KERNEL_KALLSYMS is not set), so its kernel.configdiffers from the one in the official SDK only in the GCC version, theschedutildefault governor and the zram compression backends — none of them affects the module ABI. - Verified on the device: the official
kmod-dummyandkmod-wireguard(with the NEON-accelerated ChaCha20/Poly1305 modules) load and work; a WireGuard tunnel carried ~2 GiB at 530–600 Mbit/s without kernel errors. ALL_KMODSonly builds all kernel modules intobin/; the firmware contains just the selected ones. WithoutKALLSYMSthe kernel is ~260 KiB smaller in flash and ~0.7 MiB smaller in RAM, and kernel oops traces show addresses instead of function names (as in official images).- Packages are managed with OpenWrt 25.12's native
apk(apk-mbedtls) andluci-app-package-manager.
The best acceleration settings depend on how the router is used. LuCI → System → Operating mode (luci-app-tuning, a package of this build) sets them together, as modes measured on this router (RESEARCH.md): the flow offloading type, WED, bridger, packet steering, the CPU frequency governor and SQM. Each mode lists whom it suits, its pros and cons with the measured numbers, and its warnings.
| Mode | For | Settings |
|---|---|---|
| Balanced (default) | A typical home: phones, a TV, laptops, gaming, a plan up to 1 Gbit/s. | hardware NAT and WED, bridger off, packet steering 2, schedutil |
| Maximum throughput | Large copies from a wired NAS or PC to one Wi-Fi device: ~1.3 Gbit/s at ~8 % CPU instead of ~70 %. Not for VR or gaming: higher latency and less fair sharing of the air. | as Balanced, plus bridger and performance |
| Low latency | VR streaming from a wired PC, gaming over Wi-Fi: slightly lower latency peaks while another device downloads (p99 ~27 instead of ~30 ms). Internet downloads to Wi-Fi need more CPU. | as Balanced, but WED off and performance |
| SQM (slow link) | Links slower than ~300 Mbit/s whose latency grows a lot under load (SQM or hardware offloading?). | software flow offloading, CAKE on the WAN, WED off, packet steering 1, performance |
| Custom | Any combination of the settings under Advanced. |
- Applying a mode reboots the router: WED can only change at boot.
- The page shows the mode that matches the current settings; after changes on other pages it shows Custom.
- The mode is kept across firmware upgrades.
From r10 on, the router looks for new releases of this build on GitHub. When a release is out, the Overview page shows a notice. LuCI → System → AX3200 / AX6S build updates lists what changed and installs the update with one button, with or without keeping the settings; before installing, the router checks that the file is complete and fits this router. Some releases cannot be installed this way, for example when the flash layout changes: the page then says why and links to the instructions. The check can be turned off or set to another interval on the same page.
This is standard OpenWrt behaviour: an update removes the packages you installed yourself. With Keep my packages next to the update button (on by default), the router installs them again once it is online after the update, and repeats replacements of image packages, such as dnsmasq-full instead of dnsmasq; services you had turned off stay off. Packages installed not from a repository (from a file or by an install script) have to be installed again by hand: the page lists them. After installing them, the router restarts once, so that they start as after a normal boot. An update made another way (Backup / Flash Firmware, sysupgrade) does not restore packages.
Updating earlier releases (r6–r14) with one command. On r10–r14 the update page fails with "no connection to GitHub", and r6–r9 have no update page. To update any earlier release of this build to the latest one with the settings and packages kept, run this over SSH or in LuCI's web terminal (Services → Terminal):
curl -fsSL https://raw.githubusercontent.com/Dreyk007/openwrt-ax3200/HEAD/ax3200-update.sh | shFor Russian output, use sh -s -- --lang=ru instead of sh. If the update cannot keep settings, the command shows why and stops without changing anything.
Attended Sysupgrade, OpenWrt's own update tool, is not part of this build. It can be installed separately, and an update through it works, but the router then moves to plain OpenWrt without the advantages of this build.
SQM (luci-app-sqm, CAKE) fights bufferbloat — latency spikes when the link is saturated (calls, games and browsing lag while something downloads or uploads). It needs to see every packet. Hardware flow offloading (HFO) moves established flows into the PPE, past the Linux queueing layer, so SQM does nothing while HFO is enabled. Without HFO, WED does not work either, and all routed and Wi-Fi traffic is handled by the CPU.
| HFO + WED (default) | SQM (CAKE) | |
|---|---|---|
| Max routed throughput | ~1 Gbps, almost no CPU load | CPU-bound: measured ~400 Mbit/s for wired clients and ~230–250 Mbit/s for 5 GHz clients, with one core at its limit (RESEARCH.md) |
| Latency under load | depends on the ISP / modem buffers | low and stable |
| Best for | fast links (≳ 500 Mbps), links without bufferbloat | slower or asymmetric links: DSL, LTE/5G, cable, PPPoE below ~300–500 Mbps |
How to choose: run a bufferbloat test (e.g. Waveform "Bufferbloat Test") over a wired connection with the default settings. If latency under load stays low (grade A/B), keep HFO. If it grows by tens or hundreds of milliseconds and your plan is below ~300 Mbit/s, switch to SQM.
Switch to SQM: LuCI → System → Operating mode → SQM (slow link), enter the download and upload rates (~85–95 % of the speeds measured without SQM) and click Apply; the router reboots. Then repeat the test. The mode switches hardware offloading to software offloading, which works with SQM on this router at the same speed and latency, and turns on CAKE on the WAN at the entered rates. Further SQM options, such as the link layer overhead of DSL, stay in LuCI → Network → SQM QoS.
Back to HFO: choose Balanced.
The choice is kept across sysupgrades (see section 6).
This section is only for those who run zapret on the router to get around DPI blocking. Everyone else can skip it. Tested on this router with Zapret Manager 5.004 (the panel for LuCI) and the zapret it installs.
- Install zapret with Zapret Manager. It sets the firewall up for this build by itself: with hardware offloading on, a connection goes to the hardware only after its first 30 packets. zapret then sees the start of every connection and works in all operating modes, while downloads still go through the hardware. Without this change zapret missed the connections of wired clients and, in the SQM mode, of all clients. Details: RESEARCH.md.
- Operating modes can be switched while zapret runs: it keeps working.
- Random reboots with zapret are fixed in this build (r13): the official 25.12.6 kernel crashes on some packets that zapret hands back (openwrt/openwrt#26151); here only such a packet is dropped.
- Steer of Zapret Manager needs the full
ipcommand, which this build includes since r14. On r13 runapk update && apk add ip-full '!ip-tiny'before installing anything with Zapret Manager, or Steer will not install. - IPv6: zapret handles only IPv4 by default. If your provider gives you IPv6, devices may reach a site over IPv6 past zapret: enable IPv6 in Zapret Manager.
- After a firmware update zapret is not installed again by itself, because it is installed from a file: the update page lists it among the packages to install by hand. Wait until that page shows the packages restored (the router restarts once more after installing them), then install Zapret Manager and zapret with it; the firewall is set up again as well. If the update kept the settings, the zapret settings are kept too, but Zapret Manager sets its own main strategy when it installs zapret: if you had chosen another one, choose it again.
The 5 GHz radio defaults to HE80 on channel 36 for the widest client compatibility. The MT7915E also supports 160 MHz (HE160), which doubles the link rate of the usual 2×2 clients (phones, laptops, VR headsets): up to 2402 Mbit/s instead of 1201 Mbit/s. At 160 MHz the radio uses 2 spatial streams instead of 4, so 3×3/4×4 clients gain less.
With the PA regulatory domain the 5470–5725 MHz band (channels 100–128) allows 160 MHz without DFS: no 1-minute channel availability check after boot and no channel switches on radar detection.
Trade-offs:
- clients that do not support channels 100–144 will not see the 5 GHz network;
- slightly shorter range at the edge of coverage (the same power is spread over twice the bandwidth);
- outside Panama these channels are usually subject to DFS rules — check your local regulations.
Enable it in LuCI → Network → Wireless → 5 GHz radio → Edit → Operating frequency: mode AX, channel 100, width 160 MHz → Save & Apply, or over SSH:
uci set wireless.radio1.channel='100'
uci set wireless.radio1.htmode='HE160'
uci commit wireless
wifi reloadiwinfo wl1-ap0 info then shows HT Mode: HE160. To go back to the default, set channel 36 and HE80.
PC VR streaming (Virtual Desktop, Steam Link, Air Link) benefits most from HE160 — provided the headset supports 160 MHz on 5 GHz (check its specifications; support depends on the model and its firmware):
- connect the PC to a LAN port with a cable, so that there is only one wireless hop;
- keep the headset in the same room as the router, ideally with line of sight;
- connect the headset to the 5 GHz network only;
- use the Balanced or the Low latency operating mode, not Maximum throughput: it raises the latency of the stream (Operating modes);
- avoid large downloads to other 5 GHz devices while playing: an ordinary evening (a TV streaming 4K, phones) did not affect the stream, but a full-speed download to another client raised its p99 latency from 6–11 ms to 50–100 ms in every configuration.
Measured with a 2×2 HE160 laptop as the headset about 1 m from the router (link rate 1815–2402 Mbit/s) and a wired PC as the source: a 200 Mbit/s VR-like UDP stream lost 0.01–0.15 % of its packets, ping 1.6–1.8 ms median and 6–11 ms p99, also next to a TV streaming 4K from the internet. Wired → Wi-Fi reaches 1.25–1.35 Gbit/s, Wi-Fi → wired 1.5–1.8 Gbit/s (RESEARCH.md).
- Web UI:
luci,luci-ssl, full Russian and English localization (CONFIG_LUCI_LANG_ru=y; the language follows the browser). Themes: Footstrap (default) — the new LuCI theme with a collapsible sidebar or top bar, light/dark modes, a menu search and an Appearance page for colours, density, layout and wallpaper — and the stock Bootstrap. After an upgrade from an older build or after restoring a settings backup made on another firmware, Footstrap is listed again and a removed theme (OpenWrt-2020, Material) is replaced with Footstrap automatically. - Encrypted DNS (DoH, HTTP/2 & HTTP/3):
https-dns-proxy+luci-app-https-dns-proxy(Cloudflare and Google out of the box). Clients are not forced to use the router's DNS (force_dns='0'), so client-side encrypted DNS such as Android Private DNS (DoT) keeps working. Fixed in this build:https-dns-proxycould leave its own entries in the server list of dnsmasq, so that the router kept blocking iCloud Private Relay and the automatic DoH of Firefox, and after DoH was turned off kept sending queries to the stopped proxies. - SQM / CAKE QoS:
luci-app-sqm(sqm-scripts,kmod-sched-cake) — installed but disabled by default; the SQM operating mode sets it up. - Home network services:
luci-app-upnp(miniupnpd-nftables),luci-app-wol(etherwake),luci-app-watchcat,luci-app-wifischedule,luci-app-uhttpd;luci-app-ddns: its autostart is off while no DDNS service is enabled (set up a service, then Services → Dynamic DNS → Start DDNS). With a LuCI fix (openwrt/luci#9154): without internet the DDNS status no longer leaves LuCI's Overview empty for 10 s per service;luci-app-tuning: operating modes (System → Operating mode), a package of this build inpackage/ax3200/. It replacesluci-app-cpufreqof earlier builds: the CPU frequency governor is set on the same page;luci-app-fwupdate: firmware updates (System → AX3200 / AX6S build updates), a package of this build inpackage/ax3200/;bridger: wired → Wi-Fi traffic in hardware, off by default, enabled by the Maximum throughput mode (section 2).
- Monitoring and diagnostics:
luci-app-nlbwmon(per-client traffic accounting),luci-app-statistics(collectdgraphs of CPU load and frequency, RAM,br-lan/wan, Wi-Fi, conntrack, hardware sensors and the MT7915E temperature; thewangraph includes offloaded traffic, see Interface graphs with offloading),luci-app-ttyd(web terminal), CLI toolshtop,nano,curl,iperf3,ethtool,tcpdump-mini,bind-dig,mtr-nojsonand the fullipcommand (ip-full, which packages such as Steer of Zapret Manager need).
BUILDING.md: build.sh, GitHub Actions, a manual build and changing the configuration.
OpenWrt Project is a Linux operating system targeting embedded devices. Instead of trying to create a single, static firmware, OpenWrt provides a fully writable filesystem with package management. This frees you from the application selection and configuration provided by the vendor and allows you to customize the device through the use of packages to suit any application. For developers, OpenWrt is the framework to build an application without having to build a complete firmware around it; for users this means the ability for full customization, to use the device in ways never envisioned.
- Xiaomi AX3200 / Redmi AX6S OpenWrt Wiki
- XMiR-Patcher
- OpenWrt Firmware Selector
- Developer Documentation
OpenWrt is licensed under GPL-2.0
