ESP32 接线前怎么核对模块？把供电、信号和库版本写成清单

模块名相同，不代表电路相同

“SHT40 模块”可以是裸传感器的简单转接板，也可以带稳压、电平转换、上拉和标准插座。SSD1306 表示控制器，不自动确定面板分辨率、接口模式、复位电路与引脚顺序。即使针数相同，VCC/GND 排列也可能相反。先记录厂商、产品号、PCB 修订和清晰印字，再找对应资料。

核对分成资料栏与实物栏：资料给出允许条件，实物检查确认手里的板是否匹配；上电测量则记录真实值。不要把“商家写 3–5V”直接填为“GPIO 可接 5V”，也不要把芯片裸片的供电范围当成整块带稳压模块的 VIN 范围。

点击查看大图 ↗

做到这里，你应该看到

每个模块的 VIN、输出电源、信号电平和端子定义都有可追溯的依据。

参考：[1] 乐鑫 DevKitC-1 v1.1 用户指南：固定文档提交 927ed7e[3] Adafruit SHT40：Pinouts，VIN/3V、10kΩ 上拉与 0x44[4] Adafruit SHT40 PCB：固定提交 40fe2b3 的设计与说明[5] Adafruit PID326：规格、I2C 地址与 2020/2024 修订[7] Adafruit OLED：供电与 3.3V 逻辑

核对表一：两脚红 LED，不是三线灯模块

本篇具体器件是 Kingbright WP7113ID 两脚直插红 LED。它没有 I2C 地址、稳压器或内置限流电阻；三线带电阻的 LED 模块、RGB 可寻址灯与它不是同一种接法。选用 F03 的 1kΩ 串联电阻，并按数据手册封装图识别 A/K。

当前只复用 3V3 常亮实验，GPIO 留空。后续若改成 GPIO4 控制，须在新任务中同步更新接线表与代码；不能将此处“3V3 电源”列直接当成程序信号。LED 与电阻的实际极性、阻值和亮灯现象均未在本站实板测量。

参考：[2] Kingbright WP7113ID 数据手册 V.14A：尺寸、极性与电气条件

核对表二：Adafruit PID4885 SHT40

这里限定 Adafruit PID4885 的 SHT40 STEMMA QT 转接板。其资料说明有稳压、电平转换和 SDA/SCL 各 10kΩ 上拉，默认地址为 0x44。对于 S3，本系列用 3V3 接 VIN、GND 共地，让模块按 3.3V 逻辑环境工作；3V 标注是稳压器输出，不要与 VIN 混接成两路输入。

模块 SDA 接 GPIO8、SCL 接 GPIO9，与通用 esp32s3 3.3.12 的别名一致；后续程序仍应显式记录 Wire.begin(8,9)。STEMMA QT 线材要按端子定义核对，不能只认线色。多模块并联时上拉会并联，不能因为每块都有上拉就无上限串接。

库记录可先填 Adafruit SHT4x Library 1.0.5，但其 library.properties 还声明 BusIO、Unified Sensor、SH110X、SSD1306 等依赖；后续采样示例需要把整个实际安装组合锁定并构建。本篇不安装这些库，不把资料中的版本号当作已通过的软件验证。

参考：[3] Adafruit SHT40：Pinouts，VIN/3V、10kΩ 上拉与 0x44[4] Adafruit SHT40 PCB：固定提交 40fe2b3 的设计与说明[8] Adafruit SHT4x 1.0.5：依赖声明[10] Arduino-ESP32 3.3.12：通用 S3 引脚别名

核对表三：Adafruit PID326 的 SSD1306 128×64

这里限定 PID326 的 STEMMA QT 修订，厂商记录自 2020 年 8 月增加自动复位并默认 I2C；2024 年丝印更新不改变电路。老版 PID326 可能需要不同跳线或复位连接，匿名四针 OLED、SH1106 模块和 128×32 面板也不能直接套用。

