接着我们温湿传感器上半部分的学习,现在我们学习接下来的部分,编写GXHTC3驱动程序,也就是给gxhtc3.c文件添加代码,我们要判断gxhtc3芯片是否存在和正常,就要先读取gxhtc3的ID号,根据gxhtc3的数据手册,读取命令为0xEFC8,发送命令后,可以读出16位的ID号和1个CRC字节。CRC字节用来校验判断读取的数据是否正确。
首先,我们需要先写一个校验代码,如下代码所示,
#define POLYNOMIAL 0x31 // P(x) = x^8 + x^5 + x^4 + 1 = 00110001,POLYNOMIAL是多项式因子//CRC校验
uint8_t gxhtc3_calc_crc(uint8_t *crcdata, uint8_t len) //两个参数分别是需要校验的数据和数据长度
{uint8_t crc = 0xFF; for(uint8_t i = 0; i < len; i++){crc ^= (crcdata[i]); //crc初始值是0xFF,crcdata与crc按位与或运算后,把计算后的值赋值给crc,crcdata中位是0的位置会变成1,位是1的位置会变成0,这条语句的作用就是把crcdata的值,1变成0,0变成1,然后赋值给crcfor(uint8_t j = 8; j > 0; --j) //这里的for循环按位计算,如果位是0,直接左移1位,如果位是1,左移1位后再与多项式按位与或运算{if(crc & 0x80) crc = (crc << 1) ^ POLYNOMIAL;else crc = (crc << 1);}}return crc; //返回值是计算好的CRC字节(需要和读出的CRC字节做对比,一致的话正确)
}
接下来,我们需要写一个读取ID的代码,
// 读取ID
esp_err_t gxhtc3_read_id(void) //该函数返回一个 esp_err_t 类型的错误码,表示操作是否成功
{esp_err_t ret; // 用于存储函数执行过程中返回的错误码uint8_t data[3]; //用于存储从传感器读取的3字节数据(包括ID和CRC校验值)i2c_cmd_handle_t cmd = i2c_cmd_link_create(); //创建一个新的I2C命令链i2c_master_start(cmd); //发送I2C起始信号i2c_master_write_byte(cmd, 0x70 << 1 | I2C_MASTER_WRITE, true); //写入I2C设备的地址(0x70),并设置为写模式i2c_master_write_byte(cmd, 0xEF, true); //写入命令字节0xEF,用于选择传感器的ID读取命令i2c_master_write_byte(cmd, 0xC8, true); //写入命令字节0xC8,可能是用于配置或确认读取操作i2c_master_stop(cmd); //发送I2C停止信号ret = i2c_master_cmd_begin(I2C_MASTER_NUM, cmd, 1000 / portTICK_PERIOD_MS); //执行I2C命令链,超时时间为1000毫秒if (ret != ESP_OK) { //如果执行失败(ret != ESP_OK),则跳转到 end 标签,释放资源并返回错误码goto end;}cmd = i2c_cmd_link_create(); //重新创建一个新的I2C命令链i2c_master_start(cmd); //发送I2C起始信号i2c_master_write_byte(cmd, 0x70 << 1 | I2C_MASTER_READ, true); //写入I2C设备的地址(0x70),并设置为读模式i2c_master_read(cmd, data, 3, I2C_MASTER_LAST_NACK); //读取3字节数据到 data 数组中,最后一个字节读取后发送NACK信号i2c_master_stop(cmd); //发送I2C停止信号ret = i2c_master_cmd_begin(I2C_MASTER_NUM, cmd, 1000 / portTICK_PERIOD_MS); //执行I2C命令链,超时时间为1000毫秒if(data[2]!=gxhtc3_calc_crc(data,2)){ //计算前两个字节的CRC校验值 ret = ESP_FAIL; //如果计算的CRC值与读取的CRC值不匹配(data[2]),则将 ret 设置为 ESP_FAIL,表示校验失败}
end:i2c_cmd_link_delete(cmd); //释放I2C命令链资源return ret; //表示函数执行的结
}
因为函数中用到了i2c的函数,所以给这个文件也添加一个i2c.h头文件。上面的函数中用到了I2C_MASTER_NUM这个宏定义,这个宏定义是在myi2c.h文件中定义的,所以也需要添加myi2c.h头文件
#include "myi2c.h"
#include "driver/i2c.h"
接下来给gxhtc3.h文件中添加读取ID函数的声明
extern esp_err_t gxhtc3_read_id(void);
这里用到了esp_err_t类型,所以也需要调用一下对应的头文件
#include "esp_err.h"
然后我们在main.c文件中调用这个函看能正确读取ID号
void app_main(void)
{ESP_ERROR_CHECK(i2c_master_init()); //调用 i2c_master_init() 函数初始化I2C总线,并使用 ESP_ERROR_CHECK 宏检查初始化是否成功。如果初始化失败,程序将停止并打印错误信息ESP_LOGI(TAG, "I2C initialized successfully"); //如果I2C初始化成功,使用 ESP_LOGI 宏打印一条信息,表示I2C总线已成功初始化esp_err_t ret = gxhtc3_read_id(); //调用 gxhtc3_read_id() 函数读取GXHTC3传感器的ID,并将返回值存储在 ret 变量中while(ret != ESP_OK) // 如果读取ID失败(ret != ESP_OK),则进入循环{ret = gxhtc3_read_id(); //再次尝试读取GXHTC3传感器的IDESP_LOGI(TAG,"GXHTC3 READ ID"); //打印一条信息,表示正在尝试读取GXHTC3传感器的IDvTaskDelay(1000 / portTICK_PERIOD_MS); //延迟1000毫秒(1秒),然后再次尝试读取ID}ESP_LOGI(TAG,"GXHTC3 OK"); //如果成功读取GXHTC3传感器的ID(ret == ESP_OK),打印一条信息,表示读取成功
}
这里使用了vTaskDelay函数,需要在main.c文件中添加freeRTOS相关头文件
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
以上完成之后,我们就可以试着编译一下了。
还没有完,接着,我们继续学习编写读取温湿度数据程序,根据学习,我们再给gxhtc3.c文件中添加读取温湿度的相关函数。根据gxhtc3的数据手册上介绍,每一次读取数据,都需要经过四组命令,按照执行顺序,分别是唤醒、测量、读出、休眠,我们分别写这四个命令的函数,首先,我们要写一下唤醒的代码,以下是我写的
//唤醒
esp_err_t gxhtc3_wake_up(void) //该函数返回一个 esp_err_t 类型的错误码,表示操作是否成功
{int ret; //用于存储函数执行过程中返回的错误码i2c_cmd_handle_t cmd = i2c_cmd_link_create(); //创建一个新的I2C命令链i2c_master_start(cmd); //发送I2C起始信号i2c_master_write_byte(cmd, 0x70 << 1 | I2C_MASTER_WRITE, true); //写入I2C设备的地址(0x70),并设置为写模式 i2c_master_write_byte(cmd, 0x35, true); //写入命令字节0x35,用于唤醒传感器i2c_master_write_byte(cmd, 0x17, true); //写入命令字节0x17,可能是用于配置或确认唤醒操作i2c_master_stop(cmd); //发送I2C停止信号ret = i2c_master_cmd_begin(I2C_MASTER_NUM, cmd, 1000 / portTICK_PERIOD_MS); //执行I2C命令链,超时时间为1000毫秒,执行结果存储在 ret 变量中i2c_cmd_link_delete(cmd); //释放I2C命令链资源return ret; //表示函数执行的结果
}
接着,我们在写一下测量部分的函数
// 测量
esp_err_t gxhtc3_measure(void) //该函数返回一个 esp_err_t 类型的错误码,表示操作是否成功
{int ret; //用于存储函数执行过程中返回的错误码i2c_cmd_handle_t cmd = i2c_cmd_link_create(); //创建一个新的I2C命令链i2c_master_start(cmd); //发送I2C起始信号i2c_master_write_byte(cmd, 0x70 << 1 | I2C_MASTER_WRITE, true); //写入I2C设备的地址(0x70),并设置为写模式i2c_master_write_byte(cmd, 0x7c, true); //写入命令字节0x7c,用于触发传感器进行测量i2c_master_write_byte(cmd, 0xa2, true); //写入命令字节0xa2,可能是用于配置或确认测量操作i2c_master_stop(cmd); // 发送I2C停止信号ret = i2c_master_cmd_begin(I2C_MASTER_NUM, cmd, 1000 / portTICK_PERIOD_MS); //执行I2C命令链,超时时间为1000毫秒i2c_cmd_link_delete(cmd); // 释放I2C命令链资源return ret; //表示函数执行的结果
}
接着,我们写一下读取温湿数据部分的代码
// 读出温湿度数据
esp_err_t gxhtc3_read_tah(void) //该函数返回一个 esp_err_t 类型的错误码,表示操作是否成功
{int ret; //用于存储函数执行过程中返回的错误码i2c_cmd_handle_t cmd = i2c_cmd_link_create(); //创建一个新的I2C命令链i2c_master_start(cmd); //发送I2C起始信号i2c_master_write_byte(cmd, 0x70 << 1 | I2C_MASTER_READ, true); //写入I2C设备的地址(0x70),并设置为读模式i2c_master_read(cmd, tah_data, 6, I2C_MASTER_LAST_NACK); //从传感器读取6字节数据到 tah_data 数组中,最后一个字节读取后发送NACK信号i2c_master_stop(cmd); //发送I2C停止信号ret = i2c_master_cmd_begin(I2C_MASTER_NUM, cmd, 1000 / portTICK_PERIOD_MS); //执行I2C命令链,超时时间为1000毫秒i2c_cmd_link_delete(cmd); //释放I2C命令链资源return ret; //表示函数执行的结果
}
以上是读出温湿度数据的函数。读到的数据字节放到tah_data这个数组里面,需要在gxhtc3.c文件的include下面定义tah_data数组。读出函数需要跟在测量函数后使用,一次读取6个字节,分别是2个温度数据+1个温度CRC字节+2个湿度数据+1个湿度CRC字节
接着,我们写休眠部分的函数
// 休眠
esp_err_t gxhtc3_sleep(void) //该函数返回一个 esp_err_t 类型的错误码,表示操作是否成功
{int ret; //用于存储函数执行过程中返回的错误码i2c_cmd_handle_t cmd = i2c_cmd_link_create(); //创建一个新的I2C命令链i2c_master_start(cmd); //发送I2C起始信号i2c_master_write_byte(cmd, 0x70 << 1 | I2C_MASTER_WRITE, true); //写入I2C设备的地址(0x70),并设置为写模式i2c_master_write_byte(cmd, 0xB0, true); //写入命令字节0xB0,用于使传感器进入休眠模式i2c_master_write_byte(cmd, 0x98, true); //写入命令字节0x98,可能是用于配置或确认休眠操作i2c_master_stop(cmd); //发送I2C停止信号ret = i2c_master_cmd_begin(I2C_MASTER_NUM, cmd, 1000 / portTICK_PERIOD_MS); //执行I2C命令链,超时时间为1000毫秒i2c_cmd_link_delete(cmd); //执行结果存储在 ret 变量中return ret; //表示函数执行的结果
}
接下来,我们再写一个函数,把上面的4个命令函数使用上,获取温湿度
uint16_t rawValueTemp, rawValueHumi; //rawValueTemp: 用于存储从传感器读取的原始温度数据。// rawValueHumi: 用于存储从传感器读取的原始湿度数据
float temp=0, humi=0;
uint8_t temp_int, humi_int;
// 获取并计算温湿度数据
esp_err_t gxhtc3_get_tah(void) //该函数返回一个 esp_err_t 类型的错误码,表示操作是否成功
{int ret; //用于存储函数执行过程中返回的错误码gxhtc3_wake_up(); //调用 gxhtc3_wake_up() 函数唤醒传感器,使其进入工作状态gxhtc3_measure(); //调用 gxhtc3_measure() 函数触发传感器进行温湿度测量vTaskDelay(20 / portTICK_PERIOD_MS); //延迟20毫秒,等待传感器完成测量gxhtc3_read_tah(); //调用 gxhtc3_read_tah() 函数从传感器读取温湿度数据,并存储在 tah_data 数组中gxhtc3_sleep(); //调用 gxhtc3_sleep() 函数使传感器进入休眠模式,以节省功耗if((tah_data[2]!=gxhtc3_calc_crc(tah_data,2)|| //gxhtc3_calc_crc(tah_data, 2): 计算前两个字节的CRC校验值
(tah_data[5]!=gxhtc3_calc_crc(&tah_data[3],2)))){ //gxhtc3_calc_crc(&tah_data[3], 2): 计算后两个字节的CRC校验值temp = 0; //如果CRC校验失败,将温度和湿度值设为0,并将 ret 设置为 ESP_FAILhumi = 0;temp_int = 0;humi_int = 0;ret = ESP_FAIL;}else{rawValueTemp = (tah_data[0]<<8) | tah_data[1]; // 将前两个字节合并为一个16位整数,表示原始温度数据rawValueHumi = (tah_data[3]<<8) | tah_data[4]; //将后两个字节合并为一个16位整数,表示原始湿度数据temp = (175.0 * (float)rawValueTemp) / 65535.0 - 45.0; //将原始温度数据转换为实际温度值(单位:摄氏度)humi = (100.0 * (float)rawValueHumi) / 65535.0; //将原始湿度数据转换为实际湿度值(单位:百分比)temp_int = round(temp); //将温度值四舍五入为整数humi_int = round(humi);ret = ESP_OK;}return ret;
}
转换整形数据的时候,用到了round函数,需要添加math.h头文件
#include <math.h>
然后我们在gxhtc3.h文件中,添加gxhtc3_get_tah函数声明,因为接下来要在main.c文件中调用
extern esp_err_t gxhtc3_get_tah(void);
因为用到了esp_err_t类型,所以还需要添加esp_err.h头文件
#include "esp_err.h"
现在打开main.c文件,在app_main函数中的while循环读取ID的下面,创建一个gxhtc3_task任务
xTaskCreate(gxhtc3_task, "gxhtc3_task", 4096, NULL, 6, NULL);
然后编写这个任务函数
static void gxhtc3_task(void *args) //该函数接受一个 void * 类型的参数 args,通常用于传递任务参数
{esp_err_t ret; //用于存储 gxhtc3_get_tah() 函数返回的错误码while(1){ret = gxhtc3_get_tah(); //调用 gxhtc3_get_tah() 函数获取温湿度数据,并将返回值存储在 ret 变量中if (ret!=ESP_OK) {ESP_LOGE(TAG,"GXHTC3 READ TAH ERROR."); //如果 gxhtc3_get_tah() 返回的错误码不是 ESP_OK,则使用 ESP_LOGE 宏打印错误信息,表示读取温湿度数据失败}else{ESP_LOGI(TAG, "TEMP:%.1f HUMI:%.1f", temp, humi); //如果 gxhtc3_get_tah() 返回成功(ESP_OK),则使用 ESP_LOGI 宏打印温湿度数据ESP_LOGI(TAG, "TEMP:%d HUMI:%d", temp_int, humi_int); //打印整数格式的温度和湿度值}vTaskDelay(1000 / portTICK_PERIOD_MS); //调用 vTaskDelay 函数延迟1000毫秒(1秒),然后再次执行循环}
}
这其中用到了temp humi temp_int humi_int这几个变量,所以我们需要在函数前面声明一下来自外部文件
extern float temp,humi;
extern uint8_t temp_int,humi_int;
接下来,我们在主函数中调用这个任务函数
void app_main(void)
{ESP_ERROR_CHECK(i2c_master_init()); //调用 i2c_master_init() 函数初始化I2C总线,并使用 ESP_ERROR_CHECK 宏检查初始化是否成功。如果初始化失败,程序将停止并打印错误信息ESP_LOGI(TAG, "I2C initialized successfully"); //如果I2C初始化成功,使用 ESP_LOGI 宏打印一条信息,表示I2C总线已成功初始化esp_err_t ret = gxhtc3_read_id(); //调用 gxhtc3_read_id() 函数读取GXHTC3传感器的ID,并将返回值存储在 ret 变量中while(ret != ESP_OK) //如果读取ID失败(ret != ESP_OK),则进入循环{ret = gxhtc3_read_id(); //再次尝试读取GXHTC3传感器的IDESP_LOGI(TAG,"GXHTC3 READ ID"); //打印一条信息,表示正在尝试读取GXHTC3传感器的IDvTaskDelay(1000 / portTICK_PERIOD_MS); //延迟1000毫秒(1秒),然后再次尝试读取ID}ESP_LOGI(TAG,"GXHTC3 OK"); // 如果成功读取GXHTC3传感器的ID(ret == ESP_OK),打印一条信息,表示读取成功xTaskCreate(gxhtc3_task, "gxhtc3_task", 4096, NULL, 6, NULL); // 创建并启动一个任务,用于持续读取GXHTC3传感器的温湿度数据
}
最后,我们就可以进行编译了。