AppGoBox

教程

MaixCAM-Pro 刷机教程:读卡器写 TF 卡与 USB 更新系统

Sipeed MaixCAM-Pro 装系统:区分 MaixCAM-Pro 与 MaixCAM 镜像,第一次用读卡器写 TF 卡,以后按住 user 键开机用 USB 更新,联网安装运行库并用 SSH 或 MaixVision 连接。约 15 分钟。

适用于Sipeed MaixCAM-Pro 官方系统镜像

先确认是 MaixCAM-Pro,不是 MaixCAM

Sipeed 的 MaixCAM-Pro 和 MaixCAM 都用算能 SG2002 芯片,但屏幕不同,系统镜像不能混用。Sipeed 提醒刷错镜像可能导致屏幕烧屏(一般放置一段时间会慢慢恢复)。

看哪里MaixCAMMaixCAM-Pro
屏幕2.3 寸,552×3682.4 寸,640×480
按键RST + USER 两个RST + USER + 电源键
其他两排 14 针排针PMOD 接口、1W 喇叭、照明 LED,可选锂电池版
镜像文件名maixcam-<日期>-maixpy-v<版本>.img.xzmaixcam-pro-<日期>-maixpy-v<版本>.img.xz

是 MaixCAM 的话,请看 MaixCAM 刷机教程。MaixCAM2 是另一代产品,系统默认装在板载 eMMC,镜像和刷法都不同,本页不适用。

MaixCAM-Pro 的系统运行在 TF 卡里。

准备

  • TF 卡和读卡器(自己的卡第一次装系统必须用读卡器)。
  • 一根 USB Type-C 数据线:供电,也用来连电脑。
  • Wi-Fi 网络:第一次使用需要联网激活设备、安装运行库。没有路由器可以用手机热点。

下载哪个文件

打开 Sipeed MaixCAM-Pro 系统镜像页,下载 maixcam-pro-<日期>-maixpy-v<版本>.img.xz(本站收录的是 v4.12.5,日期 2026-01-24,2026-10-22 查阅时与 Sipeed 最新的 MaixPy 发布一致)。文件名里一定要带 pro。下载后可以按 如何核对下载文件的 SHA-256 核对。

方法一:用读卡器写 TF 卡(第一次必须用这个)

  1. 取出 TF 卡,用读卡器插到电脑。Sipeed 不建议没必要时拆 MaixCAM-Pro 的外壳,拆的话注意屏幕后面的排线别扯断;卡里已有能正常运行的系统时,优先用方法二。
  2. 打开 balenaEtcher,点“从文件烧录”选镜像,点“选择目标”选 TF 卡,点“现在烧录”。balenaEtcher 写不进去时可以换 Rufus。
  3. 等烧录完成。如果 Windows 弹出“使用驱动器 G: 中的光盘之前需要将其格式化”,不要点格式化,关掉窗口,右键磁盘选“弹出”。
  4. 把卡插回 MaixCAM-Pro,用 Type-C 线供电(电池版按一下电源键)。

应看到:等一会儿后屏幕进入功能选择界面。第一次开机会慢一些。

提示balenaEtcher 报“出了点问题……Error spawning the child process”时,多半是权限不够,右键选“以管理员身份运行”。

方法二:用 USB 更新系统(以后升级用)

只能在 TF 卡里已经有能正常运行的系统时使用,不能用来第一次装系统。买的是带 TF 卡的套餐、卡里已有出厂系统并且能正常开机的,可以直接用这个方法;Sipeed 提醒出厂系统可能比较旧,拿到后务必先更新到最新版。

  1. MaixCAM-Pro 断电(电池版长按电源键关机),TF 卡保持插在设备里。
  2. 按住 user 键不放,然后开机:插上 USB 线连接电脑(电池版接好线后按一下电源键)。
  3. 等电脑上出现一个 U 盘设备,再松开 user 键。
  4. 打开 balenaEtcher,选镜像,目标选这个 U 盘设备,点“现在烧录”。弹出格式化提示时同样不要点格式化。
  5. 重启设备,等系统启动(保险起见等约 1 分钟,期间不要断电)。

进不了 U 盘模式时,可能是系统文件已损坏,改用方法一。

第一次开机和联网

  1. 在设备上点“设置”(Settings)→“WiFi”,可以点“扫描二维码”扫手机分享的 Wi-Fi 码,也可以点“扫描”搜索热点后输入密码,点“连接”。等 10~30 秒拿到 IP 地址。
  2. 再进“设置”→“安装运行库”,装好最新运行库。显示 Request failed(请求失败)时先检查能否上网。
  3. 设备的 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。固件 4.8.0 起,长按电源键 4 秒是软关机,按到 8 秒才是强制断电。
  • 刷成了 MaixCAM 的镜像:断电,用方法一写回 maixcam-pro-… 的镜像。

资料来源

按 Sipeed 官方 Wiki(MaixCAM 系统烧录、MaixCAM-Pro 与 MaixCAM 硬件介绍)、MaixPy 官方文档(MaixCAM 快速开始、升级和烧录系统、Linux 基础)以及 Sipeed 在 GitHub 发布的 MaixPy v4.12.5 版本说明整理,2026-10-22 查阅。

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

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

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

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