AppGoBox

教程

LicheeRV Nano 刷机教程:写 TF 卡与 USB、网口、Wi-Fi 登录

Sipeed LicheeRV Nano 装系统:认清 B、E、W、WE 版本和 RISC-V 默认模式,解压镜像后写 TF 卡,通过 USB RNDIS 或网口 SSH 登录,设置 Wi-Fi,附救砖方法。约 10 分钟。

适用于Sipeed LicheeRV Nano 官方系统镜像

先确认是 LicheeRV Nano,以及是哪个版本

Sipeed LicheeRV Nano 是一块 22.86×35.56mm 的小板,芯片是算能 SG2002,256 MB 内存。它按网络分四个版本:

版本后缀网络
B(标准版)没有网络
E(网口版)板载 100M 网口
W(WiFi 版)板载 Wi-Fi 6 / 蓝牙模块
WE(WiFi 网口版)Wi-Fi 模块,外加一块网口小板

本站收录的镜像在 Sipeed 的发布页里只有一个文件,没有按这四个版本分开。MaixCAM 和 MaixCAM-Pro 也用 SG2002,但系统不同,请看 MaixCAM 刷机教程。

LicheeRV Nano 的大核可以用 RISC-V(C906)或 ARM(A53)启动,由板子背面 SG2002 旁边一颗短接电阻的位置决定,出厂贴在 C906(RISC-V)一侧。本页按出厂的 RISC-V 模式写;ARM 模式要挪电阻并换用另外的镜像,本站暂未收录。

准备

  • microSD(TF)卡和读卡器。
  • 一根 USB Type-C 数据线:供电,也用来连电脑登录。
  • 可选:网线(E、WE 版)、USB 转 TTL 串口线。

下载哪个文件

打开 Sipeed LicheeRV Nano 系统镜像页,下载 <日期>-<时间>-<编号>.img.xz(本站收录的是 2025-12-30-20-00-6073d5.img.xz),这是 Sipeed 用官方 SDK 编译的系统镜像。Sipeed 之后发布的 20260114 版(2026-10-22 查阅)只提供 .tar.xz 包,不是 .img.xz 卡镜像,本站没有收录,收录的仍是 20251230 版。下载后可以按 如何核对下载文件的 SHA-256 核对。

写入 TF 卡

Windows

  1. 用 7-Zip 把 .img.xz 解压成 .img。
  2. 打开 Rufus,“设备(Device)”选你的 TF 卡,“引导类型选择(Boot selection)”旁点“选择(SELECT)”找到 .img,点“开始(START)”。也可以用 balenaEtcher:点“从文件烧录”选 .img,点“选择目标”选卡,再点“现在烧录”。
  3. 把卡插进板子的 TF 卡槽,用 Type-C 线接电脑或 5V 电源。

Linux

先解压,再把 sdX 换成 TF 卡的设备名:

xz -d 2025-12-30-20-00-6073d5.img.xz
sudo dd if=2025-12-30-20-00-6073d5.img of=/dev/sdX conv=sync

第一次登录

  • USB 网卡(所有版本):用 Type-C 线接电脑后,板子会模拟一个 USB RNDIS 网卡,电脑通过 DHCP 自动拿到地址。把电脑拿到的 IPv4 地址最后一段换成 1 就是板子的地址,例如电脑是 10.44.55.66,板子就是 10.44.55.1。然后运行 ssh root@10.44.55.1。Windows 可能要在设备管理器里手动给这个 RNDIS 设备选驱动,Sipeed 的页面有截图。
  • 网线(E、WE 版):插上网线,板子用 DHCP 获取地址,镜像默认开了 mDNS,可以直接 ssh root@licheervnano-XXXX.local。Linux 电脑可以用 avahi-browse -art | grep licheervnano 找到具体名字。
  • 用户名 root,密码 root。

连 Wi-Fi(W、WE 版)

先装好天线。镜像把 TF 卡的第一个分区挂在 /boot,在板子上运行(把 ssid、pass 换成你的 Wi-Fi 名称和密码):

touch /boot/wifi.sta
rm /boot/wifi.ap /boot/wifi.mon
echo ssid > /boot/wifi.ssid
echo pass > /boot/wifi.pass
/etc/init.d/S30wifi stop
/etc/init.d/S30wifi start

刷坏了怎么救

  • 起不来:LicheeRV Nano 的系统和引导程序都在 TF 卡里,重新写一次卡即可。Sipeed 说明芯片在 TF 卡第一个 FAT 分区里找不到 fip.bin 时,会进入 USB 烧录模式而不是启动系统。
  • 挪过 A53/C906 电阻后起不来:把电阻挪回 C906 一侧,本站镜像是 RISC-V 版。
  • USB 口被改成了主机模式、电脑连不上:用读卡器打开 TF 卡的第一个分区(板子上挂在 /boot),新建一个名为 usb.dev 的空文件,删掉 usb.host;要用 USB 网卡登录,还要确认有名为 usb.rndis0 的文件(没有就新建一个空文件)。再插回板子重启。
  • 想看启动日志:USB 转 TTL 串口接板子的 GND、A16(TX)、A17(RX),波特率 115200。见 用 USB 转 TTL 串口调试开发板。

资料来源

按 Sipeed 官方 Wiki(LicheeRV Nano 简介、套餐与安装、镜像、烧录镜像、外设使用、主线开发)和 Sipeed 在 GitHub 发布的 LicheeRV-Nano-Build 版本列表整理,2026-10-22 查阅。

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

适用的固件与系统镜像(1)

按适用范围匹配到 1 个固件条目。下载前仍需核对具体型号和硬件版本。

整理:AppGoBox · 依据 · 本站未在实机上逐一验证