跳到主要内容

镜像烧录

1. 准备工作​

出厂镜像主要用于测试开发板接口功能是否正常，更新频率较低。为保障开发板的正常使用，建议用户收到开发板后，使用 USB Type-A to Type-C 数据线等工具，自行烧录网盘提供的系统镜像。针对 Luckfox Lyra 系列开发板不同版本，存储介质使用规则如下：

  • Lyra B/Plus 版本：板载 256MB SPI NAND Flash，用户可自主选择以 Flash 或 TF 卡作为存储介质
  • Ultra 版本：采用 eMMC 存储方案，不支持 TF 卡作为存储介质
  • 基础版本：无板载 Flash，需通过读卡器将镜像写入 TF 卡，且仅支持从 TF 卡启动，不支持板上直接烧录

2. 镜像下载​

Lyra 系列提供了适配 DSI 显示屏的镜像。用户可以根据自己的需求下载镜像文件。镜像命名规则：Luckfox-(开发板型号)-(开发板系统)-(存储介质)-(更新时间)。

  • 开发板型号：Lyra、Lyra B、Lyra Plus、Lyra Ultra/Ultra W、Lyra Zero W 和 Lyra Pi

  • 开发板系统：ubuntu、Buildroot

  • 存储介质：SPI NAND FLASH、TF 卡 和 eMMC

官方 Buildroot 镜像

版本描述下载
Buildroot支持 SPI NAND FLASH、TF 卡、eMMC 三种存储介质烧录镜像百度网盘下载链接

第三方 Ubuntu22.04 镜像

版本描述下载
Ubuntu22.04支持 TF 卡、eMMC 两种存储介质烧录镜像百度网盘下载链接

3. 安装驱动​

  1. 下载 RK 驱动助手 DriverAssitant-RK驱动助手和刷机工具RKDevTool。

  2. 打开 RK 驱动助手 DriverAssitant 安装 USB 驱动程序，此过程无需连接，安装完成后重启电脑。

3.1 进入升级模式​

Loader 模式和 MaskRom 模式是两种常见的设备升级模式，用于加载固件或引导程序。

  • Loader 模式通过软件层面的引导程序进行加载，通常用于固件升级等操作。
  • MaskRom 模式是一种硬件层面的启动模式，通过直接加载固件来进行操作，通常用于出厂烧录或设备修复。

3.1.1 Loader模式​

开发板出厂时会预装测试镜像，出厂镜像主要是测试开发板功能是否正常，用户收到开发板后，还需要自己重新烧录网盘镜像。在烧录系统前，必须将开发板切换到 LOADER 模式或 MASKROM 模式，建议优先使用 LOADER 模式。

  1. 打开 RKDevTool 工具。

  2. 按住BOOT键连接电脑，连接电脑后松开BOOT键，当看到下方提示Found One LOADER Device就可以进行镜像烧录了。

  3. 如果已经连接电脑，可以不用重新插拔，按住RESET键，然后按住BOOT键，松开RESET键。当设备被识别为 LOADER 模式时，松开BOOT键。

  4. 注意：如果未正常识别成 Loader 设备，检查设备管理器下是否正确识别开发板，正确识别开发板设备管理器显示的应为：

    • 烧录模式：
    • 未进入烧录模式成功进入系统（内核正常启动，此时开发板 LED 闪烁）：

3.1.2 MaskRom模式（谨慎使用）​

如果设备进入不了 Loader 模式，此时才可以尝试强行进入 MaskRom 模式。

  1. 连接数据线，打开瑞芯微刷机工具 RKDevTool。
  2. 断开 Lyra Plus 电源，短接开发板上 Flash 的 FSPI_CLK 和 GND 引脚，连接 USB。当烧录软件识别到开发板后，断开短接。



  3. 接通电源，就会看到下方提示Found One MASKROM Device，下载完成后取下跳线帽。

4. 镜像烧录(FLASH 和 eMMC)​

4.1 Windows 镜像烧录​

  1. 打开瑞芯微刷机工具 RKDevTool，此时会看到设备处于MASKROM/LOADER模式，点击 Fiemware，选择系统镜像路径，打开update.img镜像文件。

  2. 打开后需等待镜像加载成功，点击升级。

  3. 烧录完成后，此时会看到“下载成功”。

4.2 Linux（X86_64 平台）​

