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; rebootThe 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.
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.
| 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.
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.
- Christian Marangi (Ansuel) for the upstream EDMA and PPE drivers.
- Robert Marko (robimarko) for maintaining the OpenWrt qualcommax target.
- qosmio for the NSS firmware packaging the feed builds on.
GPL-2.0, see COPYING. The NSS firmware keeps its own license.