单片机与物联网 / 系统课时

实现本地交互

实现本地交互

这一课完成一个可直接落地的本地交互闭环:OLED 显示当前数据,按键切换“数据页”和“配置页”,在配置页修改告警温度,并用 ESP32 的 Preferences 保存配置,让设备重启后仍能恢复用户设置。

学习目标

  • 使用 OLED 显示环境数据和当前配置
  • 通过按键边沿检测完成页面切换与参数修改
  • 使用 Preferences 持久化用户配置并验证重启恢复

设计页面与按键状态

本例使用 128×64 SSD1306 OLED,两枚按键分别接 GPIO 32 和 GPIO 33,并使用 INPUT_PULLUP,因此按下时读取为低电平。页面只保留两个状态:DATA 显示温湿度与光照,CONFIG 显示并修改温度告警阈值。

ESP32 本地交互页面与按键状态转换

将 OLED 的 I2C 地址按常见模块设置为 0x3C。如果你的模块地址不同,可先用 I2C 扫描程序确认后再修改。示例中的温湿度和光照使用演示变量,接入真实传感器采集代码时只需把它们替换为最新数据快照。

实现显示、按键和配置持久化

Arduino IDE 需要安装 Adafruit GFX Library 和 Adafruit SSD1306。Preferences 属于 ESP32 Arduino Core,无需额外安装。代码把按键处理、页面渲染和配置保存分开,避免一次按键同时触发多次逻辑。

cpp
#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);
}

预期输出

text
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 擦写。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现本地交互

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通