MacBook上使用rkdeveloptool为RK开发板烧录固件的完整指南

1. 为什么选择MacBook搭配rkdeveloptool

作为一个长期使用MacBook Pro做嵌入式开发的工程师，我深刻理解在macOS环境下折腾开发板的痛苦。Windows平台有官方提供的RKDevTool图形化工具，而Linux环境下也有完善的命令行支持，但Mac用户往往处于尴尬的境地。直到我发现rkdeveloptool这个开源工具，才真正解决了Rockchip开发板在Mac上的烧录难题。

rkdeveloptool是Rockchip官方为Linux/macOS平台开发的USB烧录工具，可以理解为开源版的upgrade_tool。它支持所有主流的Rockchip处理器，包括RK3399、RK3568等。我在RK3566开发板上实测，烧录速度比虚拟机方案快3倍以上，而且稳定性更好。

与虚拟机方案相比，原生macOS环境下的rkdeveloptool有几个明显优势：

• USB直通更稳定：虚拟机经常遇到USB设备识别问题
• 性能损耗更低：特别是处理大体积固件时差异明显
• 开发体验更流畅：不需要频繁切换操作系统环境

2. 环境准备与工具安装

2.1 安装必备依赖

在开始之前，需要确保系统已安装Homebrew。如果还没安装，可以通过以下命令一键安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

接下来安装rkdeveloptool的编译依赖：

brew install automake autoconf libusb pkg-config git wget

这里特别要注意libusb的版本兼容性。我遇到过因为libusb版本不匹配导致设备识别失败的情况，建议使用brew默认提供的稳定版本。

2.2 编译安装rkdeveloptool

首先克隆官方仓库（推荐使用我修改过的版本，解决了macOS下的编译问题）：

git clone https://github.com/weiqifa0/rkdeveloptool cd rkdeveloptool

执行自动化构建流程：

aclocal autoreconf -i autoheader automake --add-missing ./configure make

在macOS上编译时，你可能会遇到sprintf的安全警告。这是我的一个实际经验：需要将所有sprintf调用替换为snprintf。如果你使用我提供的仓库，这个问题已经修复。

编译完成后，将生成的可执行文件复制到系统路径：

sudo cp rkdeveloptool /usr/local/bin/

验证安装是否成功：

rkdeveloptool -v

3. 开发板进入烧录模式

不同型号的Rockchip开发板进入Loader模式的方式略有差异。以我使用的ROC-RK3566-PC为例：

1. 先断开开发板电源
2. 按住板载的Recovery按键（通常标有"MASKROM"或"LOADER"）
3. 保持按键按下的同时连接USB到MacBook
4. 持续按住按键约3秒后松开

验证设备是否进入正确模式：

rkdeveloptool ld

如果看到类似如下输出，说明设备已准备好：

DevNo=1 Vid=0x2207,Pid=0x350b,LocationID=302 Maskrom

常见问题排查：

• 如果设备显示为"Loader"而不是"Maskrom"，可能需要重新操作
• 确保使用高质量的USB数据线，劣质线材会导致识别不稳定
• 某些机型需要短接特定的测试点才能进入Maskrom模式

4. 固件烧录实战操作

4.1 准备烧录文件

Rockchip固件通常包含以下几个关键文件：

• Loader.bin：低级引导程序
• uboot.img：U-Boot镜像
• boot.img：内核和initramfs
• rootfs.img：根文件系统

建议将这些文件放在同一目录下。我通常这样组织：

firmware/ ├── loader.bin ├── uboot.img ├── boot.img └── rootfs.img

4.2 分步烧录命令

首先加载Loader：

rkdeveloptool db loader.bin

接着按分区写入镜像文件：

rkdeveloptool wl 0x40 uboot.img rkdeveloptool wl 0x4000 boot.img rkdeveloptool wl 0x8000 rootfs.img

地址参数（0x40, 0x4000等）需要根据实际分区表确定。可以通过以下命令查看分区信息：

rkdeveloptool pl

4.3 一键烧录脚本

为了简化重复操作，我编写了一个简单的shell脚本：

#!/bin/bash LOADER="loader.bin" UBOOT="uboot.img" BOOT="boot.img" ROOTFS="rootfs.img" echo "=== 开始烧录 ===" rkdeveloptool db $LOADER rkdeveloptool wl 0x40 $UBOOT rkdeveloptool wl 0x4000 $BOOT rkdeveloptool wl 0x8000 $ROOTFS echo "=== 烧录完成 ===" rkdeveloptool rd

保存为flash.sh后，添加执行权限：

chmod +x flash.sh

5. 常见问题解决方案

5.1 设备识别失败

如果rkdeveloptool ld没有输出，可以尝试：

1. 检查USB连接状态
2. 重新插拔开发板
3. 重启USB服务：

sudo killall -9 usbd

5.2 烧录过程卡住

遇到烧录卡在某个进度时：

• 可能是USB供电不足，尝试换用带外接电源的USB Hub
• 检查固件文件是否完整，特别是从Windows转换过来的文件要注意换行符问题
• 降低烧录速度，有些山寨数据线不支持高速传输

5.3 权限问题处理

如果出现权限拒绝错误，需要添加udev规则：

echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="2207", MODE="0666"' | sudo tee /etc/udev/rules.d/51-rockchip.rules sudo udevadm control --reload-rules

然后重新插拔设备即可。

6. 高级技巧与优化建议

6.1 批量烧录配置

当需要烧录多台设备时，可以结合expect脚本实现自动化：

#!/usr/bin/expect set timeout 30 spawn rkdeveloptool db loader.bin expect "Downloading bootloader succeeded" spawn rkdeveloptool wl 0x40 uboot.img expect "Write LBA" # 其他分区烧录命令...

6.2 固件验证机制

烧录完成后建议进行校验：

rkdeveloptool ul boot.img > /tmp/read_back.img diff boot.img /tmp/read_back.img

6.3 性能调优

对于大容量固件，可以启用压缩传输：

rkdeveloptool wz 0x4000 boot.img

这个命令会在传输前先压缩数据，实测可以节省约30%的烧录时间。