|
|
爱科技、爱创意、爱折腾、爱极致,我们都是技术控
您需要 登录 才可以下载或查看,没有账号?立即注册
x
全文2099字|阅读约6分钟副标题:群晖DS213+自编驱动适配USB 2.5G网卡,踩坑复盘
背景介绍我手上有一台群晖DS213+,2013年发售的老机器,一直稳定服役,舍不得换掉。想给它升级网速,在原生千兆网口之外,加装一块USB转接的2.5G网卡,选了便宜的Realtek RTL8156B,三十多块钱,铝合金外壳,性价比很高。直接插到机器USB3口上,但是完全识别不到。
排查之后才找到根因:这台NAS跑的DSM 6.2.4,内核是古老的Linux 2.6.32.12,系统原生没有RTL8156B网卡驱动。更麻烦的是DS213+是PowerPC QorIQ架构,属于非常小众的平台。瑞昱官方开源驱动、群晖官方SPK安装包,全都没有适配这个架构,等于没人做过,网上资料极少。当时差点打算放弃。
我不想单纯为了2.5G网速,直接换新NAS,于是决定自己动手,做一场硬件“考古”:给十几年前的老内核,移植适配新硬件驱动,跨版本内核API改动巨大,难度很高。
首先收集编译资源:
- 群晖官方编译工具链,藏在SourceForge,下载很折腾,换了三个站点才拿到;
- 群晖GPL内核源码,官方归档页面是空壳,最后从global.synologydownload.com拿到200多MB的linux-2.6.32.txz源码包。
驱动版本选择:驱动不是越新越好RTL8152B驱动最新版本是2.22,我最后选了2021年的2.15版本。原因:新版驱动面向新版Linux内核API,老内核跑不了。一个很反直觉的经验:硬件驱动,不是版本越新越强,和你当前系统环境匹配才最重要。
正式编译,一路接连踩坑:
- 头文件变更:新版头文件叫linux/atomic.h,老内核是asm/atomic.h,名字变了,功能一致,写三行代码做转发兼容;
- 缺少常量:驱动判断网卡模式需要的常量,老内核没有,手动补齐;
- 缺少内核函数:用来判断任务是否在队列的函数,老内核不存在,这个功能逻辑简单,自己写代码实现;三处改动加起来不到20行代码,但缺任意一处,编译都会失败。
最特殊的PowerPC专属报错编译到99%的时候链接报错,提示缺少crtsavres.o。只玩x86、ARM架构的人基本碰不到这个问题:PowerPC架构有特殊规则,函数内寄存器太多时,编译器不会自己处理,要调用这个外部辅助文件。靠着DeepSeek协助定位,单独编译出这个8KB左右的文件,再继续链接,顺利通过。
到insmod加载驱动验证的那一刻特别紧张,要么网卡成功识别,要么直接失败。最终日志输出:eth1: v2.15.0eth1: chip rev 14eth1: carrier onDSM里成功识别出eth1网口,速率显示2500M/s!一台2013年的老NAS,靠USB转接跑通2.5G,初步成功。
打包SPK套件,又遇到两个大坑目标:把驱动打包成群晖标准SPK套件,可以在套件中心安装、开机自动加载。第一个坑:安装报错error 261。排查后排除签名、权限问题,根源是套件信息文件缺少MD5校验字段,补上校验值之后,安装成功。第二个坑:开机不会自动加载驱动。原因:系统启动阶段,USB设备还没枚举完成,驱动加载时机太早。简单粗暴的解决办法:启动脚本里延时30秒,等USB硬件就绪之后,再加载驱动内核模块,解决自启问题。
套件打包完成,在群晖套件中心里,看到自己编译制作的驱动包,署名也设置好了,成就感很强。套件可以正常开机自启,配置稳定。
测速与瓶颈分析简单测速,千兆环境下跑到100.7MB/s。2.5G交换机还没到货,暂时只能跑千兆。我开始思考瓶颈:这台机器的限制,可能并不只是千兆网口。它的CPU是1GHz双核,搭配两块机械硬盘做RAID1,机械盘本身也有速度上限。等2.5G交换机到位之后,再做完整测试。
编译环境与AI协作方式编译环境:一台Linux VPS,全程 Hermes + DeepSeek(deepseek-v4.1-flash)AI承担的工作:查阅文档、判断修改优先级、写兼容补丁代码。但是风险评估、要不要做这件事,全部由我自己判断。整套工作耗时两个多小时。体验下来,现在AI能力进步很大,冷门硬件定制驱动,不再是遥不可及的事情。
本次用到的资源清单:
- SourceForge dsgpl项目:群晖工具链 + GPL源码
- GitHub bb-qq/r8152:网卡驱动本体,长期维护
- 群晖官方CPU代号查询页
- 语雀中文教程:套件法安装驱动,踩坑记录很详细
记录一下,积累经验
|
|