1. 为什么选择香橙派RK3588做YOLOv5s部署
1.1 这块板子到底强在哪
第一次拿到香橙派5的时候，我其实没抱太大期望。市面上号称能跑AI推理的开发板太多了，大部分实际跑起来要么帧率惨不忍睹，要么模型转换各种报错。但RK3588这颗芯片确实不太一样——它内置的NPU算力标称6TOPS，这个数字放在边缘计算设备里算是相当能打的了。
我选它跑YOLOv5s有几个很实际的考虑。YOLOv5s是整个YOLOv5系列里最轻量的模型，参数量大约7.2M，权重文件才14MB左右，输入640×640的情况下在COCO数据集上能跑到37%左右的mAP。这个精度对于大多数工业检测、安防监控、智能零售的场景已经够用了。而RK3588的NPU对卷积运算的加速非常明显，实测下来单帧推理能压到30ms以内，算上前后处理，跑个20FPS以上问题不大。
另一个关键因素是生态。RK3588的NPU工具链叫RKNN，瑞芯微官方一直在维护，支持ONNX、TensorFlow、PyTorch等主流框架的模型转换。YOLOv5s导出ONNX之后再转RKNN，整个链路是通的，社区里也有大量现成的踩坑记录可以参考。相比之下，有些开发板的NPU工具链文档稀少、版本混乱，调起来非常痛苦。
1.2 镜像烧写为什么是第一步
很多人拿到板子第一反应是插电开机看看，但香橙派5出厂通常不带系统，或者带的是一个非常精简的出厂镜像。你要跑YOLOv5s，需要的是完整的Ubuntu或Debian环境，要能装Python、OpenCV、RKNN Toolkit这些依赖。所以镜像烧写是整个项目的地基，这一步没搞对，后面全是空中楼阁。
我见过不少新手在这一步翻车：烧错了镜像版本导致NPU驱动不匹配、TF卡质量太差导致系统频繁崩溃、烧写工具版本不对导致板子变砖。这些问题看起来简单，但真遇到了很浪费时间。所以这篇先把镜像烧写这件事讲透，把可能踩的坑提前填平。
注意：香橙派5的镜像和香橙派5B、5Plus的镜像不完全通用，下载时一定要看清楚型号。RK3588和RK3588S虽然名字像，但引脚和部分外设驱动有差异，镜像不能混用。
2. 烧写前的硬件与软件准备
2.1 硬件清单与选型建议
先把手头需要的东西列清楚，缺一样都干不了活。
必备硬件：
- 香橙派5主板一块（确认是RK3588版本，不是RK3588S）
- TF卡一张，容量建议32GB起步，Class 10或UHS-I以上速度等级
- TF卡读卡器一个，USB 3.0接口的最好
- 电源适配器一个，支持5V/4A或更高功率的Type-C供电
- 网线一根或HDMI线+显示器（用于首次启动验证）
- 散热片或风扇（RK3588满载发热不小，烧写完测试时建议装上）
TF卡这块我要多说一句。很多人觉得随便找张旧卡就行，结果系统跑起来卡顿、文件损坏、甚至烧写过程中就报错。我实测过几张不同品牌的卡，杂牌卡在连续写入时掉速非常严重，而三星EVO Plus、闪迪Extreme这类正规卡就稳得多。如果预算允许，直接上A2级别的卡，随机读写性能对系统流畅度影响很大。
电源也是容易被忽视的点。香橙派5在NPU满载时功耗能到10W以上，如果用手机充电器那种5V/2A的，很可能出现供电不足导致系统重启或NPU降频。官方推荐5V/4A，我建议直接上5V/5A的电源，留足余量。
软件准备：
- 香橙派官方镜像文件（Ubuntu 22.04或Debian 11，根据需求选）
- 烧写工具：balenaEtcher或RKDevTool
- 解压工具：7-Zip或类似软件
- 串口调试工具（可选，但强烈建议准备）
2.2 镜像版本怎么选
香橙派官网提供的镜像有好几种，我按实际使用场景给个选择建议：
| 镜像类型 | 适用场景 | 优缺点 |
|---|---|---|
| Ubuntu 22.04 Desktop | 需要图形界面调试 | 功能全，但占用资源多 |
| Ubuntu 22.04 Server | 纯命令行部署 | 轻量，适合最终产品 |
| Debian 11 Desktop | 习惯Debian生态 | 稳定，软件包略旧 |
| Debian 11 Server | 服务器式部署 | 最精简，启动快 |
如果你是要跑YOLOv5s做推理，我建议先用Desktop版本把环境跑通，确认NPU驱动、RKNN Toolkit都正常之后，再考虑换Server版本做最终部署。Desktop版本有图形界面，调试的时候方便很多，比如你可以直接打开图片查看推理结果，不用每次都靠命令行。
镜像文件通常是一个.img.xz的压缩包，下载下来大概1-2GB。解压之后得到.img文件，大小在8-16GB左右，所以TF卡容量一定要够。
提示：下载镜像时优先选官方渠道，第三方修改版可能集成了不明组件，安全性和稳定性都没保障。下载完记得核对一下文件的MD5或SHA256值，确保下载完整。
2.3 烧写工具的选择与对比
烧写工具有两个主流选择，我分别说说使用体验。
balenaEtcher是我最常用的。它的优点是跨平台（Windows/macOS/Linux都有）、界面直观、烧写完成后会自动校验。操作就三步：选镜像、选TF卡、点烧写。缺点是对某些读卡器的兼容性一般，偶尔会报"源文件损坏"的误报，换个读卡器通常就好了。
RKDevTool是瑞芯微官方的工具，主要用于通过USB线烧写到板载eMMC。如果你买的是带eMMC的版本，或者TF卡烧写失败想换方式，可以用这个。它需要板子进入Loader模式或Maskrom模式，操作稍微复杂一点，但胜在是官方工具，兼容性最好。
我个人的建议是：先用balenaEtcher烧TF卡，这是最简单的方式。如果TF卡烧写后启动不了，再考虑用RKDevTool通过USB烧写到eMMC。
3. 镜像烧写完整实操流程
3.1 第一步：格式化TF卡
拿到新卡或者旧卡，第一步都是格式化。别跳过这步，旧卡里残留的分区表可能导致烧写后无法启动。
Windows下用SD Card Formatter这个工具最省事，选好TF卡盘符，点"Format"就行。格式化类型选"Overwrite format"，虽然慢一点但最彻底。macOS下可以用磁盘工具，选"MS-DOS (FAT)"格式，方案选"主引导记录"。
格式化完成后，TF卡应该是一个单一的分区，容量显示正常。如果显示容量明显偏小（比如32G的卡只显示几百MB），说明卡里有隐藏分区或者卡本身有问题，需要先用diskpart之类的工具清理。
# Linux下查看TF卡设备名 lsblk # 假设TF卡是 /dev/sdb，用dd清零分区表（谨慎操作，确认设备名无误） sudo dd if=/dev/zero of=/dev/sdb bs=1M count=100注意：
dd命令非常危险，of=后面的设备名一定要确认是TF卡而不是你的系统盘。搞错了会把电脑硬盘清空。新手建议还是用图形化工具。
3.2 第二步：用balenaEtcher烧写镜像
打开balenaEtcher，界面很简洁。
- 点击"Flash from file"，选择解压好的
.img文件 - 点击"Select target"，勾选你的TF卡（注意别选错成U盘或移动硬盘）
- 点击"Flash!"开始烧写
烧写时间取决于TF卡速度和镜像大小，一般8-15分钟。烧写完成后，Etcher会自动进行校验（Validate），这一步会再花几分钟，但建议不要跳过，能确认写入的数据没有问题。
烧写过程中如果报错，常见原因和解决办法：
- "Source file is corrupted"：镜像下载不完整，重新下载并核对哈希值
- "Target device is busy"：TF卡被其他程序占用，关掉文件管理器等可能访问TF卡的程序
- 烧写进度卡住不动：读卡器或TF卡有问题，换个读卡器试试
烧写完成后，Windows可能会弹出"需要格式化磁盘"的提示，千万别点格式化！这是因为Windows不认识Linux的分区格式，点取消就行。TF卡现在已经是可启动的系统盘了。
3.3 第三步：首次启动与验证
把烧写好的TF卡插入香橙派5的TF卡槽（在板子背面），接好HDMI、网线、键盘鼠标，最后插电源。
首次启动会比较慢，因为系统要做一些初始化工作，大概1-2分钟。如果接了显示器，你会看到启动日志滚动，最后进入登录界面或桌面。默认用户名和密码通常是：
- Ubuntu镜像：用户名
orangepi，密码orangepi - Debian镜像：用户名
root，密码orangepi
登录之后，先做几件确认工作：
# 确认系统版本 cat /etc/os-release # 确认内核版本 uname -a # 确认NPU设备是否存在 ls /dev/rknpu* # 查看CPU和NPU温度 cat /sys/class/thermal/thermal_zone*/temp如果/dev/rknpu存在，说明NPU驱动已经加载了。如果没有，可能需要更新内核或安装NPU驱动包。
网络方面，如果插了网线，通常会自动获取IP。用ip addr查看。如果要连WiFi，Desktop版本可以直接在图形界面操作，Server版本用nmcli命令：
# 扫描WiFi nmcli dev wifi list # 连接WiFi nmcli dev wifi connect "你的WiFi名称" password "你的密码"3.4 第四步：系统基础配置
系统跑起来之后，有几项配置建议立刻做，能省掉后面很多麻烦。
更新软件源和系统：
sudo apt update sudo apt upgrade -y香橙派的镜像默认软件源可能比较慢，可以换成国内镜像源。编辑/etc/apt/sources.list，把里面的地址替换成清华或中科大的镜像。
安装常用工具：
sudo apt install -y vim git wget curl htop net-tools扩展TF卡分区：
有些镜像烧写后不会自动扩展分区，导致可用空间只有镜像本身的大小。用df -h看一下根分区大小，如果明显小于TF卡容量，需要手动扩展：
# 查看分区情况 sudo fdisk -l # 使用resize2fs扩展文件系统（假设根分区是/dev/mmcblk0p2） sudo resize2fs /dev/mmcblk0p2设置静态IP（可选）：
如果板子要作为固定设备部署，建议设个静态IP，方便远程SSH连接。在Ubuntu 22.04下用netplan配置：
# /etc/netplan/01-netcfg.yaml network: version: 2 ethernets: eth0: dhcp4: no addresses: - 192.168.1.100/24 gateway4: 192.168.1.1 nameservers: addresses: [8.8.8.8, 114.114.114.114]改完执行sudo netplan apply生效。
4. 烧写过程中的常见问题与排查
4.1 板子插电后没有任何反应
这是最常见的问题，可能原因按概率排序：
电源功率不够。香橙派5对供电要求比较高，5V/2A的充电器很可能带不动。换5V/4A以上的电源试试。另外注意Type-C线也要支持大电流，有些细线电阻大，压降严重。
TF卡没插好或烧写失败。重新插拔TF卡，确认卡完全插入卡槽。如果还是不行，重新烧写一次镜像。
HDMI没有输出。香橙派5的HDMI默认输出分辨率可能和你的显示器不匹配。可以尝试换一根HDMI线，或者换一个显示器。如果板子有串口调试口，接串口线看启动日志最直接。
板子硬件故障。如果以上都排除了，可能是板子本身有问题。检查板子上的电源指示灯是否亮起，如果完全不亮，联系售后。
4.2 系统启动后频繁死机或重启
这个问题通常和供电或散热有关。
先测电源电压。用万用表量一下板子Type-C接口处的电压，如果低于4.8V，说明电源或线材有问题。NPU满载时电流会突然增大，如果电源响应跟不上，电压跌落就会导致系统重启。
再看温度。RK3588的CPU和NPU在高负载下温度能到70-80度，如果没有散热措施，会触发降频甚至关机。装个散热片加小风扇，温度能压到50度左右。
TF卡质量也是嫌疑对象。劣质卡在大量读写时会出错，导致系统崩溃。换一张正规品牌的卡试试。
4.3 NPU设备找不到
登录系统后如果/dev/rknpu不存在，说明NPU驱动没加载。先确认内核版本：
uname -r香橙派官方镜像的内核通常是5.10或6.1版本，这两个版本都带RKNPU驱动。如果内核版本不对，可能需要更新内核：
sudo apt update sudo apt install linux-image-rockchip更新完重启，再检查/dev/rknpu。如果还是没有，检查一下/boot/config-$(uname -r)里是否有CONFIG_ROCKCHIP_RKNPU=y。
还有一种情况是NPU被其他驱动占用了。用dmesg | grep -i npu查看内核日志，看有没有报错信息。
4.4 网络连不上
有线网络连不上，先检查网口指示灯是否亮。不亮的话可能是网线问题或网口硬件问题。亮的话用ip addr看有没有获取到IP。
如果没获取到IP，可能是DHCP服务有问题。可以手动设个静态IP试试。或者用sudo dhclient eth0手动触发DHCP请求。
WiFi连不上，先确认WiFi模块被识别：
lsmod | grep wifi如果没有输出，可能是WiFi驱动没加载。香橙派5用的是AP6275P模组，驱动一般在镜像里已经集成了。如果没有，需要手动安装。
实操心得：我遇到过几次WiFi能扫描到网络但连不上的情况，最后发现是信道问题。有些WiFi 6路由器用了149以上的信道，而板子的WiFi模块默认只支持1-11信道。把路由器信道改成36-48或者1-11就好了。
4.5 常见问题速查表
| 现象 | 可能原因 | 排查方法 | 解决办法 |
|---|---|---|---|
| 插电无反应 | 电源功率不足 | 测Type-C口电压 | 换5V/4A以上电源 |
| 插电无反应 | TF卡烧写失败 | 重新烧写并校验 | 换读卡器或TF卡 |
| 启动后死机 | 散热不良 | 摸散热片温度 | 加装风扇或散热片 |
| 启动后死机 | TF卡质量差 | 换卡测试 | 用正规品牌A2卡 |
| NPU找不到 | 驱动未加载 | dmesg | grep npu | 更新内核或装驱动 |
| 网络连不上 | DHCP失败 | ip addr查看 | 设静态IP或重启网络 |
| WiFi连不上 | 信道不兼容 | 查看路由器信道 | 改为1-11信道 |
| 烧写报错 | 镜像损坏 | 核对哈希值 | 重新下载镜像 |
5. 烧写完成后的下一步准备
5.1 系统备份与镜像克隆
系统配置好之后，建议立刻做个备份。TF卡这东西说坏就坏，没有备份的话重新配环境很痛苦。
在Linux电脑上可以用dd命令把TF卡整个克隆成镜像文件：
# 假设TF卡是 /dev/sdb sudo dd if=/dev/sdb of=orangepi5_backup.img bs=4M status=progress这个镜像文件可以压缩保存，以后需要恢复的时候直接烧写回去就行。注意备份镜像的大小和TF卡容量一样，32G的卡备份出来就是32G的文件，压缩后可能只有几个G。
Windows下可以用Win32 Disk Imager的读取功能做同样的事。
5.2 远程访问配置
板子跑起来之后，每次都接显示器键盘太麻烦。配好SSH之后就可以远程操作了。
# 确认SSH服务已安装并启动 sudo apt install -y openssh-server sudo systemctl enable ssh sudo systemctl start ssh # 查看板子IP ip addr show eth0然后在电脑上用SSH连接：
ssh orangepi@192.168.1.100如果需要传文件，可以用scp或者rsync。我习惯用rsync，支持断点续传，传大文件更稳：
rsync -avz --progress ./local_folder/ orangepi@192.168.1.100:/home/orangepi/remote_folder/5.3 开发环境预装
镜像烧写只是第一步，接下来要装YOLOv5s部署需要的各种依赖。这里先把基础环境列一下，后面文章会详细讲。
Python环境：
sudo apt install -y python3 python3-pip python3-dev python3-venvOpenCV：
sudo apt install -y python3-opencvRKNN Toolkit：
这个需要从瑞芯微的官方仓库下载，注意版本要和NPU驱动匹配。RK3588一般用RKNN Toolkit2。
其他依赖：
sudo apt install -y cmake build-essential libatlas-base-dev这些装完，基础环境就差不多了。具体的RKNN模型转换和YOLOv5s部署流程，我会在后续文章里一步步展开。
提示：装依赖的时候建议用虚拟环境（venv），避免污染系统Python。香橙派官方镜像里有些系统工具依赖特定版本的Python包，乱装可能导致系统功能异常。
5.4 性能测试与基准记录
环境装好之后，建议跑个基准测试，记录一下板子的初始性能。这样后面优化的时候有个对比参照。
CPU性能可以用sysbench：
sudo apt install -y sysbench sysbench cpu --cpu-max-prime=20000 runNPU性能可以用RKNN Toolkit自带的benchmark工具，跑一个简单的模型看看推理耗时。
温度监控也很重要，装个lm-sensors：
sudo apt install -y lm-sensors sudo sensors-detect sensors这些数据记下来，后面调优的时候就知道有没有提升空间。
我个人在实际操作中的体会是，香橙派5这块板子硬件底子不错，但软件生态还在完善中。镜像烧写这一步看似简单，实际上涉及电源、存储、散热、驱动多个环节，任何一个出问题都会导致后面无法进行。把这一步做扎实，后面跑YOLOv5s的时候会顺利很多。另外建议每次改动系统配置之前都做个备份，TF卡上的系统说崩就崩，有备份心里不慌。
