幸狐 Luckfox Pico Pro / Max 刷机教程：SPI NAND 与 TF 卡烧录 Buildroot、Ubuntu

先确认是 Pico Pro 还是 Pico Max

两款板子外形和接口完全一样，Buildroot 镜像也通用，只有 Ubuntu 镜像分开：

分不清时，一般可以看主芯片上的型号印字（RV1106G2 还是 G3），这不是 Luckfox 给出的方法，以购买时的型号为准。两款都没有 eMMC，也没有无线网卡。出厂时 SPI NAND 里只有工厂测试用的镜像，拿到板子后要自己刷系统。

准备

• 一根能传数据的 USB-A 转 USB-C 线，接板子上的 USB-C 口。
• Windows 电脑：本站的 SocToolKit，以及 RKDevTool 页 里的驱动助手 DriverAssistant。Linux 或 macOS 用 upgrade_tool，但它不能写 TF 卡。
• 写 TF 卡时：一张 8 GB 以上的 TF 卡和读卡器，以及 SD Card Formatter（本站暂未收录，从文末“官方资料”进入 Luckfox 页面获取）。
• 先装驱动：运行驱动助手，点“驱动安装”，装完重启电脑。这一步不用接板子。

下载哪个文件

• 建议选 Buildroot：Luckfox 把 Buildroot 列为官方推荐镜像，本站目前最新是 250607 版。Ubuntu 镜像被 Luckfox 列为“第三方镜像”，只有 TF 卡版本，本站收录的是 250313 版。
• 文件名里的 6 位数字是镜像日期。Luckfox 要求烧最新日期的镜像，厂商网盘上可能有比本站更新的版本。
• Luckfox 只为 Pro/Max 提供 TF 卡版本的 Ubuntu 镜像，没有 SPI NAND 版本。
• 下载后先核对 SHA-256，方法见 如何核对下载文件的 SHA-256，再用 7-Zip 完整解压，得到一个同名文件夹。

注意这些压缩包都要用 SocToolKit 写入，不能用 balenaEtcher 等写卡工具直接写，也不能把里面的 update.img 当成整盘镜像写进 TF 卡。

方法一：刷进板载 SPI NAND（Windows）

1. 右键 SocToolKit，以管理员身份运行。弹出“选择芯片（Chip Selection）”时选 RV1106，点 OK。
2. 按住板上的 BOOT 键不放，用 USB 线把板子接到电脑，然后松开。

应看到：SocToolKit 顶部 USB 一栏显示 Maskrom 或 Loader 设备（后面的编号每台电脑不同）。

1. 在“固件下载（Download）”页，点“固件...（Firmware...）”，选解压出来的 update.img。
2. 点“升级（Upgrade）”，等右侧日志走完。

应看到：日志里出现 Upgrade firmware ok.，最后一行是 Upgrade update...OK（中文界面为“升级update...成功”）。下载页的“重启设备（reset）”保持勾选时，板子随后会自动重启。

板子已经能开机、并且能用 ADB 登录时，不用按键：执行 adb shell 登录后运行 reboot loader，板子会直接进入刷机模式。

提示Luckfox 还提供“分区选择性烧录”：点“搜索路径...（Search Path...）”选解压出来的文件夹，勾选全部分区后点“下载（Download）”。它和上面的整包升级二选一即可，不用两种都做。

方法二：做 TF 卡启动（Windows）

1. 用读卡器把 TF 卡接到电脑，拔掉其他 U 盘和存储卡。打开 SD Card Formatter，选中这张卡，点 Format。
2. 以管理员身份运行 SocToolKit，芯片选 RV1106，切到“SD卡工具（SDTool）”页。
3. 在“Usb 磁盘（Usb Disk）”一栏确认显示的是这张卡的容量。
4. 选“SD 启动（SD Boot）”，点“选择启动文件...（Boot Files...）”，选中解压文件夹里的 boot.img、env.img、idblock.img、oem.img、rootfs.img、uboot.img、userdata.img。不要选 `update.img`。
5. 点“创建SD（Create SD）”，确认目标磁盘后开始写入。

