跳到主要内容

镜像烧录

Lyra 系列开发板支持在 Windows、Linux（x86_64） 和 macOS 环境下进行镜像烧录。请根据所使用的主机操作系统选择对应的烧录方式。

主机系统支持烧录介质烧录工具
WindowsSPI Flash、eMMC、TF 卡RKDevTool、SDDiskTool
Linux（x86_64）SPI Flash、eMMCUpgrade_Tool
macOSSPI Flash、eMMCupgrade_tool

1. Windows 镜像烧录​

  1. 打开瑞芯微烧录工具 RKDevTool，确认设备已进入 MASKROM 或 LOADER 模式。点击 Firmware，选择系统镜像路径，并打开 update.img 镜像文件。

  2. 等待镜像加载完成后，点击 升级（Upgrade） 开始烧录。

  3. 烧录完成后，软件界面显示 下载成功，表示镜像已成功烧录。

2. 镜像烧录（Linux 环境）​

提示

目前镜像的成功烧录仅在 Ubuntu 环境下完成验证，其他 Linux 发行版本需用户自行测试。

2.1 开发板进入烧录模式​

按住BOOT按键的同时连接主机，使开发板进入烧录模式。执行 lsusb 命令后，可通过以下示例对比开发板在 烧录模式 与 正常运行模式 下的设备识别信息。

  • 开发板处于烧录模式：

    xxx

  • 开发板成功进入系统：

    xxx

提示

当虚拟机无法识别开发板时，通常可能由以下两种情况导致：

  1. **USB 连接线异常：**若重新插拔后无任何反应，且未出现系统或 VMware 弹窗提示，通常为数据线损坏或接触不良。此时建议更换 USB 线后再次尝试。
  2. **VMware 弹窗未及时选择导致设备未分配：**插入设备时，VMware 会弹出提示以选择设备连接到“宿主机”或“虚拟机”。 如果用户未在弹窗消失前进行选择，且 VMware 的“自动连接策略”未配置明确，设备的控制权会处于未分配状态——即设备既未被宿主机接管，也未成功挂载至虚拟机。 此时需重新拔插设备，使系统重新分配控制权。

2.2 独立镜像烧录（无需 SDK）​

  1. 下载、解压和安装upgrade_tool ：

    sudo unzip upgrade_tool_v2.17.zip
    cd upgrade_tool_v2.17_for_linux/
    sudo cp upgrade_tool /usr/local/bin
    sudo chmod +x /usr/local/bin/upgrade_tool

  2. 测试是否安装成功：

    ubuntu@ubuntu:~$ sudo upgrade_tool -v
    Upgrade Tool v2.17

  3. 运行程序烧录固件：

    luckfox@luckfox:~$ sudo upgrade_tool uf update.img
    Loading firmware...
    Support Type:1106	FW Ver:0.0.00	FW Time:2023-11-16 16:24:18
    Loader ver:1.01	Loader Time:2023-11-16 16:22:58
    Start to upgrade firmware...
    Download Boot Start
    Download Boot Success
    Wait For Maskrom Start
    Wait For Maskrom Success
    Test Device Start
    Test Device Success
    Check Chip Start
    Check Chip Success
    Get FlashInfo Start
    Get FlashInfo Success
    Prepare IDB Start
    Prepare IDB Success
    Download IDB Start
    Download IDB Success
    Download Firmware Start
    Download Image... (100%)
    Download Firmware Success
    Upgrade firmware ok.

  4. 效果如下：

    KVM

2.3 使用 SDK 脚本一键烧录镜像​

提示

在 output/image 目录下需存在 update.img 镜像文件,该目录通常由 自行编译 SDK 时自动生成。下载解压 SDK，具体操作方法参考《SDK开发环境搭建》部分。 若尚未编译过 SDK，则需手动创建 output/image 文件夹，并将从网盘获取的镜像文件放入其中，文件名必须为 update.img。

  1. 按住BOOT按键的同时连接主机，使开发板进入烧录模式。

  2. 以管理员工权限执行脚本。

    $ sudo ./rkflash.sh update
    [sudo] password for ubuntu:
    Using /home/ubuntu/Luckfox/rk3506/luckfox-lyra-sdk/tools/linux/Linux_Upgrade_Tool/Linux_Upgrade_Tool/config.ini
    Loading firmware...
    Support Type:350F	FW Ver:8.1.00	FW Time:2024-12-13 19:40:06
    Loader ver:1.01	Loader Time:2024-12-13 18:35:14
    Start to upgrade firmware...
    Test Device Start
    Test Device Success
    Check Chip Start
    Check Chip Success
    Get FlashInfo Start
    Get FlashInfo Success
    Prepare IDB Start
    Prepare IDB Success
    Download IDB Start
    Download IDB Success
    Download Firmware Start
    Download Image... (100%)
    Download Firmware Success
    Upgrade firmware ok.

  3. 效果如下：

3. Mac OS​

upgrade_tool 不仅提供了 Linux 版本，还支持 macOS 平台。

  1. 根据 Mac 电脑的处理器架构 下载并解压对应版本的 Upgrade Tool 烧录工具。
系统版本烧录工具版本下载链接
MacOS 12.7upgrade_tool_v2.25_for_mac.zip下载
MacOS 26.1upgrade_tool_v2.44_for_mac.zip下载
  1. 按照当前产品教程开头针对相应型号说明的方式进入烧录模式。带外壳且能够正常启动的 Luckfox Pico 86-Panel，请登录开发板后执行 reboot loader。
  2. 运行程序烧录固件：
提示

以下命令仅为示例，请根据镜像文件的实际名称及存放路径自行修改。

   cd upgrade_tool_v2.44_mac
   sudo ./upgrade_tool uf Luckfox-xxx-xxx.img
  1. 效果如下：

4. 镜像擦除​

  • 需要擦除EMMC中的数据，选中update.img固件点击擦除Flash即可：

5. TF卡镜像烧录​

  1. 下载 TF 卡格式化工具 SD Card Formatter，解压后一键安装即可。
  2. 选择 TF 卡盘符，然后点击 Format。操作前请移除其他 TF 卡，避免误格式化导致数据丢失。

  1. 下载 TF 卡烧录工具，解压后无需安装即可使用。
工具版本说明下载
SDDiskTool v1.78推荐使用下载
SDDiskTool v1.69兼容版本，v1.78 异常时可尝试下载