系统烧录指南

1. 概述

1.1 功能简介

本文档介绍如何为 M5-R2A 开发板烧录系统固件。支持通过 USB OTG 接口使用 RKDevTool 烧录至 eMMC，以及通过 SD 卡启动系统。

1.2 烧录方式对比

烧录方式适用场景优点缺点
USB OTG + RKDevTool首次烧录、系统恢复速度快，支持完整烧录需要 Windows 电脑
SD 卡启动快速测试、系统演示无需电脑，即插即用SD 卡速度受限
线刷（Linux Upgrade Tool）Linux 开发环境无需 Windows需要在 Linux 下操作

1.3 工作原理

RK3588 支持 MaskROM 和 Loader 两种烧录模式：

  • MaskROM 模式：芯片内部固化的引导代码，通过 USB 通信执行烧录
  • Loader 模式：从 eMMC/SD 加载的引导程序，支持通过 USB 升级

2. 硬件准备

2.1 硬件清单

组件数量备注
M5-R2A 主板1C-3588LQ 核心板 + SHIMETAPI-M5-R2A 底板
USB Type-C 数据线1用于连接电脑
4V/5A 电源适配器1误差 ±5%
电脑（Windows 10/11）1运行烧录工具
MicroSD 卡（可选）1用于 SD 卡启动，16GB+

2.2 硬件连接

  1. 使用 USB Type-C 线连接开发板 USB OTG 口到电脑 USB 口
  2. 不要连接电源适配器（烧录时由 USB 供电）
  3. 按住 RECOVERY 键（或 MASKROM 键，视版本而定）不放
  4. 短按 RESET 键复位开发板
  5. 保持按住 RECOVERY 键约 2 秒后松开

2.3 硬件确认

确认电脑识别到设备：

  • Windows 设备管理器中出现"Rockusb Device"或"Class for Rockusb Devices"
  • 如果未识别，请检查驱动安装（见第 4 节）

3. 软件准备

3.1 烧录工具

工具版本说明
RKDevToolv2.91+Windows 烧录工具
Driver Assistant最新版Rockchip 驱动安装助手
Linux_Upgrade_Toolv2.1+Linux 烧录工具

3.2 固件文件

烧录需要以下固件文件（由 SDK 编译产出）：

文件说明
update.img完整烧录镜像（含所有分区）
MiniLoaderAll.bin一级引导加载器
uboot.imgU-Boot 引导程序
boot.img内核 + 设备树 + ramdisk
rootfs.img根文件系统

固件文件由 RK3588 Linux 6.1 SDK 编译产出，具体编译方法见 SDK下载与编译环境搭建。

4. 驱动安装

4.1 Windows 驱动

  1. 下载 Driver Assistant 最新版
  2. 解压并运行 DriverInstall.exe
  3. 点击"驱动安装"按钮
  4. 安装完成后，设备管理器中应能看到 Rockusb 设备

4.2 驱动验证

将开发板进入 MaskROM 模式并连接 USB 后：

  • 打开设备管理器
  • 确认出现"Class for Rockusb Devices"或"Rockusb Device"
  • 如果出现黄色感叹号，尝试更新驱动或更换 USB 口

5. 烧录操作

5.1 RKDevTool 烧录（Windows）

  1. 打开 RKDevTool
  2. 选择"升级固件"标签页
  3. 点击"固件"按钮，选择 update.img
  4. 点击"升级"按钮开始烧录
  5. 等待烧录完成，开发板将自动重启

5.2 Linux 线刷

# 安装 Linux_Upgrade_Tool
sudo ./upgrade_tool

# 列举设备
sudo upgrade_tool ld

# 烧录完整固件
sudo upgrade_tool uf update.img

5.3 SD 卡启动

  1. 使用 SD 卡烧录工具将固件写入 SD 卡
  2. 将 SD 卡插入开发板 TF 卡槽
  3. 开发板将优先从 SD 卡启动

6. 验证

6.1 烧录成功验证

烧录完成后，通过串口终端连接开发板，上电后应看到：

DDR ...
RK3588 ...

具体启动日志内容取决于固件版本和配置。

6.2 常见问题

现象可能原因处理方法
设备管理器未识别驱动未安装或 USB 口问题重新安装驱动，更换 USB 口
烧录失败USB 连接不稳定更换 USB 线缆，使用 USB 2.0 口
烧录后无法启动固件版本不匹配确认固件与开发板型号匹配

相关文档