香橙派5烧写镜像全攻略：从eMMC到TF卡，为yolov5s部署铺路

烧写镜像这种事看着简单但我在香橙派5上栽过的跟头真不算少。这个系列准备从空板一路写到yolov5s跑起来第一篇就先把烧写讲透。你手上如果已经拿到香橙派5RK3588S的板子或者正打算入手这篇文章能帮你把系统从零跑起来后面部署yolov5s、调NPU、做推理这些活儿才有得玩。我尽量把流程、原理、坑位都讲清楚不用你反复翻文档。1. 为什么第一件事是镜像烧写先把整体思路捋清楚1.1 这个系列要做什么从空板到yolov5s实时推理先交代一下这个系列的整体规划你才知道现在这一步在全局里的位置。整个系列的目标是在香橙派5上把yolov5s模型跑起来而且不是那种在CPU上慢慢磨的跑法是真正用上RK3588自带的NPU做推理加速。瑞芯微官方这套工具链叫RKNN它能把PyTorch训练好的yolov5s模型转换成RKNN格式然后在NPU上执行推理。整个流程大致分这么几段系统烧写、环境配置、RKNN工具链安装、模型转换、推理代码编写、性能调优。你现在看到的这篇文章就是第一步——把底层系统烧进板子。这一步做不好后面全是空中楼阁所以我花一整篇来写它值得。很多人拿到开发板第一反应是插电看灯亮不亮但香橙派5跟树莓派不同它板载eMMC存储出厂可能不带系统或者带的系统版本太老你直接用会有各种奇怪问题。所以烧写这一步不是可选项是必选项。烧写完成之后你手里才真正拥有一块可以干活儿的Linux开发板。1.2 选香橙派5跑yolov5s的逻辑为什么要选香橙派5这块板子来部署yolov5s核心原因就是RK3588这颗芯片。RK3588S是RK3588的简化版本主要在接口数量上做了削减但CPU、GPU、NPU这些核心计算单元一个没少。RK3588S的NPU算力是6 TOPS这是什么概念拿它来跑yolov5s输入分辨率640x640的情况下int8量化后的模型推理速度能做到30到60 FPS之间具体看你的预处理和后处理怎么优化。跟树莓派4B这种纯CPU跑yolov5s、只有一两帧每秒的方案比起来完全是两个维度的体验。这也是为什么这两年边缘AI项目里RK3588系列这么火——同价位的板子里它的NPU算力是最能打的之一。另外香橙派5的价格也实在比某些大厂的RK3588开发板便宜不少但功能该有的都有。社区资料这两年也攒起来了真遇到问题不至于完全没地方查。综合下来拿它当yolov5s的部署平台性价比很合适。1.3 镜像烧写的本质把系统装进存储介质这里用一个生活化的类比来解释烧写这件事。买回来的新电脑硬盘是空的你拿U盘装个Windows这过程叫装系统。开发板也一样香橙派5的eMMC不预装系统或者预装的版本不靠谱你要用工具把系统镜像写进它的eMMC里这个过程你叫它烧写、刷机、线刷都是一个意思。跟电脑装系统不同的是开发板烧写通常不是用一个安装程序去跑向导而是把完整的系统镜像直接“刻”进存储。镜像文件里面已经包含分区表、引导程序、内核、根文件系统相当于一整个硬盘的快照。你要做的就是把这个快照还原到板子的存储上。香橙派5支持两种启动介质板载eMMC和TF卡。烧写的方式也分两种一种是通过USB线连接电脑用瑞芯微官方工具直接烧eMMC另一种是把镜像写到TF卡里让板子从TF卡启动。这篇教程我会把两种方式都讲清楚你根据手头条件选一种就行。我个人的建议是主力用eMMCTF卡留着当救援模式或者跑其他系统玩。2. 烧写前的准备硬件、软件、镜像一次拿全2.1 硬件清单别忽略电源和线材这两个隐形坑烧写前先把硬件备齐不然中途缺东西很耽误事。你需要准备的东西如下。第一是香橙派5主板本身。第二是电源适配器这一点我必须格外强调——香橙派5对电源质量很敏感官方推荐5V/4A以上的电源适配器最好带DC圆头接口。你如果随手拿个手机充电头5V/2A去供电跑轻负载可能没事但烧写过程中板子要做大量IO操作电流需求波动大供电不足会导致烧写中断、设备反复重启甚至把eMMC写坏。我用过好几个充电头最后固定用一个5V/4A的工业电源再没出过供电问题。第三是USB数据线用来连接板子和电脑。这里有个很多人踩的坑Type-C线看起来都一样但有些线只支持充电不支持数据传输。你拿一根纯充电线去连电脑驱动装好了设备就是不出来折腾半天。建议找一根确认支持数据传输的Type-C线最好是短线USB 2.0标准就够烧写了长线会增加信号衰减。第四是TF卡如果你选择SD卡烧写方式。虽然不是必须——因为不装TF卡也能烧eMMC——但我强烈建议备一张容量16GB以上速度等级C10或A1以上。TF卡用处很大板子万一变砖了插个卡还能救回来。第五是显示器和HDMI线第六是USB键盘鼠标。这两样不细说但注意一下如果你用SD卡启动系统没有显示器的话纯靠SSH也可以配置但第一次烧写还是建议接显示器看效果排查问题方便。2.2 软件工具准备三样东西缺一不可软件方面分三块镜像文件、烧写工具、驱动程序。镜像文件去香橙派官网下载在“Orange Pi 5”的页面里能找到官方发布的系统镜像。我推荐选Ubuntu 22.04版本对应的是Xfce桌面那个镜像虽然带桌面会占一些资源但作为开发调试环境很方便。真正跑yolov5s推理的时候可以切换到纯命令行的模式甚至关掉桌面服务来腾出资源。你下载下来会发现文件是.xz后缀的压缩格式体积大概两三个GB需要先解压成.img镜像文件才能用。解压工具Windows下用7-Zip就行别用Windows自带的解压器它解压xz格式慢而且容易报错。烧写工具看你的操作系统和烧写方式。如果你用Windows电脑烧eMMC用瑞芯微官方的RKDevTool这个工具在香橙派官网也能找到下载链接对应Windows版本。烧TF卡的话用一个通用的开源工具balenaEtcher就行它跨平台、操作简单、不容易出错。如果你用Linux电脑烧eMMC可以直接用瑞芯微的Linux烧写工具或者干脆用dd命令写到TF卡。驱动这块只有Windows USB烧写时需要。瑞芯微提供了一个驱动安装包叫DriverAssitant装上之后电脑才能在USB层面识别到板子的烧写模式。这个驱动安装有个比较隐蔽的坑Windows对未签名驱动的限制。你如果装不上需要在“高级启动”里禁用驱动程序强制签名然后重新安装。我后面在问题排查部分会再展开讲。2.3 两种烧写路径怎么选先决定你的主力方案结合我用过的各种方式这里给你一个清晰的选择建议。决定烧写方案主要看三件事你的电脑系统、板子当下的状态、以及你后续怎么用这块板。如果你的主力电脑是Windows那么走USB线刷eMMC是最顺的。瑞芯微的RKDevTool和DriverAssitant就是为Windows准备的装上驱动、打开工具、接上线就能烧。这个方式的好处是写eMMC速度快一个几GB的镜像几分钟就写完而且不额外需要TF卡。如果你的电脑是Linux烧TF卡最省心。一条dd命令搞定不需要装任何额外工具。虽然写卡速度取决于TF卡本身但胜在流程简单可靠。而且Linux写出来的TF卡格式不会有兼容性问题插到板子上直接启动。至于已经有了TF卡、不想折腾线刷的情况我也建议直接用balenaEtcher写TF卡。它比dd多了一层校验写完能验证数据是否正确对新手更友好。但注意一点同一时间eMMC和TF卡都有系统的话板子默认是从TF卡启动的这不是坏事你反而可以把TF卡当U盘里的急救系统用。三者的关系我用一张表来说明。烧写方式目标存储工具适用场景特点USB线刷板载eMMCRKDevToolWindows主力追求速度快需要装驱动烧写最快板子最“完整”写TF卡TF卡balenaEtcher / ddLinux主力或者救援用步骤最简单但TF卡读写速度有上限混合方案两者皆有上述都行调试和开发环境分离eMMC当主力系统TF卡当救援系统3. Windows下USB线刷完整流程一步步走通eMMC3.1 驱动安装与常见障碍我猜大部分人用的都是Windows电脑所以这条线刷的路线我会写得更细致。第一步是装驱动。把DriverAssitant解压出来右键以管理员身份运行DriverInstall.exe点击“驱动安装”。正常情况下几秒钟就装好了你会看到安装成功的提示。如果你在安装时报错或者提示驱动签名问题那就是触到了Windows驱动签名限制。解决方法重启电脑在开机过程中按F8或者进入“设置-系统-恢复-高级启动”里选择“重启现在”进入蓝色菜单后依次选“疑难解答-高级选项-启动设置-重启”重启后按提示按数字键7也就是“禁用驱动程序强制签名”模式。在这个模式下重新安装驱动就能装上。装完驱动后最好重启一下电脑避免某些系统服务没有刷新导致识别异常。这一步不太起眼但很多人忽略结果插上板子怎么都不识别。3.2 让板子进入Loader模式这一步决定了你能不能识别到设备打开RKDevTool你会发现它默认停在“升级固件”页面但设备列表是空的。现在需要把板子切到烧写模式。香橙派5进入烧写模式有两种方法我推荐最简单的一种先不给板子供电用USB线把板子的Type-C口板子上标注了“Type-C”的那个口连到电脑然后按住板子上的MASKROM按键不放再插上电源。等大概两秒后松开MASKROM键。稍等一下RKDevTool的设备列表里就会多出一个设备如果显示的是“MaskROM模式”说明成功了。第二种方法是先进系统然后在系统里通过adb命令切换到loader模式命令是adb reboot loader。这个方式适合你已经烧过系统、板子能正常启动的情况。但第一次烧写没有系统所以Method A才是王道。这里有个概念要分清Loader模式和MaskROM模式的区别。Loader模式是板子的引导程序可用它能接收烧写指令MaskROM模式是引导程序都没法正常跑芯片直接进入最底层的烧写状态。RKDevTool对两种模式都能烧写区别在于要是你已经烧过系统但系统坏了还能进Loader要是Loader都被写坏了那就只能用MaskROM。所以MASKROM键关键时刻能救命这个物理按键就是咱们的“急救开关”。3.3 配置RKDevTool并执行烧写设备识别到了接下来的操作就简单了。在RKDevTool的“升级固件”页面你会看到默认有一个烧写配置项它描述了哪些镜像写到哪个分区。香橙派的官方镜像文件一般是一个整体镜像后缀是.img里面已经包含了所有分区的数据。点击“选择文件”按钮选中你解压好的镜像文件。然后确保“配置”列这一行的选择框是勾选状态。最后点击“执行”按钮烧写就开始了。烧写过程大概持续几分钟进度条会显示数据传输的百分比。这时候你什么都别动不要拔出USB线、不要断电耐心等着。烧写完成后RKDevTool会提示“下载完成”板子会自动重启进入系统。首次启动会比平时慢一些因为它要生成一些系统运行时的缓存数据正常等一两分钟就好。这里多说一句RKDevTool还有个“高级功能”选项卡里面有单独烧写某个分区的选项。比如你改了内核只想刷boot分区加速测试就可以单独操作。但第一次烧写别碰那些直接用整包镜像最稳。等以后你开始调yolov5s推理代码、需要定制自己的内核时再来研究分区级烧写。4. Linux下dd写卡给爱用命令行的你一条快捷路径4.1 dd命令的原理与完整操作如果你电脑是Linux或者想给TF卡做启动卡那用dd命令是最直接的。亮哥我自己平时主力工作机是Ubuntu所以这套流程操练过很多次。先插入TF卡用lsblk或sudo fdisk -l查看设备列表找到你的TF卡对应哪个节点。这一步特别重要因为dd命令是把数据直接写入块设备不经过文件系统你要是写错盘符后果是灾难性的——我就听说过有人把系统盘给写成镜像的。确定设备节点后比如是/dev/sdb执行sudo dd iforangepi5_ubuntu22.04_xfce.img of/dev/sdb bs4M statusprogress convfsync这里if是输入文件你的镜像of是输出设备TF卡bs是块大小设为4M提升拷贝速度statusprogress会实时显示进度convfsync确保数据全部落盘后才结束命令。等待写入完成一般几个GB的数据也就几分钟。完成后拔卡插到板子上接电启动就行。命令本身简单但有几个细节要提醒第一确认of的设备节点时要特别小心。你看一下lsblk的输出TF卡会显示一个总容量跟你的卡容量相符并且下面可能带有几个分区。如果你插卡前后分别执行一次lsblk对比新增的设备节点那是最稳的确认方式。第二写完TF卡之后Windows如果弹窗说“需要格式化”千万别点。那是Windows不识别Linux分区的正常提示你的卡没坏。拔下来插板子上用就好。第三TF卡的速度决定了系统体验。如果用的是那种路边摊杂牌卡系统启动可能很慢甚至烧写过程中就报错。建议用闪迪、三星这类品牌的A1以上级别卡差价不大体验差很多。4.2 两种方案并存eMMC和TF卡怎么分工我的实际经验是不要二选一让eMMC和TF卡共存各司其职。eMMC里烧Ubuntu作为主力开发系统日常跑代码、部署yolov5s都在里面TF卡里放一个备份系统或者测试用的其他系统比如想试试新版本内核先写到TF卡上试跑没问题再烧进eMMC。这样做的好处很明显你只要把TF卡拔掉板子就从eMMC启动插上TF卡板子就从TF卡启动。切换系统只是插拔一张卡的事。万一你把eMMC里的系统弄坏了插上TF卡还能进系统去修复eMMC等于买了一份保险。另外TF卡本身也可以当作扩展存储用。eMMC容量一般是32GB或64GB开发过程中装一些依赖库、模型文件之后空间会紧张。把TF卡格式化成一个ext4分区挂载到系统里专门放模型文件和数据集这样存储压力就缓解了。5. 烧写完成后开机验证与基础配置5.1 首次开机从指示灯到桌面不管你是用USB烧写了eMMC还是插了TF卡首次启动的验证方式都一样。接好显示器和HDMI线插上键鼠然后供电。板子上电后你会看到红色的电源指示灯亮起紧接着绿色指示灯闪烁这表示系统正在引导。第一次启动会慢一点因为它要初始化一些随机数种子、SSH主机密钥这类系统独有的数据。看到桌面桌面环境或者登录界面就说明系统跑起来了。香橙派官方的Ubuntu镜像默认用户名是orangepi密码是orangepi首次登录后建议立刻修改密码。如果你没接显示器而是想直接SSH登录需要先知道板子的IP地址。最简单的办法是登录路由器后台看设备列表找到名为orangepi的设备。如果板子插着网线IP地址一般就在路由器列表里如果用Wi-Fi看镜像默认有没有自动连接官方Ubuntu镜像通常会在首次启动时弹出Wi-Fi配置界面。打开终端执行ssh orangepi你的IP地址输入密码后就能进系统。进去之后第一件事把系统源换成国内镜像源不然下载东西的速度会让你怀疑人生。修改/etc/apt/sources.list文件把archive.ubuntu.com替换成mirrors.aliyun.com或mirrors.ustc.edu.cn然后执行sudo apt update sudo apt upgrade -y5.2 检查磁盘空间与分区扩容官方镜像烧写进eMMC之后分区大小通常已经扩展到整个eMMC容量。但如果你是写TF卡有时候会发现系统分区只占用了TF卡的一部分空间剩下的是未分配区域。原因在于镜像本身是按一个固定的尺寸做的分区表烧进更大的卡后需要手动扩展。可以用下面这套流程来扩展先看分区布局df -h sudo parted -l然后使用resize2fs扩展文件系统。对于多数基于RK的镜像分区表里根本还没占用未分配区域需要先用fdisk或parted把分区扩展到剩余空间再用resize2fs让文件系统识别新空间。我这里建议一个更省事的图形化工具gparted注意安装它之后再打开sudo apt install gparted sudo gparted在图形界面里选中ext4分区右键调整大小把滑块拖到最大然后应用。操作完成后df -h就能看到根分区容量变成了整个存储的大小。这个操作本身不复杂但要注意调整分区时要确保系统不处于极端负载状态如果是在SSH远程操作最好别在扩展过程中断开网络。5.3 验证NPU设备为yolov5s部署做铺垫系统跑起来后你可以顺手验证一下NPU设备是否存在。虽然这篇文章不涉及具体的模型部署但提前确认硬件层面没问题后面调RKNN工具链的时候能少走弯路。执行命令查看设备节点ls /dev/rknpu*如果输出类似/dev/rknpu0说明NPU设备已经被内核识别到了。瑞芯微的系统镜像默认带NPU驱动所以正常情况下这一步肯定能通过。另外再看一下内核版本uname -a确认内核版本跟镜像发布的版本一致。不用太纠结具体版本号只要它是5.10以上的主线或厂商定制内核后面装RKNN工具链都没问题。如果你打算后续优化模型推理速度还可以先跑一个简单的CPU压力测试看看散热和电源能不能扛住高负载。这一步不是必须的但香橙派5在高负载下如果散热片没装好温度上去之后频率会掉推理速度会受影响。我就遇到过夏天室温下跑yolov5sCPU和NPU同负载温度飙到80度帧率掉了一半。后来重新涂了硅脂、加了主动散热风扇问题才解决。6. 烧写阶段容易踩的坑这八条经验你直接抄6.1 设备识别不到先查驱动、线材、接口的顺序排查法这是新手群里问得最多的问题。板子连上电脑了RKDevTool就是识别不到设备。碰到这种情况先别重复插拔按照下面这个顺序排查。第一步查驱动。右键“此电脑”-“管理”-“设备管理器”看有没有一个设备显示黄色感叹号如果看到了名为“Rockusb Device”或类似名字的未知设备说明驱动没装对或者没装上。在感叹号设备上右键更新驱动手动指定到DriverAssitant的安装目录重新装一遍驱动。第二步查线材。这条比你想的更常见。换一根你确定能传数据的Type-C线最好用手机自带的原装线它通常保证支持数据传输。我遇到过一根看起来很粗的编织线结果只能充电被坑惨了。第三步查接口。板子的Type-C口旁边可能标注了具体用途有些板子上有两个Type-C口一个只供电一个支持USB通信与烧写。香橙派5的话烧写用的口是板上标注“Type-C”的那个不是电源接口旁边那个。另外建议用电脑主板背后的USB口前面板的USB口经过延长线容易供电和信号都打折。6.2 烧写中途失败大概率是供电和线材的问题烧写烧到一半提示失败、或者进度条卡住不动是第二高发问题。如果每次都失败在同一位置多半是数据线质量不行传输不稳定。换短线换有数据传输保障的线别用那种几块钱的usb转type-c转换头。供电因素也常被忽视。烧写过程中板子和电脑同时供电有些情况下USB接口的供电跟不上板子会小幅重启。你可以试试不给板子单独供电只靠USB线供电烧写或者反过来给板子接上电源适配器烧写。这两种方式我都在不同板子上用过具体哪种更稳跟板子版本的电源管理策略有关只能现场试。还有一个容易被忽略的Windows的杀毒软件或安全策略会拦截RKDevTool的驱动加载或者直接阻止工具的底层操作。烧写前把杀毒软件退出或者至少把RKDevTool和DriverAssitant加入白名单。6.3 系统启动反复重启八成是电源功率不足烧写成功了但板子一进系统就重启循环往复那问题基本不在系统上而在供电上。香橙派5满载功耗可以到10W以上换算过来就是5V下需要2A以上的持续电流开机时还有浪涌电流用5V/2A的充电头就是勉勉强强。所以我前面再三强调用5V/4A的电源适配器不是官方在吓唬你是真的必要。判断电源问题的另一个小技巧把外设拔掉再开机。如果拔掉USB键盘鼠标、卸掉无线网卡之后能正常进系统那你更可以确定是电源功率不够。解决办法就是换大功率电源或者用带载能力强的电源别在电源上抠成本。6.4 备用技巧SD卡“救砖”流程讲了这么多坑最后再分享一个保底技能。万一你折腾eMMC把系统搞坏了连MASKROM模式都进不去别慌用TF卡救砖。拿之前准备好的TF卡在Linux或Windows上用balenaEtcher烧录官方镜像烧完把卡插到板子上。板子检测到TF卡里的合法系统后会优先从TF卡启动。进系统后你可以把eMMC重新分区格式化或者直接用dd把TF卡的系统整盘复制到eMMC。sudo dd if/dev/mmcblk0 of/dev/mmcblk1 bs4M statusprogress convfsync这里假设TF卡是mmcblk0eMMC是mmcblk1具体设备名用lsblk确认。这个操作等于把TF卡里的系统克隆到eMMC效率很高。救砖的本质就是给板子一个可启动的外部系统再从里面修复内部存储思路比任何命令都值钱。