单片机与物联网 / 系统课时
实现本地交互
实现本地交互
这一课完成一个可直接落地的本地交互闭环:OLED 显示当前数据,按键切换“数据页”和“配置页”,在配置页修改告警温度,并用 ESP32 的 Preferences 保存配置,让设备重启后仍能恢复用户设置。
学习目标
- 使用 OLED 显示环境数据和当前配置
- 通过按键边沿检测完成页面切换与参数修改
- 使用
Preferences持久化用户配置并验证重启恢复
设计页面与按键状态
本例使用 128×64 SSD1306 OLED,两枚按键分别接 GPIO 32 和 GPIO 33,并使用 INPUT_PULLUP,因此按下时读取为低电平。页面只保留两个状态:DATA 显示温湿度与光照,CONFIG 显示并修改温度告警阈值。

将 OLED 的 I2C 地址按常见模块设置为 0x3C。如果你的模块地址不同,可先用 I2C 扫描程序确认后再修改。示例中的温湿度和光照使用演示变量,接入真实传感器采集代码时只需把它们替换为最新数据快照。
实现显示、按键和配置持久化
Arduino IDE 需要安装 Adafruit GFX Library 和 Adafruit SSD1306。Preferences 属于 ESP32 Arduino Core,无需额外安装。代码把按键处理、页面渲染和配置保存分开,避免一次按键同时触发多次逻辑。
#include <Arduino.h>
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#include <Preferences.h>
constexpr uint8_t BTN_PAGE = 32;
constexpr uint8_t BTN_EDIT = 33;
constexpr uint8_t OLED_ADDR = 0x3C;
constexpr int SCREEN_WIDTH = 128;
constexpr int SCREEN_HEIGHT = 64;
constexpr uint32_t DEBOUNCE_MS = 50;
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1);
Preferences preferences;
enum class Page { DATA, CONFIG };
Page page = Page::DATA;
float temperature = 25.4f;
float humidity = 58.0f;
float lux = 320.0f;
float tempAlarm = 30.0f;
bool lastPageLevel = HIGH;
bool lastEditLevel = HIGH;
uint32_t lastButtonAt = 0;
bool pressed(uint8_t pin, bool& lastLevel) {
bool level = digitalRead(pin);
// INPUT_PULLUP 下按键按下产生 HIGH -> LOW 的下降沿。
bool fallingEdge = (lastLevel == HIGH && level == LOW);
lastLevel = level;
if (fallingEdge && millis() - lastButtonAt >= DEBOUNCE_MS) {
lastButtonAt = millis();
return true;
}
return false;
}
void drawDataPage() {
display.setCursor(0, 0);
display.println("DATA");
display.printf("T: %.1f C\n", temperature);
display.printf("H: %.1f %%\n", humidity);
display.printf("L: %.0f lx\n", lux);
}
void drawConfigPage() {
display.setCursor(0, 0);
display.println("CONFIG");
display.println("Temp alarm:");
display.printf("%.0f C\n", tempAlarm);
display.println("B: +1 C");
}
void render() {
display.clearDisplay();
display.setTextSize(1);
display.setTextColor(SSD1306_WHITE);
if (page == Page::DATA) {
drawDataPage();
} else {
drawConfigPage();
}
display.display();
}
void handleButtons() {
if (pressed(BTN_PAGE, lastPageLevel)) {
page = (page == Page::DATA) ? Page::CONFIG : Page::DATA;
Serial.printf("page=%s\n", page == Page::DATA ? "DATA" : "CONFIG");
render();
}
if (pressed(BTN_EDIT, lastEditLevel) && page == Page::CONFIG) {
tempAlarm += 1.0f;
if (tempAlarm > 40.0f) tempAlarm = 20.0f;
// 用户完成一次修改后写入 NVS;高频连续调整时应改为延迟批量保存。
preferences.putFloat("tempAlarm", tempAlarm);
Serial.printf("tempAlarm=%.0f saved\n", tempAlarm);
render();
}
}
void setup() {
Serial.begin(115200);
// 内部上拉让两枚按键只需在按下时接地。
pinMode(BTN_PAGE, INPUT_PULLUP);
pinMode(BTN_EDIT, INPUT_PULLUP);
Wire.begin();
if (!display.begin(SSD1306_SWITCHCAPVCC, OLED_ADDR)) {
Serial.println("OLED init failed");
while (true) delay(1000);
}
preferences.begin("device", false);
tempAlarm = preferences.getFloat("tempAlarm", 30.0f);
Serial.printf("loaded tempAlarm=%.0f\n", tempAlarm);
render();
}
void loop() {
handleButtons();
delay(5);
}预期输出
loaded tempAlarm=<VALUE>
page=CONFIG
tempAlarm=<VALUE> saved
page=DATA<VALUE> 取决于上次保存的阈值。首次运行没有历史配置时默认是 30;在配置页按下编辑键后数值增加 1,并立即重绘 OLED。
验证页面切换与重启恢复
上电后应先看到数据页。按页面键一次进入配置页,再按编辑键修改阈值;串口应同步打印保存结果。随后让 ESP32 复位,若启动日志里的 loaded tempAlarm 与修改后的值一致,说明 NVS 持久化成功。
如果按一次键却切换两次页面,优先检查机械抖动和按键接线。示例已经做了 50 ms 的边沿消抖,但非常长的导线或噪声环境仍可能需要硬件上拉、电容或更严格的软件状态机。
把交互循环保持非阻塞
本地交互的刷新频率通常高于传感器采样频率,因此不要在按键处理里执行长时间读取、联网或 delay(1000)。页面只读取“最新数据快照”,采集、联网和显示各自按自己的节奏运行,设备才能保持按键响应及时。
Preferences.putFloat() 会写入 Flash,不适合在旋钮高速变化或每次循环中调用。若后续增加长按连调,可在最后一次修改后的几百毫秒再统一保存。这样既保留用户体验,也能减少不必要的 Flash 擦写。