Skip to content

About

OpenWrt with Qualcomm NSS hardware offload (NAT, PPPoE, SQM, bridge, ath11k Wi-Fi) on the upstream qca_edma/qca_ppe drivers, for IPQ807x and IPQ60xx routers: Xiaomi AX3600, Redmi AX6, Linksys MX4300/MR7350, GL.iNet Flint and more

Topics

Resources

Security policy

Stars

87 stars

Watchers

5 watching

Forks

 
 

Repository files navigation

OpenWrt with PPE and NSS offload for IPQ807x and IPQ60xx

OpenWrt main with hardware offload for Qualcomm IPQ807x and IPQ60xx routers in the qualcommax target, such as the Xiaomi AX3600, Redmi AX6, Linksys MX4300 and MR7350, Dynalink DL-WRX36 and GL.iNet GL-AX1800. It runs OpenWrt's upstream qca_edma and qca_ppe ethernet and DSA drivers on kernel 6.18 and uses only in-kernel offload interfaces: no ECM, no NSS qdiscs and no vendor NSS host driver.

Traffic Engine Kernel interface
Routed IPv4/IPv6, NAT, PPPoE, 802.1Q VLAN PPE fw4 flowtable (flow_offloading_hw)
Bridging, VLAN filtering, multicast snooping PPE switchdev
SQM shaping and queue classes PPE tc qdisc and flower offload, DCB
Wi-Fi data path of the SoC radios NSS nss-wifi-drv, ath11k
Routed and bridged flows with a Wi-Fi end NSS fw4 flowtable, bridge conntrack
Routed multicast to Wi-Fi NSS kernel multicast routing (MFC)
Routed flows over a cellular modem (raw-IP device) NSS fw4 flowtable

The PPE is the packet engine in the SoC's switch; qca_ppe programs it without firmware. nss-wifi-drv is a small host driver that boots the NSS firmware and hands it the ath11k rings. The Wi-Fi offload is on by default and is turned off with:

uci set nss-wifi.general.offload='0'; uci commit nss-wifi; reboot

The Xiaomi AX3600 is the test board. Other boards are built but not tested by the maintainer, and IPQ60xx is not tested at all. Reports are welcome.

Images

Find your router on ppenss.github.io: sysupgrade images for 41 IPQ807x and 24 IPQ60xx boards, custom images, the kernel modules of each release and updates. The images carry NSS firmware 12.5 and 11.4, the last line that supports 802.11s mesh, and boot 12.5.

The wiki covers each part of the offload, SQM, bug reports and migrating from edma-nss. Benchmarks has the throughput and router CPU of every flow class measured on the AX3600.

Branches

Branch Contents
ppe-nss The default. openwrt/openwrt main, which carries the PPE flowtable, tc and switchdev offload since openwrt/openwrt#24806, plus the NSS Wi-Fi series.
nss-edma-rework Archived. The vendor NSS stack (qca-nss-drv, ECM, NSS qdiscs). Final state: tag archive/nss-edma-rework-final.

The NSS Wi-Fi series on ppe-nss adds the NSS device tree nodes, the qca_edma and qca_ppe changes that let the NSS firmware share the EDMA and PPE with the host, nss-wifi-drv, and the ath11k patches that hand the data-path rings to the firmware. The only package taken from the nss-packages feed (branch ppe-nss) is nss-firmware.

Building

git clone -b ppe-nss https://github.com/JuliusBairaktaris/openwrt-ppe-nss.git
cd openwrt-ppe-nss
cp feeds.conf.default feeds.conf
echo "src-git nss https://github.com/JuliusBairaktaris/nss-packages.git;ppe-nss" >> feeds.conf
./scripts/feeds update -a && ./scripts/feeds install -a
cat seeds/qualcommax-nss-wifi.seed >> .config
make defconfig
make -j"$(nproc)"

seeds/qualcommax-nss-wifi.seed selects kmod-nss-wifi-drv, ATH11K_NSS_WIFI and wpad-openssl, which supports 802.11s mesh. kmod-nss-wifi-drv pulls in the NSS firmware of the subtarget, both firmware lines included. The rest of the seed is marked optional: the PPE SQM and QoS packages, the tc and sched modules, DCB, devlink and routed multicast that the release images add.

hw_ppe.qos for SQM and the PPE QoS LuCI page come from a feed patch and a luci fork in the builder. Its README builds the exact release images.

ppe-nss is rebased often. Update with git fetch origin && git reset --hard origin/ppe-nss, not git pull.

Acknowledgements

Support

GitHub Sponsors or PayPal.

License

GPL-2.0, see COPYING. The NSS firmware keeps its own license.

About

OpenWrt with Qualcomm NSS hardware offload (NAT, PPPoE, SQM, bridge, ath11k Wi-Fi) on the upstream qca_edma/qca_ppe drivers, for IPQ807x and IPQ60xx routers: Xiaomi AX3600, Redmi AX6, Linksys MX4300/MR7350, GL.iNet Flint and more

Topics

Resources

Security policy

Stars

87 stars

Watchers

5 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages