qualcommax: ipq807x: add support for Zyxel NWA210AX
authorEric Schäfer <[email protected]>
Tue, 12 Aug 2025 18:47:28 +0000 (18:47 +0000)
committerRobert Marko <[email protected]>
Mon, 1 Dec 2025 13:30:27 +0000 (14:30 +0100)
commit401c0a03f13de816e1a5998e69bff82057b489d6
tree964f33191b5c939de06129c7f3f029528578fbda
parentbda163eb7c0c8e3f97302c222f32ea3062075b31
qualcommax: ipq807x: add support for Zyxel NWA210AX

The Zyxel NWA210AX is a wall- and ceiling-mountable access point (AP).

Hardware specifications:
- SoC: Qualcomm IPQ8071A
- RAM: 1 GB (Samsung K4A8G165WC-BCTD)
- Flash: 8 MB (Winbond W25Q64DW), 256 MB (Winbond W29N02GZ)
- Ethernet: 1x 2.5 Gbps RJ45 port (QCA8081), 1x 1 Gbps RJ45 port (AR8033)
- WiFi: 2.4 GHz 802.11ax/b/g/n (QCN5024), 5 GHz 802.11 ac/ax/n (QCN5054)
- Power: DC 12V/PoE 802.3at
- Button: Reset
- LEDs: Multicolour red/green/blue/white via LP5562

Installation/flashing instructions:
1. In OEM web interface navigate to gear icon → System → SSH and enable SSH.
2. Log in via SSH (username/password are the same as for the web interface).
3. Run "debug dual-image show".
4. Verify that output is "Current Image num: 1".
5. If this is not the case (i.e. if the output is "Current Image num: 0"):
   a. Either flash a fresh version of factory firmware, or
   b. run "debug dual-image set boot-image image1" and then run "reboot".
6. Log in via SSH again and verify that output is "Current Image num: 1".
7. Rename "openwrt-qualcommax-ipq807x-zyxel_nwa210ax-squashfs-factory.bin" to
   "openwrt.bin" to avoid upload errors in the OEM web interface.
8. Reopen OEM web interface, navigate to wrench icon → File Manager →
   Firmware Package and upload the bin file. Once the upgrade process is
   finished and OpenWrt has booted, the LED will light up green.

Switching between OpenWrt and OEM firmware:
- OpenWrt → Zyxel via ssh command "zyxel-bootconfig-ipq807x set image1".
- Zyxel → OpenWrt via ssh command "debug dual-image set boot-image image0".

This commit is based on the work of Pascal Beleiu  <[email protected]>:
93ca21f3 (qualcommax: ipq807x: add support for Zyxel NWA210AX, 2025-03-17)

Signed-off-by: Eric Schäfer <[email protected]>
Link: https://github.com/openwrt/openwrt/pull/19828
Signed-off-by: Robert Marko <[email protected]>
package/boot/uboot-tools/uboot-envtools/files/qualcommax_ipq807x
package/firmware/ipq-wifi/Makefile
package/utils/zyxel-bootconfig-ipq807x/Makefile [new file with mode: 0644]
package/utils/zyxel-bootconfig-ipq807x/files/95_apply_bootconfig [new file with mode: 0644]
package/utils/zyxel-bootconfig-ipq807x/files/zyxel-bootconfig-ipq807x [new file with mode: 0755]
target/linux/qualcommax/config-6.12
target/linux/qualcommax/files/arch/arm64/boot/dts/qcom/ipq8071-nwa210ax.dts [new file with mode: 0644]
target/linux/qualcommax/image/ipq807x.mk
target/linux/qualcommax/ipq807x/base-files/etc/board.d/02_network
target/linux/qualcommax/ipq807x/base-files/etc/hotplug.d/firmware/11-ath11k-caldata
target/linux/qualcommax/ipq807x/base-files/lib/upgrade/platform.sh