幸狐 Luckfox Lyra / Lyra Plus / Lyra Zero W 刷机教程：SPI NAND 与 TF 卡烧录

先确认型号

本页适用于 Luckfox Lyra、Lyra B、Lyra Plus 和 Lyra Zero W。四款都是 RK3506 芯片、没有 eMMC，系统装在板载 SPI NAND 或 TF 卡里：

Luckfox 说明 Lyra 和 Lyra B 的主要区别在默认存储：Lyra 用 TF 卡，Lyra B 有 256 MB SPI NAND，按购买时的型号区分。Lyra Plus 就是在 Lyra B 的基础上加了一个网口。Lyra Pi 和 Lyra Ultra 用 eMMC，请看 幸狐 Luckfox Lyra Pi 刷机教程 和 幸狐 Luckfox Lyra Ultra 刷机教程。

准备

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

注意Lyra 系列用的是 RKDevTool 和 SDDiskTool，不是 Pico 系列的 SocToolKit。

下载哪个文件

• 文件名里 Flash 表示写板载 SPI NAND，MircoSD（厂商原文如此拼写）或 MicroSD 表示写 TF 卡。
• 这些都是 Luckfox 官方的 Buildroot 系统，本站目前是 250717 版。文件名里的 6 位数字是镜像日期，厂商网盘上可能有更新的版本。
• 幸狐官方说明 Ubuntu 镜像为第三方镜像，本站不提供；需要时请到幸狐页面了解。
• 下载后先核对 SHA-256，方法见 如何核对下载文件的 SHA-256，再用 7-Zip 完整解压，文件夹里的 update.img 就是要用的文件。

注意update.img 是瑞芯微刷机包，必须用 RKDevTool、upgrade_tool 或 SDDiskTool 写入，不能用 balenaEtcher 等写卡工具直接写。

方法一：刷进板载 SPI NAND（Lyra B、Lyra Plus、Lyra Zero W）

1. 解压并打开 RKDevTool。
2. 按住板上的 BOOT 键，用 USB 线把板子接到电脑，接好后松开 BOOT 键。

应看到：RKDevTool 窗口底部显示“发现一个LOADER设备”（英文界面为 Found One LOADER Device）。

已经接着电脑时也可以不拔线：按住 RESET 键，再按住 BOOT 键，松开 RESET 键，等工具识别成 LOADER 设备后再松开 BOOT 键。

1. 在“升级固件（Upgrade Firmware）”页，点“固件（Firmware）”，选解压出来的 update.img，等镜像信息加载完成。
2. 点“升级（Upgrade）”，等右侧进度走完。

应看到：界面显示“下载成功”。系统正常启动后，板上的 LED 会闪烁。

第一次在 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 运行。

Linux 或 macOS：同样按住 BOOT 接上电脑，在解压出来的文件夹里执行 sudo upgrade_tool uf update.img（macOS 版为 sudo ./upgrade_tool uf 镜像路径/update.img），最后一行是 Upgrade firmware ok. 就完成了。

方法二：做 TF 卡启动（所有型号，Windows）

1. 用读卡器把 TF 卡接到电脑，拔掉其他 U 盘和存储卡。打开 SD Card Formatter，选中这张卡，点 Format。
2. 打开 SDDiskTool（不用安装，解压即用）。
3. 第一步“选择可移动磁盘设备”：选你的 TF 卡，核对容量。
4. 第二步“选择功能模式”：勾选“SD启动”。
5. 第三步：点“选择固件”，选 MircoSD（或 MicroSD）文件夹里的 update.img。
6. 点“开始创建”，等进度条走完。
7. 把卡插进板子的 TF 卡槽，上电启动。

警告创建启动卡会清空整张卡。Luckfox 推荐 SDDiskTool 1.78 版，遇到异常可以换 1.69 版再试（1.69 版本站暂未收录）。

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

第一次开机：怎么登录

Buildroot 默认账号 root，密码 luckfox。Luckfox 写明 Lyra 系列最新固件默认开启 SSH。

• ADB：用 USB 线接电脑，执行 adb shell 直接进入板子。
• SSH（USB 线）：Lyra、Lyra B、Lyra Zero W 没有网口，用这种方式。板子的 USB 网络固定地址是 192.168.123.100，把电脑上新出现的 RNDIS 虚拟网卡的 IPv4 设成 192.168.123.99，再 ssh root@192.168.123.100。
• SSH（网线，仅 Lyra Plus）：接上路由器后板子会自动获取 IP，在路由器后台找到它，或登录后用 ifconfig 查看。
• 串口：波特率 1500000。Luckfox 推荐 CH343、FT232、CP2102 串口模块，不推荐 PL2303、CH340。接线见 用 USB 转 TTL 串口调试开发板。

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

登录后先用 passwd 改掉默认密码。

刷坏了怎么救

• 刷错了、不开机（有 SPI NAND 的型号）：先试 Loader 模式（按住 BOOT 再接电脑），按方法一重新刷本型号的 Flash 包。
• Loader 模式进不去：Luckfox 说只有这时才强制进 MaskRom 模式。断开电源，按 Luckfox 文档中该型号的图示，把 MaskRom 触点短接到 GND，再接上 USB 线；RKDevTool 识别到设备后断开短接。应看到：工具显示“发现一个MASKROM设备”（Found One MASKROM Device），然后按方法一刷写，完成后重新上电。
• 想清空 SPI NAND：在 RKDevTool 里选中 update.img，点“擦除Flash（EraseFlash）”，然后重新刷。
• TF 卡启动不了：用 SD Card Formatter 重新格式化，再按方法二重做；仍不行就换 SDDiskTool 1.69 版。
• 识别不到设备：重装驱动助手并重启电脑，换一根能传数据的线，直接插电脑的 USB 口。

其他情况见 瑞芯微开发板 USB 线刷 和 开发板刷坏了怎么办。

资料来源

按幸狐 Luckfox Wiki 的 Luckfox Lyra / Lyra B、Lyra Plus、Lyra Zero W 产品介绍与引脚图，Lyra 系列镜像介绍和下载、镜像烧录、登录和 FAQ 页面整理（2026-10-22 查阅）。

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