在锐捷 M520 上把 NSS 硬件加速移植进 ImmortalWrt:一次从源码到真机验证的记录
一、为什么要在 M520 上做 NSS
M520(锐捷 RG-MT-Fi-M520)跑 ImmortalWrt 时,NAT、QoS 这些转发路径如果全走 CPU,吞吐很容易先撞上 CPU 瓶颈。Qualcomm NSS(Network Subsystem)就是为这事存在的硬件加速:把一部分转发、ECM 连接管理、GMAC 收发从 CPU 上卸下来。对这台机器来说,做 NSS 不是为了跑分好看,而是想让 LAN 到 WAN 的转发不再被软转发拖住。
二、路线是怎么定的
一开始我对比了三家 NSS 来源:ACwifidude 的 nss-packages、Karin-Laboratory 的 wg2600hp 移植、APCCV 的 23.05 老树。Karin 那套最完整,但它是另一棵树的全套;APCCV 的树太老,补丁在 6.12 上基本不可用,只能参考它的 qdisc、ifb、pppoe 配置思路。
最后定的路线是:以我们自己的 ImmortalWrt-M520 树(内核 6.12.91)为基线,把 gyimesibalazs 的 NSS 集合回移植进来。理由很实际:自己的树、自己的配置和已验证过的 ath10k、LuCI、防火墙组合都不用推倒重来,NSS 是加进去的,不是换一棵树。
三、移植到底改了什么
核心改动分四块:
- 包:引入
package/qca-nss(9 个子包)和package/kernel/qca-nss-dp,以及全部 77 个990-*内核补丁。 - 设备树:M520 的 DTS 里 mdio 段按 swconfig 重写,phy0 用 ar8327-initvals 标准集加 phy4,DSA 的 switch@10 节点去掉。
- 内核配置:
config-6.12增加 5 行,主要是 SWCONFIG、SWCONFIG_LEDS、AR8216_PHY、REGULATOR_NSS_VOLT 相关选择。 - 固件配置:
.config里 NSS 相关选择换成新包,应用层包不动。
内核 prepare 在 6.12.91 上一次通过,只刷新了 3 个补丁:990-0001(只保留能对上树内 dtsi 的部分)、990-0207(一个 READ_ONCE 段)、990-0317(两处 bonding 段)。其余补丁原样通过。
四、两个差点毁掉整个构建的坑
第一个坑:源码包哈希。 有一次构建里 5 个 NSS 源码包的哈希校验被临时跳过,镜像站返回的 HTTP 200 错误页(HTML)被当成 tarball 存了下来,直到 gmac 解包失败才暴露。正确做法是每个包都从 codelinaro 按 Makefile 锁定的 commit 克隆,用 git rev-parse HEAD 逐个对上,再本地打包写回真实 sha256。跳过校验省下的几分钟,最后要用几小时还。
第二个坑:defconfig 静默丢配置。 有一次 defconfig 跑在 awk=mawk 的环境下,.config 里 =y 的包从 522 个掉到 218 个,NSS 全套、LuCI、dnsmasq-full 全被置成 not set,而当时只验了文件大小,没逐项复查符号。教训是:每次 defconfig 之后,必须逐个复查关键符号,文件大小说明不了任何问题。
这两个坑都不在 NSS 本身,而在构建流程的可信度上。固件能不能用,第一步是先证明构建过程本身没撒谎。
五、真机验证到了哪一步
精简版(SLIM3,2026-10-23 构建成功):factory 32,420,623 B,initramfs 29,360,128 B,sha256sums 全通过;rootfs 里 NSS 驱动、gmac、ecm、ifb 齐全,两块 NSS 固件 blob 的哈希与零售版实证过的一致。真机串口记录里,首次完整开机走到了 login 提示符,双频 ath10k 起来了,25 秒左右出现 “ECM init complete”——NSS 这条线在真机上是通的。
全量版(NSSBR1,作者 nss 分支,2026-10-26 构建成功,耗时 77 分钟):factory 78,805,159 B,manifest 里 NSS 全套加 passwall、sing-box 都在位,同样已发给用户待确认。
六、还没收尾的一件事
有一次刷机后卡住,查下来不是固件问题,是机上继承自出厂时代的旧 F2FS overlay:刷机不会擦掉它,合并后的上层残留文件会让 ubusd 根本没被执行。处理办法是 failsafe 进去清掉数据区、重建 F2FS 再刷。这件事的教训和上面两个坑是一样的:固件本身没问题,不等于刷机环境没问题;排障时先分清是哪一层,再动手。
七、结论
NSS 移植本身没有魔法,工作量集中在三处:选对基线树、把补丁和包原样搬进来并逐个验哈希、每次改配置后逐项复查。真机验证通过之后,剩下的收尾工作反而是交付和刷机环境的清理——这些不写进构建脚本,但一样决定用户手里那台机器能不能正常用。
- 点赞
- 收藏
- 关注作者
评论(0)