【开发准备】RK3568 开发板 OpenHarmony 镜像烧录实操指南

前言
本文专为 RK3568 开发板开发者打造,镜像烧录是嵌入式开发的基础环节,对系统完成修改后,必须通过烧录测试验证修改有效性,避免引入新的程序问题。本文基于 Windows10 系统,详细讲解 RK3568 开发板的 OpenHarmony 镜像(也叫固件)烧录流程。需要注意的是,润和(Hihoop)是该开发板的集成商,Dayu200 是具体型号,而 RK3568 是瑞芯微的芯片型号,三者实际指向同一款开发板。作为 OpenHarmony 生态中首批全支持的标准系统开发板,RK3568 的烧录操作流程简洁,上手难度较低。

一、 操作流程总览

  1. 烧录避坑要点

2.Windows 系统烧录前期准备
3.Windows 系统镜像烧录操作
3.1 Loader 模式烧录 —— 日常开发首选模式
3.2 Maskrom 模式烧录
4.Linux 系统命令行烧录镜像

二、烧录避坑要点

1.如何实现烧录镜像免重复选择路径?

  1. 首次导入原始 config.cfg 配置文件后,选定正确的文件路径,将配置导出并本地保存;
  2. 后续烧录时,直接导入已保存的配置文件,即可跳过路径选择步骤。

2.服务器下载镜像文件完整,但烧录最终提示失败如何解决?

  • 该问题大概率是镜像文件下载不完整导致,表现为文件实际大小远小于正常大小,只需重新完整下载镜像文件后再次烧录即可解决。

3.Gitee 上的最新镜像是否可直接使用

  • 并非绝对可用,部分情况下最新镜像可能持续一周处于异常状态,建议本地至少备份近期验证可用的代码包和镜像包,避免开发中断。

三、Windows 下烧录前准备

3.1. 安装 USB 驱动
双击路径 windows\DriverAssitant\ DriverInstall.exe 打开驱动安装程序,点击下图中的 “驱动安装” 按钮完成安装:
安装 USB 驱动
说明: 1. 若电脑已安装旧版本烧录工具,需先点击 “驱动卸载” 清理旧驱动,再执行 “驱动安装” 操作;2.USB 驱动为一次性安装,后续烧录无需重复操作。

3.2 连接电缆
按照图片指引,依次连接开发板的电源线、Debug 串口调试线和 USB 烧录线,连接完成后打开电源,确认开发板指示灯正常点亮。

连接电缆

3.3 下载镜像

本次提供三种镜像获取方式,可根据开发需求选择:

四、Windows 下烧录镜像

4.1 以 Loader 模式烧录

4.1.1. 将固件下载到本地目录
image.png
image.png
将获取到的 OpenHarmony 固件文件保存至电脑本地指定目录,确保路径无中文和特殊字符,避免烧录识别异常。

4.1.2. 打开烧录工具

  • 保持开发板为开机状态,双击 windows\RKDevTool.exe 打开烧录工具,右键点击界面选择导入配置;

烧录工具

  • 在文件选择窗口中选定 config.cfg 配置文件,点击打开完成导入;

烧录工具g

  • 长按开发板的 Power 键和 VOL+/RECOVER 键超过 6 秒,使开发板关机,此时烧录工具界面提示 "没有发现设备";

image.png

  • 再次按下上述两个按键,烧录工具将提示 "发现一个 LOADER 设备",说明进入 Loader 烧录模式;

image.png

  • 松开按键,点击烧录工具中的 “执行” 按钮开始烧录,等待数秒后,工具右侧信息框提示 “下载完成” 即表示 Loader 模式烧录成功。

4.2. 以 Maskrom 模式烧录

4.2.1. 打开烧录工具

  • 双击 windows\RKDevTool.exe 打开烧录工具,工具默认进入 Maskrom 烧录模式;

image.png

  • 将 OpenHarmony 固件下载并保存至电脑本地目录,在烧录工具界面勾选需要烧录的固件文件。

image.png

4.2.2 确认开发板是否进入烧录模式

  • 若烧录工具界面显示 "发现一个 MASKROM 设备",说明开发板已成功进入 Maskrom 模式,可等待烧录;
  • 若界面显示 "没有发现设备",需按照以下步骤手动让开发板进入 Maskrom 烧录模式:

image.png

  • 同时按住开发板的白色 Maskrom 按键(图中标注①号键)和 RESET 按钮(图中标注②号键)不松开,此时烧录工具显示
    “没有发现设备”;

image.png

  • 先松开 RESET 键,烧录工具界面提示 “发现一个 MASKROM 设备”,即表示开发板成功进入 Maskrom 烧录模式;

image.png

  • 松开所有按键,等待数秒后点击烧录工具的 “执行” 按钮开始烧录。

image.png
说明: 烧录成功时,工具界面右侧会显示 “下载完成”;若烧录失败,右侧将以红色字体显示错误信息,可前往 Log 目录查看详细的出错日志定位问题。

五、Linux 命令行烧录镜像

对于习惯使用 Linux 系统的开发者,可通过命令行完成烧录操作,具体步骤如下:
5.1. 查看开发板是否进入烧录模式

  • 进入 OpenHarmony 系统的根目录,执行以下命令检测开发板烧录模式:python3 flash.py -q
  • 说明: 命令输出 "loader",代表开发板进入 Loader 烧录模式;输出 "maskrom",代表进入 Maskrom 烧录模式;输出 "none",说明未进入烧录模式,需按照前文操作让开发板进入对应烧录模式。

5.2. 烧录固件

全量烧录
烧录所有 OHOS 固件,执行命令:python3 flash.py -a

说明:该命令将一次性烧录 uboot、kernel (boot_linux)、system、vendor、userdata 等所有核心固件。
单独烧录指定固件
可根据开发需求,单独烧录某一个固件,对应命令如下:

python3 flash.py -u //仅烧录 uboot.img
python3 flash.py -k //仅烧录 boot_linux.img
python3 flash.py -s //仅烧录 system.img
python3 flash.py -v //仅烧录 vendor.img
python3 flash.py -d //仅烧录 userdata.img

说明:若需要同时烧录多个指定固件,可组合参数执行命令,例如:-sv 表示同时烧录 system.img 和 vendor.img。
5.3 烧录完成
执行烧录命令后,等待命令行执行完毕,无报错信息即表示烧录完成,此时可重启开发板验证固件是否生效。

发表新评论