应看到：右侧日志最后出现 Create sdcard OK（中文界面为“创建SD卡成功”）。

1. 把卡插进板子的 TF 卡槽，上电启动。

警告创建 TF 卡会清空整张卡。工具识别不到卡时，关掉 SocToolKit，重新以管理员身份运行。

提示SPI NAND 和 TF 卡里都有系统时，Luckfox 没有写明优先从哪个启动。想从 SPI NAND 启动就拔掉 TF 卡。

方法三：Linux 或 macOS（只能刷 SPI NAND）

第一次在 Linux 上使用时，先按 Luckfox 的步骤安装本站 upgrade_tool 页的 Linux 版（2.17）：

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
sudo upgrade_tool -v

应看到：Upgrade Tool v2.17。macOS 版解压后在工具所在目录用 sudo ./upgrade_tool 运行。

1. 按住 BOOT 键接上电脑，让板子进入刷机模式。Linux 上可以在进入刷机模式前后各运行一次 lsusb，对比多出来的设备。
2. 进入解压出来的文件夹，执行：

sudo upgrade_tool uf update.img

macOS 版在工具所在目录执行 sudo ./upgrade_tool uf 镜像路径/update.img。

应看到：最后一行是 Upgrade firmware ok.。

Linux 方法 Luckfox 只在 Ubuntu 22.04 x86_64 上验证过。

第一次开机：怎么登录

• 最简单：ADB。用 USB 线接电脑，在命令行执行 adb shell 直接进入板子。
• SSH（网线）：Luckfox 写明 Pro/Max 的最新固件默认开启 SSH。接上路由器后板子会自动获取 IP，在路由器后台找到它，然后 ssh root@板子IP（Ubuntu 用 pico 登录，不是 root）。
• SSH（USB 线）：电脑上会多出一个 RNDIS 虚拟网卡，把它的 IPv4 设成 172.32.0.100，再 ssh root@172.32.0.93（Ubuntu 镜像为 ssh pico@172.32.0.70）。
• 串口：波特率 115200，接线见 用 USB 转 TTL 串口调试开发板。

提示USB 线 SSH 连不上时，检查 Windows 防火墙是否拦截了这个 RNDIS 虚拟网卡。

登录后先用 passwd 改掉默认密码。更多方式见 开发板首次启动。

提示Buildroot 写进 TF 卡后只用到约 8 GB，卡再大也一样，这是镜像的分区设定，不是卡坏了。

刷坏了怎么救

• 不开机、刷错了镜像：按住 BOOT 键再接电脑，板子会进入刷机模式（MaskRom 或 Loader），按方法一重新刷 Luckfox_Pico_Pro_Max_Flash_… 即可。
• 想清空 SPI NAND：Luckfox 的方法是在 SocToolKit 里载入 update.img 后执行擦除（Luckfox 文档写作 Erase Flash），然后重新刷。
• SocToolKit 识别不到设备：确认驱动助手装好并重启过；临时关闭可能误删工具文件的杀毒软件；改插电脑后面板（主板直连）的 USB 口，不要经过 USB 集线器。
• 日志卡在“下载 DownloadBin...失败”：Luckfox 说多半是线的问题，换一根质量好的 USB-C 数据线。
• 在虚拟机里刷，卡在“下载 env...失败”：插拔设备时虚拟机会弹窗询问 USB 设备归属，要选择连接到虚拟机。

其他情况见 开发板刷坏了怎么办。

资料来源

按幸狐 Luckfox Wiki 的 Luckfox Pico Pro / Max 产品介绍、镜像介绍和下载、镜像烧录（SocToolKit 与 upgrade_tool）、登录和常见问题页面整理（2026-10-22 查阅），SocToolKit 中文按钮名取自本站收录的 2.2 版。

提示本页按厂商官方文档整理，本站没有在实机上测试。按键位置和文件名以你的板子和 Luckfox 官方说明为准。