SuperAPI AI 工具集

wiring-doc

通用与其它

查看项目

更新于 10-15 23:49

技能介绍

用途:为 packages/<domain>/ 下的 ESP32 项目生成或更新标准化的 WIRING.md 接线文档,依据源码中的引脚分配而非 README 描述。

主要能力:读取 main/.c 与 main/.h 中的 #define 引脚、gpio_config()、i2c_config()、spi_bus_config()、LEDC、UART、ADC 等用法;从 main/CMakeLists.txt 的 REQUIRES 识别组件;从 sdkconfig.defaults 获取启用特性、栈大小、蓝牙模式与 CONFIG_IDF_TARGET;从 justfile 获取目标芯片与构建变体;从 README.md、CLAUDE.md、Kconfig.projbuild 获取硬件描述与可配置引脚。据此识别板卡及板级约束(如 ESP32-CAM PSRAM 冲突、TTGO LoRa 引脚保留、ESP32-S3 USB PHY 共享)。

输出结构:按固定模板生成,除 Board 与 Pin Assignments 外各节均可选,仅包含项目实际使用的部分,不写占位内容。章节包括 Board、Pin Assignments(GPIO/功能/方向/元件/备注,方向取 Output、Input、Bidirectional 或 —)、Wiring Diagram(ASCII 图)、Components、Bus Configuration(I2C/SPI/UART 的地址、速率或波特率及总线争用)、Power、LED/Status Indicators、Safety Notes、Troubleshooting。

风格与限制:简洁优先,不写通用 GPIO 参考表、安全引脚列表、面包板图、扩展建议、元件替换或外壳建议;引脚号以源码 #define 为准,与 README 冲突时需标注;用十进制 GPIO 编号(如 GPIO4);优先 ASCII 图而非 Mermaid;备注列用于上下拉、strapping 引脚警告、仅输入约束或备选引脚。供电与安全部分只写项目特定信息,不含通用 ESP32 规格或通用电子安全建议。

使用方式:以项目相对路径 $1 作为参数调用该技能。具体安装命令与调用命令资料未提供。