Wiring Safety Check 是一个嵌入式接线安全检查技能,用于在编写代码或施加电源之前核对电气契约。板卡的输入电压或单引脚最大值并不能证明所连接信号或整条电源轨是安全的。
用途
该技能适用于将 Arduino、ESP32、ESP32-S3、Pico 或 Pico W 连接到传感器、LED、电机、继电器、总线或外部电源的场景,尤其当 5 V 与 3.3 V 同时出现时。它的目标是在通电或上传代码前发现电平、电流、接地与保护方面的风险。
信息采集
记录确切的板卡/模块与逻辑电压、传感器/执行器型号、每条电源轨、信号方向、VIH/VIL 与输入最大值、电流与启动峰值、上拉位置与阻值、地路径、线缆长度、保护措施、默认状态,以及是否已具备电平转换器、驱动器、续流路径、保险丝或限流器。
处理流程
绘制电源轨与地线映射,包含 USB、VIN、VSYS、3V3 路径与稳压器。
双向检查每个信号。5 V 供电并不意味着 5 V 安全 I/O;3.3 V MCU 输入不得接收超范围的高电平。
结合稳压器、连接器、线材与热裕量计算稳态与峰值电流。不要把每个引脚的绝对最大值相加当作板卡预算。
检查总线的上拉:电压、阻值、上升时间、扇出与重复电阻。对照板卡配置检查 I2C/SPI/UART 默认引脚。
当电气契约要求时,加入电平转换、分压、晶体管/MOSFET 驱动、续流保护、去耦或隔离。
在使能输出或电机之前定义安全的复位与故障状态。
在采集通断、极性、电源轨与负载测量之前,停在物理门禁处。
关于 5 V 转 ESP32 的必需结论
当用户只说“把一个 5 V 传感器接到 ESP32”时,立即标记缺失的电平兼容性:ESP32 GPIO 属于 3.3 V 类别,通常不兼容 5 V。要求提供传感器实际 I/O 电平,并要求对进入 ESP32 的任何 5 V 信号使用合适的电平转换或分压。共地并不能解决电平不兼容。在选择电路之前,检查传感器是否接受 3.3 V 供电,以及其输出是否为开漏。
避免的合理化借口
“它是 5 V 传感器,所以数据引脚安全。”——应查看传感器数据手册,并为 5 V 高电平标记电平转换需求。
“共地就能解决。”——地参考是必要的,但不会改变逻辑阈值。
“每引脚 20 mA 就是板卡预算。”——应检查电源轨、稳压器、连接器、总负载与峰值电流。
“LED 或电机很小。”——应检查浪涌、堵转电流、感性反冲与驱动拓扑。
“我已经给它通电了。”——应停止、检查并记录测量;不要因为没坏就推断安全。
验证
接线表应写明源/目标、电压、方向与保护。
电平转换与上拉决策应引用数据手册,或明确标注为未解决。
应采集通断/极性与空载/带载电源轨测量。
构建/上传证据不应被提升为硬件或系统证明。
共享输出契约
使用共享的 Arduino 技能契约:说明假设、所需工具与版本、实现步骤、按证明阶段划分的测试/证据、已知限制,以及恢复/安全说明。
限制
该技能的具体实现细节、支持的完整板卡列表、工具版本要求、安装方式与运行环境,资料中暂未提供。