SHT31 温湿度传感器

fastbee大约 3 分钟

SHT31 温湿度传感器

SHT31 是常用 I2C 温湿度传感器，精度和稳定性优于 DHT11，适合环境监测、温控和恒湿场景。当前驱动为轻量实现，不依赖额外第三方库，esp32、esp32c3、esp32s3 和 esp32s3-F16R8 均可使用。

接线

SHT31	ESP32
VCC	3.3V
GND	GND
SDA	GPIO21
SCL	GPIO22

默认地址为 0x44，部分模块可切换到 0x45。

配置方式

方式1：Web界面配置（推荐）

SHT31 保存前重点核对 I2C 地址、采样间隔和温湿度字段。

步骤1：进入外设管理页面

打开浏览器访问 ESP32 IP 地址
登录后点击左侧菜单 外设配置

步骤2：添加SHT31外设

点击 新增外设 按钮

填写配置：

字段	填写内容	说明
外设ID	`sht31_i2c`	唯一标识符
名称	`SHT31温湿度`	显示名称
外设类型	通用传感器 (type: 38)	I2C传感器
SDA引脚	`21`	I2C数据引脚
SCL引脚	`22`	I2C时钟引脚
I2C地址	`0x44`	0x44或0x45
采集间隔	`5000`	5秒

点击保存

步骤3：验证配置

在外设列表中找到刚添加的外设
点击启用开关
等待5秒后查看温度和湿度数据

💡 提示：SHT31精度和稳定性优于DHT11，所有ESP32型号均支持

方式2：JSON配置文件导入

{
  "id": "sht31_i2c",
  "name": "SHT31温湿度",
  "type": 2,
  "enabled": false,
  "pinCount": 2,
  "pins": [21, 22, 255, 255, 255, 255, 255, 255],
  "params": {
    "frequency": 100000,
    "address": 0,
    "isMaster": true
  }
}

外设执行联动

Web界面配置步骤

创建温度采集与控制规则

切换到 外设执行管理 标签
点击 新增规则 按钮
配置定时触发器：
- 触发类型：定时触发
- 执行间隔：30 秒
添加动作：
- 动作1：读取温度
  - 动作类型：传感器读取
  - 目标外设：sht31_i2c
  - 数据字段：temperature
开启 执行后上报数据
点击保存

创建温度过高打开继电器规则

创建新规则
配置事件触发器：
- 触发类型：事件触发
- 事件ID：ds:sht31_i2c_temperature
- 比较操作：大于
- 比较值：35（℃）
添加动作：
- 动作类型：高电平
- 目标外设：relay_01（风扇继电器）
点击保存

💡 提示：SHT31适用于精密温控、恒湿场景

JSON配置示例

{
  "id": "exec_sht31_temperature_read",
  "name": "SHT31温度采集",
  "enabled": false,
  "triggers": [
    {
      "triggerType": 1,
      "timerMode": 0,
      "intervalSec": 30
    }
  ],
  "actions": [
    {
      "targetPeriphId": "sht31_i2c",
      "actionType": 19,
      "actionValue": "{\"periphId\":\"sht31_i2c\",\"sensorCategory\":\"SHT31\",\"dataField\":\"temperature\",\"sensorLabel\":\"温度\",\"unit\":\"℃\",\"decimalPlaces\":1,\"driverParams\":{\"addr\":\"0x44\",\"sda\":21,\"scl\":22}}",
      "useReceivedValue": false,
      "syncDelayMs": 0,
      "execMode": 0
    }
  ],
  "reportAfterExec": true
}

温度过高打开继电器

{
  "id": "exec_sht31_hot_relay",
  "name": "SHT31高温打开继电器",
  "enabled": false,
  "triggers": [
    {
      "triggerType": 4,
      "eventId": "ds:sht31_i2c_temperature",
      "operatorType": 2,
      "compareValue": "35"
    }
  ],
  "actions": [
    {
      "targetPeriphId": "relay_01",
      "actionType": 0,
      "actionValue": "",
      "useReceivedValue": false,
      "syncDelayMs": 0,
      "execMode": 0
    }
  ],
  "reportAfterExec": true
}

可采集字段

dataField	含义	单位
`temperature`	温度	℃
`humidity`	相对湿度	%