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

实现显示与按键交互

实现显示与按键交互

本课把传感器数据、设备状态和可调参数组织成多个显示页面,并使用两个按键完成页面切换、进入编辑、修改数值和确认保存。实现重点不是绘制更多字符,而是建立清晰的界面状态、稳定的按键事件和按需刷新的显示流程。

学习目标

  • 使用页面状态机组织实时数据、状态和设置页面
  • 将原始 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。

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;
}

编译并运行:

bash
gcc -std=c99 -Wall -Wextra -pedantic ui_demo.c -o ui_demo
./ui_demo

预期输出:

text
[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 驱动的片段示例。

c
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,确认只出现一次保存动作;最后停留在数据页更新传感器值,检查显示按设定周期刷新,而无状态变化时不重复传输整屏数据。

本课总结

  • 按键原始电平必须先经过防抖和事件化处理,再交给界面状态机
  • 页面、编辑状态和参数保存时机应明确分离,避免同一按键产生歧义
  • 使用脏标志按需刷新显示,可减少总线占用、闪烁和无效功耗

下一课预告

后续将把采集、显示、参数和执行器模块组合成完整系统,并通过日志、断言和分层排查方法验证模块之间的数据流与异常恢复能力。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现显示与按键交互

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

登录哪都通