最近在调RV1126B的SDK移植从DDR配置一路折腾到USB调试整个过程踩了不少坑也把整个启动链路从底层到应用层摸了一遍。这篇文章就围绕这次移植实战展开把DDR参数怎么定、SDK怎么改、USB调试口怎么从零配出来这些关键环节拆开讲清楚适合正在搞瑞芯微平台、或者刚拿到新板子准备做系统移植的嵌入式开发朋友参考。RV1126B这颗芯片主打IPC和AI视觉方向双核A7加上RISC-V协处理器拿来做摄像头、门锁、边缘盒子之类的产品很常见。SDK移植本身并不只是把代码拉下来编译一把就能跑真正的难点在于适配板子的硬件差异尤其是DDR初始化、设备树裁剪、外设驱动加载这几个环节。下面从整体思路上开始拆解。1. 移植前需要想清楚的事SDK选择与整体启动链路1.1 RV1126B SDK里到底装了什么瑞芯微的SDK是一个包含完整系统方案的代码仓库拿RV1126B来说核心目录大致有U-Boot、Kernel、Buildroot、external、rkbin、tools这几块。U-Boot负责引导Kernel负责驱动和系统调用Buildroot负责用户态根文件系统external里面是瑞芯微自己的多媒体和ISP相关库rkbin存放着DDR初始化二进制和ATF固件tools里是烧录、打包、调试用的PC端工具。第一次拿到SDK的人很容易被这些目录搞晕但其实理解每个模块的作用之后整个移植路径就清晰了先让DDR和时钟初始化跑通U-Boot能起来再去调内核和设备树最后才是文件系统和外设功能。很多人移植失败往往是因为没弄明白“现在卡在哪一层”一上来就改内核结果板子连DDR都没过去。1.2 一次完整移植要过哪几关从板上电到系统能登录实际要经过ROM代码、DDR初始化、U-Boot、内核、根文件系统这几个阶段。ROM代码是芯片出厂固化好的我们不用动DDR初始化由rkbin里的DDR bin完成U-Boot负责加载内核和设备树内核启动后再挂载根文件系统。对应到SDK移植上大致就是四件事适配DDR参数、修改板级配置和设备树、裁剪内核驱动、制作根文件系统。这次移植的核心堵点就集中在两个地方——DDR初始化和USB调试前者决定板子能不能从“死机”变成“活着”后者决定你后续调试效率能有多高。所以我把这两个部分单独展开讲。2. DDR配置实操内存颗粒决定你起不起得来2.1 DDR3 1GB方案怎么选颗粒现在很多RV1126B的产品为了控成本走的都是DDR3 1GB方案。市面上的DDR3颗粒型号五花八门但选择时主要看几个硬指标单片容量、位宽、速度等级、温度等级。RV1126B的DDR控制器支持16bit和32bit总线配置常见的1GB方案有两条路线一是用2颗512MB×16bit的颗粒组成32bit总线另一条是用4颗256MB×16bit的颗粒组成32bit总线具体取决于原理图怎么布线。挑选颗粒时有一点特别容易被忽略——同容量同封装的颗粒时序参数很可能不一样。比如有的颗粒标称DDR3-1600但CL、tRCD、tRP这些参数由厂家的speed grade决定直接拿去用默认配置不一定会死机但稳定性就没法保证。稳妥的做法是在PCB定版之前先到芯片原厂或瑞芯微官方支持的DDR列表里核对一下颗粒型号选已经被验证过的方案能省掉大量调试时间。2.2 DDR参数从哪里来频率、时序与容量计算DDR配置核心是三件事频率、时序、容量。频率方面RV1126B的DDR控制器一般跑在DDR3-1066或DDR3-1600对应的时钟频率是533MHz和800MHz具体跑多高取决于颗粒速度等级和PCB走线质量不必盲目追求高频稳定优先。时序参数需要从DDR颗粒的datasheet里查关键项包括CLCAS Latency、tRCD、tRP、tRFC、tRC等这些数值决定了内存控制器访问颗粒的节奏。SDK里通常有一份DDR配置头文件或dts中的频率表移植时先把颗粒手册里的时序填进去再通过DDR压力测试验证不要想当然沿用其他型号的参数。容量识别则是由行列bank和位宽共同决定的比如一颗256MB×16bit的颗粒内部组织结构大概是Row15、Col10、Bank8总线位宽配置成32bit时4颗颗粒组合出1GB空间。如果容量算错系统起来后要么只识别到一半内存要么直接崩溃。瑞芯微的U-Boot在DDR初始化时会打印一行类似下面这样的日志DDR Version 1.09 20210425 In DDR3 Bus Width32 Col10 Bank8 Row15 CS1 Die BW16 Size1024MB看到Size1024MB且和硬件实际容量一致说明DDR容量识别正常如果显示512MB或256MB就要回头检查行列配置和片选信号。2.3 把DDR配置写进SDK的完整步骤在瑞芯微SDK里DDR初始化代码并不需要自己写SDK的rkbin目录里已经编译好了二进制我们只需要告诉U-Boot“这块板子用的是哪组DDR参数”。实际操作分几步在U-Boot的board目录下新建或复制一块板级配置参考同系列EVB板在DDR配置头文件里找到颗粒参数表格把本板颗粒的时序、容量、位宽填进去确认dts中的内存节点内存大小与实际容量一致重新编译U-Boot用烧录工具把新U-Boot烧进去观察串口输出的DDR初始化日志确认频率、容量、总线位宽无误进入系统后跑DDR压力测试验证长时间稳定性。第4步编译的时候要注意瑞芯微的U-Boot编译命令通常是./make.sh rv1126b编译产物是uboot.img烧录时要连同idblock一起烧。只更新uboot.img而没更新idblock可能会导致DDR初始化还是旧参数这是新手很容易踩的坑。2.4 DDR问题排查起不来、报错、压力测试不通过DDR初始化失败的现象通常有三类。第一类是板子完全没反应串口没有任何输出这种情况大概率是DDR颗粒没有被正确初始化可能原因是rkbin里缺少该颗粒的配置或者PCB走线问题导致颗粒没被识别。第二类是U-Boot能起来但系统内存容量不对或者随机死机这种多半是行列地址配置错误、片选信号问题、以及CS1颗粒未正确配置。第三类是DDR压力测试跑不过表现为高负载下重启或报ECC错误这通常是时序太紧或者电源纹波偏大。可以整理成一张排查表现象可能原因排查手段完全没有串口输出rkbin配置缺失、DDR颗粒未被识别检查颗粒型号是否在支持列表用示波器看DDR时钟U-Boot起来但内存容量不对行列地址、片选、总线位宽配置错误核对dts与U-Boot DDR配置检查CS引脚连接运行时随机死机/重启时序参数过紧、供电不足、走线质量差降频测试核对颗粒手册时序用稳压电源观察纹波高负载崩溃或报ECC错误tRFC/tRC等参数异常、散热不够适当放宽时序参数加强散热换颗粒验证我自己这次遇到的坑是DDR容量显示只有512MB排查到最后发现是原理图上CS1的地址线被接到了NC但软件里没有关掉第二个片选导致初始化时多访问了不存在的颗粒把CS配置改掉后问题消失。所以DDR配置出问题时不要只盯着软件参数先对着原理图确认硬件连接再看软件的配置是否和硬件一致。3. 内核、设备树与sensor移植3.1 设备树裁剪不是谁的板子都能直接跑DDR起来之后接下来就是内核启动。RV1126B的SDK默认支持自家的EVB板如果你的板子跟EVB不完全一样设备树必须改否则很可能出现串口没输出、网口不通、USB不识别等各种“看起来正常但就是不对”的问题。设备树里需要重点关注的节点有内存节点memory、调试串口uart、以太网gmac、USB PHY、SD/MMC控制器、I2C外设、sensor节点和相关的pinctrl。比如串口调试口如果原理图上用的是UART2设备树里就要确认uart2节点状态为okay同时引脚复用要选对否则串口只会出乱码。有个经验值很值得分享拿到一块新板子先把SDK自带的EVB设备树复制一份然后对照原理图把差异点逐项修改每改完一项就编译烧录验证一次。不要一次性改几十个节点不然出问题根本定位不到是哪里引起的。改设备树用的是dts/dtsi文件编译是在内核目录下make dtbs然后用烧录工具把resource.img或boot.img烧进去具体看SDK分区设计。3.2 sensor移植RV1126B的核心应用场景RV1126B天生就是做视觉产品的sensor驱动移植是绕不开的环节。这次项目里用的是OV5640一颗很常见的500万像素sensor但也有用SC3336、GC2053的方案移植思路基本一致。sensor移植分三块设备树配置、内核驱动、ISP tuning文件。设备树里需要配置sensor的I2C地址、MCLK时钟频率、reset和pwdn引脚、以及MIPI CSI的lane数量和频率。比如OV5640的I2C地址一般是0x36或0x3cMCLK常用24MHz具体要以sensor手册和原理图为准。内核驱动方面SDK默认带了一批sensor驱动只要在内核配置里启用对应的CONFIG即可比如CONFIG_VIDEO_OV5640。ISP tuning文件则是瑞芯微rkaiq体系下的XML参数决定了成片效果通常放在SDK的external/aiq或类似路径下产品化阶段需要对着实际效果反复调。调试时最实用的命令是i2cdetect和v4l2-ctl。先用i2cdetect -y -r 总线号确认sensor在I2C总线上能探测到地址再查看/dev/video*节点是否正确生成最后用v4l2-ctl --list-devices确认ISP链路注册情况。如果i2cdetect检测不到地址先检查sensor供电、reset引脚电平和MCLK有没有波形这类硬件问题的比例其实很高。3.3 串口日志与启动异常排查系统起不来的问题大部分靠串口日志就能定位。RV1126B的调试串口一般是UART2波特率很特殊是1500000也就是1.5M波特率电脑端用minicom或MobaXterm配置时要选对否则看到的全是乱码。还有一个小技巧用TTL转USB模块调试时供电要干净最好用带隔离的模块否则板子功耗一大串口工具容易自己复位。如果串口卡在U-Boot阶段通常是DDR或存储介质初始化没过如果过了U-Boot但内核没起来看看是死在dtb解析、驱动probe还是控制台还没有注册如果内核起来了但进不了系统多半是根文件系统或者分区表问题。把启动分成这几个阶段来排查效率会高很多。为了调试方便我习惯在文件系统没调好之前先用initramfs启动内核或者通过NFS挂载根文件系统这样改文件系统内容不需要反复烧写Flash。4. USB调试全解析从host到device4.1 硬件先看明白板子上的USB口长什么样RV1126B的USB调试说到底就是让芯片的USB OTG口在device模式下工作让PC端能够枚举到板子。常见的板子会设计一个Micro USB或者Type-C口专用于调试也可能是USB OTG口复用具体看原理图。调试前先把硬件看明白确认这个口是不是真的连到了支持OTG的USB控制器上VBUS检测、ID检测是怎么处理的如果硬件上没有把ID脚拉对后面软件怎么配都白搭。另一个硬件细节是USB PHY的供电和参考时钟。RV1126B的USB PHY一般有独立的供电引脚还要一个24MHz晶振提供参考时钟如果时钟不对USB就会出现时好时坏、枚举不稳定这类封闭问题。用示波器测量DP/DM信号和PHY供电波形是比较直接的验证手段。4.2 加载USB gadget驱动RNDIS和ADB是怎么配出来的Linux下USB device模式的标准做法是透过configfs配置gadget。先用这个方式把RNDIS网卡配出来操作流程大致是# 挂载configfs mount -t configfs none /sys/kernel/config # 创建gadget目录 mkdir /sys/kernel/config/usb_gadget/rk1126 cd /sys/kernel/config/usb_gadget/rk1126 # 设置VID/PID0x2207是瑞芯微常用的VID echo 0x2207 idVendor echo 0x0010 idProduct # 添加字符串描述 mkdir strings/0x409 echo rockchip strings/0x409/manufacturer echo rv1126b strings/0x409/product # 创建配置 mkdir configs/c.1 # 创建RNDIS function mkdir functions/rndis.usb0 ln -s functions/rndis.usb0 configs/c.1/ # 绑定UDC控制器具体名称以/sys/class/udc下为准 echo ci_hdrc.0 UDC执行完上面的命令PC端应该能枚举出一个RNDIS网卡给板子配一个静态IP比如192.168.1.10PC端设192.168.1.2两边就能ping通这样就算有了一个“USB有线网络”后续SSH、传输文件都方便了。如果还需要ADB调试SDK的Buildroot默认可以开启adbd服务但需要确保内核开启了对应的USB gadget功能并且/system分区或者根文件系统里有adbd可执行文件和相关的dev节点权限。有一件事必须提醒上面这些操作每次重启后都会丢失。产品化的时候要把配置gadget的过程写成开机自启脚本放在/etc/init.d或者使用systemd服务来管理这样才能做到开机自动进入device模式不用每次手动敲命令。4.3 USB枚举问题速查为什么插上没反应USB调试不成功现象千奇百怪核心原因却往往很集中。下面这张表是我这次和以前项目里积累的排查经验现象可能原因排查手段PC完全没有枚举反应硬件供电/DP/DM接反/USB线是充电线换线用示波器量DP/DM检查USB PHY供电枚举成功后反复断开VBUS检测信号不稳、驱动电流不足、接触不良检查VBUS脚和ID脚改用短而粗的USB线识别为Unknown Device描述符读取失败、VID/PID冲突、USB PHY时钟异常看dmesg报错重新配置gadget描述符检查晶振RNDIS网卡不出现内核没有打开RNDIS功能、Windows缺少驱动检查内核配置在设备管理器里手动更新驱动传输大文件时断连供电不足、信号质量差、地弹影响加强供电缩短线材长度检查GND连接最常用的排查命令就是dmesg和lsusb。板子端执行dmesg | grep usb看重定向和错误PC端插拔瞬间看lsusb输出。如果PC端完全没反应优先怀疑硬件不要一上来就改软件如果在不同的PC上表现不同那多半是gadget描述符问题或者USB线材的兼容性问题。4.4 提升USB调试效率的小技巧等RNDIS或者ADB跑通之后USB调试口的作用就不只是“能连上”了而是要让整个开发流程更顺。我习惯在板子起来后自动给RNDIS网卡配置好固定IP这样每次开机直接SSH进去不用每次重新找IP、配网络。ADB的话也可以通过网络adb connect指定板子的IP来连接省去插拔USB线的麻烦。还有一个比较实用的技巧是保留一个串口调试口的同时把USB gadget做成多功能组合一个RNDIS网卡加一个ACM串口再加一个UVC摄像头。这样PC端既能通过网络访问板子又能通过虚拟串口看系统日志还能直接预览sensor图像调试体验会好很多。瑞芯微的SDK里面其实已经有这套组合的参考实现搬过来改改VID、PID和脚本路径就能用。5. 几个实测中容易踩的坑这次RV1126B移植下来有几个坑是反复出现的专门列出来说一下。5.1 SDK版本和烧录工具必须配套瑞芯微的SDK会不断更新烧录工具、U-Boot、内核可能都会跟着变。如果SDK是从旧版本升级上来的编译工具链最好也一起升级否则可能出现编译通过但运行崩溃的问题。我这次就碰到过一次SDK更新后旧的RKDevTool不识别新固件的打包格式烧录总是卡在下载阶段后来换成新版工具才解决。5.2 先让系统跑起来再调外设很多新手拿到板子喜欢上来就把所有外设节点全部配好结果系统起不来很难排查。正确做法是先用最简配置把系统跑起来串口能登录、USB能调试然后再逐个打开功能模块。这样每次只增加一个变量出了问题很容易定位。5.3 DDR参数不能只看容量DDR参数里频率和时序才是稳定性的关键容量只是冰山一角。有些颗粒虽然容量和位宽匹配但tRFC差异很大在DDR3-1600下长时间跑压力测试很容易报错这时调低频率或者放宽时序往往能快速验证是不是时序问题。DDR这块没有捷径数据手册一定要看每一行参数都要有出处。5.4 USB调试的硬件基础要先确认最后再说一次USB调试不成功的时候先怀疑硬件换USB线、换电脑、量DP/DM波形、检查PHY供电这些物理层面的排查往往比自己调半天内核配置更有效。我这次卡了两天的USB枚举问题最后发现是USB线是那种只能充电的线换了一根数据线直接就好。这次移植从DDR配置到USB调试全跑通最大的体会是SDK移植表面上看是代码的事实际上是硬件和软件交叉验证的过程每一层都有它自己的“通关条件”。先把DDR这关过了系统才算活着再把USB调试配好后面的开发效率才能上去。希望这篇能把你们要走的路提前铺平一点少踩几个我踩过的坑。