【花雕学编程】Arduino动手做（256）---AHT20 OLED显示温湿度

  【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验二百五十六：AHT20 温湿度传感器模块 高精度湿度探头 DHT11升级款I2C
  项目之四：在 OLED 屏幕 (SSD1306) 以及串口监视器进行显示温湿度

实验模块接线示意图

  【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验二百五十六：AHT20 温湿度传感器模块 高精度湿度探头 DHT11升级款I2C
  项目之四：在 OLED 屏幕 (SSD1306) 以及串口监视器进行显示温湿度

实验开源代码

/*
  【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验二百五十六：AHT20 温湿度传感器模块 高精度湿度探头 DHT11升级款I2C
  项目之四：在 OLED 屏幕 (SSD1306) 以及串口监视器进行显示温湿度
*/

// 引入 SSD1306 OLED 显示库
#include "ssd1306.h"
// 引入 Adafruit AHTX0 传感器库
#include <Adafruit_AHTX0.h>

// 创建 AHT10/AHT20 传感器对象
Adafruit_AHTX0 aht;

void setup() {
  Serial.begin(9600); // 初始化串口通信
  Serial.println("AHT20 test");

  // 检测 AHT20 传感器是否正确连接
  if (!aht.begin()) {
    Serial.println("Could not find AHT? Check wiring"); // 显示错误信息
    while (1) delay(10); // 停止执行，防止错误数据读取
  }
  Serial.println("AHT10 or AHT20 found");

  // 初始化 OLED 显示屏
  ssd1306_setFixedFont(ssd1306xled_font6x8); // 设置固定字体
  ssd1306_128x64_i2c_init(); // 初始化 SSD1306 (128x64 I2C)
  ssd1306_clearScreen(); // 清空屏幕

  // 在 OLED 屏幕上显示初始化信息
  ssd1306_printFixed(0, 8, "arduino-er exercise", STYLE_NORMAL);
  ssd1306_printFixed(0, 16, "XIAO/ssd1306", STYLE_BOLD);
  ssd1306_printFixed(0, 24, "AHT20 test", STYLE_ITALIC);
  ssd1306_positiveMode(); // 设置 OLED 正显模式

  delay(2000); // 延迟 2 秒，确保 OLED 初始化完成
  ssd1306_clearScreen(); // 清空屏幕，准备显示实时数据
}

void loop() {
  // 创建温湿度数据对象
  sensors_event_t humidity, temp;
  aht.getEvent(&humidity, &temp); // 读取最新温湿度数据

  // 在串口监视器输出温度数据
  Serial.print("Temperature: ");
  Serial.print(temp.temperature);
  Serial.println(" degrees C");

  // 在 OLED 屏幕上显示标题
  ssd1306_printFixed(0, 10, "- AHT20 -", STYLE_BOLD);

  // 格式化温度数据并显示在 OLED 上
  char charTemp[32]; // 存储格式化后的温度字符串
  dtostrf(temp.temperature, 8, 2, charTemp); // 将浮点数转换为字符串
  ssd1306_printFixed(0, 28, "Temperature (C):", STYLE_NORMAL);
  ssd1306_printFixed(80, 36, charTemp, STYLE_NORMAL); // 显示温度数值

  // 在串口监视器输出湿度数据
  Serial.print("Humidity: ");
  Serial.print(humidity.relative_humidity);
  Serial.println("% rH");

  // 格式化湿度数据并显示在 OLED 上
  char charHumi[32]; // 存储格式化后的湿度字符串
  dtostrf(humidity.relative_humidity, 8, 2, charHumi); // 将浮点数转换为字符串
  ssd1306_printFixed(0, 44, "Humidity (% rH):", STYLE_NORMAL);
  ssd1306_printFixed(80, 52, charHumi, STYLE_NORMAL); // 显示湿度数值

  delay(500); // 每 500 毫秒更新一次数据
}
复制代码

代码简单解读

使用 AHT20 传感器 采集 温湿度数据，并在 OLED 屏幕 (SSD1306) 以及 串口监视器 进行显示。以下是核心逻辑：

1、初始化传感器和 OLED

aht.begin(); 连接 AHT10/AHT20 传感器，确保数据采集正常。

ssd1306_128x64_i2c_init(); 初始化 SSD1306 OLED (128x64 I2C)。

2、读取温湿度数据

aht.getEvent(&humidity, &temp); 获取 最新的温度 (°C) 和 湿度 (%RH)。

3、串口输出

Serial.print(temp.temperature); 显示 温度。

Serial.print(humidity.relative_humidity); 显示 湿度。

4、OLED 显示

ssd1306_printFixed(0, 28, "Temperature (C):", STYLE_NORMAL);

ssd1306_printFixed(0, 44, "Humidity (% rH):", STYLE_NORMAL);

dtostrf() 将浮点数据转换为 字符串，确保显示正确。

5、数据更新

delay(500); 控制 更新频率，避免数据刷新过快。

这样，你可以通过 OLED 屏幕 以及 串口监视器 观察环境温湿度变化，适用于 环境监测、智能家居、气象站 等项目。

实验串口返回情况

实验场景图