待补充
adafruit/Adafruit_CircuitPython_Motor
3/5
🧩 软硬件结合
已发布
项目简介
Helpers for controlling PWM based motors and servos
Adafruit CircuitPython Motor 是一个专为 CircuitPython 环境设计的电机与舵机控制辅助库。它主要解决在微控制器项目中，直接操作 PWM 信号来控制电机和舵机时面临的代码复杂、可移植性差的问题。通过提供更高层次的抽象对象，开发者无需深入处理底层 PWM 的占空比计算，就能快速、稳定地驱动直流电机、步进电机和舵机。该库的核心功能包括：为直流电机提供正反转和速度控制，为舵机提供精确的角度控制，并支持通过单个或多个 PWM 输出通道组合实现更复杂的运动逻辑。其技术栈基于 CircuitPython 和底层硬件 PWM 接口，要求 PWM 输出对象具备 16 位的 duty_cycle 属性，并假设用户已预先配置好合适的频率（通常舵机为 50Hz，电机为 1600Hz）。该库特别适用于机器人制作、自动化装置、智能玩具等需要精确运动控制的场景，尤其适合使用 Adafruit 开发板或 Raspberry Pi 等支持 CircuitPython 的硬件平台。作为 Adafruit CircuitPython 生态的一部分，它依赖 Adafruit CircuitPython 核心库，可通过 Adafruit 库驱动包或 PyPI 轻松安装，并拥有完善的 API 文档和活跃的社区支持，极大降低了硬件控制项目的开发门槛。
标签
项目特点
**高层抽象接口**：将 PWM 底层操作封装为电机、舵机对象，无需手动计算占空比。
**支持多种电机类型**：涵盖直流电机（正反转+速度）、舵机（角度控制）和步进电机。
**多通道组合控制**：支持通过单个或多个 PWM 输出通道组合，实现更复杂的运动逻辑。
**兼容 CircuitPython 生态**：与 Adafruit 系列开发板及众多支持 CircuitPython 的微控制器无缝配合。
**代码简洁可移植**：减少重复代码，方便在不同硬件平台间迁移项目。
**开源社区维护**：由 Adafruit 官方维护，持续更新，文档和示例丰富。
技术规格
| 编程语言 | CircuitPython |
|---|---|
| 依赖库 | pulseio（或 pwmio）、board、microcontroller |
| 支持电机类型 | 直流电机（DC Motor）、舵机（Servo）、步进电机（Stepper Motor） |
| PWM 分辨率 | 16 位（0-65535） |
| 舵机角度范围 | 0° ~ 180°（可配置脉冲范围） |
| 直流电机控制 | 正转、反转、停止、速度调节（0-100%） |
| 步进电机控制 | 步进角度、方向、速度 |
| 最小硬件要求 | 至少 1 个 PWM 输出引脚 |
| 兼容板型 | Adafruit Circuit Playground Express、Feather、ItsyBitsy 等 |
| 许可证 | 待补充（通常为 MIT 或 BSD） |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Adafruit Circuit Playground Express | 1 | — | 或其他支持 CircuitPython 的板子 |
| 直流电机（如 6V 小型电机） | 1~2 | — | 根据项目需求 |
| 标准舵机（如 SG90） | 1~多个 | — | 角度控制用 |
| 28BYJ-48 步进电机 | 1 | — | 可选，需配合驱动板 |
| L293D 或 DRV8833 电机驱动板 | 1 | — | 直流电机驱动 |
| 电池盒（4×AA）或 USB 供电 | 1 | — | 根据电机功率选择 |
| 杜邦线（公对母/公对公） | 若干 | — | 连接电路 |
| 830 孔面包板 | 1 | — | 原型搭建 |
能力画像
**记忆与知识检索**：3/5 — 需要查阅 PWM 原理、电机驱动电路和 CircuitPython 文档，但库本身简化了底层细节。
**动手与操作**：4/5 — 涉及面包板接线、电机与舵机安装、电源连接等硬件操作，适合动手实践。
**编程与算法**：3/5 — 主要调用库接口，逻辑简单（正反转、角度设置），但组合多个电机时需一定编程思维。
**设计与建模**：2/5 — 通常不需要 3D 建模，但若制作机器人外壳或支架则需简单设计。
**实验与调试**：4/5 — 需要调试电机转向、舵机角度范围、PWM 频率等参数，常用串口打印和示波器辅助。
**协作与分享**：2/5 — 项目多为个人学习或小团队，但可上传代码至 GitHub 分享。
**学习与研究**：4/5 — 适合学习电机控制原理、PWM 信号、CircuitPython 库开发等知识。
**系统集成**：3/5 — 可与其他传感器（如距离、红外）组合构建完整机器人系统。
项目图库
所需技能
基础电路知识（面包板、电源、电机驱动）
CircuitPython 编程基础（变量、循环、函数）
理解 PWM 信号的基本概念
能够阅读英文技术文档（库文档为英文）
使用 Mu Editor 或 Thonny 等 IDE
适用场景
教育机器人制作（如小车、机械臂）
创客工作坊中的电机控制教学
智能家居项目（如自动窗帘、门锁）
小型自动化设备原型开发
CircuitPython 入门学习与实验
竞赛机器人（如巡线、避障小车）