单片机与物联网 / 系统课时
实现显示与按键交互
实现显示与按键交互
本课把传感器数据、设备状态和可调参数组织成多个显示页面,并使用两个按键完成页面切换、进入编辑、修改数值和确认保存。实现重点不是绘制更多字符,而是建立清晰的界面状态、稳定的按键事件和按需刷新的显示流程。
学习目标
- 使用页面状态机组织实时数据、状态和设置页面
- 将原始 GPIO 电平转换为短按、长按等稳定事件
- 使用脏标志减少无意义刷新,并控制参数保存时机
交互需求与状态划分
示例界面包含数据页、状态页和设置页。NEXT 短按切换页面,在编辑状态下改为递增参数;OK 短按进入或退出编辑;OK 长按确认保存。相同按键在不同状态下具有不同含义,因此必须先判断页面和编辑状态,再处理事件。

按键事件与防抖规则
机械按键在接通和断开时会产生数毫秒抖动,直接读取 GPIO 会把一次按压识别成多次事件。示例在原始电平持续 20 ms 后才更新稳定状态,并从稳定按下到稳定释放之间计算按压时长。
| 事件 | 识别条件 | 界面动作 |
|---|---|---|
NEXT 短按 |
稳定按下后在 800 ms 内释放 | 切页或参数加一 |
OK 短按 |
稳定按下后在 800 ms 内释放 | 进入或退出编辑 |
OK 长按 |
稳定按下达到 800 ms | 保存参数并退出编辑 |
长按事件应在达到阈值时只上报一次,释放时不能再补报短按。若按键为低电平有效,应先把 GPIO 电平转换成统一的 pressed 布尔值,再交给防抖函数,避免业务代码到处判断高低电平。
显示刷新与参数编辑
界面状态变化时设置 dirty = true,主循环只在脏标志存在时清屏、绘制和提交显示缓冲。这样可以减少 I2C 或 SPI 传输占用,也能避免 OLED 不必要的闪烁。传感器数据更新后若当前位于数据页,也应设置脏标志。
参数编辑采用“工作副本”思想更安全:进入编辑时复制当前值,短按只修改副本,确认后再覆盖正式参数并写入非易失存储。示例为便于阅读直接修改内存值,但仍只在长按确认时输出保存动作,避免每次加一都擦写 Flash。
完整可运行示例
下面的 C99 程序模拟两只机械按键的原始电平,完整执行防抖、短按、长按、页面切换和按需刷新。将代码保存为 ui_demo.c。
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#define DEBOUNCE_MS 20u
#define LONG_PRESS_MS 800u
typedef enum {
BUTTON_NONE,
BUTTON_SHORT,
BUTTON_LONG
} ButtonEvent;
typedef struct {
bool last_raw;
bool stable_pressed;
bool long_reported;
uint32_t changed_at_ms;
uint32_t pressed_at_ms;
} ButtonFilter;
typedef enum {
PAGE_DATA,
PAGE_STATUS,
PAGE_SETTING
} UiPage;
typedef struct {
UiPage page;
int alarm_limit_c;
bool editing;
bool dirty;
} UiState;
static ButtonEvent button_update(ButtonFilter *button, bool raw_pressed, uint32_t now_ms) {
if (raw_pressed != button->last_raw) {
button->last_raw = raw_pressed;
button->changed_at_ms = now_ms;
}
if (raw_pressed != button->stable_pressed &&
now_ms - button->changed_at_ms >= DEBOUNCE_MS) {
button->stable_pressed = raw_pressed;
if (raw_pressed) {
button->pressed_at_ms = now_ms;
button->long_reported = false;
} else if (!button->long_reported) {
return BUTTON_SHORT;
}
}
if (button->stable_pressed && !button->long_reported &&
now_ms - button->pressed_at_ms >= LONG_PRESS_MS) {
button->long_reported = true;
return BUTTON_LONG;
}
return BUTTON_NONE;
}
static void ui_handle_next(UiState *ui, ButtonEvent event) {
if (event != BUTTON_SHORT) {
return;
}
if (ui->page == PAGE_SETTING && ui->editing) {
ui->alarm_limit_c = ui->alarm_limit_c >= 40 ? 20 : ui->alarm_limit_c + 1;
} else {
ui->page = (UiPage) ((ui->page + 1) % 3);
}
ui->dirty = true;
}
static void ui_handle_ok(UiState *ui, ButtonEvent event) {
if (ui->page != PAGE_SETTING || event == BUTTON_NONE) {
return;
}
if (event == BUTTON_SHORT) {
ui->editing = !ui->editing;
ui->dirty = true;
} else if (event == BUTTON_LONG && ui->editing) {
ui->editing = false;
ui->dirty = true;
printf("SAVE alarm_limit=%dC\n", ui->alarm_limit_c);
}
}
static void ui_render(UiState *ui) {
if (!ui->dirty) {
return;
}
if (ui->page == PAGE_DATA) {
printf("[DATA] temperature=25.3C humidity=61%%\n");
} else if (ui->page == PAGE_STATUS) {
printf("[STATUS] sensor=OK alarm=OFF\n");
} else {
printf("[SETTING] alarm_limit=%dC%s\n",
ui->alarm_limit_c,
ui->editing ? " <editing>" : "");
}
ui->dirty = false;
}
static bool next_raw_pressed(uint32_t now_ms) {
return (now_ms >= 50 && now_ms < 100) ||
(now_ms >= 150 && now_ms < 200) ||
(now_ms >= 350 && now_ms < 400) ||
(now_ms >= 450 && now_ms < 500) ||
(now_ms >= 1450 && now_ms < 1500);
}
static bool ok_raw_pressed(uint32_t now_ms) {
return (now_ms >= 250 && now_ms < 300) ||
(now_ms >= 550 && now_ms < 1450);
}
int main(void) {
ButtonFilter next_button = {0};
ButtonFilter ok_button = {0};
UiState ui = {
.page = PAGE_DATA,
.alarm_limit_c = 30,
.editing = false,
.dirty = true
};
for (uint32_t now_ms = 0; now_ms <= 1550; now_ms += 10) {
ButtonEvent next_event =
button_update(&next_button, next_raw_pressed(now_ms), now_ms);
ButtonEvent ok_event =
button_update(&ok_button, ok_raw_pressed(now_ms), now_ms);
ui_handle_next(&ui, next_event);
ui_handle_ok(&ui, ok_event);
ui_render(&ui);
}
return 0;
}编译并运行:
gcc -std=c99 -Wall -Wextra -pedantic ui_demo.c -o ui_demo
./ui_demo预期输出:
[DATA] temperature=25.3C humidity=61%
[STATUS] sensor=OK alarm=OFF
[SETTING] alarm_limit=30C
[SETTING] alarm_limit=30C <editing>
[SETTING] alarm_limit=31C <editing>
[SETTING] alarm_limit=32C <editing>
SAVE alarm_limit=32C
[SETTING] alarm_limit=32C
[DATA] temperature=25.3C humidity=61%板端接入与验收
在 STM32 主循环中,使用 HAL_GetTick() 提供毫秒时基,把低电平有效的按键转换为布尔值,再复用示例中的防抖与界面处理函数。下面是依赖已初始化 GPIO 和 OLED 驱动的片段示例。
uint32_t now_ms = HAL_GetTick();
bool next_pressed =
HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) == GPIO_PIN_RESET;
bool ok_pressed =
HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_1) == GPIO_PIN_RESET;
ButtonEvent next_event =
button_update(&next_button, next_pressed, now_ms);
ButtonEvent ok_event =
button_update(&ok_button, ok_pressed, now_ms);
ui_handle_next(&ui, next_event);
ui_handle_ok(&ui, ok_event);
if (ui.dirty) {
OLED_Clear();
Ui_DrawCurrentPage(&ui, &latest_sensor_frame);
OLED_UpdateScreen();
ui.dirty = false;
}验收时先快速连续点击按键,确认每次物理按压只产生一个短按事件;再长按 OK,确认只出现一次保存动作;最后停留在数据页更新传感器值,检查显示按设定周期刷新,而无状态变化时不重复传输整屏数据。
本课总结
- 按键原始电平必须先经过防抖和事件化处理,再交给界面状态机
- 页面、编辑状态和参数保存时机应明确分离,避免同一按键产生歧义
- 使用脏标志按需刷新显示,可减少总线占用、闪烁和无效功耗
下一课预告
后续将把采集、显示、参数和执行器模块组合成完整系统,并通过日志、断言和分层排查方法验证模块之间的数据流与异常恢复能力。