对本文 S3，VIN 接 3V3、GND 共地，SDA/数据接 GPIO8，SCL/时钟接 GPIO9。该修订的 I2C 模式跳线已闭合，自动复位使 RST 可不接；若手里的板不同，先按其实际资料修正。本模块默认地址按 128×64 示例核对为 0x3D，并可经地址跳线变为 0x3C；后续必须以实物跳线与扫描记录确认，不写“所有 OLED 都是 0x3C”。

SSD1306 库版本记录为 2.5.17，仍需其声明的 Adafruit GFX 及间接依赖。128×64 单色帧缓冲约需 1024 字节，这来自像素数除以 8 的计算；不由“128×64 看上去与别的屏差不多”决定驱动类。本文没有显示程序，不用一次扫描应答证明控制器和显示都正确。

参考：[5] Adafruit PID326：规格、I2C 地址与 2020/2024 修订[6] Adafruit OLED：128×64 接线、模式跳线与自动复位[7] Adafruit OLED：供电与 3.3V 逻辑[9] Adafruit SSD1306 2.5.17：依赖声明[10] Arduino-ESP32 3.3.12：通用 S3 引脚别名

合并到项目时，再做一次电气和资源检查

单独填完三张表后，先不要把模块全插上。把主控每个 GPIO 的所有用途列出来：两个 I2C 模块共享 SDA8/SCL9 且地址不同是计划中的总线共享；LED 的电源回路则没有 GPIO。若另一个驱动把 8 或 9 配作输出，表面接线没变，总线仍会失效。

将 3V3 的各个负载、电源轨分段、地线与信号上拉来源列入总表。当前选择的两个 Adafruit 模块支持 3.3V 供电与逻辑，但未知模块必须重新核查。模块断电而主控仍向信号输出时还可能经信号反供电，不能把共地理解成所有电源可以随意并联。

按一次一个模块的顺序验收：先裸板、再 LED、再 SHT40、最后 OLED。每次断电再接，核对后上电，记录成功与失败。芯片手册、PCB 修订、库版本或接线发生变化，就更新总表并重做受影响检查。

点击查看大图 ↗

参考：[1] 乐鑫 DevKitC-1 v1.1 用户指南：固定文档提交 927ed7e[3] Adafruit SHT40：Pinouts，VIN/3V、10kΩ 上拉与 0x44[4] Adafruit SHT40 PCB：固定提交 40fe2b3 的设计与说明[5] Adafruit PID326：规格、I2C 地址与 2020/2024 修订[6] Adafruit OLED：128×64 接线、模式跳线与自动复位[7] Adafruit OLED：供电与 3.3V 逻辑[10] Arduino-ESP32 3.3.12：通用 S3 引脚别名

留下能被下一位读者复核的记录

一份可复用记录至少包含：日期、主控板修订/模组、器件产品号/修订、来源链接与文档版本、每条线的两端、电源与逻辑、地址/模式、库及依赖、构建结果、实板现象和未确认项。资料值与测量值分栏；没有工具或实物就写未测，不以预期值代填。

本篇提供的是三张已完成的资料核对表与执行方法，没有运行传感器或显示程序。软件验证不适用于这篇清单；接线、电压和器件行为仍待实板。在后续作品里复用时，应引用这张清单并补上该作品的代码、依赖和真实检查记录。

做到这里，你应该看到

三张表都能标出具体型号和边界，任何一个未知模块都没有被写成“已兼容”。

参考：[1] 乐鑫 DevKitC-1 v1.1 用户指南：固定文档提交 927ed7e[2] Kingbright WP7113ID 数据手册 V.14A：尺寸、极性与电气条件[3] Adafruit SHT40：Pinouts，VIN/3V、10kΩ 上拉与 0x44[4] Adafruit SHT40 PCB：固定提交 40fe2b3 的设计与说明[5] Adafruit PID326：规格、I2C 地址与 2020/2024 修订[6] Adafruit OLED：128×64 接线、模式跳线与自动复位[7] Adafruit OLED：供电与 3.3V 逻辑[8] Adafruit SHT4x 1.0.5：依赖声明[9] Adafruit SSD1306 2.5.17：依赖声明[10] Arduino-ESP32 3.3.12：通用 S3 引脚别名