ESP32-S3 项目展示：SHT30 温湿度写入设备状态，串口 / 局域网页 / 手机三端可见（ESP-IDF v6.1）

文章目录

[ESP32-S3 项目展示：SHT30 温湿度写入设备状态，串口 / 局域网页 / 手机三端可见（ESP-IDF v6.1）](#ESP32-S3 项目展示：SHT30 温湿度写入设备状态，串口 / 局域网页 / 手机三端可见（ESP-IDF v6.1）)
- 一、这篇在整条链里干什么
- 二、接线（现象级）
- 三、验收前置条件
- 四、验收目标（同时满足才过）
- 五、实操步骤
- - [5.1 接线并上电](#5.1 接线并上电)
  - [5.2 看传感器是否被发现](#5.2 看传感器是否被发现)
  - [5.3 看读数（串口 + 网页）](#5.3 看读数（串口 + 网页）)
  - [5.4 简单现象验证](#5.4 简单现象验证)
- 六、对照与排查
- 七、验收自检清单
- 八、小结
- 系列博文

ESP32-S3 项目展示：SHT30 温湿度写入设备状态，串口 / 局域网页 / 手机三端可见（ESP-IDF v6.1）

级别： 实战篇（免费·现象级）

适合谁读： 已按本系列完成配网、局域网页控灯（建议再过 NVS），想给板子加上温湿度 的读者。MQTT 上云非必须 。

适用环境： Windows 10/11；ESP-IDF v6.1 ；乐鑫 ESP32-S3-DevKitC-1 ；SHT30（或兼容 SHT3x）模块；演示工程文中称 wifi_led。

目标： 接好线，串口能读到温湿度，且局域网页在电脑与手机浏览器上都能正常显示温度、湿度（读数已进 state）。

前置阅读：

文 05 局域网网页控灯 ·

文 04 SoftAP 配网 ·

文 06 NVS 掉电记 Wi‑Fi（建议） ·

文 07 MQTT 上云（可选，要看演示页时再读） ·

文 00 环境安装

本文只做 SHT30 接线 + 看见温湿度 的现象验收。

本篇不强制 MQTT/上云 ：以串口 + 局域网页 为准；电脑与手机打开同一 STA IP 都要能看见温湿度。超限闪灯留给下一篇。

摘要： 用四根线把 SHT30 接到 ESP32-S3（供电与电平统一用 3.3V）。固件读到传感器后，温度、湿度写入设备状态；串口与局域网页（电脑、手机）均能看见，已上云时云端演示页同源展示。本文展示「温湿度被正常采集、上报并三端可见」这一结果。

演示工程： 文中称 wifi_led。实机需固件已集成 SHT3x 读取，并把温湿度放进状态上报。

公开演示入口（可选）： https://linkeverything.top/tools/iot/

（能上云时，页面可显示温度、湿度；维护时可能暂时离线。）

一、这篇在整条链里干什么

前面已经：配网 → 控灯 → 掉电记住 Wi‑Fi →（可选）MQTT 远程看灯。

本篇补上环境感知 ：板子知道「现在几度、湿度多少」，数字进 state（设备状态），后面网页、演示页、小程序、Agent 才能共用同一份数。

没做文 07 也不影响本篇：串口 + 局域网页（电脑与手机）看见温湿度即可。

你看见	含义
串口出现 `temp` / `rh` 或类似读数	传感器被读到了
电脑、手机打开局域网页都能看到温度、湿度	数已进状态，页面两端可用
已上云时演示页也有温湿度	同一份 state 远程也能看（加分，非本篇硬门槛）
只有灯、没有温湿度	接线、地址或固件未编进传感

下一篇 才会讲：温度超限时灯怎么闪（本地联动）。本篇先保证数是准的、能看见。

二、接线（现象级）

演示固件常用：GPIO8 = SDA，GPIO9 = SCL ；模块供电用 3.3V ，禁止接 5V。

说明：模块说明书常写宽电压，但 ESP32-S3 的 GPIO 是 3.3V 电平 。传感器若用 5V 供电，I²C 高电平可能超出 GPIO 耐压。本演示统一 3V3 + 共地。

模块脚（常见丝印）	接到开发板	说明
VCC	3V3	只能 3.3V（见上）
GND	GND	共地
SDA / SD	GPIO8	数据线
SCL / SC	GPIO9	时钟线

常见模块 I²C 地址：0x44 （ADR 接地或板内默认）或 0x45 （ADR 接高）。串口里出现的地址应与此对应；其它封装以模块手册为准。

多数成品模块已带 I²C 上拉；若用裸芯片自行搭线，需按手册外加约 4.7kΩ 上拉（本篇按模块跟做即可）。

板载 RGB 常见在 GPIO38 ，接线时不要占错灯脚。

面包板孔位因排板而异，以模块丝印与上表 GPIO 为准。

上电前自检：

四根线无插反、无松动
VCC 绝不是 5V
模块 VCC 与 GND 未短路

三、验收前置条件

文 04～06 已过：能自动拿 STA got IP，局域网页能控灯。（文 06 建议完成，便于掉电后仍在同一网。）
SHT30 已按第二节接线。
串口监视可用（波特率常见 115200 ；COM3 换成你的口）。
电脑与手机均已连同一家用 Wi‑Fi （与板同网；勿用访客网），能打开 http://<STA IP>/。
（可选）已按文 07 能打开演示页；不做 MQTT 时跳过本条，本篇硬门槛仍是局域网页两端可见。

powershell 复制代码

. 'C:\Espressif\tools\Microsoft.v6.1.PowerShell_profile.ps1'
cd F:\esp\projects\wifi_led
idf.py -p COM3 monitor

路径按本机 Espressif / 工程目录修改。退出监视：Ctrl + ]。

四、验收目标（同时满足才过）

上电后串口出现找到传感器一类日志（常见地址 0x44 或 0x45，文案因固件而异）。
串口周期性或按事件打出温度、湿度 （演示固件形态如 mqtt_hal: state light=0 temp=23.5C rh=59.8%，每 30 秒左右一条；以你的日志为准）。
局域网页两端都正常：
- 电脑浏览器打开 http://<STA IP>/，能看到温度、湿度；
- 手机浏览器打开同一地址 ，同样能看到温度、湿度（与电脑大致一致）。
  仅串口有数、网页打不开或手机打不开 → 本篇不过（硬门槛）。
（加分）已上云时，演示页 https://linkeverything.top/tools/iot/ 也能显示温湿度。
用手捂一下模块或哈气，读数应有合理变化（不必实验室精度）。不要长时间捂住，以免读数异常偏高。

五、实操步骤

5.1 接线并上电

断电，按第二节接好四根线。
上电，打开串口监视。

5.2 看传感器是否被发现

正常：出现类似 found SHT3x at 0x44（或 0x45）。

约 30 秒内 仍完全没有传感相关日志：断电查接线与 3.3V；确认固件含 SHT30 功能。

若模块地址不是 0x44/0x45（少见封装），以模块手册为准，并确认固件是否探测该地址。

偶发提示：上电瞬间可能冒出一次 meas read: ESP_ERR_INVALID_RESPONSE 之类的 I²C 报错，随后自动恢复、读数稳定，属面包板首读抖动，不算故障；只要后续能持续读到数即可。

5.3 看读数（串口 + 网页）

继续看串口：应出现温度、湿度数字（演示形态 mqtt_hal: state ... temp=...C rh=...%，约 30 秒一条）。
电脑浏览器打开局域网页 http://<STA IP>/（文 05），确认页面有温度、湿度。无更新时先 F5。
手机连同一 Wi‑Fi，用系统浏览器打开同一地址，同样确认温湿度可见、与电脑大致一致。已按文 07 上云的话，手机也可在演示页或小程序里核对同一份数。

手机打不开时：是否仍连着 SoftAP / 访客网？是否被改成 https:// 或加了 www.？先按文 05 排查同网访问。

5.4 简单现象验证

捂热或吹气数秒，温度或湿度应有变化；松手后等几秒再读，避免手温一直压着探头。

完全不变：可能是读缓存、接线虚焊，或看错了显示字段------以串口原始读数为准，并再刷一次网页核对。

能完成 5.2～5.3（含电脑与手机网页）→ 本篇现象验收通过。

六、对照与排查

现象	你怎么做
串口有数，电脑与手机局域网页都能看温湿度	本篇通过
完全找不到传感器	查 3.3V/GND/SDA/SCL；地址是否被固件写死；线是否松
找到了但读数全是 0 / NaN	供电或通信不稳；换线重插；勿接 5V
串口有数，电脑网页没有	先 F5 ；浏览器直接开 `http://<STA IP>/api/state`，看是否返回 `temp_c`/`rh`------有则页面应能读、查前端，无则固件未把温湿度写进状态、回查文 05
电脑网页正常，手机打不开	手机是否同网、非访客网；是否被改成 https / 加了 www.；关移动数据再试
读数飘、刚捂完偏高	正常；松手等几秒稳定后再记数
演示页离线	回文 07；本篇硬门槛是局域网页两端，不依赖演示页

七、验收自检清单

（快速自检用，逐条含义见第四节。）

□ VCC=3V3，未接 5V
□ 串口有发现 SHT3x 类日志
□ 串口有温度、湿度读数
□ 电脑打开局域网页能看见温湿度
□ 手机打开同一局域网页能看见温湿度
□ （加分）捂热/哈气后读数有变化；演示页也能看（若已上云）

八、小结

SHT30 用 3.3V + I²C（本演示常见 GPIO8/9） 接到 ESP32-S3（为 GPIO 电平安全，勿用 5V 供电）。
本篇验收：传感器被发现，温湿度进状态；串口有数，且电脑与手机局域网页都能看见；不强制上云。
同一份 state，后面联动规则、小程序、Agent 都吃它------先保证数对、两端页面可用。
下一篇预告：温度超限时本地闪灯（联动现象级）。

欢迎对照实践，并在评论区交流（板型、接线、已打码的串口关键字均可）。

ESP32-S3 项目展示：SHT30 温湿度写入设备状态，串口 / 局域网页 / 手机三端可见（ESP-IDF v6.1）

文章目录