幸狐 Luckfox Pico / Mini A/B / Plus 刷机教程:TF 卡与 SPI NAND 烧录系统
RV1103 小板 Luckfox Pico、Pico Mini A/B、Pico Plus 装系统:按型号选 MicroSD 或 Flash 镜像,用 SocToolKit 做 TF 启动卡或刷进 SPI NAND,附 USB 登录地址和救砖方法。约 15 分钟。
适用于Luckfox Pico 官方系统镜像Luckfox Pico Mini A/B 官方系统镜像Luckfox Pico Mini B 官方系统镜像Luckfox Pico Plus 官方系统镜像
先确认型号
Luckfox Pico、Pico Mini A、Pico Mini B、Pico Plus 都是 RV1103 芯片、64 MB 内存的小板,刷机步骤相同,区别在于有没有板载 SPI NAND:
| 型号 | 板载存储 | 网口 | 能用的方法 |
|---|---|---|---|
| Luckfox Pico | 无,只能用 TF 卡 | 无 | 方法二 |
| Luckfox Pico Mini A | 无,只能用 TF 卡 | 无 | 方法二 |
| Luckfox Pico Mini B | 128 MB SPI NAND | 无 | 方法一或方法二 |
| Luckfox Pico Plus | 128 MB SPI NAND | 有(百兆) | 方法一或方法二 |
Mini A 和 Mini B 规格相同,区别只在 Mini B 有 128 MB SPI NAND,按购买时的型号区分。Pico Plus 比 Pico 多了 SPI NAND 和一个网口。同为 RV1103 的 WebBee 带外壳,请看 幸狐 Luckfox Pico WebBee 刷机教程。
准备
- 一根能传数据的 USB-A 转 USB-C 线(刷 SPI NAND 时用)。
- Windows 电脑:本站的 SocToolKit,以及 RKDevTool 页 里的驱动助手 DriverAssistant。Linux 或 macOS 用 upgrade_tool,它只能刷 SPI NAND,不能写 TF 卡。
- 用 TF 卡时:一张 8 GB 以上的 TF 卡和读卡器,以及 SD Card Formatter(本站暂未收录,从文末“官方资料”进入 Luckfox 页面获取)。
- 先装驱动:运行驱动助手,点“驱动安装”,装完重启电脑。这一步不用接板子。
下载哪个文件
| 型号 | 写 TF 卡(Buildroot) | 写 SPI NAND(Buildroot) | 本站页面 |
|---|---|---|---|
| Pico | Luckfox_Pico_MicroSD_日期.zip | 不支持 | Luckfox Pico 镜像 |
| Mini A | Luckfox_Pico_Mini_MicroSD_日期.zip | 不支持 | Pico Mini A/B 镜像 |
| Mini B | Luckfox_Pico_Mini_MicroSD_日期.zip | Luckfox_Pico_Mini_Flash_日期.zip | Pico Mini A/B 镜像(TF 卡)、Pico Mini B 镜像(SPI NAND) |
| Plus | Luckfox_Pico_Plus_MicroSD_日期.zip | Luckfox_Pico_Plus_Flash_日期.zip | Luckfox Pico Plus 镜像 |
- 文件名里
MicroSD表示写 TF 卡,Flash表示写板载 SPI NAND。 - 这些都是 Luckfox 的官方 Buildroot 镜像,本站目前最新是 250607 版。幸狐官方说明 Ubuntu 镜像为第三方镜像,本站不提供;需要时请到幸狐页面了解。
- Mini B 和 Plus 两种都能用:想省掉 TF 卡就刷 SPI NAND;需要更大空间就用 TF 卡。
- 文件名里的 6 位数字是镜像日期。Luckfox 要求烧最新日期的镜像,厂商网盘上可能有比本站更新的版本。
- 下载后先核对 SHA-256,方法见 如何核对下载文件的 SHA-256,再用 7-Zip 完整解压,得到一个同名文件夹。
注意这些压缩包都要用 SocToolKit 写入,不能用 balenaEtcher 等写卡工具直接写,也不能把里面的 update.img 当成整盘镜像写进 TF 卡。
方法一:刷进板载 SPI NAND(Mini B、Plus)
- 右键 SocToolKit,以管理员身份运行。弹出“选择芯片(Chip Selection)”时选 RV1106(RV1103 的板子也选它),点 OK。
- 按住板上的 BOOT 键不放,用 USB 线把板子接到电脑,然后松开。
应看到:SocToolKit 顶部 USB 一栏显示 Maskrom 或 Loader 设备(后面的编号每台电脑不同)。
- 在“固件下载(Download)”页,点“固件...(Firmware...)”,选
…_Flash_…文件夹里的update.img。 - 点“升级(Upgrade)”,等右侧日志走完。
应看到:日志里出现 Upgrade firmware ok.,最后一行是 Upgrade update...OK(中文界面为“升级update...成功”)。下载页的“重启设备(reset)”保持勾选时,板子随后会自动重启。
板子已经能开机、并且能用 ADB 登录时,不用按键:执行 adb shell 登录后运行 reboot loader,板子会直接进入刷机模式。
第一次在 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)
- 用读卡器把 TF 卡接到电脑,拔掉其他 U 盘和存储卡。打开 SD Card Formatter,选中这张卡,点 Format。
- 以管理员身份运行 SocToolKit,芯片选 RV1106,切到“SD卡工具(SDTool)”页。
- 在“Usb 磁盘(Usb Disk)”一栏确认显示的是这张卡的容量。
- 选“SD 启动(SD Boot)”,点“选择启动文件...(Boot Files...)”,选中
…_MicroSD_…文件夹里的boot.img、env.img、idblock.img、oem.img、rootfs.img、uboot.img、userdata.img。不要选 `update.img`。 - 点“创建SD(Create SD)”,确认目标磁盘后开始写入。
应看到:右侧日志最后出现 Create sdcard OK(中文界面为“创建SD卡成功”)。
- 把卡插进板子的 TF 卡槽,上电启动。
警告创建 TF 卡会清空整张卡。工具识别不到卡时,关掉 SocToolKit,重新以管理员身份运行。
提示Mini B 和 Plus 的 SPI NAND 与 TF 卡里都有系统时,Luckfox 没有写明优先从哪个启动。想从 SPI NAND 启动就拔掉 TF 卡。
第一次开机:怎么登录
| 系统 | 用户名 | 密码 | USB 网络固定地址 |
|---|---|---|---|
| Buildroot | root | luckfox | 172.32.0.93 |
- 最简单:ADB。用 USB 线接电脑,在命令行执行
adb shell直接进入板子。 - SSH(USB 线):Pico 和 Mini 没有网口,用这种方式。电脑上会多出一个 RNDIS 虚拟网卡,把它的 IPv4 设成
172.32.0.100,再ssh root@172.32.0.93。 - SSH(网线,仅 Plus):接上路由器后板子会自动获取 IP,在路由器后台找到它,然后
ssh root@板子IP。 - 串口:波特率 115200,接线见 用 USB 转 TTL 串口调试开发板。
提示USB 线 SSH 连不上时,检查 Windows 防火墙是否拦截了这个 RNDIS 虚拟网卡。
登录后先用 passwd 改掉默认密码。更多方式见 开发板首次启动。
提示Buildroot 写进 TF 卡后只用到约 8 GB,卡再大也一样,这是镜像的分区设定,不是卡坏了。
刷坏了怎么救
- TF 卡启动不了:用 SD Card Formatter 重新格式化,再按方法二重做一次。确认选的是本型号的
MicroSD包,启动文件里没有混进update.img。 - SPI NAND 刷错了、不开机(Mini B、Plus):按住 BOOT 键再接电脑进入刷机模式,按方法一重新刷本型号的
Flash包。 - 想清空 SPI NAND:Luckfox 的方法是在 SocToolKit 里载入
update.img后执行擦除(Luckfox 文档写作 Erase Flash),然后重新刷。 - SocToolKit 识别不到设备:确认驱动助手装好并重启过;临时关闭可能误删工具文件的杀毒软件;改插电脑后面板(主板直连)的 USB 口,不要经过 USB 集线器。
- 日志卡在“下载 DownloadBin...失败”:Luckfox 说多半是线的问题,换一根质量好的 USB-C 数据线。
其他情况见 开发板刷坏了怎么办。
资料来源
按幸狐 Luckfox Wiki 的 Luckfox Pico RV1103 版型介绍、Luckfox Pico / Plus / Mini 镜像烧录、登录和常见问题页面整理(2026-10-22 查阅),SocToolKit 中文按钮名取自本站收录的 2.2 版。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置和文件名以你的板子和 Luckfox 官方说明为准。
适用的固件与系统镜像(4)
按适用范围匹配到 4 个固件条目。下载前仍需核对具体型号和硬件版本。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证