AHT10温湿度传感器

AHT10，新一代温湿度传感器在尺寸与智能方面建立了新的标准：它嵌入了适于回流焊的双列扁平无引脚SMD 封装，底面 4 x 5mm ，高度1.6mm。传感器输出经过标定的数字信号，标准 I 2 C 格式。AHT10 配有一个全新设计的 ASIC专用芯片、一个经过改进的MEMS半导体电容式湿度传感元件和一个标准的片上温度传感元件，其性能已经大大提升甚至超出了前一代传感器的可靠性水平，新一代温湿度传感器，经过改进使其在恶劣环境下的性能更稳定。每一个传感器都经过校准和测试，在产品表面印有产品批号。由于对传感器做了改良和微型化改进，因此它的性价比更高，并且最终所有设备都将得益于尖端的节能运行模式。
应用范围主要在暖通空调、除湿器、测试及检测设备、消费品、汽车、自动控制、数据记录器、气象站、家电、湿度调节、医疗及其他相关温湿度检测控制。

模块来源

采购链接：
https://item.taobao.com/item.htm?spm=a230r.1.14.28.5b982786BAvoXy&id=630894804483&ns=1&abbucket=19#detail
资料下载链接：
https://pan.baidu.com/s/1xTX_QCmEmy8DWgxgtgXXFw
提取码：pp3k

规格参数

工作电压：1.8~3.6V
工作电流：0.25~23uA
湿度误差：±2%RH
温度误差：±0.3℃
输出方式: IIC
管脚数量：3 Pin

查看资料

器件地址为0x38，但是最后一位是读写位，需要空出一位给读写位，因此需要左移一位，即0x38<<1得到0X70

采集步骤：(写=0，读=1)
起始信号->器件地址左移1位+写 -> 等待传感器应答 -> 发送触发测量命令（0XAC）-> 等待传感器应答 -> 发送数据位0X33 -> 等待传感器应答 -> 发送数据位0x00 -> 等待传感器应答 -> 停止信号（可不加）-> 起始信号 ->器件地址左移1位+读 -> 等待传感器应答 -> 读取8位数据（状态字）-> 主机发送应答 -> 读取湿度高位数据 -> 主机发送应答 -> 读取湿度低位数据 -> 主机发送应答-> 读取湿度最后4位数据和温度最高的4位数据 -> -> 主机发送应答 -> 读取温度8数据 -> 主机发送应答-> 读取温度8位数据 -> 主机发送应答 -> 停止信号。

8位状态字，各个位表示的意义。

示例：
状态位 = 0x1C
0X1C = 0001 1100
bit7 = 设备空闲
bit6~5= NOR mode
bit4 = 保留
BIT3 = 1已校准
bit0~2= 保留

湿度换算公式：其中SRH等于读取到的20位湿度数据整合后的数据。
RH(%)=（SRH/2的20次方）* 100
温度换算公式：其中ST等于读取到的20位温度数据整合后的数据。

T (℃) = （ S T / 2 的 20 次 方 ） * 200 - 50

移植过程

引脚选择

移植至工程

我们的目标是将例程移植至ESP32-S3开发板上。已经为大家提供了完整的驱动代码，按照以下步骤，即可完成移植。
具体新建文件夹和新建c和h文件在【DHT11温湿度传感器】章节中的1.4.2小节中有详细的教学，这里就不再多说了。
只不过这里我们将文件名 bsp_dht11.c 和 bsp_dht11.h 换成 bsp_aht10.c 和 bsp_aht10.h，文件夹名字改为AHT10。

代码写入

在文件bsp_sht10.c中，编写如下代码。

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：club.szlcsc.com
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2024-01-02     LCKFB-lp    first version
 */

#include "bsp_aht10.h"
#include "stdio.h"

float Temperature = 0;
float Humidity = 0;

