Arduino项目实战：用SSD1306 OLED屏和Adafruit库打造一个简易环境监测显示器

张

张建站

2026/5/13 20:46:06

10分钟阅读

Arduino项目实战用SSD1306 OLED屏和Adafruit库打造一个简易环境监测显示器在创客和物联网开发领域实时监测环境数据是一个常见需求。想象一下当你需要随时了解房间的温湿度状况或者监控植物生长环境的微小变化时一个简洁直观的显示设备就显得尤为重要。本文将带你从零开始使用Arduino、SSD1306 OLED屏幕和Adafruit库构建一个功能完善的环境监测显示器。这个项目不仅适合初学者入门也能满足进阶开发者对数据可视化的需求。我们将从硬件连接开始逐步实现传感器数据采集、OLED屏幕显示优化最终完成一个可以直接应用于实际场景的监测系统。1. 硬件准备与连接在开始编码之前我们需要准备好所有必要的硬件组件。以下是项目所需的核心部件清单Arduino开发板UNO或Nano均可SSD1306 OLED显示屏128×64像素I2C接口DHT11或DHT22温湿度传感器面包板和连接线若干10kΩ电阻用于DHT传感器I2C连接示意图OLED引脚Arduino引脚VCC3.3VGNDGNDSCLA5 (SCL)SDAA4 (SDA)DHT传感器的连接同样简单VCC接5VGND接GNDDATA接数字引脚2需接10kΩ上拉电阻注意虽然OLED屏幕支持3.3V和5V供电但实际使用中发现3.3V供电更为稳定能避免屏幕闪烁问题。2. 库安装与环境配置要实现这个项目我们需要安装几个关键的Arduino库Adafruit_SSD1306OLED屏幕驱动库Adafruit_GFX图形显示基础库DHT sensor library温湿度传感器库安装方法很简单打开Arduino IDE点击工具→管理库搜索上述库名并安装最新版本安装完成后我们需要对SSD1306进行基本配置。创建一个新的Arduino项目添加以下头文件#include Wire.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h #include DHT.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 #define DHTPIN 2 #define DHTTYPE DHT22 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, OLED_RESET); DHT dht(DHTPIN, DHTTYPE);在setup()函数中初始化这些设备void setup() { Serial.begin(9600); if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F(SSD1306分配失败)); for(;;); } dht.begin(); display.display(); delay(2000); display.clearDisplay(); }3. 数据采集与显示实现环境监测的核心是准确获取传感器数据并以直观方式呈现。我们先实现基本的温湿度读取功能。3.1 读取传感器数据DHT传感器虽然使用简单但在读取时需要注意几点两次读取之间需要至少2秒间隔需要检查返回值是否有效湿度值可能偶尔出现异常波动以下是优化的数据读取函数float readTemperature() { float t dht.readTemperature(); if (isnan(t)) { Serial.println(读取温度失败); return -999; } return t; } float readHumidity() { float h dht.readHumidity(); if (isnan(h)) { Serial.println(读取湿度失败); return -999; } return h; }3.2 基础数据显示有了数据后我们可以在OLED上创建简洁的显示界面。先实现一个基础版本void displayBasicData(float temp, float humi) { display.clearDisplay(); display.setTextSize(1); display.setTextColor(WHITE); // 显示标题 display.setCursor(0,0); display.println(环境监测系统); // 绘制分隔线 display.drawFastHLine(0, 10, display.width(), WHITE); // 显示温度 display.setCursor(0,15); display.print(温度: ); display.print(temp); display.println( °C); // 显示湿度 display.setCursor(0,30); display.print(湿度: ); display.print(humi); display.println( %); display.display(); }在loop()函数中整合这些功能void loop() { float t readTemperature(); float h readHumidity(); if(t ! -999 h ! -999) { displayBasicData(t, h); } delay(2000); // 每2秒更新一次 }4. 界面优化与高级功能基础显示已经可用但我们可以做得更好。下面介绍几种提升用户体验的优化方法。4.1 自定义字体与图标Adafruit_GFX库支持自定义字体虽然默认只有一种内置字体但我们可以通过图形方式添加简单图标。例如为温度和湿度添加图标标识void drawTempIcon(int x, int y) { // 绘制温度计图标 display.fillRoundRect(x, y, 10, 16, 2, WHITE); display.fillRect(x3, y16, 4, 8, WHITE); display.drawPixel(x5, y6, BLACK); } void drawHumiIcon(int x, int y) { // 绘制水滴图标 display.fillCircle(x3, y3, 3, WHITE); display.drawFastVLine(x3, y3, 10, WHITE); display.drawPixel(x2, y13, WHITE); display.drawPixel(x4, y13, WHITE); }修改显示函数使用这些图标void displayEnhancedData(float temp, float humi) { display.clearDisplay(); // 显示标题 display.setTextSize(1); display.setCursor(0,0); display.println(环境监测系统); display.drawFastHLine(0, 10, display.width(), WHITE); // 温度显示带图标 drawTempIcon(0, 15); display.setCursor(15, 20); display.print(temp, 1); display.println( C); // 湿度显示带图标 drawHumiIcon(0, 35); display.setCursor(15, 40); display.print(humi, 1); display.println( %); display.display(); }4.2 历史数据趋势图对于环境监测了解数据变化趋势比单纯看当前值更有意义。我们可以实现一个简单的趋势图显示#define HISTORY_SIZE 30 float tempHistory[HISTORY_SIZE] {0}; int historyIndex 0; void updateHistory(float temp) { tempHistory[historyIndex] temp; historyIndex (historyIndex 1) % HISTORY_SIZE; } void drawHistoryGraph() { // 确定温度范围 float minTemp 100, maxTemp -100; for(int i0; iHISTORY_SIZE; i) { if(tempHistory[i] minTemp) minTemp tempHistory[i]; if(tempHistory[i] maxTemp) maxTemp tempHistory[i]; } // 添加一些余量 float range maxTemp - minTemp; minTemp - range * 0.1; maxTemp range * 0.1; if(range 2) { // 确保有最小范围 minTemp - 1; maxTemp 1; } // 绘制坐标轴 display.drawFastVLine(10, 15, 30, WHITE); display.drawFastHLine(10, 45, 110, WHITE); // 绘制刻度 display.setTextSize(1); display.setCursor(0, 12); display.print(maxTemp, 0); display.setCursor(0, 42); display.print(minTemp, 0); // 绘制曲线 for(int i1; iHISTORY_SIZE; i) { if(tempHistory[i] 0 || tempHistory[i-1] 0) continue; int x1 10 (i-1)*4; int y1 45 - map(tempHistory[i-1]*10, minTemp*10, maxTemp*10, 0, 300); int x2 10 i*4; int y2 45 - map(tempHistory[i]*10, minTemp*10, maxTemp*10, 0, 300); display.drawLine(x1, y1, x2, y2, WHITE); } }然后在主显示函数中调用void displayEnhancedData(float temp, float humi) { // ...之前的代码... // 更新历史数据 updateHistory(temp); // 绘制趋势图 drawHistoryGraph(); display.display(); }4.3 多页面显示随着功能增加单个页面可能无法显示所有信息。我们可以实现简单的页面切换功能#define PAGE_BASIC 0 #define PAGE_GRAPH 1 #define PAGE_DETAIL 2 int currentPage PAGE_BASIC; unsigned long lastPageChange 0; void checkPageChange() { if(millis() - lastPageChange 5000) { // 每5秒自动切换 currentPage (currentPage 1) % 3; lastPageChange millis(); } } void displayData(float temp, float humi) { switch(currentPage) { case PAGE_BASIC: displayBasicData(temp, humi); break; case PAGE_GRAPH: displayGraphPage(temp, humi); break; case PAGE_DETAIL: displayDetailPage(temp, humi); break; } }在loop()中添加页面检查void loop() { float t readTemperature(); float h readHumidity(); if(t ! -999 h ! -999) { checkPageChange(); displayData(t, h); } delay(1000); }5. 项目优化与扩展完成基础功能后我们可以考虑以下几个优化方向5.1 低功耗优化对于电池供电的应用功耗是需要考虑的重要因素。SSD1306 OLED屏幕本身功耗较低但我们还可以进一步优化void enterLowPowerMode() { display.dim(true); // 调暗屏幕 // 或者完全关闭显示 // display.ssd1306_command(SSD1306_DISPLAYOFF); } void wakeUp() { display.dim(false); // display.ssd1306_command(SSD1306_DISPLAYON); }可以设置当监测到长时间无显著变化时进入低功耗模式bool checkStable(float temp, float humi) { static float lastTemp 0, lastHumi 0; bool stable (abs(temp - lastTemp) 0.5) (abs(humi - lastHumi) 1); lastTemp temp; lastHumi humi; return stable; } void loop() { float t readTemperature(); float h readHumidity(); if(t ! -999 h ! -999) { if(checkStable(t, h)) { enterLowPowerMode(); delay(10000); // 稳定时延长读取间隔 } else { wakeUp(); checkPageChange(); displayData(t, h); delay(1000); } } }5.2 添加更多传感器除了温湿度我们还可以轻松集成其他传感器大气压传感器如BMP180/BMP280空气质量传感器如MQ系列光照传感器如BH1750只需添加相应的库和读取代码然后在显示函数中增加新的信息区域即可。5.3 数据记录与导出对于长期监测数据记录功能很有必要。我们可以使用SD卡模块或通过串口输出到电脑void logData(float temp, float humi) { Serial.print(millis()); Serial.print(,); Serial.print(temp); Serial.print(,); Serial.println(humi); // 或者使用SD卡 /* File dataFile SD.open(datalog.txt, FILE_WRITE); if(dataFile) { dataFile.print(millis()); dataFile.print(,); dataFile.print(temp); dataFile.print(,); dataFile.println(humi); dataFile.close(); } */ }5.4 无线传输将Arduino连接到WiFi或蓝牙模块可以实现远程监测// 伪代码实际实现取决于使用的无线模块 void sendToServer(float temp, float humi) { WiFiClient client; if(client.connect(api.thingspeak.com, 80)) { String url /update?api_keyYOUR_KEY; url field1; url String(temp); url field2; url String(humi); client.print(String(GET ) url HTTP/1.1\r\n); client.print(Host: api.thingspeak.com\r\n); client.print(Connection: close\r\n\r\n); } }6. 完整项目代码以下是整合所有优化功能后的完整代码框架#include Wire.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h #include DHT.h // 配置参数 #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 #define DHTPIN 2 #define DHTTYPE DHT22 #define HISTORY_SIZE 30 // 页面定义 #define PAGE_BASIC 0 #define PAGE_GRAPH 1 #define PAGE_DETAIL 2 // 全局变量 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, OLED_RESET); DHT dht(DHTPIN, DHTTYPE); float tempHistory[HISTORY_SIZE] {0}; int historyIndex 0; int currentPage PAGE_BASIC; unsigned long lastPageChange 0; void setup() { Serial.begin(9600); if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F(SSD1306分配失败)); for(;;); } dht.begin(); display.display(); delay(2000); display.clearDisplay(); } void loop() { float t readTemperature(); float h readHumidity(); if(t ! -999 h ! -999) { updateHistory(t); checkPageChange(); displayData(t, h); logData(t, h); if(checkStable(t, h)) { enterLowPowerMode(); delay(10000); } else { wakeUp(); delay(1000); } } else { displayError(); delay(2000); } } // 其他功能函数实现... // (包含前面章节介绍的所有功能函数)7. 常见问题与调试技巧在实际项目中可能会遇到各种问题。以下是几个常见问题及其解决方法OLED屏幕不显示检查I2C地址是否正确通常是0x3C或0x3D确认接线无误特别是电源连接尝试降低I2C时钟速度Wire.setClock(100000)DHT传感器读数失败确保使用了正确的上拉电阻检查电源电压是否足够尝试增加读取间隔时间显示内容闪烁可能是电源问题尝试单独供电减少全屏刷新频率只更新变化部分内存不足优化变量使用减少全局变量使用F()宏存储字符串到Flashdisplay.print(F(温度: ))图形显示错位确认屏幕宽高设置正确检查所有坐标计算是否在有效范围内调试提示始终先通过串口监视器验证传感器数据正确性再处理显示问题。分阶段测试每个功能模块可以快速定位问题源头。在实际使用中我发现DHT22传感器虽然精度高于DHT11但对电路稳定性要求也更高。当遇到读数不稳定时添加一个0.1μF的电容在传感器电源引脚附近往往能显著改善数据稳定性。