在锐捷 M520 上把 NSS 硬件加速移植进 ImmortalWrt:一次从源码到真机验证的记录

举报
yd_230687875 发表于 2026/11/17 19:42:08 2026/11/17
【摘要】 一、为什么要在 M520 上做 NSSM520(锐捷 RG-MT-Fi-M520)跑 ImmortalWrt 时,NAT、QoS 这些转发路径如果全走 CPU,吞吐很容易先撞上 CPU 瓶颈。Qualcomm NSS(Network Subsystem)就是为这事存在的硬件加速:把一部分转发、ECM 连接管理、GMAC 收发从 CPU 上卸下来。对这台机器来说,做 NSS 不是为了跑分好看...

一、为什么要在 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 是加进去的,不是换一棵树。

三、移植到底改了什么

核心改动分四块:

  1. 包:引入 package/qca-nss(9 个子包)和 package/kernel/qca-nss-dp,以及全部 77 个 990-* 内核补丁。
  2. 设备树:M520 的 DTS 里 mdio 段按 swconfig 重写,phy0 用 ar8327-initvals 标准集加 phy4,DSA 的 switch@10 节点去掉。
  3. 内核配置:config-6.12 增加 5 行,主要是 SWCONFIG、SWCONFIG_LEDS、AR8216_PHY、REGULATOR_NSS_VOLT 相关选择。
  4. 固件配置:.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 移植本身没有魔法,工作量集中在三处:选对基线树、把补丁和包原样搬进来并逐个验哈希、每次改配置后逐项复查。真机验证通过之后,剩下的收尾工作反而是交付和刷机环境的清理——这些不写进构建脚本,但一样决定用户手里那台机器能不能正常用。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。