STM32+Arduino环境搭建后，你的第一个项目可以不是点灯：用官方核心库驱动OLED和读取传感器

STM32+Arduino环境搭建后，你的第一个项目可以不是点灯：用官方核心库驱动OLED和读取传感器

当你终于完成了STM32在Arduino环境下的搭建，看着IDE界面和开发板，是不是有种"然后呢？"的迷茫？别急着从点灯开始，让我们直接进入两个更酷的项目：驱动OLED显示和读取环境传感器数据。这不仅能让你的开发板真正"活"起来，还能立即获得可视化的反馈和成就感。

1. 准备工作：硬件连接与库安装

在开始编码前，我们需要确保硬件正确连接并安装必要的库。假设你手头有一块STM32F103C8T6开发板（Blue Pill）、SSD1306 OLED屏幕（I2C接口）和DHT11温湿度传感器。

硬件连接示意图：

注意：不同型号的STM32开发板I2C引脚可能不同，请查阅你的开发板原理图确认SCL/SDA引脚。

库安装步骤：

1. 打开Arduino IDE，点击"工具"->"管理库..."
2. 搜索并安装以下库：
   • U8g2：用于驱动OLED显示
   • DHT sensor library：用于读取DHT11数据
   • Adafruit Unified Sensor：DHT库的依赖项

安装完成后，你可以在"文件"->"示例"中看到这些库的示例代码，但我们接下来会从头开始编写。

2. 项目一：让OLED说"Hello STM32"

OLED屏幕是嵌入式开发中最实用的外设之一，它能提供直观的视觉反馈。我们将使用U8g2库来驱动SSD1306 OLED。

2.1 初始化U8g2库

U8g2库支持多种显示控制器和通信方式，我们需要选择适合我们硬件的构造函数：

#include <U8g2lib.h> #include <Wire.h> // 使用硬件I2C的构造函数 U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset=*/ U8X8_PIN_NONE);

这段代码初始化了一个128x64像素的SSD1306 OLED显示器，使用硬件I2C通信。U8X8_PIN_NONE表示我们没有连接复位引脚。

2.2 编写第一个显示程序

在setup()函数中初始化显示，然后在loop()中显示文本：

