AppGoBox

教程

幸狐 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 B128 MB SPI NAND无方法一或方法二
Luckfox Pico Plus128 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)本站页面
PicoLuckfox_Pico_MicroSD_日期.zip不支持Luckfox Pico 镜像
Mini ALuckfox_Pico_Mini_MicroSD_日期.zip不支持Pico Mini A/B 镜像
Mini BLuckfox_Pico_Mini_MicroSD_日期.zipLuckfox_Pico_Mini_Flash_日期.zipPico Mini A/B 镜像(TF 卡)、Pico Mini B 镜像(SPI NAND)
PlusLuckfox_Pico_Plus_MicroSD_日期.zipLuckfox_Pico_Plus_Flash_日期.zipLuckfox 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)

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

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

  1. 在“固件下载(Download)”页,点“固件...(Firmware...)”,选 …_Flash_… 文件夹里的 update.img。
  2. 点“升级(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)

  1. 用读卡器把 TF 卡接到电脑,拔掉其他 U 盘和存储卡。打开 SD Card Formatter,选中这张卡,点 Format。
  2. 以管理员身份运行 SocToolKit,芯片选 RV1106,切到“SD卡工具(SDTool)”页。
  3. 在“Usb 磁盘(Usb Disk)”一栏确认显示的是这张卡的容量。
  4. 选“SD 启动(SD Boot)”,点“选择启动文件...(Boot Files...)”,选中 …_MicroSD_… 文件夹里的 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 卡槽,上电启动。

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

第一次开机:怎么登录

系统用户名密码USB 网络固定地址
Buildrootrootluckfox172.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 · 依据 · 本站未在实机上逐一验证