Skip to content
Julius Bairaktaris edited this page Oct 17, 2026 · 3 revisions

FAQ

Questions from the forum thread.

Are the edma-nss images still updated?

No. Only ppe-nss is built. The last edma-nss images stay on the releases page, and their sources are the archive/nss-edma-rework-final tag of this repo and the archive/edma-nss-final tag of the builder.

Can I upgrade from edma-nss and keep my settings?

Yes, with a normal sysupgrade, followed by a few manual steps: turn hardware flow offloading on, switch SQM to hw_ppe.qos and delete the old configs. They are on Migrating from edma-nss.

My PPE counters are zero and one CPU core is busy. Why?

Hardware flow offloading is probably off. This is the usual result of an upgrade from edma-nss with settings kept. Check it:

uci show firewall.@defaults[0] | grep flow_offloading
grep -c HW_OFFLOAD /proc/net/nf_conntrack

Both options must be 1. See Migrating from edma-nss and Wired Offload.

I set nss-wifi.general.offload to 1, and after a reboot it reads 0. Is that a bug?

No. The service sets it to 0 before it boots the NSS core and back to 1 two minutes after the bring-up succeeded. If a bring-up hangs the board, the next boot comes up on the host path. Check the state with logread -e nss-wifi; "offload armed again for the next boot" means it worked. See Wi-Fi Offload.

Does the Wi-Fi offload need hardware flow offloading?

For routed traffic, yes. The Wi-Fi offload takes routed flows from the same fw4 flowtable as the PPE. Bridged Wi-Fi connections and multicast do not need it.

Where are nss-status and the NSS Offload page?

They belonged to the old vendor stack and are gone. The PPE and the Wi-Fi offload report through standard tools and debugfs; the commands are in Wired Offload, Wi-Fi Offload and Reporting Bugs. Queue classes moved to Network → PPE QoS.

My third radio is not offloaded, and the nss_redirect option is unknown.

Only the radios inside the SoC are offloaded. A PCIe radio (QCN9074 or an ath10k radio such as the QCA9984) runs on the host path. The mac80211 nss_redirect parameter was part of the old vendor stack and does not exist here.

Which options do I need when I move my edma-nss build config?

Drop every NSS package of the old stack (qca-nss-drv, ECM, the NSS clients and qdiscs, nss-userspace). The Wi-Fi offload needs only CONFIG_PACKAGE_kmod-nss-wifi-drv=y, CONFIG_ATH11K_NSS_WIFI=y and the firmware choice. The seeds/ files hold both variants. See Building.

My build fails with a recursive dependency on ATH11K_NSS_WIFI.

Remove tmp/ in the build tree and run make defconfig again. Stale package metadata from another branch causes it. Start from a seed file rather than an old config.

Can I install kmods (zram, USB drivers and so on) with apk?

Yes. Each release publishes every kernel module built with its kernel, and the image points apk at that feed: apk update && apk add kmod-<name>. The kmods in the official OpenWrt feeds do not match the kernel. The image picker lists the modules of each release.

Where do I set up SQM with PPPoE?

On the physical wan port, with hw_ppe.qos. Do not put it on pppoe-wan or a VLAN device: the switch only knows the port. See SQM and QoS.

Latency under load is worse with hw_ppe.qos than without SQM.

Hardware SQM is new. Turn SQM off and report your line type, the rates you set and a test result with and without SQM.

Does IPTV work?

Yes, with a multicast routing daemon such as igmpproxy, which is not in the images. Build it in. With the Wi-Fi offload on, routed streams to Wi-Fi run on the NSS cores and reach each station as unicast. See Multicast and IPTV.

Which image do I need for 802.11s mesh?

The normal ppe-nss image. It carries NSS firmware 12.5 and 11.4 and boots 12.5, which does not accept a mesh interface. Switch to 11.4 once: uci set nss-wifi.general.firmware=11.4; uci commit nss-wifi; reboot.

Wi-Fi to wired throughput is lower with the Wi-Fi offload on.

Measure with iperf3 between a Wi-Fi client and a wired host, never with the router itself as the server or client. Run it with the offload on and off and report both numbers, with your MTU if it is not 1500.

Does mwan3 work with the Wi-Fi offload?

It is not tested. If Wi-Fi clients break with mwan3, set nss-wifi.general.offload to 0, reboot, and report it.

Does it work on IPQ60xx?

The images build and boot the same drivers, but the maintainer has no IPQ60xx board, so nothing on IPQ60xx is tested here. Reports with logs are welcome; see Reporting Bugs.

Can this go into OpenWrt?

The PPE offload has no proprietary parts. It is proposed in openwrt/openwrt#24806. The Wi-Fi offload needs the NSS firmware, which has its own license, so it stays in this tree.

Clone this wiki locally