20260610

2026-06-12 17:03:10 +08:00
parent e488cd3216
commit 9eaffcc9ff
31 changed files with 6829 additions and 0 deletions
@@ -0,0 +1,48 @@
+/**
+ * @file sht30.h
+ * @brief SHT30 温湿度传感器驱动 (I2C)
+ *
+ * 硬件接口: I2C (复用 hw_init 中已初始化的 I2C_PORT)
+ * I2C 地址: 0x44 (ADDR 接地) 或 0x45 (ADDR 接 VDD)
+ * 框架: ESP-IDF 5.1.x
+ */
+
+#ifndef SHT30_H
+#define SHT30_H
+
+#include <stdint.h>
+#include "esp_err.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** 单次测量结果 */
+typedef struct {
+    float temperature;   /* 摄氏度 */
+    float humidity;      /* 相对湿度 % */
+} sht30_data_t;
+
+/**
+ * @brief 初始化 SHT30 传感器 (验证 I2C 通信)
+ * @return ESP_OK 成功, 否则失败
+ *
+ * 注意: 调用前需确保 I2C 总线已初始化 (hw_i2c_init)。
+ */
+esp_err_t sht30_init(void);
+
+/**
+ * @brief 执行单次测量 (高重复性、时钟拉伸模式)
+ * @param data [输出] 温湿度结果
+ * @return ESP_OK 成功, 否则失败
+ *
+ * 内部等待约 15 ms 后读取 6 字节原始数据,
+ * 经 CRC-8 校验后转换为物理量。
+ */
+esp_err_t sht30_read(sht30_data_t *data);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* SHT30_H */