wiring-safety-check

接线安全检查

在编写代码或接通电源前，检查电气规范。开发板的输入电压或单引脚最大值，并不能证明已连接的信号或整个电源轨是安全的。

信息收集

记录确切的开发板／模块及逻辑电压、传感器／执行器的零件编号、每条电源轨、信号方向、VIH／VIL／输入最大值、电流和启动峰值、上拉电阻的位置／阻值、接地路径、线缆长度、保护措施、默认状态，以及是否配有电平转换器、驱动器、续流路径、保险丝或限流器。

流程

1. 绘制电源轨和接地示意图，包括 USB／VIN／VSYS／3V3 路径及稳压器。
2. 检查每个信号的双向情况。5 V 供电不代表 I/O 可耐受 5 V；3.3 V MCU 输入不得接收超出范围的高电平。
3. 计算稳态和峰值电流，并为稳压器、连接器、布线和热量留出裕量。不要把各引脚的绝对最大值相加，当作开发板的预算。
4. 检查上拉电阻的总线电压、阻值、上升时间、扇出和重复电阻。对照开发板配置检查 I2C／SPI／UART 默认引脚。
5. 如电气规范有要求，添加电平转换、电阻分压、晶体管／MOSFET 驱动器、续流保护、去耦或隔离。
6. 在启用输出或电机前，确定安全的复位状态和故障状态。
7. 在完成连续性、极性、电源轨和负载测量记录之前，不得通过实物连接关卡。

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 技能规范：说明假设、所需工具及版本、实现步骤、各证明阶段的测试／证据、已知限制，以及恢复／安全说明。