把设备当成 agent 终端之前,先核对你手里的是哪一个版本,以及系统是否按官方方式启动。三款型号都使用 Raspberry Pi CM0,但传感器和附件并不相同。
先看清型号
根据官方产品对照:
| 项目 | CardputerZero | CardputerZero-Lite | CardputerZero v1.0 |
|---|---|---|---|
| SKU | C154 / C154-B | C155 / C155-B | C154-V1 |
| 8MP 摄像头 | 有 | 无 | 有 |
| IMU BMI270 | 有 | 无 | 有 |
| BMM150 磁力计 | 有 | 无 | 无 |
| 标配 32GB microSD | 有 | 无 | 有 |
Lite 没有内置摄像头和 IMU,官方 Compass 应用也不支持。若你的 agent 计划「看一眼再行动」,Lite 需要外接受支持的 USB 摄像头,或放弃视觉工具。Lite 出厂不附带 microSD,必须先按官方镜像烧录指南把系统写到自备卡里,再在关机状态下插卡开机。
系统是什么
官方烧录工具 M5 Imager 的系统列表指向 Debian Trixie 的 arm64 镜像。开源仓库 cardputer-zero-os 把它说明为运行在 Raspberry Pi OS / Debian 之上的 CardputerZero 系统配置。也就是说,这是一台普通的 aarch64 Linux 电脑,不是封闭固件。
官方操作说明写明,系统镜像预装了命令行终端、文件管理器和多媒体应用,并带有 Python 应用:打开后是 Python 3 交互式解释器。首次开机可以向导设置用户名、网络,并按需启用 SSH。也可以在烧录镜像时预先写入这些配置。
开发调试方面,官方支持 SSH(通过 IP Panel 或 Settings 查看地址)以及 ADB(在 Settings > Developer 中开启,将 USB Switch 拨到 Slave,用右侧 USB-C2 连接电脑)。应用可在 Settings > System > Software 中更新;需要重装系统时,回到官方镜像烧录指南。
网络与 USB 模式
云端 agent 依赖稳定网络。机身提供 2.4 GHz Wi-Fi 802.11 b/g/n,以及 10/100M 以太网(SR9900A USB 2.0 转以太网)。需要记住:
- Wi-Fi 只有 2.4 GHz,官方文档没有承诺 5 GHz。
- 以太网走内部 USB Hub。左侧 USB Switch 拨到 Slave(设备模式)时,官方说明会断开 USB Hub,此时左侧 USB-A、Type-C、顶部 EXT 的 USB 以及以太网都不可用。要用有线网,应使用 Host 模式。
- 充电走 USB-C2;开关机以及 USB Switch 在任意位置时都可以充电。建议供电 / 充电为 5V @ 2A。
电源是硬约束
官方规格:内置 3.7V 1750 mAh 电池(带 NTC),待机功耗 2.5W,建议 5V 2A 供电。用电量粗算:3.7 × 1.75 ≈ 6.5 Wh;若按官方给出的 2.5W 待机功耗估算,大约只有两个半小时的量级。这不是实测续航,只是用官方数字做的上限参考。开启 Wi-Fi、点亮屏幕、跑工具或尝试本地推理时,消耗会更高,可用时间更短。长时间作为 agent 终端使用时,更稳妥的方式是接上建议规格的电源。
官方没有给出可引用的完整热设计曲线。整机只有 84.0 × 54.0 × 23.1 mm,持续满负载时应当自行观察是否过热或降频,不要假设四个 Cortex-A53 可以长时间满载工作。
建议的准备清单
- 确认 SKU,尤其是有没有摄像头和 IMU。
- 使用官方 M5 Imager 烧录,或确认当前系统为官方镜像。
- 完成用户与网络配置,需要时打开 SSH。
- 在 IP Panel 里确认地址,用电脑 SSH 进去执行
free -h和uname -a,先看清可用内存,再谈模型。 - 若走云端 API,把密钥放在环境变量或仅你可读的配置里,不要写进即将分享的脚本。
Before you treat the device as an agent terminal, confirm which model you have and that the system was installed the official way. All three versions use a Raspberry Pi CM0, but the sensors and accessories are not the same.
Identify the model first
From the official product comparison:
| Item | CardputerZero | CardputerZero-Lite | CardputerZero v1.0 |
|---|---|---|---|
| SKU | C154 / C154-B | C155 / C155-B | C154-V1 |
| 8MP camera | Yes | No | Yes |
| BMI270 IMU | Yes | No | Yes |
| BMM150 magnetometer | Yes | No | No |
| Bundled 32GB microSD | Yes | No | Yes |
Lite has no built-in camera or IMU, and the official Compass app is not supported on that model. If your agent is supposed to “look, then act,” Lite needs a supported USB camera, or you should drop the vision tool. Lite also ships without a microSD card: flash the official image to a card you supply, insert it with the device powered off, then turn the unit on.
What the system actually is
The OS list used by the official M5 Imager points at a Debian Trixie arm64 image. The open-source cardputer-zero-os repository describes it as a CardputerZero system profile on top of Raspberry Pi OS / Debian. In other words, this is an ordinary aarch64 Linux computer, not a sealed firmware appliance.
The official usage guide states that the image ships a command-line terminal, a file manager, and multimedia apps, plus a Python app that opens a Python 3 REPL. On first boot you can set a username, join a network, and optionally enable SSH. Those settings can also be written at flash time.
For development, official docs describe SSH (read the address in IP Panel or Settings) and ADB (enable it under Settings > Developer, set the USB Switch to Slave, and connect a computer to the right-hand USB-C2 port). Apps can be updated under Settings > System > Software. To reinstall the system, return to the official image-flashing guide.
Networking and USB mode
A cloud agent needs a stable network. The hardware provides 2.4 GHz Wi-Fi 802.11 b/g/n and 10/100M Ethernet (an SR9900A USB 2.0-to-Ethernet chip). Keep these constraints in mind:
- Wi-Fi is 2.4 GHz only; official documentation does not promise 5 GHz.
- Ethernet is provided through the internal USB hub. When the left-side USB Switch is set to Slave (device mode), official documentation says the hub is disconnected, and the left USB-A and Type-C ports, the USB pins on the top EXT header, and Ethernet are unavailable. Use Host mode for wired Ethernet.
- Charging is through USB-C2 and works whether the unit is on or off and regardless of the USB Switch position. The recommended supply is 5V @ 2A.
Power is a hard limit
Official specifications list a 3.7V 1750 mAh battery with NTC, 2.5W idle power consumption, and a recommended 5V 2A supply. A rough energy figure is 3.7 × 1.75 ≈ 6.5 Wh. Dividing that by the official 2.5W idle figure gives an order of about two and a half hours. That is not a measured runtime; it is an upper-bound sketch from official numbers. Wi-Fi, a lit display, tool execution, or any attempt at local inference will draw more and last less. For long sessions as an agent terminal, a 5V 2A supply is the more conservative choice.
Official documentation does not publish a full thermal curve that this page can cite. The body is only 84.0 × 54.0 × 23.1 mm. Under sustained full load you should watch for heat and possible throttling, and not assume all four Cortex-A53 cores can run flat out indefinitely.
A practical checklist
- Confirm the SKU, especially whether a camera and IMU are present.
- Flash with the official M5 Imager, or confirm that the current system is the official image.
- Finish user and network setup, and enable SSH if you need it.
- Read the address in IP Panel, SSH in from a computer, and run
free -handuname -abefore talking about models. - If you use a cloud API, keep the key in an environment variable or a file readable only by you—not in a script you are about to share.