今天，我们开始第三个专题：连接SHT30温湿度传感器模块，获取当前环境实时温湿度数据，并显示在1.3寸TFT液晶显示屏上。
第一专题内容，请参考
【NodeMCU实时天气时钟温湿度项目 1】连接点亮SPI-TFT屏幕和UI布局设计-CSDN博客
第二专题内容，请参考
【NodeMCU实时天气时钟温湿度项目 2】WIFI模式设置及连接-CSDN博客
一、硬件需求------温湿度传感器模块SHT3X系列
SHT3x DIS是Sensirion's新一代温度和湿度传感器。它建立在一个新的CMOSens®传感器芯片上，该芯片是Sensirion's新的湿度和温度平台的核心。与前代相比，SHT3x DIS具有更高的智能性、可靠性和更高的精度规格。它的功能包括增强的信号处理、两个独特的用户可选择的 I2C 地址和高达1MHz的通信速率。
DFN封装规格为为 2.5mm x 2.5mm x 0.9mm（Height)，这就很方便将SHT3x DIS集成到各种应用中。另外，2.4伏至5.5伏的宽电源电压范围保证了与各种组装情况的兼容性。
总之，SHT3x DIS融合了作为湿度传感器行业的领导者Sensirion's15年来丰富的经验沉淀。
SHT30-31-35资料：点击下载， 提取码：369r。
本项目采用的型号为：SHT30
二、硬件连接关系
|---------|-----|-----|-----|-----|
| NodeMCU | 3V3 | GND | D1 | D2 |
| SHT30 | vcc | gnd | scl | sda |
三、添加ClosedCube SHT31D库
ClosedCube SHT31D，是支持 Sensirion SHT30-D, SHT31-D and SHT35-D温湿度传感器的Arduino框架库，适用于I2C接口。
方法：直接打开 PlatformIO 界面，选择 Libraries 图标，在搜索栏内输入 ClosedCube SHT31D，添加到本项目中。
四、ClosedCube SHT31D官方示例代码
cpp
//以下代码来源于官方示例 periodicmode.info 的代码
//为了能在[vscode + platformIO]平台正常运行，主要修改了三个位置的代码，均已在程序中加注释说明。
//在本项目中，重新定义了 I2C 通信引脚
#include <Wire.h>
#include "ClosedCube_SHT31D.h"
ClosedCube_SHT31D sht3xd;
// 新增： 定义 I2C 引脚
const int SHT_SCL = D1;
const int SHT_SDA = D2;
void printResult(String text, SHT31D result) ; //新增：函数预先声明
void setup()
{
//Wire.begin();----------这行是原代码，已加注释标志
//定义I2C通讯的引脚
Wire.begin(SHT_SDA, SHT_SCL);//新增：替换上一行代码，主要是定义启用I2C引脚
Serial.begin(9600);
Serial.println("ClosedCube SHT3X-D Periodic Mode Example");
Serial.println("supports SHT30-D, SHT31-D and SHT35-D");
sht3xd.begin(0x44); // I2C address: 0x44 or 0x45
Serial.print("Serial #");
Serial.println(sht3xd.readSerialNumber());
if (sht3xd.periodicStart(SHT3XD_REPEATABILITY_HIGH, SHT3XD_FREQUENCY_10HZ) != SHT3XD_NO_ERROR)
Serial.println("[ERROR] Cannot start periodic mode");
}
void loop()
{
printResult("Periodic Mode", sht3xd.periodicFetchData());
delay(250);
}
void printResult(String text, SHT31D result) {
if (result.error == SHT3XD_NO_ERROR) {
Serial.print(text);
Serial.print(": T=");
Serial.print(result.t);
Serial.print("C, RH=");
Serial.print(result.rh);
Serial.println("%");
} else {
Serial.print(text);
Serial.print(": [ERROR] Code #");
Serial.println(result.error);
}
}将此代码复制到项目 main.cpp 中，编译上传成后，如果在串口监视器输出如下信息，那就说明 SHT30 温湿度传感器已。
五、在项目中使用SHT30采集温湿度实时数据的代码
使用SHT30采集温湿度实时数据的代码，都封装在 sht30.h 文件中，分别定义了3个函数：
（1）void sht30_setup()，开机时调用，设置SHT30的I2C引脚、地址和工作模式。
（2）void saveResult(SHT31D result)，用于保存结果到指定的数据结构，如果传感器断开，则尝试重载。
（3）void sht30()，在主程序/循环体loop中调用。
本程序主要内容，来源于网络大神，如有异议，请及时联系作者。
cpp
//********sht30 温湿度传感器***************
#include <Wire.h>
#include "ClosedCube_SHT31D.h"
ClosedCube_SHT31D sht3xd;
// 配置引脚
const int SHT_SCL = D1;
const int SHT_SDA = D2;
const int SHT_ADDRESS = 0x44;
//定义保存采集数据结果的数据结构，并设置读取频率
struct SHT_DATA{
int8_t temperature = -99;
int8_t humidity = -99;
unsigned long sht30_last = 0;
const long sht30_interval = 1000; //每秒读取一次
} sht_data;
//开机函数
void sht30_setup() {
//定义I2C通讯的引脚
Wire.begin(SHT_SDA, SHT_SCL);
//准备读取sht3x传感器
sht3xd.begin(SHT_ADDRESS);
if (sht3xd.periodicStart(SHT3XD_REPEATABILITY_HIGH, SHT3XD_FREQUENCY_10HZ) != SHT3XD_NO_ERROR){
Serial.println("[ERROR] 读取sht30数据失败，可能是传感器没插好");
}
}
//保存结果到指定的数据结构，如果传感器断开，则尝试重载
void saveResult(SHT31D result) {
if (result.error == SHT3XD_NO_ERROR) {
sht_data.temperature = result.t;
sht_data.humidity = result.rh;
} else {
sht_data.temperature = -99;
sht_data.humidity = -99;
sht30_setup();
}
}
//循环体函数，放在loop中
void sht30() {
unsigned long currentMillis = millis();
if (currentMillis - sht_data.sht30_last >= sht_data.sht30_interval) {
sht_data.sht30_last = currentMillis;
saveResult(sht3xd.periodicFetchData());
Serial.print("T:");
Serial.print(sht_data.temperature);
Serial.print(" H:");
Serial.println(sht_data.humidity);
}
}六、运行结果展示
（1） 依据硬件连接关系，在面包板上接入SHT30温湿度传感器；
（2）设置每隔500ms调用一次sht30()函数；
（3）修改主程序 main.cpp 内容，实现在TFT液晶屏显示的目标。
（4）编译上传后，就可以在TFT屏幕上看到实时采集到的温湿度数据了。
（以下视频，是使用电热风机模拟来观察采集显示的结果）
sht30_test
七、项目资源下载
百度网盘下载链接：
https://pan.baidu.com/s/1Rk5OBIxZ-BtUMQqG8TjUag?pwd=vo5t，提取码：vo5t
八、编译不通过的解决办法
本项目需要导入ClosedCube SHT31D库以支持SHT30正常工作。在编译时，您可能会遇到如下图所示的错误信息。
解决方法是， 请将箭头所指方框内的内容修改成： return returnError(error);
cpp
return returnError(error);修改后的内容，如下图所示。再次编译，就可以顺利通过了。
参考资料
1.ClosedCube SHT31D 库源代码