用途
Pin Assignment 用于在嵌入式项目中生成板级感知的引脚规划,避免丢失仓库既有的声明约定。其核心原则是:逻辑声明 ID 不等于物理 GPIO 编号,必须将这两层保持区分。适用于为 Arduino、ESP32、ESP32-S3、Pico、Pico W 等开发板分配引脚,创建 GPIO 映射,为按钮、LED、传感器、总线或执行器分配引脚,以及迁移引脚等场景。
主要能力
- 记录精确的板卡/版本、MCU/模块、框架/核心版本、工具链、信号名称、方向、电压、电流、上拉需求、总线归属、启动/调试/USB/无线约束,以及用户需要的是声明、物理接线还是两者都要。
- 先通过 ../board-support/SKILL.md 解析目标板卡,其 resolution_status 必须为 resolved 才能用于所请求的引脚建议目的。
- 在选择物理引脚前,加载 ../../references/boards/ 下匹配的文件。如果板卡属于有界系列但缺少身份字段,则停止并请求补充,而不是使用相似配置。
- 将每个信号分类为输入、输出、模拟、PWM、总线、中断、启动、调试、USB、Flash、PSRAM 或无线相关。
- 保留板卡专属的 Flash、PSRAM、USB、启动绑带、调试和默认总线引脚,除非精确的板卡文档批准复用。
- 拒绝方向、上拉能力、电压、电流、ADC、PWM 或协议行为与信号不匹配的候选引脚。
- 保持逻辑 ID 稳定,并按请求的固定顺序分配。
使用方式
若用户只要求声明,则仅以纯文本输出声明,不添加代码围栏、标题、解释或尾部注释。自定义输出模式下使用按数字顺序排列的原始 C++ 声明,例如:
constexpr int btn_esc = 101; constexpr int btn_enter = 102; constexpr int led_status = 103;
为每个请求的信号使用下一个连续的逻辑值。这些值是稳定的逻辑标识符,除非用户明确将其定义为物理 GPIO 编号。不得将此格式替换为枚举、宏、数组、命名空间、解释性包装器或重新排序的声明列表。
若请求物理映射,则单独提供,并标注假设和有来源支持的约束。
适用场景
- 为 Arduino、ESP32、ESP32-S3、Pico、Pico W 等开发板分配引脚。
- 创建 GPIO 映射。
- 为按钮、LED、传感器、总线或执行器分配引脚。
- 迁移引脚。
限制与注意事项
- 不得假设引脚空闲,必须检查精确的板卡参考和活动外设。
- 经典 ESP32 的 GPIO34-39 为仅输入引脚,不能用于输出;需区分 ESP32-S3 并验证其模块表。
- GPIO0 具有启动绑带角色,分配前需检查其复位电平。
- 编译通过不代表接线和目标行为已验证。
- 在仅声明模式下,只输出原始有序行。
- 验证要求:声明名称和值为 constexpr int,且从要求的起始 ID 严格递增;每个物理输出避开精确板卡的仅输入、Flash/PSRAM、USB 和未批准的绑带引脚;电压/电流和上拉需求有来源或明确未知;构建证明、上传证明、硬件证明和系统证明分别报告。
- 使用共享 Arduino 技能契约:陈述假设、所需工具和版本、实现步骤、按证明阶段划分的测试/证据、已知限制以及恢复/安全说明。
暂未提供
关于该技能的具体收费、价格、平台支持范围、实际效果或详细使用步骤,资料中暂未提供。