Upgrade_Tool是 Linux 下用来烧写原始固件、RK 固件和分区映像到 eMMC 的工具，是 Rockchip 提供的闭源命令行工具。此工具仅支持使用 SPI NAND FLASH 进行烧录。若需将固件烧录至 TF 卡，则需要在 Windows 环境下使用 SDDiskTool 软件进行烧录。我们使用的 rkflash.sh 脚本和 Upgrade_Tool 工具默认存放在 SDK 中。SDK 推荐使用 Ubuntu 22.04 系统，我们的测试环境也是 Ubuntu 22.04。对于其他版本的系统，烧录操作可能需要自行研究。

  1. 按下 boot 按键连接主机，使用 lsusb 查看设备，如果未识别设备尝试更换Type-c线解决。
    • Lyra Plus 主机处于“ADB”模式
    • Lyra Plus 主机处于“LOADER”模式
    • Lyra Plus 主机处于“MASKROM”模式

  1. 只有 Lyra Plus 主机处于“LOADER” 或者“MASKROM”模式的时候才能烧录。

  2. 下载解压 SDK，具体操作方法参考《SDK开发环境搭建》部分。

    $ ls -l
    total 3124652
    drwxrwxr-x  4 ubuntu ubuntu       4096 12月 13 17:16 app
    drwxrwxr-x 19 ubuntu ubuntu       4096 12月 13 18:35 buildroot
    lrwxrwxrwx  1 ubuntu ubuntu         39 12月 13 17:16 build.sh -> device/rockchip/common/scripts/build.sh
    lrwxrwxrwx  1 ubuntu ubuntu         22 12月 13 17:19 common -> device/rockchip/common
    drwxrwxr-x  3 ubuntu ubuntu       4096 12月 13 17:16 device
    drwxrwxr-x  8 ubuntu ubuntu       4096 12月 13 17:16 docs
    drwxrwxr-x 16 ubuntu ubuntu       4096 12月 13 17:16 external
    drwxrwxr-x 11 ubuntu ubuntu       4096 12月 13 17:16 hal
    lrwxrwxrwx  1 ubuntu ubuntu         10 12月 13 17:17 kernel -> kernel-6.1
    drwxrwxr-x 27 ubuntu ubuntu       4096 12月 13 19:39 kernel-6.1
    lrwxrwxrwx  1 ubuntu ubuntu         31 12月 13 17:16 Makefile -> device/rockchip/common/Makefile
    drwxrwxr-x  7 ubuntu ubuntu       4096 12月 13 19:40 output
    drwxrwxr-x  3 ubuntu ubuntu       4096 12月 13 17:17 prebuilts
    lrwxrwxrwx  1 ubuntu ubuntu         32 12月 13 17:19 README.md -> device/rockchip/common/README.md
    -rw-r--r--  1 ubuntu ubuntu 3199580732 12月 13 17:09 repo_1213.tar.gz
    drwxrwxr-x 10 ubuntu ubuntu       4096 12月 13 18:35 rkbin
    lrwxrwxrwx  1 ubuntu ubuntu         41 12月 13 17:16 rkflash.sh -> device/rockchip/common/scripts/rkflash.sh
    lrwxrwxrwx  1 ubuntu ubuntu         15 12月 13 19:40 rockdev -> output/firmware
    drwxrwxr-x 15 ubuntu ubuntu       4096 12月 13 17:17 rtos
    drwxrwxr-x  6 ubuntu ubuntu       4096 12月 13 17:17 tools
    drwxrwxr-x 28 ubuntu ubuntu       4096 12月 13 18:35 u-boot
    drwxrwxr-x  8 ubuntu ubuntu       4096 12月 13 17:17 yocto

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

    $ 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.

  4. 效果如下：

4.3 Mac OS​

  1. 下载、解压upgrade_tool ：

    sudo ditto -xk upgrade_tool_v2.3_mac.zip .

  2. 运行程序烧录固件（请根据镜像的实际存放位置来修改路径）：

    cd upgrade_tool_v2.3_mac
    sudo ./upgrade_tool uf Luckfox-RK3576-Debian12-Xfce-HDMI-202409.img

  3. 效果如下：

4.4 镜像擦除​

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

5. TF卡镜像烧录​

  1. 下载TF卡擦除工具 SD Card Formatter，解压一键安装即可。

  2. 选择TF卡盘符，点击 Format（注意移除其它的TF卡，以免造成数据丢失）

  3. 下载 TF 卡烧录工具 SDDiskTool，解压无需安装即可使用。