void delay_ms(unsigned int ms)
{
    vTaskDelay(ms / portTICK_PERIOD_MS);
}
void delay_us(unsigned int us)
{
    ets_delay_us(us);
}
/******************************************************************
 * 函 数 名 称：AHT10_GPIO_Init
 * 函 数 说 明：AHT10的引脚初始化
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void AHT10_GPIO_Init(void)
{
    gpio_config_t lll_config = {
        .pin_bit_mask = (1ULL<<AHT10_SCL_PIN)|(1ULL<<AHT10_SDA_PIN), //配置引脚
        .mode =GPIO_MODE_OUTPUT,                   //输出模式
        .pull_up_en = GPIO_PULLUP_ENABLE,         //使能上拉
        .pull_down_en = GPIO_PULLDOWN_DISABLE,    //不使能下拉
        .intr_type = GPIO_INTR_DISABLE            //不使能引脚中断
    };
    gpio_config(&lll_config);
}

/******************************************************************
 * 函 数 名 称：IIC_Start
 * 函 数 说 明：IIC起始时序
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void IIC_Start(void)
{
        SDA_OUT();

        SDA(1);
        delay_us(5);
        SCL(1);
        delay_us(5);

        SDA(0);
        delay_us(5);
        SCL(0);
        delay_us(5);

}
/******************************************************************
 * 函 数 名 称：IIC_Stop
 * 函 数 说 明：IIC停止信号
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void IIC_Stop(void)
{
        SDA_OUT();
        SCL(0);
        SDA(0);

        SCL(1);
        delay_us(5);
        SDA(1);
        delay_us(5);

}

/******************************************************************
 * 函 数 名 称：IIC_Send_Ack
 * 函 数 说 明：主机发送应答或者非应答信号
 * 函 数 形 参：0发送应答  1发送非应答
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void IIC_Send_Ack(unsigned char ack)
{
        SDA_OUT();
        SCL(0);
        SDA(0);
        delay_us(5);
        if(!ack) SDA(0);
        else         SDA(1);
        SCL(1);
        delay_us(5);
        SCL(0);
        SDA(1);
}

/******************************************************************
 * 函 数 名 称：I2C_WaitAck
 * 函 数 说 明：等待从机应答
 * 函 数 形 参：无
 * 函 数 返 回：0有应答  1超时无应答
 * 作       者：LC
 * 备       注：无
******************************************************************/
unsigned char I2C_WaitAck(void)
{

        char ack = 0;
        unsigned char ack_flag = 10;
        SCL(0);
        SDA(1);
        SDA_IN();
        delay_us(5);
        SCL(1);
    delay_us(5);

        while( (SDA_GET()==1) && ( ack_flag ) )
        {
                ack_flag--;
                delay_us(5);
        }

        if( ack_flag <= 0 )
        {
                IIC_Stop();
                return 1;
        }
        else
        {
                SCL(0);
                SDA_OUT();
        }
        return ack;
}

/******************************************************************
 * 函 数 名 称：Send_Byte
 * 函 数 说 明：写入一个字节
 * 函 数 形 参：dat要写人的数据
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void Send_Byte(uint8_t dat)
{
        int i = 0;
        SDA_OUT();
        SCL(0);//拉低时钟开始数据传输

        for( i = 0; i < 8; i++ )
        {
                SDA( (dat & 0x80) >> 7 );
                delay_us(1);
                SCL(1);
                delay_us(5);
                SCL(0);
                delay_us(5);
                dat<<=1;
        }
}

/******************************************************************
 * 函 数 名 称：Read_Byte
 * 函 数 说 明：IIC读时序
 * 函 数 形 参：无
 * 函 数 返 回：读到的数据
 * 作       者：LC
 * 备       注：无
******************************************************************/
unsigned char Read_Byte(void)
{
        unsigned char i,receive=0;
        SDA_IN();//SDA设置为输入
    for(i=0;i<8;i++ )
        {
        SCL(0);
        delay_us(5);
        SCL(1);
        delay_us(5);
        receive<<=1;
        if( SDA_GET() )
        {
            receive|=1;
        }
        delay_us(5);
    }
        SCL(0);
  return receive;
}

/**********************************************************
 * 函 数 名 称：AHT10_Read
 * 函 数 功 能：读取AHT10的温湿度数据
 * 传 入 参 数：无
 * 函 数 返 回：0读取成功
 * 作       者：LC
 * 备       注：无
**********************************************************/
unsigned char AHT10_Read(void)
{
        char timeout = 0;
        unsigned char buff[6] = {0};
        unsigned int dat = 0;

        IIC_Start();//起始信号
        Send_Byte(0X38<<1 | 0);//器件地址+写命令
        I2C_WaitAck();                //等待传感器应答
        Send_Byte(0XAC);//寄存器地址：触发测量命令
        I2C_WaitAck();//等待传感器应答

        Send_Byte(0X33);//发送数据位
        I2C_WaitAck();//等待传感器应答

        Send_Byte(0X00);//发送数据位
        I2C_WaitAck();//等待传感器应答

        IIC_Stop();        //停止信号

        do{
                delay_ms(1);//超时判断，等待传感器采集数据
                timeout++;
                IIC_Start();//重新发送起始信号
                Send_Byte(0X38<<1  | 1);//器件地址+写命令
        }while( I2C_WaitAck() == 1 && timeout < 5 );

        buff[0] = Read_Byte();//读取状态字
        IIC_Send_Ack(0);//主机发送应答

        buff[1] = Read_Byte();//湿度高8位数据
        IIC_Send_Ack(0);//主机发送应答

        buff[2] = Read_Byte();//湿度低8位数据
        IIC_Send_Ack(0);//主机发送应答

        buff[3] = Read_Byte();
        IIC_Send_Ack(0);//主机发送应答

        buff[4] = Read_Byte();
        IIC_Send_Ack(0);//主机发送应答

        buff[5] = Read_Byte();
        IIC_Send_Ack(1);//主机发送应答

        IIC_Stop();//停止信号

        //高位在前
        dat = (((buff[1]<<12) | (buff[2]<<4)) | (buff[3]>>4));
        Humidity = dat / 1048576.0 * 100.0;

        dat = 0;
        dat = ((buff[3] &0x0F) << 16 ) | ( buff[4] << 8) | buff[5];
        Temperature = (dat/1048576.0) * 200 - 50;

        return 0;
}

