幸狐 Luckfox Pico Pi / Pi W 刷机教程：拨码开关与 eMMC 烧录

先确认型号

Luckfox Pico Pi 系列有四款，接口布局相同（百兆网口带 PoE、4 个 USB-A、40 针排针），系统装在板载 8 GB eMMC 里：

板上的 TF 卡槽只能当存储扩展，不能从 TF 卡启动系统。本站收录的镜像分成不带无线和带无线两个文件，按有没有无线选。

注意本站文件按有无无线分开，带 W 的型号选文件名带 W 的镜像。这是按文件名判断的，Luckfox 没有逐个型号写明。

准备

• 一根能传数据的 USB-A 转 USB-C 线，接板子的 USB-C 口。
• Windows 电脑：本站的 SocToolKit，以及 RKDevTool 页 里的驱动助手 DriverAssistant。Linux 或 macOS 用 upgrade_tool。
• 先装驱动：运行驱动助手，点“驱动安装”，装完重启电脑。这一步不用接板子。

警告刷机前必须把板上左边的拨码开关拨到 ON（USB Device 模式）。拨在 1 时是 USB Host 模式，USB-C 口只供电、不通信，电脑和刷机工具都认不到板子。

下载哪个文件

• 这些都是 Luckfox 的官方 Buildroot 镜像，本站目前最新是 250607 版。幸狐官方说明 Ubuntu 镜像为第三方镜像，本站不提供；需要时请到幸狐页面了解。
• 文件名里的 6 位数字是镜像日期。Luckfox 要求烧最新日期的镜像，厂商网盘上可能有比本站更新的版本。
• 下载后先核对 SHA-256，方法见 如何核对下载文件的 SHA-256，再用 7-Zip 完整解压，文件夹里的 update.img 就是要刷的整包。

注意这些文件要用 SocToolKit 或 upgrade_tool 通过 USB 线刷进 eMMC，不能用写卡工具写。

方法一：Windows 用 SocToolKit 刷 eMMC

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

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

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

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

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

方法二：Linux 或 macOS 用 upgrade_tool

第一次在 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. 拨码开关拨到 ON，按住 BOOT 键接上电脑，让板子进入刷机模式。
2. 进入解压出来的文件夹，执行：

sudo upgrade_tool uf update.img

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

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

第一次开机：怎么登录

• SSH（网线）：接上路由器后板子会自动获取 IP，在路由器后台找到它，然后 ssh root@板子IP。
• ADB 或 USB 网络：拨码开关在 ON 时，用 USB 线接电脑执行 adb shell；或把电脑上新出现的 RNDIS 虚拟网卡的 IPv4 设成 172.32.0.100，再 ssh root@172.32.0.93。
• 串口：波特率 115200，接线见 用 USB 转 TTL 串口调试开发板。

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

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

提示要用板上的 4 个 USB-A 口（键盘、U 盘等），需要把拨码开关拨到 1（USB Host 模式），并在系统里用 luckfox-config 切到 Host 模式。此时 USB-C 只能供电，ADB 也会断开。

刷坏了怎么救

• 不开机、刷错了镜像：拨码开关拨到 ON，按住 BOOT 键再接电脑进入刷机模式，按方法一重新刷本型号的镜像。
• 电脑完全认不到板子：先看拨码开关是不是在 ON，再换一根能传数据的线。
• 想清空 eMMC：Luckfox 的方法是在 SocToolKit 里载入 update.img 后执行擦除（Luckfox 文档写作 Erase Flash），然后重新刷。
• SocToolKit 识别不到设备：确认驱动助手装好并重启过；临时关闭可能误删工具文件的杀毒软件；改插电脑后面板的 USB 口，不要经过 USB 集线器；日志卡在“下载 DownloadBin...失败”时换一根好的 USB-C 数据线。

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

资料来源

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

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