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
- 用 7-Zip 把
.img.xz解压成.img。 - 打开 Rufus,“设备(Device)”选你的 TF 卡,“引导类型选择(Boot selection)”旁点“选择(SELECT)”找到
.img,点“开始(START)”。也可以用 balenaEtcher:点“从文件烧录”选.img,点“选择目标”选卡,再点“现在烧录”。 - 把卡插进板子的 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 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证