详细说明
优势 5 项
2017 年由 Adafruit 从 MicroPython 分叉,专注教育与「插上就能改代码」的体验
板子插入电脑后自动出现为 U 盘,编辑 1 个 code.py 保存即自动重启执行,无需任何工具
内置 USB HID 能力,可把开发板变成键盘、鼠标、游戏手柄或 MIDI 等 4 类设备
官方支持 300 余种开发板,配套 CircuitPython 库包按版本统一分发
全部代码与库开源,把 1 个 .py 文件拷入 lib 目录即可调用,方便教学与二次开发
不足 4 项
为易用性牺牲性能与内存:GC 与文件系统开销更大,复杂逻辑容易触发内存不足
与 MicroPython 分叉后 API 有差异,跨生态移植需要改动
高级外设(CAN、USB Host、低功耗深度睡眠)支持有限
生产部署需要关掉 USB 存储写入等便利功能,配置更接近传统固件
服务商概述
CircuitPython 于 2017 年由 Adafruit 从 MicroPython 分叉而来,目标不是做通用嵌入式运行时,而是把「插上就能改」做到极致:开发板连接电脑后出现为一个 U 盘,里面有一个 code.py,改完保存即自动重启执行。
在编程语言与框架分类里,它代表「教育优先」的硬件 Python 路线:内置 USB HID、统一库包、300 余种板型支持,让没有工具链经验的人也能在几分钟内让硬件动起来。
核心优势
- 零工具链:不需要装 IDE 或编译器,文本编辑器改
code.py即可,学生上手最快 - USB HID 原生能力:开发板可直接充当键盘、鼠标、手柄或 MIDI 设备
- 库包统一:按 CircuitPython 版本发布库包,
lib目录拖入即可用 - 板型覆盖广:官方固件支持 300 余种开发板,含 ESP32-S2/S3、RP2040、nRF52、SAMD
- 错误提示友好:语法与运行时错误会输出到串口并以文件形式提示,便于教学排查
产品生态
固件与板型
circuitpython.org/downloads 列出全部受支持板型并按芯片家族分类。
库
Adafruit 维护的 CircuitPython 库包覆盖传感器、显示屏、电机与网络,按版本发布。
工具
Mu Editor、Thonny 与 VS Code 插件提供串口与文件同步;circup 可批量更新库。
不足之处
- 性能与内存开销大于 MicroPython:文件系统与 GC 更重,复杂逻辑易触发 MemoryError
- 与 MicroPython 分叉后 API 差异明显,两个生态的库不能直接互换
- 高级外设支持有限:CAN、USB Host、深度睡眠等场景常需回到 C 或 MicroPython
- 量产配置繁琐:需要关闭 USB 写入与自动重载,才能接近传统固件的行为
适用场景
- 教学与创客工作坊(★★★★★):插上即用,不需要环境配置
- 快速硬件原型(★★★★):传感器与显示屏代码量极小
- USB HID 小工具(★★★★):把板子变成键盘或手柄
- 量产与硬实时(★★):建议 C/C++ 或 Rust
价格参考
| 项目 | 价格 | 说明 |
|---|---|---|
| CircuitPython 固件 | $0 | 开源(MIT),可自由使用 |
| 开发板 | 按型号 | Adafruit 原板与兼容板价差较大 |
| 库包 | $0 | 官方与社区库均开源 |
成本集中在硬件;教学场景建议选带 USB 与传感器齐全的入门板。
常见问题
- 和 MicroPython 该选哪个? 教学、快速原型、需要 U 盘式更新选 CircuitPython;需要更完整的模块覆盖与性能选 MicroPython。
- 为什么我的板子报 MemoryError? 常见原因是同时 import 太多库或建了大数组,可精简库、改用
displayio分块刷新,或换内存更大的板型。 - 能连 Wi-Fi 吗? 支持,ESP32-S2/S3 与 Pico W 等板型可用
wifi与socketpool模块。相关网络项目可参考编程语言与框架里的 MicroPython。
代码示例
code.py:板载 LED 呼吸与按键
import board, digitalio, time
led = digitalio.DigitalInOut(board.LED)
led.direction = digitalio.Direction.OUTPUT
button = digitalio.DigitalInOut(board.BUTTON)
button.switch_to_input(pull=digitalio.Pull.DOWN)
while True:
if button.value:
led.value = True
else:
led.value = False
time.sleep(0.05)
board 模块按板型自动映射引脚名,换板时通常只改这一处。
作 USB HID 键盘
import time
import usb_hid
from adafruit_hid.keyboard import Keyboard
from adafruit_hid.keycode import Keycode
kbd = Keyboard(usb_hid.devices)
time.sleep(1)
kbd.send(Keycode.CONTROL, Keycode.ALT, Keycode.DELETE)
把板子插到电脑上,它就会被识别成键盘设备。
社区与资源
- CircuitPython 官网:下载、板型支持与文档入口
- CircuitPython 板型下载:按芯片家族筛选固件
- GitHub CircuitPython 主题:库与示例工程
- Adafruit Learn:可直接照抄的教程与接线图
- MicroPython 文档:分叉来源与移植参考
前往 CircuitPython 官网 →
https://circuitpython.org/
访问官网 ↗