幸狐 Luckfox Lyra Pi / Pi W 刷机教程：A 型刷 eMMC、B 型写 TF 卡

先确认型号

Luckfox Lyra Pi 系列是 RK3506B 芯片、512 MB 内存的板子，带 2 个百兆网口（其中 1 个支持 PoE）。四款的区别在于存储和无线，A 型号用 eMMC，B 型号用 TF 卡：

Luckfox 写明 A 型号只支持 eMMC 启动，B 型号只支持 TF 卡启动、不支持 USB 线刷。按购买时的型号选，别装错。

准备

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

下载哪个文件

• 不带无线的 Pi A、Pi B：Lyra Pi 镜像页，A 下 EMMC 文件，B 下 MicroSD 文件。
• 带无线的 Pi A W、Pi B W：Lyra Pi W 镜像页，同样按 A / B 选 EMMC 或 MicroSD。
• 这些都是 Luckfox 官方的 Buildroot 系统，本站目前是 250717（W 为 250718）版。文件名里的 6 位数字是镜像日期，厂商网盘上可能有更新的版本。
• 幸狐官方说明 Ubuntu 镜像为第三方镜像，本站不提供；需要时请到幸狐页面了解。
• 下载后先核对 SHA-256，方法见 如何核对下载文件的 SHA-256，再用 7-Zip 完整解压，文件夹里的 update.img 就是要用的文件。

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

方法一：刷进 eMMC（Lyra Pi A、Lyra Pi A 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 卡启动（Lyra Pi B、Lyra Pi B W，Windows）

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

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

第一次开机：怎么登录

Buildroot 默认账号 root，密码 luckfox，最新固件默认开启 SSH。

• SSH（网线）：网口接路由器，板子会自动获取 IP，在路由器后台找到它（或用 ADB、串口登录后执行 ifconfig 查看），然后 ssh root@板子IP。
• ADB 或 USB 网络：用 USB 线接电脑，执行 adb shell；或把电脑上新出现的 RNDIS 虚拟网卡的 IPv4 设成 192.168.123.99，再 ssh root@192.168.123.100。
• 串口：波特率 1500000，推荐 CH343、FT232、CP2102 串口模块，接线见 用 USB 转 TTL 串口调试开发板。

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

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

刷坏了怎么救

• Pi A 刷错了、不开机：先试 Loader 模式（按住 BOOT 再接电脑），按方法一重新刷 EMMC 包。
• Loader 模式进不去：断开电源，按 Luckfox 文档中的图示把 MaskRom 触点短接到 GND，再接 USB 线；RKDevTool 显示“发现一个MASKROM设备”（Found One MASKROM Device）后断开短接，按方法一刷写，完成后重新上电。
• 想清空 eMMC：在 RKDevTool 里选中 update.img，点“擦除Flash（EraseFlash）”，然后重新刷。
• Pi B 启动不了：TF 卡用 SD Card Formatter 重新格式化，按方法二重做；仍不行就换 SDDiskTool 1.69 版。

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

资料来源

按幸狐 Luckfox Wiki 的 Luckfox Lyra Pi 产品介绍，Lyra 系列镜像介绍和下载、镜像烧录与登录页面整理（2026-10-22 查阅）。

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