今天,我们开始第三个专题:连接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 库源代码