/**********************************************************
 * 函 数 名 称：Get_Temperature
 * 函 数 功 能：获取采集后的温度数据
 * 传 入 参 数：无
 * 函 数 返 回：温度数据，单位℃
 * 作       者：LC
 * 备       注：必须先采集与数据，否则返回0或者之前的数据
**********************************************************/
float Get_Temperature(void)
{
        return Temperature;
}

/**********************************************************
 * 函 数 名 称：Get_Humidity
 * 函 数 功 能：获取采集后的湿度数据
 * 传 入 参 数：无
 * 函 数 返 回：湿度数据，单位%RH
 * 作       者：LC
 * 备       注：必须先采集与数据，否则返回0或者之前的数据
**********************************************************/
float Get_Humidity(void)
{
        return Humidity;
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297

在文件bsp_sht10.h中，编写如下代码。

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：club.szlcsc.com
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2024-01-02     LCKFB-lp    first version
 */

#ifndef _BSP_AHT10_H_
#define _BSP_AHT10_H_

#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_log.h"
#include "freertos/queue.h"
#include <inttypes.h>
#include "sdkconfig.h"
#include "driver/gpio.h"
#include "esp_log.h"
#include "rom/ets_sys.h"
#include "esp_system.h"
#include "driver/gpio.h"

//端口移植
#define AHT10_SCL_PIN   1
#define AHT10_SDA_PIN   2

//设置SDA输出模式
#define SDA_OUT()        gpio_set_direction(AHT10_SDA_PIN,GPIO_MODE_OUTPUT)
//设置SDA输入模式
#define SDA_IN()         gpio_set_direction(AHT10_SDA_PIN,GPIO_MODE_INPUT)
//获取SDA引脚的电平变化
#define SDA_GET()        gpio_get_level(AHT10_SDA_PIN)
//SDA与SCL输出
#define SDA(x)           gpio_set_level(AHT10_SDA_PIN, (x?1:0))
#define SCL(x)           gpio_set_level(AHT10_SCL_PIN, (x?1:0))

void delay_us(unsigned int us);
void delay_ms(unsigned int ms);
void AHT10_GPIO_Init(void);
unsigned char AHT10_Read(void);
float Get_Temperature(void);
float Get_Humidity(void);

#endif

移植验证

在自己工程中的main主函数中，编写如下。

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：club.szlcsc.com
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2024-01-02     LCKFB-lp    first version
 */
#include <stdio.h>
#include "bsp_aht10.h"

void app_main(void)
{

    AHT10_GPIO_Init();//AHT10引脚初始化
    printf("start\r\n");
    while(1)
    {
        //采集温湿度
        AHT10_Read();

        //串口打印温度数据
        printf("temp = %.2f\r\n", Get_Temperature() );
        //串口打印湿度数据
        printf("humi = %.2f\r\n", Get_Humidity() );
        delay_ms(1000);

    }

}

上电效果：

驱动代码：

文件下载

📌 资料下载中心（点击跳转）

📌 在 资料下载中心->模块移植资料下载 里面的该章节压缩包中。

ESP-IDF 入门手册

Arduino 入门手册

MicroPython 入门手册

模块移植手册【基于IDF】

显示类

传感器类

无线通信类

控制类

项目案例

训练营活动

AHT10温湿度传感器

模块来源

规格参数

查看资料

移植过程

引脚选择

移植至工程

代码写入

移植验证

AHT10温湿度传感器 ​

模块来源 ​

规格参数 ​

查看资料 ​

移植过程 ​

引脚选择 ​

移植至工程 ​

代码写入 ​

移植验证 ​

AHT10温湿度传感器

模块来源

规格参数

查看资料

移植过程

引脚选择

移植至工程

代码写入

移植验证