1. 写号这件事到底在写什么第一次接触瑞芯微平台的人听到“写号”这个词大概率会愣一下。写号不是写代码也不是烧固件它干的事情更底层——把一串设备唯一的信息比如序列号、MAC地址、蓝牙地址、厂商ID这些东西写进芯片或存储的特定区域。你可以把它理解成给每一台出厂设备发一张身份证这张身份证在产线上批量生成、批量写入写完之后设备才算真正“有名有姓”。RKDevInfoWriteTool 就是瑞芯微官方提供的一个专门干这件事的PC端工具。它跑在Windows上通过USB连接处于Loader模式或者Maskrom模式的设备把预先准备好的号段数据写进去。和完整的固件烧录工具相比它更轻、更快、更专注产线上一个工位一天写几千台设备是常态。这篇文章适合谁看如果你是第一次拿到瑞芯微的开发板或者在做小批量试产需要给设备写入SN和MAC那这篇内容基本能覆盖你从下载工具到成功写号的全过程。如果你已经在用jflash、esptool这类工具烧其他芯片想了解瑞芯微这套写号逻辑有什么不同也能在这里找到对照。我会把每一步的操作意图、参数含义、容易踩的坑都讲清楚尽量做到你照着做就能跑通。需要提前说明的是写号操作本身有一定的不可逆性写错了可能要整片擦除重来所以每一步我都会强调“先确认再执行”。另外不同芯片型号比如RK3568、RV1106、RK3588在细节上会有差异我会以通用流程为主遇到型号差异的地方单独标注。2. 工具获取与环境准备2.1 工具从哪来版本怎么选RKDevInfoWriteTool 不在公开的应用商店里它的正规获取渠道是瑞芯微官方的开发者资源区。通常你拿到开发板或者进入量产阶段时FAE或者代理商会给到你一个工具包里面包含写号工具、驱动、以及一个示例的号段文件。如果你手上没有可以找你的供应商要这是最稳妥的方式。版本选择上有一个原则工具版本要和你芯片平台的SDK版本大致匹配。比如你在做RK3568的项目SDK是比较新的那就用较新的写号工具如果用的是老平台反而要用老版本工具新工具可能不认老芯片的Loader协议。我遇到过用新版工具连RV1106死活进不去Loader的情况换回配套版本就正常了这种问题排查起来很费时间不如一开始就配对。工具包解压后一般长这样RKDevInfoWriteTool.exe主程序DriverAssitant驱动安装目录config或template目录放号段模板可能还有一个doc目录放说明文档注意不要从不明来源下载写号工具这类工具直接操作设备底层存储来路不明的版本可能带恶意代码或者写坏分区。2.2 驱动安装这一步别偷懒瑞芯微设备在Loader模式下通过USB识别Windows需要装专门的驱动。工具包里通常带DriverInstall.exe或者DriverAssitant_v5.x这样的目录。安装的时候建议右键以管理员身份运行装完之后在设备管理器里应该能看到类似“Rockusb Device”或者“RK3xxx Device”的条目。如果你之前装过其他瑞芯微工具的驱动可能会有冲突。判断方法很简单设备进入Loader模式后看设备管理器里有没有黄色感叹号或者设备名称是不是带问号。有异常就先把旧驱动卸载干净再装新的。驱动装不好的典型症状是工具能打开但设备列表里一直空白点“搜索设备”也没反应。这时候别急着怀疑工具九成是驱动问题。可以试试换USB口、换线尤其是别用那种只能充电的劣质线。2.3 硬件连接与模式进入写号需要设备进入Loader模式或者Maskrom模式。两者的区别在于Loader模式设备里已经有可运行的Loader工具通过它来读写。进入方式通常是按住设备上的某个按键比如Recovery键或者Maskrom键再上电或者在上电后通过串口输入命令切换。Maskrom模式设备里没有可运行的Loader芯片直接进入USB下载状态。这通常是在设备变砖或者首次烧录时使用。对于写号来说Loader模式就够用了速度也更快。进入Loader模式的通用操作是设备断电按住Loader键有些板子上标的是Recovery或者直接是Maskrom然后插入USB线到PC松开按键。这时候工具里点“搜索设备”应该能看到设备出现。不同板子的按键位置和名称不一样RK3568的开发板通常有一个独立的Maskrom按键RV1106的板子可能要靠短接某个测试点。这个一定要看你手上板子的原理图或者用户手册别凭感觉按。3. 号段文件与参数配置3.1 号段文件长什么样写号工具的核心输入是一个号段文件通常是一个文本文件或者CSV文件。里面定义了每个字段的名称、起始值、步进、长度、写入地址等信息。一个典型的号段文件内容大概是这样SN,0x00000001,1,16,0x0000 MAC,0x001122330001,1,6,0x1000 BT,0x001122330001,1,6,0x1006每一列的含义需要对照工具的说明来理解但大体上是字段名、起始值、步进值、字节长度、在存储中的偏移地址。步进值决定了每写一台设备这个字段自动加多少。比如SN从1开始步进1那第一台是1第二台是2以此类推。MAC地址的步进通常是1但要注意MAC地址是6字节写的时候要保证不溢出、不重复。有些工具支持从起始MAC自动递增你只需要给一个起始值就行。提示号段文件里的地址偏移一定要和你的分区表对应上写错地址可能覆盖到其他重要数据导致设备无法启动。3.2 参数配置里的几个关键项打开写号工具后一般需要配置这几项存储类型eMMC、SPI NAND、SPI NOR等。这个必须选对选错了工具可能找不到对应的存储区域。分区或偏移有些工具让你直接填偏移地址有些让你选分区。选分区的方式更安全因为分区表是设备里已经定义好的。写入模式单次写入还是连续写入。产线上通常用连续写入写一台自动跳到下一组号。校验选项写完是否回读校验。建议开启虽然慢一点但能确保写进去的数据是对的。我个人的习惯是第一次调试的时候把所有能开的校验都打开确认流程跑通之后再根据产线节拍决定要不要关掉部分校验来提速。3.3 号段数据的准备与校验在批量写号之前号段数据的正确性必须反复确认。我见过因为起始MAC写错一位导致整批设备MAC地址冲突的事故返工成本极高。校验的方法有几个先用少量设备试写写完后用工具回读或者用系统命令查看写入结果。用脚本模拟号段生成过程检查是否有重复、溢出、格式错误。如果号段文件是别人给的一定要自己抽查几组数据别直接上产线。号段文件建议用UTF-8无BOM格式保存有些工具对文件编码敏感带BOM头可能导致解析失败。4. 写号全流程实操4.1 从搜索设备到写入完成整个写号流程可以拆成下面这几步我按实际操作顺序来说打开工具加载号段文件。在工具界面里找到“加载”或者“导入”按钮选择你准备好的号段文件。加载成功后界面通常会显示第一组待写入的数据。配置存储参数。根据你的设备类型选择eMMC或SPI NAND选择对应的分区或填写偏移地址。设备进入Loader模式并连接。按前面说的方法让设备进入Loader模式工具里点“搜索设备”。设备出现后通常会显示芯片型号和存储信息。点击“写入”或“开始”。工具会把当前号段数据写入设备写入过程中不要拔线、不要断电。等待写入完成并校验。写入完成后工具会提示成功如果开了校验会多花几秒做回读比对。断开设备写下一台。如果是连续写入模式工具会自动加载下一组号你只需要换设备、重新进入Loader模式、再点写入。整个过程熟练之后一台设备从连接到写完大概十几秒到几十秒取决于存储类型和校验选项。4.2 写入过程中的状态判断工具界面上一般会有进度条和日志输出。写入过程中要关注几个信号进度条是否正常前进。如果卡在某个百分比不动可能是通信中断或者存储坏块。日志里有没有报错。常见的错误包括“设备未响应”、“写入失败”、“校验不匹配”等。设备端的指示灯如果有是否有变化。有些板子写入时会闪灯或者变灯。如果写入中途失败不要直接拔线先看工具能不能重试。有些工具支持断点续写但写号这种操作建议还是整片重写避免数据不一致。4.3 写完之后怎么验证写完之后验证是必不可少的一步。验证方法有几种工具回读用写号工具的回读功能把刚写进去的数据读出来比对。系统内查看设备启动后在系统里用命令查看SN和MAC。比如Linux下可以用cat /proc/cmdline看序列号相关的参数或者用ifconfig看MAC地址。扫码核对产线上通常会在设备外壳贴SN标签写完后扫标签和系统里读出来的SN比对确保一致。我一般会建议在产线首件的时候做完整验证批量过程中做抽检。如果发现某台设备写号异常要立刻停下来排查别抱着“可能是个例”的心态继续写。5. 常见问题与排查技巧5.1 设备搜不到怎么办这是最高频的问题。排查顺序建议这样确认驱动设备管理器里有没有识别到Rockusb设备有没有黄色感叹号。确认模式设备是不是真的进了Loader模式。可以看设备上的指示灯或者用串口工具看有没有输出Loader相关的日志。换线换口USB线要选数据线别用充电线。USB口优先选主板后置的别用前面板或者Hub。工具版本换一个版本的写号工具试试有时候就是版本不兼容。5.2 写入失败或校验不通过写入失败的原因比较多常见的有现象可能原因处理方式写入到一半失败USB通信不稳定换线换口降低写入速度校验不匹配存储坏块或写入参数错误检查偏移地址尝试整片擦除后重写提示分区不存在分区表不匹配确认设备的分区表和工具配置一致写入后设备无法启动写到了错误区域回读确认写入位置必要时重刷完整固件校验不通过的时候不要反复重试同一个位置先确认参数对不对。如果参数没问题可能是存储本身有问题换一台设备试试。5.3 批量写号时的效率技巧产线上效率很重要几个实用技巧用连续写入模式减少每台设备的手动操作。如果设备支持自动进入Loader模式比如通过USB插拔触发可以省掉按键操作。把校验选项根据实际情况调整首件全校验批量抽检。准备一个写号工装把USB线和按键固定好减少每次插拔的麻烦。注意提速的前提是数据准确不要为了赶产量牺牲校验环节写错号的返工成本远高于多花的那几秒。5.4 不同芯片平台的差异点RK3568、RV1106、RK3588这些平台在写号上的主要差异在于Loader协议版本新平台可能用新的协议老工具不认。存储类型有些平台只支持eMMC有些支持SPI NAND工具里的选项要对应。分区定义不同SDK的分区表不一样偏移地址不能照搬。进入Loader的方式按键位置、短接点、串口命令都可能不同。我的建议是每换一个平台都重新走一遍完整的调试流程别想着把上一个平台的配置直接复制过来用。6. 一些实操心得写号这个操作技术门槛不算高但细节特别多。我踩过的坑里最典型的是号段文件编码问题——有一次用Excel编辑完保存成CSV工具死活加载不了后来发现是Excel默认加了BOM头换成纯文本编辑器保存就好了。还有一次是MAC地址步进设成了2导致一半的地址被跳过虽然不影响功能但地址空间利用率低了后来改成步进1才符合规范。另一个体会是写号工具的日志一定要看。很多人只看进度条进度条走完了就以为成功了其实日志里可能有警告信息。比如“校验跳过”这种提示如果你没注意可能就漏掉了校验环节。最后说一个产线管理的经验写号工位最好配一个简单的记录表记录每台设备的SN和写入时间。万一后面发现某台设备号有问题能快速定位是哪一批、哪个时间段写的方便追溯。这个习惯在小批量试产的时候可能觉得多余但一旦上量没有记录会非常被动。写号工具本身不复杂复杂的是围绕它的流程管理和细节把控。把号段文件管好、把驱动装好、把校验做扎实基本就不会出大问题。 瑞芯微RKDevInfoWriteTool写号工具使用教程：从环境准备到批量写入全流程
1. 写号这件事到底在写什么第一次接触瑞芯微平台的人听到“写号”这个词大概率会愣一下。写号不是写代码也不是烧固件它干的事情更底层——把一串设备唯一的信息比如序列号、MAC地址、蓝牙地址、厂商ID这些东西写进芯片或存储的特定区域。你可以把它理解成给每一台出厂设备发一张身份证这张身份证在产线上批量生成、批量写入写完之后设备才算真正“有名有姓”。RKDevInfoWriteTool 就是瑞芯微官方提供的一个专门干这件事的PC端工具。它跑在Windows上通过USB连接处于Loader模式或者Maskrom模式的设备把预先准备好的号段数据写进去。和完整的固件烧录工具相比它更轻、更快、更专注产线上一个工位一天写几千台设备是常态。这篇文章适合谁看如果你是第一次拿到瑞芯微的开发板或者在做小批量试产需要给设备写入SN和MAC那这篇内容基本能覆盖你从下载工具到成功写号的全过程。如果你已经在用jflash、esptool这类工具烧其他芯片想了解瑞芯微这套写号逻辑有什么不同也能在这里找到对照。我会把每一步的操作意图、参数含义、容易踩的坑都讲清楚尽量做到你照着做就能跑通。需要提前说明的是写号操作本身有一定的不可逆性写错了可能要整片擦除重来所以每一步我都会强调“先确认再执行”。另外不同芯片型号比如RK3568、RV1106、RK3588在细节上会有差异我会以通用流程为主遇到型号差异的地方单独标注。2. 工具获取与环境准备2.1 工具从哪来版本怎么选RKDevInfoWriteTool 不在公开的应用商店里它的正规获取渠道是瑞芯微官方的开发者资源区。通常你拿到开发板或者进入量产阶段时FAE或者代理商会给到你一个工具包里面包含写号工具、驱动、以及一个示例的号段文件。如果你手上没有可以找你的供应商要这是最稳妥的方式。版本选择上有一个原则工具版本要和你芯片平台的SDK版本大致匹配。比如你在做RK3568的项目SDK是比较新的那就用较新的写号工具如果用的是老平台反而要用老版本工具新工具可能不认老芯片的Loader协议。我遇到过用新版工具连RV1106死活进不去Loader的情况换回配套版本就正常了这种问题排查起来很费时间不如一开始就配对。工具包解压后一般长这样RKDevInfoWriteTool.exe主程序DriverAssitant驱动安装目录config或template目录放号段模板可能还有一个doc目录放说明文档注意不要从不明来源下载写号工具这类工具直接操作设备底层存储来路不明的版本可能带恶意代码或者写坏分区。2.2 驱动安装这一步别偷懒瑞芯微设备在Loader模式下通过USB识别Windows需要装专门的驱动。工具包里通常带DriverInstall.exe或者DriverAssitant_v5.x这样的目录。安装的时候建议右键以管理员身份运行装完之后在设备管理器里应该能看到类似“Rockusb Device”或者“RK3xxx Device”的条目。如果你之前装过其他瑞芯微工具的驱动可能会有冲突。判断方法很简单设备进入Loader模式后看设备管理器里有没有黄色感叹号或者设备名称是不是带问号。有异常就先把旧驱动卸载干净再装新的。驱动装不好的典型症状是工具能打开但设备列表里一直空白点“搜索设备”也没反应。这时候别急着怀疑工具九成是驱动问题。可以试试换USB口、换线尤其是别用那种只能充电的劣质线。2.3 硬件连接与模式进入写号需要设备进入Loader模式或者Maskrom模式。两者的区别在于Loader模式设备里已经有可运行的Loader工具通过它来读写。进入方式通常是按住设备上的某个按键比如Recovery键或者Maskrom键再上电或者在上电后通过串口输入命令切换。Maskrom模式设备里没有可运行的Loader芯片直接进入USB下载状态。这通常是在设备变砖或者首次烧录时使用。对于写号来说Loader模式就够用了速度也更快。进入Loader模式的通用操作是设备断电按住Loader键有些板子上标的是Recovery或者直接是Maskrom然后插入USB线到PC松开按键。这时候工具里点“搜索设备”应该能看到设备出现。不同板子的按键位置和名称不一样RK3568的开发板通常有一个独立的Maskrom按键RV1106的板子可能要靠短接某个测试点。这个一定要看你手上板子的原理图或者用户手册别凭感觉按。3. 号段文件与参数配置3.1 号段文件长什么样写号工具的核心输入是一个号段文件通常是一个文本文件或者CSV文件。里面定义了每个字段的名称、起始值、步进、长度、写入地址等信息。一个典型的号段文件内容大概是这样SN,0x00000001,1,16,0x0000 MAC,0x001122330001,1,6,0x1000 BT,0x001122330001,1,6,0x1006每一列的含义需要对照工具的说明来理解但大体上是字段名、起始值、步进值、字节长度、在存储中的偏移地址。步进值决定了每写一台设备这个字段自动加多少。比如SN从1开始步进1那第一台是1第二台是2以此类推。MAC地址的步进通常是1但要注意MAC地址是6字节写的时候要保证不溢出、不重复。有些工具支持从起始MAC自动递增你只需要给一个起始值就行。提示号段文件里的地址偏移一定要和你的分区表对应上写错地址可能覆盖到其他重要数据导致设备无法启动。3.2 参数配置里的几个关键项打开写号工具后一般需要配置这几项存储类型eMMC、SPI NAND、SPI NOR等。这个必须选对选错了工具可能找不到对应的存储区域。分区或偏移有些工具让你直接填偏移地址有些让你选分区。选分区的方式更安全因为分区表是设备里已经定义好的。写入模式单次写入还是连续写入。产线上通常用连续写入写一台自动跳到下一组号。校验选项写完是否回读校验。建议开启虽然慢一点但能确保写进去的数据是对的。我个人的习惯是第一次调试的时候把所有能开的校验都打开确认流程跑通之后再根据产线节拍决定要不要关掉部分校验来提速。3.3 号段数据的准备与校验在批量写号之前号段数据的正确性必须反复确认。我见过因为起始MAC写错一位导致整批设备MAC地址冲突的事故返工成本极高。校验的方法有几个先用少量设备试写写完后用工具回读或者用系统命令查看写入结果。用脚本模拟号段生成过程检查是否有重复、溢出、格式错误。如果号段文件是别人给的一定要自己抽查几组数据别直接上产线。号段文件建议用UTF-8无BOM格式保存有些工具对文件编码敏感带BOM头可能导致解析失败。4. 写号全流程实操4.1 从搜索设备到写入完成整个写号流程可以拆成下面这几步我按实际操作顺序来说打开工具加载号段文件。在工具界面里找到“加载”或者“导入”按钮选择你准备好的号段文件。加载成功后界面通常会显示第一组待写入的数据。配置存储参数。根据你的设备类型选择eMMC或SPI NAND选择对应的分区或填写偏移地址。设备进入Loader模式并连接。按前面说的方法让设备进入Loader模式工具里点“搜索设备”。设备出现后通常会显示芯片型号和存储信息。点击“写入”或“开始”。工具会把当前号段数据写入设备写入过程中不要拔线、不要断电。等待写入完成并校验。写入完成后工具会提示成功如果开了校验会多花几秒做回读比对。断开设备写下一台。如果是连续写入模式工具会自动加载下一组号你只需要换设备、重新进入Loader模式、再点写入。整个过程熟练之后一台设备从连接到写完大概十几秒到几十秒取决于存储类型和校验选项。4.2 写入过程中的状态判断工具界面上一般会有进度条和日志输出。写入过程中要关注几个信号进度条是否正常前进。如果卡在某个百分比不动可能是通信中断或者存储坏块。日志里有没有报错。常见的错误包括“设备未响应”、“写入失败”、“校验不匹配”等。设备端的指示灯如果有是否有变化。有些板子写入时会闪灯或者变灯。如果写入中途失败不要直接拔线先看工具能不能重试。有些工具支持断点续写但写号这种操作建议还是整片重写避免数据不一致。4.3 写完之后怎么验证写完之后验证是必不可少的一步。验证方法有几种工具回读用写号工具的回读功能把刚写进去的数据读出来比对。系统内查看设备启动后在系统里用命令查看SN和MAC。比如Linux下可以用cat /proc/cmdline看序列号相关的参数或者用ifconfig看MAC地址。扫码核对产线上通常会在设备外壳贴SN标签写完后扫标签和系统里读出来的SN比对确保一致。我一般会建议在产线首件的时候做完整验证批量过程中做抽检。如果发现某台设备写号异常要立刻停下来排查别抱着“可能是个例”的心态继续写。5. 常见问题与排查技巧5.1 设备搜不到怎么办这是最高频的问题。排查顺序建议这样确认驱动设备管理器里有没有识别到Rockusb设备有没有黄色感叹号。确认模式设备是不是真的进了Loader模式。可以看设备上的指示灯或者用串口工具看有没有输出Loader相关的日志。换线换口USB线要选数据线别用充电线。USB口优先选主板后置的别用前面板或者Hub。工具版本换一个版本的写号工具试试有时候就是版本不兼容。5.2 写入失败或校验不通过写入失败的原因比较多常见的有现象可能原因处理方式写入到一半失败USB通信不稳定换线换口降低写入速度校验不匹配存储坏块或写入参数错误检查偏移地址尝试整片擦除后重写提示分区不存在分区表不匹配确认设备的分区表和工具配置一致写入后设备无法启动写到了错误区域回读确认写入位置必要时重刷完整固件校验不通过的时候不要反复重试同一个位置先确认参数对不对。如果参数没问题可能是存储本身有问题换一台设备试试。5.3 批量写号时的效率技巧产线上效率很重要几个实用技巧用连续写入模式减少每台设备的手动操作。如果设备支持自动进入Loader模式比如通过USB插拔触发可以省掉按键操作。把校验选项根据实际情况调整首件全校验批量抽检。准备一个写号工装把USB线和按键固定好减少每次插拔的麻烦。注意提速的前提是数据准确不要为了赶产量牺牲校验环节写错号的返工成本远高于多花的那几秒。5.4 不同芯片平台的差异点RK3568、RV1106、RK3588这些平台在写号上的主要差异在于Loader协议版本新平台可能用新的协议老工具不认。存储类型有些平台只支持eMMC有些支持SPI NAND工具里的选项要对应。分区定义不同SDK的分区表不一样偏移地址不能照搬。进入Loader的方式按键位置、短接点、串口命令都可能不同。我的建议是每换一个平台都重新走一遍完整的调试流程别想着把上一个平台的配置直接复制过来用。6. 一些实操心得写号这个操作技术门槛不算高但细节特别多。我踩过的坑里最典型的是号段文件编码问题——有一次用Excel编辑完保存成CSV工具死活加载不了后来发现是Excel默认加了BOM头换成纯文本编辑器保存就好了。还有一次是MAC地址步进设成了2导致一半的地址被跳过虽然不影响功能但地址空间利用率低了后来改成步进1才符合规范。另一个体会是写号工具的日志一定要看。很多人只看进度条进度条走完了就以为成功了其实日志里可能有警告信息。比如“校验跳过”这种提示如果你没注意可能就漏掉了校验环节。最后说一个产线管理的经验写号工位最好配一个简单的记录表记录每台设备的SN和写入时间。万一后面发现某台设备号有问题能快速定位是哪一批、哪个时间段写的方便追溯。这个习惯在小批量试产的时候可能觉得多余但一旦上量没有记录会非常被动。写号工具本身不复杂复杂的是围绕它的流程管理和细节把控。把号段文件管好、把驱动装好、把校验做扎实基本就不会出大问题。