# ext2-py-pca9685-api

**Repository Path**: mind-plus/ext2-py-pca9685-api

## Basic Information

- **Project Name**: ext2-py-pca9685-api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-26
- **Last Updated**: 2026-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI课程工具箱 - i2c工具箱（pca9685tools）

`pca9685tools` 是一个适用于 Mind+ V2 Python 积木模式的扩展，由爱方思（AiFangSi）同名 Mind+ V1.8 用户库 `pca9685tools`（i2c工具箱）转换而来，通过 CH341T USB 转 I2C 适配器驱动 PCA9685，实现 16 路 PWM / 舵机 / 马达输出，配合 AI 课程与 AIToolkit2 使用。

本扩展无硬件 SKU；运行依赖本机 AIToolkit2 Python 环境（或外置 Python 解释器）及扩展自带的 `mp_pca9685` 等本地库（含 `ch341T/CH341DLLA64.dll`，Windows 64 位）。

## 积木

扩展共 10 个积木：

- 初始化：外置 Python 解释器 PCA9685 初始化（I2C 地址 0x40，PWM 频率 50）、Mind+ Python 解释器 PCA9685 初始化、关闭 USB 转 IIC 接口
- 简单控制：模拟输出（针脚 0-15，值 0-255）、数字输出（值 0-1）、舵机角度控制、驱动马达
- 电机控制：L298P 驱动板（左右速度 -255~255）、L298N 驱动板、驱动板任意针脚输出（左右马达速度与四个针脚可自定义）

## 示例程序

V1 源库未包含示例工程文件，本仓库暂未提供可运行示例；典型用法：先初始化 PCA9685（选择与解释器对应的初始化积木），再用模拟输出 / 舵机角度等积木控制通道。

## 支持列表

本扩展为 Python 积木模式（`mode: "python-block"`），不绑定主板，在 Mind+ Python 模式下于 Windows 平台经 CH341T 适配器使用（V1 config 声明 `platform: ["win"]`）。

## 更新日志

### V2.0.6

- 由 Mind+ V1 用户库 `pca9685tools` 2.0.6 完整转换为 Mind+ V2 扩展；积木名称、参数、默认值与生成代码行为保持一致（`compatibilityId: 爱方思-pca9685tools-thirdex`）
- 舵机角度积木的 V1 专用「角度」输入框映射为数值输入框（生成代码不变）

## 开发指南

- 源码位于 `extension/`（index.js 积木定义、func.js 生成代码、public/ 配置与本地库、icon/ 图标、locales/ 翻译）。
- 本地库 `public/libraries/` 保留 V1 全部文件：`mp_pca9685.py`、线程与限流模块、`ch341T/`（含 CH341T DLL 与 Python 封装）。
- 初始化与编译：`npm install` 后 `npm run build`，产物在 `build/`。
- 更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)