MaixCAM 刷机教程:读卡器写 TF 卡与 USB 更新系统
Sipeed MaixCAM 装系统:区分 MaixCAM 与 MaixCAM-Pro 镜像,第一次用读卡器写 TF 卡,以后按住 user 键用 USB 更新,联网安装运行库并用 SSH 或 MaixVision 连接。约 15 分钟。
适用于Sipeed MaixCAM 官方系统镜像
先确认是 MaixCAM,不是 MaixCAM-Pro
Sipeed 的 MaixCAM 和 MaixCAM-Pro 都用算能 SG2002 芯片,但屏幕不同,系统镜像不能混用。Sipeed 提醒刷错镜像可能导致屏幕烧屏(一般放置一段时间会慢慢恢复)。
| 看哪里 | MaixCAM | MaixCAM-Pro |
|---|---|---|
| 屏幕 | 2.3 寸,552×368 | 2.4 寸,640×480 |
| 按键 | RST + USER 两个 | RST + USER + 电源键 |
| 其他 | 两排 14 针排针 | PMOD 接口、1W 喇叭、照明 LED,可选锂电池版 |
| 镜像文件名 | maixcam-<日期>-maixpy-v<版本>.img.xz | maixcam-pro-<日期>-maixpy-v<版本>.img.xz |
是 MaixCAM-Pro 的话,请看 MaixCAM-Pro 刷机教程。MaixCAM2 是另一代产品,系统默认装在板载 eMMC,镜像和刷法都不同,本页不适用。
MaixCAM 的系统运行在 TF 卡里。
准备
- TF 卡和读卡器(自己的卡第一次装系统必须用读卡器)。
- 一根 USB Type-C 数据线:供电,也用来连电脑。
- Wi-Fi 网络:第一次使用需要联网激活设备、安装运行库。没有路由器可以用手机热点。
下载哪个文件
打开 Sipeed MaixCAM 系统镜像页,下载 maixcam-<日期>-maixpy-v<版本>.img.xz(本站收录的是 v4.12.5,日期 2026-01-24,2026-10-22 查阅时与 Sipeed 最新的 MaixPy 发布一致)。文件名里没有 pro 才是 MaixCAM 用的。下载后可以按 如何核对下载文件的 SHA-256 核对。
警告更新(烧录)系统会抹掉卡里的所有数据。已经在设备里存了工程、模型或图片的,先用 MaixVision 的设备文件管理器,或用 scp 把 /maixapp 和 /root 目录拷到电脑上。
方法一:用读卡器写 TF 卡(第一次必须用这个)
- 取出 TF 卡(MaixCAM 要小心打开外壳,里面有排线,别扯断),用读卡器插到电脑。
- 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选 TF 卡,点“现在烧录”。balenaEtcher 写不进去时可以换 Rufus。
- 等烧录完成。如果 Windows 弹出“使用驱动器 G: 中的光盘之前需要将其格式化”,不要点格式化,关掉窗口,右键磁盘选“弹出”。
- 把卡插回 MaixCAM,用 Type-C 线供电。
应看到:等一会儿后屏幕进入功能选择界面。第一次开机会慢一些。
提示balenaEtcher 报“出了点问题……Error spawning the child process”时,多半是权限不够,右键选“以管理员身份运行”。
方法二:用 USB 更新系统(以后升级用)
只能在 TF 卡里已经有能正常运行的系统时使用,不能用来第一次装系统。买的是带 TF 卡的套餐、卡里已有出厂系统并且能正常开机的,可以直接用这个方法;Sipeed 提醒出厂系统可能比较旧,拿到后务必先更新到最新版。
- MaixCAM 断电,TF 卡保持插在设备里。
- 按住 user 键不放,用 USB 线接到电脑(或者先接好 USB 线,按住 user 键,再短按一下 reset 键)。
- 等电脑上出现一个 U 盘设备,再松开 user 键。
- 打开 balenaEtcher,选镜像,目标选这个 U 盘设备,点“现在烧录”。弹出格式化提示时同样不要点格式化。
- 按一下 reset 键或重新上电,等系统启动(保险起见等约 1 分钟,期间不要断电)。
进不了 U 盘模式时,可能是系统文件已损坏,改用方法一。
第一次开机和联网
- 在设备上点“设置”(Settings)→“WiFi”,可以点“扫描二维码”扫手机分享的 Wi-Fi 码,也可以点“扫描”搜索热点后输入密码,点“连接”。等 10~30 秒拿到 IP 地址。
- 再进“设置”→“安装运行库”,装好最新运行库。显示
Request failed(请求失败)时先检查能否上网。 - 设备的 IP 和设备名在“设置”→“设备信息”里。
用电脑连接:
- 同一个 Wi-Fi(Sipeed 推荐):电脑上的 MaixVision 点左下角“连接”就能找到设备。
- USB 线:设备会在电脑上模拟一个 USB 网卡(RNDIS 或 NCM)。电脑拿到的 IP(例如
10.131.167.100)最后一段改成1,就是设备的 IP(10.131.167.1)。 - 终端登录:
ssh root@设备IP,用户名root,密码root。
以后升级
- 只升级 MaixPy 软件包(设备运行正常,并且从当前版本到目标版本之间没有哪个版本更新过系统):在 MaixVision 的设备终端运行
pip install -U MaixPy,完成后重启应用或设备。 - 中间有版本更新过系统,或者拿不准时,Sipeed 建议直接更新系统,用方法二。
刷坏了怎么救
- 屏幕不亮、起不来:先确认屏幕和摄像头的排线没有松动(拆外壳时容易脱落),再用方法一重新写一次 TF 卡。
- USB 进不了 U 盘模式:用读卡器按方法一重写。
- 平时少按 reset:reset 是强制断电,系统正在写卡时按下可能损坏系统和数据。关机请用“设置”→“电源”,或在终端运行
poweroff、reboot。 - 刷成了 Pro 的镜像:断电,用方法一写回
maixcam-…(不带pro)的镜像。
资料来源
按 Sipeed 官方 Wiki(MaixCAM 系统烧录、MaixCAM 与 MaixCAM-Pro 硬件介绍)、MaixPy 官方文档(MaixCAM 快速开始、升级和烧录系统、Linux 基础)以及 Sipeed 在 GitHub 发布的 MaixPy v4.12.5 版本说明整理,2026-10-22 查阅。
提示本页按厂商官方文档整理,本站没有在实机上测试。按键位置和文件名以你的设备和 Sipeed 官方说明为准。
整理:AppGoBox · 依据 · 本站未在实机上逐一验证