void setup() { u8g2.begin(); // 初始化显示 } void loop() { u8g2.clearBuffer(); // 清除内部内存 u8g2.setFont(u8g2_font_ncenB14_tr); // 选择字体 u8g2.drawStr(0, 20, "Hello"); // 在坐标(0,20)处写"Hello" u8g2.drawStr(0, 40, "STM32!"); // 在坐标(0,40)处写"STM32!" u8g2.sendBuffer(); // 将内存内容发送到显示器 delay(1000); }

上传代码后，你应该能看到OLED上显示了两行文字。如果屏幕没有反应，检查：

• I2C引脚连接是否正确
• 是否选择了正确的U8g2构造函数
• 屏幕是否需要上拉电阻（有些模块已经内置）

2.3 进阶显示技巧

U8g2库功能强大，除了显示文字，还能绘制图形。试试这段代码：

void loop() { u8g2.clearBuffer(); // 绘制边框 u8g2.drawFrame(0, 0, 128, 64); // 显示不同大小的文字 u8g2.setFont(u8g2_font_6x10_tr); u8g2.drawStr(5, 15, "STM32 + Arduino"); u8g2.setFont(u8g2_font_10x20_tr); u8g2.drawStr(10, 40, "OLED Demo"); // 绘制进度条 static uint8_t width = 0; u8g2.drawBox(10, 50, width, 5); width = (width + 1) % 100; u8g2.sendBuffer(); delay(50); }

这段代码展示了如何绘制边框、使用不同字体以及创建简单的动画效果。U8g2库还支持位图显示、各种几何图形绘制等功能，值得深入探索。

3. 项目二：读取环境传感器数据

现在让我们为系统添加环境感知能力。DHT11虽然精度不高，但价格低廉且易于使用，非常适合入门。

3.1 初始化DHT传感器

首先包含必要的库并初始化传感器对象：

#include <DHT.h> #define DHTPIN PA1 // 传感器连接的引脚 #define DHTTYPE DHT11 // DHT 11 DHT dht(DHTPIN, DHTTYPE);

在setup()函数中启动传感器：

void setup() { Serial.begin(115200); dht.begin(); }

3.2 读取并显示传感器数据

DHT11的典型读取间隔为2秒，太快会导致读取失败。我们可以在OLED上同时显示温度和湿度：

void loop() { delay(2000); // DHT11需要至少2秒间隔 float h = dht.readHumidity(); // 读取湿度(%) float t = dht.readTemperature(); // 读取温度(°C) if (isnan(h) || isnan(t)) { Serial.println("读取DHT11失败!"); return; } // 在串口监视器输出 Serial.print("湿度: "); Serial.print(h); Serial.print("% 温度: "); Serial.print(t); Serial.println("°C"); // 在OLED上显示 u8g2.clearBuffer(); u8g2.setFont(u8g2_font_6x10_tr); u8g2.drawStr(0, 15, "环境监测"); u8g2.setFont(u8g2_font_10x20_tr); char buffer[20]; sprintf(buffer, "%.1f C", t); u8g2.drawStr(10, 40, buffer); sprintf(buffer, "%.1f %%", h); u8g2.drawStr(10, 65, buffer); u8g2.sendBuffer(); }

3.3 提高读取稳定性

DHT11对时序要求严格，在STM32上可能需要微调。如果遇到频繁读取失败，可以尝试：

1. 在传感器VCC和GND之间添加一个100nF的电容
2. 使用更短的数据线
3. 在代码中添加重试逻辑：

float readDHTTemperature() { float t = dht.readTemperature(); for (int i = 0; i < 3 && isnan(t); i++) { delay(100); t = dht.readTemperature(); } return t; }

4. 项目整合：创建环境监测仪表

现在我们将两个项目结合起来，创建一个完整的环境监测系统，定期更新显示并保留最高/最低记录。

4.1 系统设计

我们需要跟踪以下数据：

• 当前温度和湿度
• 历史最高和最低温度
• 显示更新时间

代码结构如下：

#include <U8g2lib.h> #include <Wire.h> #include <DHT.h> // OLED和DHT初始化代码... float maxTemp = -100, minTemp = 100; unsigned long lastUpdate = 0; void setup() { // 初始化代码... } void loop() { // 每5秒更新一次 if (millis() - lastUpdate >= 5000) { lastUpdate = millis(); float t = readDHTTemperature(); float h = readDHTHumidity(); if (!isnan(t) && !isnan(h)) { maxTemp = max(maxTemp, t); minTemp = min(minTemp, t); updateDisplay(t, h); } } } void updateDisplay(float temp, float humidity) { u8g2.clearBuffer(); // 绘制界面框架 u8g2.drawFrame(0, 0, 128, 64); u8g2.drawHLine(0, 16, 128); // 显示标题 u8g2.setFont(u8g2_font_6x10_tr); u8g2.drawStr(5, 13, "环境监测系统"); // 显示当前数据 u8g2.setFont(u8g2_font_10x20_tr); char buffer[20]; sprintf(buffer, "%.1f C", temp); u8g2.drawStr(10, 35, buffer); sprintf(buffer, "%.1f %%", humidity); u8g2.drawStr(70, 35, buffer); // 显示极值 u8g2.setFont(u8g2_font_6x10_tr); sprintf(buffer, "高:%.1f 低:%.1f", maxTemp, minTemp); u8g2.drawStr(10, 50, buffer); // 显示更新时间 sprintf(buffer, "更新:%02d:%02d", (millis()/60000)%60, (millis()/1000)%60); u8g2.drawStr(10, 63, buffer); u8g2.sendBuffer(); }

4.2 添加按钮控制

为了增加交互性，我们可以添加一个按钮来切换显示模式。连接一个按钮到PA0引脚（带10K上拉电阻）：

#define BUTTON_PIN PA0 enum DisplayMode {CURRENT, MAX_MIN, GRAPH}; DisplayMode mode = CURRENT; void checkButton() { static unsigned long lastPress = 0; if (digitalRead(BUTTON_PIN) == LOW && millis() - lastPress > 200) { lastPress = millis(); mode = (DisplayMode)((mode + 1) % 3); } } void loop() { checkButton(); // 其余代码... }

然后根据模式修改updateDisplay()函数，添加不同的显示布局。

5. 深入理解：STM32在Arduino环境下的特殊考量

虽然我们使用了Arduino环境，但STM32与传统的AVR Arduino仍有一些差异需要注意。

5.1 GPIO速度配置

STM32的GPIO可以配置不同的速度，这在Arduino环境中通常被忽略：

void setup() { // 配置传感器引脚为高速输入 pinMode(DHTPIN, INPUT); GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = digitalPinToPinName(DHTPIN); GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(digitalPinToPort(DHTPIN), &GPIO_InitStruct); }

5.2 I2C引脚重映射

某些STM32型号支持I2C引脚重映射，如果默认I2C引脚被占用，可以这样重映射：

void remapI2CPins() { __HAL_AFIO_REMAP_I2C1_ENABLE(); // 启用I2C1引脚重映射 // 现在I2C1的SCL是PB8，SDA是PB9 }

5.3 低功耗考虑

STM32的低功耗特性是AVR Arduino不具备的。即使在这个简单项目中，我们也可以加入简单的休眠：

#include <STM32LowPower.h> void setup() { LowPower.begin(); } void loop() { // 读取传感器并更新显示... LowPower.deepSleep(5000); // 休眠5秒 }

6. 项目扩展思路

这个基础项目可以扩展出许多有趣的方向：

1. 数据记录：添加SD卡模块，定期记录环境数据
2. 无线传输：通过ESP8266或HC-05将数据发送到手机或服务器
3. 警报系统：当温度超过阈值时触发蜂鸣器或继电器
4. 电池供电：设计低功耗版本，使用18650电池长时间工作
5. 外壳设计：3D打印一个专业的外壳，做成完整的产品

每个扩展都可以作为一个独立的学习项目，逐步提升你的STM32开发能力。