零基础实战Ubuntu 22.04环境下为Luckfox RK3506B开发板烧录Linux系统第一次拿到Luckfox RK3506B开发板时面对这个仅有信用卡大小的硬件许多开发者既兴奋又忐忑。作为Rockchip阵营的新锐产品RK3506B凭借其四核Cortex-A35架构和Mali-G31 GPU在嵌入式领域展现出强劲潜力。但要让这块开发板真正运转起来系统烧录就成了必须跨越的第一道门槛。不同于树莓派等开箱即用的开发板Luckfox需要用户手动完成整个Linux系统的烧写过程。这对嵌入式新手而言可能是个挑战——从工具链配置到镜像下载从进入Loader模式到分区烧录每个环节都可能隐藏着让初学者卡壳的细节问题。本文将用最直观的方式带你一步步完成从零开始的完整烧录流程。1. 环境准备与工具安装在开始烧录之前我们需要确保主机环境配置正确。推荐使用Ubuntu 22.04 LTS作为开发环境这是目前最稳定的Linux发行版之一对Rockchip系列工具的支持也最为完善。1.1 安装基础依赖首先更新系统软件源并安装必要的依赖库sudo apt update sudo apt install -y libusb-1.0-0-dev libssl-dev这些库是后续工具运行的基础特别是libusb用于USB设备通信而libssl则提供加密支持。1.2 安装rkdeveloptoolrkdeveloptool是Rockchip官方提供的烧录工具我们需要从源码编译安装最新版本git clone https://github.com/rockchip-linux/rkdeveloptool cd rkdeveloptool autoreconf -i ./configure make sudo make install安装完成后可以通过以下命令验证是否成功rkdeveloptool -v正常情况应该显示类似rkdeveloptool version 1.40的版本信息。如果遇到权限问题可能需要将当前用户加入dialout组sudo usermod -a -G dialout $USER然后注销重新登录使更改生效。提示如果在编译过程中遇到错误可能是缺少automake工具可以通过sudo apt install automake解决。2. 获取系统镜像与准备文件Luckfox官方提供了完整的系统镜像包我们需要先下载并解压到合适的工作目录。2.1 下载官方镜像访问Luckfox Wiki或开发者社区找到对应RK3506B的最新系统镜像。通常镜像包会包含以下关键文件文件名称作用描述是否必需MiniLoaderAll.binRockchip引导加载程序是parameter.txt分区表配置参数是uboot.imgU-Boot引导程序是boot.imgLinux内核与初始RAM磁盘是rootfs.img根文件系统镜像是update.img完整系统更新包可选否建议创建一个专门的工作目录存放这些文件mkdir ~/luckfox_image cd ~/luckfox_image # 将下载的镜像文件解压到此目录2.2 理解镜像文件结构每个镜像文件在烧录过程中扮演着不同角色MiniLoaderAll.bin这是Rockchip特有的二级引导程序负责初始化DDR内存和基本外设然后加载U-Bootuboot.img通用的U-Boot引导加载程序提供丰富的启动选项和设备树支持boot.img包含Linux内核(zImage)和初始内存磁盘(initrd)是系统启动的核心rootfs.img完整的根文件系统包含所有应用程序和库文件注意不同版本的镜像可能文件结构略有差异务必参考官方文档确认。3. 连接开发板并进入Loader模式这是整个过程中最容易出错的一步需要特别注意操作时机。3.1 硬件连接准备使用USB-A转USB-C线连接开发板的OTG接口到电脑准备一个5V/2A的电源适配器暂不接通找到开发板上的BOOT按键和RESET按键位置3.2 进入Loader模式的标准操作Rockchip设备需要通过特殊操作进入烧录模式具体步骤如下按住BOOT按键不放插入USB线连接电脑此时仍按住BOOT保持按住BOOT键约3秒后松开最后接通电源适配器成功进入Loader模式后开发板应该处于无显示状态此时可以通过lsusb命令检查设备lsusb | grep 2207:350f如果看到类似Bus 003 Device 005: ID 2207:350f的输出说明设备已被识别。3.3 常见问题排查如果设备未被识别可以尝试以下解决方案更换USB线或USB接口建议使用主板原生USB接口检查rkdeveloptool是否安装正确尝试不同的BOOT按键按压时间2-5秒之间确保开发板供电充足4. 分区烧录全流程确认设备进入Loader模式后我们就可以开始实际的烧录操作了。4.1 查看设备分区信息首先检查开发板的分区表结构sudo rkdeveloptool list-partitions典型输出如下Partition Start Sector End Sector Size Name ----------------------------------------------------------- 0 0 8191 4.0MB uboot 1 8192 16383 4.0MB trust 2 16384 40959 12.0MB boot 3 40960 65535 12.0MB recovery 4 65536 15155135 7.2GB rootfs这个分区布局与parameter.txt中的定义一致烧录时必须确保镜像与分区大小匹配。4.2 分步烧录镜像文件按照Rockchip的要求烧录应该遵循特定顺序烧录Loadersudo rkdeveloptool db MiniLoaderAll.bin烧录U-Bootsudo rkdeveloptool write-partition uboot uboot.img烧录boot分区sudo rkdeveloptool write-partition boot boot.img烧录rootfs分区sudo rkdeveloptool write-partition rootfs rootfs.img每个步骤完成后工具会显示传输进度和校验结果。rootfs.img通常较大烧录可能需要几分钟时间。4.3 验证烧录结果烧录完成后可以再次列出分区信息并检查CRCsudo rkdeveloptool list-partitions --verify如果所有分区都显示验证通过就可以重启设备了sudo rkdeveloptool reboot5. 首次启动与故障排除成功烧录后开发板将自动重启进入新系统这时还需要注意几个关键点。5.1 初始启动流程正常启动顺序应该是红色电源指示灯常亮绿色状态指示灯开始闪烁如果有HDMI输出约15秒后显示登录界面如果是通过串口调试可以使用以下命令连接sudo picocom -b 1500000 /dev/ttyUSB05.2 常见启动问题如果系统无法正常启动可以检查以下几个方面无任何反应确认电源适配器功率足够测量核心电压是否正常卡在U-Boot检查boot.img是否正确烧录尝试重新烧写内核崩溃可能是内存配置问题检查parameter.txt中的参数根文件系统挂载失败确认rootfs.img烧录完整尝试重新烧写5.3 系统优化建议成功启动后建议立即执行以下操作扩展根文件系统分区sudo /usr/bin/resize-rootfs.sh更新软件包sudo apt update sudo apt upgrade -y安装常用开发工具sudo apt install -y build-essential git python3-dev6. 高级技巧与维护掌握基础烧录后还可以了解一些进阶操作来提升开发效率。6.1 自定义分区布局如果需要调整分区大小可以修改parameter.txt文件中的定义。例如要扩大rootfs分区FIRMWARE_VER: 1.0 MACHINE_MODEL: RK3506B MACHINE_ID: 007 MANUFACTURER: LUCKFOX MAGIC: 0x5041524B ATAG: 0x00200800 MACHINE: 0xffffffff CHECK_MASK: 0x80 PWR_HLD: 0,0,A,0,1 TYPE: GPT CMDLINE: mtdpartsrk29xxnand:0x000020000x00004000(uboot),0x000020000x00006000(trust),0x000060000x00008000(boot),0x000060000x0000E000(recovery),-0x00014000(rootfs)修改后需要重新烧写parameter.txt和所有受影响的分区。6.2 备份与恢复系统可以使用dd命令备份整个系统或特定分区# 备份boot分区 sudo rkdeveloptool read-partition boot boot.backup.img6.3 批量烧录技巧对于生产环境可以编写自动化脚本完成烧录#!/bin/bash IMAGES_DIR./images rkdeveloptool db $IMAGES_DIR/MiniLoaderAll.bin for part in uboot boot rootfs; do rkdeveloptool write-partition $part $IMAGES_DIR/$part.img done rkdeveloptool reboot保存为flash.sh后添加执行权限即可一键烧录。
保姆级教程：在Ubuntu 22.04上给Luckfox幸狐RK3506B开发板烧录Linux系统（含rkdeveloptool安装）
发布时间：2026/6/20 4:50:10
零基础实战Ubuntu 22.04环境下为Luckfox RK3506B开发板烧录Linux系统第一次拿到Luckfox RK3506B开发板时面对这个仅有信用卡大小的硬件许多开发者既兴奋又忐忑。作为Rockchip阵营的新锐产品RK3506B凭借其四核Cortex-A35架构和Mali-G31 GPU在嵌入式领域展现出强劲潜力。但要让这块开发板真正运转起来系统烧录就成了必须跨越的第一道门槛。不同于树莓派等开箱即用的开发板Luckfox需要用户手动完成整个Linux系统的烧写过程。这对嵌入式新手而言可能是个挑战——从工具链配置到镜像下载从进入Loader模式到分区烧录每个环节都可能隐藏着让初学者卡壳的细节问题。本文将用最直观的方式带你一步步完成从零开始的完整烧录流程。1. 环境准备与工具安装在开始烧录之前我们需要确保主机环境配置正确。推荐使用Ubuntu 22.04 LTS作为开发环境这是目前最稳定的Linux发行版之一对Rockchip系列工具的支持也最为完善。1.1 安装基础依赖首先更新系统软件源并安装必要的依赖库sudo apt update sudo apt install -y libusb-1.0-0-dev libssl-dev这些库是后续工具运行的基础特别是libusb用于USB设备通信而libssl则提供加密支持。1.2 安装rkdeveloptoolrkdeveloptool是Rockchip官方提供的烧录工具我们需要从源码编译安装最新版本git clone https://github.com/rockchip-linux/rkdeveloptool cd rkdeveloptool autoreconf -i ./configure make sudo make install安装完成后可以通过以下命令验证是否成功rkdeveloptool -v正常情况应该显示类似rkdeveloptool version 1.40的版本信息。如果遇到权限问题可能需要将当前用户加入dialout组sudo usermod -a -G dialout $USER然后注销重新登录使更改生效。提示如果在编译过程中遇到错误可能是缺少automake工具可以通过sudo apt install automake解决。2. 获取系统镜像与准备文件Luckfox官方提供了完整的系统镜像包我们需要先下载并解压到合适的工作目录。2.1 下载官方镜像访问Luckfox Wiki或开发者社区找到对应RK3506B的最新系统镜像。通常镜像包会包含以下关键文件文件名称作用描述是否必需MiniLoaderAll.binRockchip引导加载程序是parameter.txt分区表配置参数是uboot.imgU-Boot引导程序是boot.imgLinux内核与初始RAM磁盘是rootfs.img根文件系统镜像是update.img完整系统更新包可选否建议创建一个专门的工作目录存放这些文件mkdir ~/luckfox_image cd ~/luckfox_image # 将下载的镜像文件解压到此目录2.2 理解镜像文件结构每个镜像文件在烧录过程中扮演着不同角色MiniLoaderAll.bin这是Rockchip特有的二级引导程序负责初始化DDR内存和基本外设然后加载U-Bootuboot.img通用的U-Boot引导加载程序提供丰富的启动选项和设备树支持boot.img包含Linux内核(zImage)和初始内存磁盘(initrd)是系统启动的核心rootfs.img完整的根文件系统包含所有应用程序和库文件注意不同版本的镜像可能文件结构略有差异务必参考官方文档确认。3. 连接开发板并进入Loader模式这是整个过程中最容易出错的一步需要特别注意操作时机。3.1 硬件连接准备使用USB-A转USB-C线连接开发板的OTG接口到电脑准备一个5V/2A的电源适配器暂不接通找到开发板上的BOOT按键和RESET按键位置3.2 进入Loader模式的标准操作Rockchip设备需要通过特殊操作进入烧录模式具体步骤如下按住BOOT按键不放插入USB线连接电脑此时仍按住BOOT保持按住BOOT键约3秒后松开最后接通电源适配器成功进入Loader模式后开发板应该处于无显示状态此时可以通过lsusb命令检查设备lsusb | grep 2207:350f如果看到类似Bus 003 Device 005: ID 2207:350f的输出说明设备已被识别。3.3 常见问题排查如果设备未被识别可以尝试以下解决方案更换USB线或USB接口建议使用主板原生USB接口检查rkdeveloptool是否安装正确尝试不同的BOOT按键按压时间2-5秒之间确保开发板供电充足4. 分区烧录全流程确认设备进入Loader模式后我们就可以开始实际的烧录操作了。4.1 查看设备分区信息首先检查开发板的分区表结构sudo rkdeveloptool list-partitions典型输出如下Partition Start Sector End Sector Size Name ----------------------------------------------------------- 0 0 8191 4.0MB uboot 1 8192 16383 4.0MB trust 2 16384 40959 12.0MB boot 3 40960 65535 12.0MB recovery 4 65536 15155135 7.2GB rootfs这个分区布局与parameter.txt中的定义一致烧录时必须确保镜像与分区大小匹配。4.2 分步烧录镜像文件按照Rockchip的要求烧录应该遵循特定顺序烧录Loadersudo rkdeveloptool db MiniLoaderAll.bin烧录U-Bootsudo rkdeveloptool write-partition uboot uboot.img烧录boot分区sudo rkdeveloptool write-partition boot boot.img烧录rootfs分区sudo rkdeveloptool write-partition rootfs rootfs.img每个步骤完成后工具会显示传输进度和校验结果。rootfs.img通常较大烧录可能需要几分钟时间。4.3 验证烧录结果烧录完成后可以再次列出分区信息并检查CRCsudo rkdeveloptool list-partitions --verify如果所有分区都显示验证通过就可以重启设备了sudo rkdeveloptool reboot5. 首次启动与故障排除成功烧录后开发板将自动重启进入新系统这时还需要注意几个关键点。5.1 初始启动流程正常启动顺序应该是红色电源指示灯常亮绿色状态指示灯开始闪烁如果有HDMI输出约15秒后显示登录界面如果是通过串口调试可以使用以下命令连接sudo picocom -b 1500000 /dev/ttyUSB05.2 常见启动问题如果系统无法正常启动可以检查以下几个方面无任何反应确认电源适配器功率足够测量核心电压是否正常卡在U-Boot检查boot.img是否正确烧录尝试重新烧写内核崩溃可能是内存配置问题检查parameter.txt中的参数根文件系统挂载失败确认rootfs.img烧录完整尝试重新烧写5.3 系统优化建议成功启动后建议立即执行以下操作扩展根文件系统分区sudo /usr/bin/resize-rootfs.sh更新软件包sudo apt update sudo apt upgrade -y安装常用开发工具sudo apt install -y build-essential git python3-dev6. 高级技巧与维护掌握基础烧录后还可以了解一些进阶操作来提升开发效率。6.1 自定义分区布局如果需要调整分区大小可以修改parameter.txt文件中的定义。例如要扩大rootfs分区FIRMWARE_VER: 1.0 MACHINE_MODEL: RK3506B MACHINE_ID: 007 MANUFACTURER: LUCKFOX MAGIC: 0x5041524B ATAG: 0x00200800 MACHINE: 0xffffffff CHECK_MASK: 0x80 PWR_HLD: 0,0,A,0,1 TYPE: GPT CMDLINE: mtdpartsrk29xxnand:0x000020000x00004000(uboot),0x000020000x00006000(trust),0x000060000x00008000(boot),0x000060000x0000E000(recovery),-0x00014000(rootfs)修改后需要重新烧写parameter.txt和所有受影响的分区。6.2 备份与恢复系统可以使用dd命令备份整个系统或特定分区# 备份boot分区 sudo rkdeveloptool read-partition boot boot.backup.img6.3 批量烧录技巧对于生产环境可以编写自动化脚本完成烧录#!/bin/bash IMAGES_DIR./images rkdeveloptool db $IMAGES_DIR/MiniLoaderAll.bin for part in uboot boot rootfs; do rkdeveloptool write-partition $part $IMAGES_DIR/$part.img done rkdeveloptool reboot保存为flash.sh后添加执行权限即可一键烧录。
