1. Button_Control 库概述Button_Control 是一个轻量级、可移植的嵌入式按钮状态管理库专为资源受限的 MCU如 STM32F0/F1/F4、ESP32、nRF52、RA4M1 等设计。其核心目标并非简单读取 GPIO 电平而是在硬件抖动、长按/短按区分、多按键协同、低功耗轮询等真实工程约束下提供确定性、可预测、可配置的按钮事件抽象层。该库不依赖操作系统但天然兼容 FreeRTOS、Zephyr、RT-Thread 等 RTOS 环境不绑定特定 HAL支持标准 CMSIS GPIO 接口、STM32 HAL/LL、NXP MCUXpresso SDK、Espressif ESP-IDF GPIO API 等多种底层驱动模型。其设计哲学是将“物理按键”转化为“语义化事件”并将事件生命周期与系统时序解耦。在工业控制面板、IoT 设备人机交互、医疗设备紧急按键、电池供电传感器节点等场景中一个不可靠的按钮驱动可能导致误触发、漏触发、状态粘连甚至系统死锁。Button_Control 通过三级状态机 时间戳滤波 可配置阈值从根本上规避了这些问题。2. 核心设计原理与状态机详解2.1 为什么不能直接HAL_GPIO_ReadPin()直接轮询 GPIO 引脚存在三大致命缺陷硬件抖动Bounce机械触点闭合/断开瞬间产生 5–20ms 的电压振荡若无消抖单次按下可能被识别为 3–5 次脉冲状态粘连Stuck State若主循环卡顿 按键稳定时间状态机无法及时更新导致BTN_PRESSED持续为真事件丢失Event Loss短按50ms在低频轮询如 10Hz下极易被跳过。Button_Control 采用“采样-确认-上报”三阶段异步处理模型彻底分离硬件采样与逻辑判断。2.2 三级状态机定义每个按钮实例维护独立的状态机共 6 个原子状态由button_state_t枚举定义typedef enum { BUTTON_STATE_IDLE, // 空闲引脚为释放态高电平上拉 BUTTON_STATE_DEBOUNCING, // 消抖中检测到下降沿启动消抖定时器 BUTTON_STATE_PRESSED, // 已按下消抖完成且持续为低 BUTTON_STATE_LONGPRESS, // 长按触发按下超时默认 1000ms BUTTON_STATE_RELEASE_DEBOUNCING, // 释放消抖检测到上升沿启动释放消抖 BUTTON_STATE_RELEASED // 已释放释放消抖完成 } button_state_t;状态迁移严格受控于两个关键时间参数参数名默认值作用工程选型依据DEBOUNCE_TIME_MS20下降沿后等待稳定低电平的最短时间覆盖 99% 机械开关抖动典型 5–15ms留 5ms 余量LONG_PRESS_TIME_MS1000从PRESSED进入LONGPRESS的阈值人体操作习惯短按 300ms长按 700ms取中间值防误触✅关键设计洞察BUTTON_STATE_PRESSED并非“正在按下”而是“已确认按下且尚未释放”。这保证了is_pressed()接口返回true时状态绝对稳定可安全用于控制继电器、点亮 LED 等强副作用操作。2.3 时间戳驱动机制无阻塞库内部不使用HAL_Delay()或vTaskDelay()所有时间判断基于单调递增的毫秒时间戳// 用户需在 SysTick 或 RTOS tick 中断中调用此函数推荐 1ms tick void button_tick(void) { static uint32_t last_ms 0; uint32_t now_ms HAL_GetTick(); // 或 xTaskGetTickCount() * portTICK_PERIOD_MS uint32_t elapsed now_ms - last_ms; last_ms now_ms; for (uint8_t i 0; i button_count; i) { button_update(buttons[i], elapsed); // 核心状态推进函数 } }button_update()内部仅做整数减法与状态比对零浮点运算、零动态内存分配、最大执行时间 1.2μsCortex-M4100MHz满足硬实时要求。3. API 接口规范与参数详解3.1 初始化与配置结构体typedef struct { uint8_t pin; // 物理引脚编号如 GPIO_PIN_0 GPIO_TypeDef* port; // GPIO 端口如 GPIOA GPIO_PinState active_level; // 有效电平GPIO_PIN_SET低有效或 GPIO_PIN_RESET高有效 uint16_t debounce_ms; // 自定义消抖时间覆盖默认值 uint16_t long_press_ms; // 自定义长按阈值 void (*on_short_press)(void*); // 短按回调传入用户上下文指针 void (*on_long_press)(void*); // 长按回调 void (*on_release)(void*); // 释放回调仅在释放时触发 void* user_data; // 用户私有数据如设备句柄、任务句柄 } button_config_t;⚠️ 注意active_level决定硬件连接方式若设为GPIO_PIN_SET则按钮一端接地另一端接 GPIO 上拉电阻常见若设为GPIO_PIN_RESET则按钮一端接 VCC另一端接 GPIO 下拉电阻抗干扰更强但功耗略高。3.2 核心 API 函数表函数签名功能说明典型调用时机线程安全性button_init(button_t* btn, const button_config_t* cfg)初始化单个按钮实例main()开始MX_GPIO_Init()之后✅ 安全无共享状态button_update(button_t* btn, uint32_t elapsed_ms)推进状态机必须周期调用SysTick_Handler()或vApplicationTickHook()✅ 安全只读 GPIO纯计算button_is_pressed(const button_t* btn)查询当前是否处于稳定按下态控制逻辑中如if (button_is_pressed(power_btn)) { ... }✅ 安全button_was_short_pressed(const button_t* btn)查询自上次调用起是否发生短按事件主循环末尾清空事件标志❌ 非安全需临界区或原子操作button_was_long_pressed(const button_t* btn)同上长按事件查询同上❌ 非安全button_was_released(const button_t* btn)释放事件查询同上❌ 非安全事件查询函数的线程安全警告was_*类函数采用“边缘触发”模式内部使用bool标志位调用后自动清零。若在中断中调用button_update()而在主循环中调用was_short_pressed()必须用__disable_irq()/__enable_irq()包裹或改用 FreeRTOS 队列投递事件。3.3 回调函数使用范式FreeRTOS 环境// 在 button_config_t 中注册 static void on_power_short(void* ctx) { BaseType_t xHigherPriorityTaskWoken pdFALSE; // 向高优先级任务发送消息 xQueueSendFromISR(event_queue, (event_t){.typeEVENT_POWER_SHORT}, xHigherPriorityTaskWoken); portYIELD_FROM_ISR(xHigherPriorityTaskWoken); } // 初始化配置 const button_config_t power_btn_cfg { .pin GPIO_PIN_5, .port GPIOB, .active_level GPIO_PIN_SET, // 低有效 .on_short_press on_power_short, .user_data NULL }; button_init(power_btn, power_btn_cfg);回调在button_update()内部同步触发因此必须为快响应函数 50μs禁止调用vTaskDelay()、printf()、大数组拷贝等阻塞操作。4. 典型应用示例与工程实践4.1 STM32 HAL FreeRTOS 多按键协同控制需求某手持终端含 3 个按键 ——MENU短按进菜单长按关机、UP短按向上翻页、DOWN短按向下翻页所有按键共用同一组 GPIOPB0/PB1/PB2需防误触。// 1. 定义按钮数组 button_t buttons[3]; QueueHandle_t event_queue; // 2. 初始化在 MX_GPIO_Init() 后 void button_init_all(void) { __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitTypeDef gpio {0}; gpio.Pin GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2; gpio.Mode GPIO_MODE_INPUT; gpio.Pull GPIO_PULLUP; // 所有按键共用上拉 gpio.Speed GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOB, gpio); event_queue xQueueCreate(10, sizeof(event_t)); const button_config_t cfgs[3] { [0] {.pinGPIO_PIN_0, .portGPIOB, .on_short_pressmenu_short, .on_long_presspower_long}, [1] {.pinGPIO_PIN_1, .portGPIOB, .on_short_pressup_short}, [2] {.pinGPIO_PIN_2, .portGPIOB, .on_short_pressdown_short} }; for (int i 0; i 3; i) { button_init(buttons[i], cfgs[i]); } } // 3. SysTick 中断中统一更新 void SysTick_Handler(void) { HAL_IncTick(); if (xTaskGetSchedulerState() ! taskSCHEDULER_NOT_STARTED) { button_tick(); // 内部遍历 buttons 数组 } } // 4. 主任务中消费事件 void event_task(void* pvParameters) { event_t evt; while (1) { if (xQueueReceive(event_queue, evt, portMAX_DELAY) pdTRUE) { switch (evt.type) { case EVENT_MENU_SHORT: enter_menu(); break; case EVENT_POWER_LONG: system_shutdown(); break; // ... } } } }✅工程优势3 个按钮共享SysTick更新CPU 占用率恒定无额外定时器资源消耗回调函数将“硬件事件”转为“业务事件”解耦驱动层与应用层system_shutdown()可在回调中安全调用HAL_PWR_EnterSTANDBYMode()因回调在中断上下文需确保HAL_PWR_EnterSTANDBYMode()支持中断调用STM32 HAL v1.12.0 已修复。4.2 超低功耗场景RTC 周期唤醒 按键扫描需求纽扣电池供电的温湿度记录仪要求待机电流 1μA仅在按键按下或定时唤醒时工作。// 利用 RTC Alarm 每 30 秒唤醒一次唤醒后扫描所有按键 void rtc_alarm_callback(void) { // 1. 使能 GPIO 时钟并配置为输入 __HAL_RCC_GPIOA_CLK_ENABLE(); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_All, GPIO_PIN_SET); // 清除所有输出锁存 HAL_GPIO_DeInit(GPIOA, GPIO_PIN_All); GPIO_InitTypeDef gpio {0}; gpio.Pin BTN_MENU_PIN | BTN_UP_PIN; gpio.Mode GPIO_MODE_INPUT; gpio.Pull GPIO_PULLUP; HAL_GPIO_Init(GPIOA, gpio); // 2. 短暂延时让上拉稳定10μs for (volatile int i 0; i 100; i); // 3. 单次 updateelapsed_ms 0仅采样不推进时间 button_update(menu_btn, 0); button_update(up_btn, 0); // 4. 若检测到按下进入全功能模式 if (button_is_pressed(menu_btn) || button_is_pressed(up_btn)) { enter_active_mode(); } else { // 无按键立即返回待机 HAL_PWR_EnterSTANDBYMode(); } }✅关键技巧button_update(btn, 0)允许零时间推进仅执行电平采样与状态比对待机前关闭所有 GPIO 时钟避免漏电流利用 RTC Alarm 的亚秒级精度±1ppm替代高功耗 SysTick。5. 高级配置与定制化开发5.1 自定义消抖算法替换默认阈值判断默认采用“连续 N 次采样一致”策略。若需更鲁棒的滤波如对抗 ESD 干扰可重写button_sample_pin()// 在 button_port.c 中实现弱符号可被用户覆盖 __weak GPIO_PinState button_sample_pin(const button_t* btn) { // 默认直接读取 return HAL_GPIO_ReadPin(btn-config-port, btn-config-pin); } // 用户自定义带 RC 滤波验证 GPIO_PinState button_sample_pin(const button_t* btn) { static uint8_t filter_buf[4] {0}; // 4 点滑动窗口 static uint8_t idx 0; GPIO_PinState raw HAL_GPIO_ReadPin(btn-config-port, btn-config-pin); filter_buf[idx] raw; idx (idx 1) 0x03; // 统计窗口内高电平数量≥3 判为高 uint8_t high_cnt 0; for (int i 0; i 4; i) { high_cnt (filter_buf[i] GPIO_PIN_SET) ? 1 : 0; } return (high_cnt 3) ? GPIO_PIN_SET : GPIO_PIN_RESET; }5.2 多按键组合识别Shift Key// 检测 MENU UP 同时按下用于工厂模式 bool is_menu_up_combo(void) { return button_is_pressed(menu_btn) button_is_pressed(up_btn) (button_get_press_time_ms(menu_btn) 200) // 防误触 (button_get_press_time_ms(up_btn) 200); } // 在主循环中调用 if (is_menu_up_combo()) { enter_factory_mode(); }button_get_press_time_ms()返回当前按下持续时间毫秒精度为button_tick()调用周期。5.3 与 LVGL 图形库集成// LVGL 输入设备驱动 void lvgl_button_read(lv_indev_drv_t* drv, lv_indev_data_t* data) { static uint32_t last_press 0; if (button_is_pressed(lvgl_btn)) { >
嵌入式按钮消抖与状态管理库设计原理
1. Button_Control 库概述Button_Control 是一个轻量级、可移植的嵌入式按钮状态管理库专为资源受限的 MCU如 STM32F0/F1/F4、ESP32、nRF52、RA4M1 等设计。其核心目标并非简单读取 GPIO 电平而是在硬件抖动、长按/短按区分、多按键协同、低功耗轮询等真实工程约束下提供确定性、可预测、可配置的按钮事件抽象层。该库不依赖操作系统但天然兼容 FreeRTOS、Zephyr、RT-Thread 等 RTOS 环境不绑定特定 HAL支持标准 CMSIS GPIO 接口、STM32 HAL/LL、NXP MCUXpresso SDK、Espressif ESP-IDF GPIO API 等多种底层驱动模型。其设计哲学是将“物理按键”转化为“语义化事件”并将事件生命周期与系统时序解耦。在工业控制面板、IoT 设备人机交互、医疗设备紧急按键、电池供电传感器节点等场景中一个不可靠的按钮驱动可能导致误触发、漏触发、状态粘连甚至系统死锁。Button_Control 通过三级状态机 时间戳滤波 可配置阈值从根本上规避了这些问题。2. 核心设计原理与状态机详解2.1 为什么不能直接HAL_GPIO_ReadPin()直接轮询 GPIO 引脚存在三大致命缺陷硬件抖动Bounce机械触点闭合/断开瞬间产生 5–20ms 的电压振荡若无消抖单次按下可能被识别为 3–5 次脉冲状态粘连Stuck State若主循环卡顿 按键稳定时间状态机无法及时更新导致BTN_PRESSED持续为真事件丢失Event Loss短按50ms在低频轮询如 10Hz下极易被跳过。Button_Control 采用“采样-确认-上报”三阶段异步处理模型彻底分离硬件采样与逻辑判断。2.2 三级状态机定义每个按钮实例维护独立的状态机共 6 个原子状态由button_state_t枚举定义typedef enum { BUTTON_STATE_IDLE, // 空闲引脚为释放态高电平上拉 BUTTON_STATE_DEBOUNCING, // 消抖中检测到下降沿启动消抖定时器 BUTTON_STATE_PRESSED, // 已按下消抖完成且持续为低 BUTTON_STATE_LONGPRESS, // 长按触发按下超时默认 1000ms BUTTON_STATE_RELEASE_DEBOUNCING, // 释放消抖检测到上升沿启动释放消抖 BUTTON_STATE_RELEASED // 已释放释放消抖完成 } button_state_t;状态迁移严格受控于两个关键时间参数参数名默认值作用工程选型依据DEBOUNCE_TIME_MS20下降沿后等待稳定低电平的最短时间覆盖 99% 机械开关抖动典型 5–15ms留 5ms 余量LONG_PRESS_TIME_MS1000从PRESSED进入LONGPRESS的阈值人体操作习惯短按 300ms长按 700ms取中间值防误触✅关键设计洞察BUTTON_STATE_PRESSED并非“正在按下”而是“已确认按下且尚未释放”。这保证了is_pressed()接口返回true时状态绝对稳定可安全用于控制继电器、点亮 LED 等强副作用操作。2.3 时间戳驱动机制无阻塞库内部不使用HAL_Delay()或vTaskDelay()所有时间判断基于单调递增的毫秒时间戳// 用户需在 SysTick 或 RTOS tick 中断中调用此函数推荐 1ms tick void button_tick(void) { static uint32_t last_ms 0; uint32_t now_ms HAL_GetTick(); // 或 xTaskGetTickCount() * portTICK_PERIOD_MS uint32_t elapsed now_ms - last_ms; last_ms now_ms; for (uint8_t i 0; i button_count; i) { button_update(buttons[i], elapsed); // 核心状态推进函数 } }button_update()内部仅做整数减法与状态比对零浮点运算、零动态内存分配、最大执行时间 1.2μsCortex-M4100MHz满足硬实时要求。3. API 接口规范与参数详解3.1 初始化与配置结构体typedef struct { uint8_t pin; // 物理引脚编号如 GPIO_PIN_0 GPIO_TypeDef* port; // GPIO 端口如 GPIOA GPIO_PinState active_level; // 有效电平GPIO_PIN_SET低有效或 GPIO_PIN_RESET高有效 uint16_t debounce_ms; // 自定义消抖时间覆盖默认值 uint16_t long_press_ms; // 自定义长按阈值 void (*on_short_press)(void*); // 短按回调传入用户上下文指针 void (*on_long_press)(void*); // 长按回调 void (*on_release)(void*); // 释放回调仅在释放时触发 void* user_data; // 用户私有数据如设备句柄、任务句柄 } button_config_t;⚠️ 注意active_level决定硬件连接方式若设为GPIO_PIN_SET则按钮一端接地另一端接 GPIO 上拉电阻常见若设为GPIO_PIN_RESET则按钮一端接 VCC另一端接 GPIO 下拉电阻抗干扰更强但功耗略高。3.2 核心 API 函数表函数签名功能说明典型调用时机线程安全性button_init(button_t* btn, const button_config_t* cfg)初始化单个按钮实例main()开始MX_GPIO_Init()之后✅ 安全无共享状态button_update(button_t* btn, uint32_t elapsed_ms)推进状态机必须周期调用SysTick_Handler()或vApplicationTickHook()✅ 安全只读 GPIO纯计算button_is_pressed(const button_t* btn)查询当前是否处于稳定按下态控制逻辑中如if (button_is_pressed(power_btn)) { ... }✅ 安全button_was_short_pressed(const button_t* btn)查询自上次调用起是否发生短按事件主循环末尾清空事件标志❌ 非安全需临界区或原子操作button_was_long_pressed(const button_t* btn)同上长按事件查询同上❌ 非安全button_was_released(const button_t* btn)释放事件查询同上❌ 非安全事件查询函数的线程安全警告was_*类函数采用“边缘触发”模式内部使用bool标志位调用后自动清零。若在中断中调用button_update()而在主循环中调用was_short_pressed()必须用__disable_irq()/__enable_irq()包裹或改用 FreeRTOS 队列投递事件。3.3 回调函数使用范式FreeRTOS 环境// 在 button_config_t 中注册 static void on_power_short(void* ctx) { BaseType_t xHigherPriorityTaskWoken pdFALSE; // 向高优先级任务发送消息 xQueueSendFromISR(event_queue, (event_t){.typeEVENT_POWER_SHORT}, xHigherPriorityTaskWoken); portYIELD_FROM_ISR(xHigherPriorityTaskWoken); } // 初始化配置 const button_config_t power_btn_cfg { .pin GPIO_PIN_5, .port GPIOB, .active_level GPIO_PIN_SET, // 低有效 .on_short_press on_power_short, .user_data NULL }; button_init(power_btn, power_btn_cfg);回调在button_update()内部同步触发因此必须为快响应函数 50μs禁止调用vTaskDelay()、printf()、大数组拷贝等阻塞操作。4. 典型应用示例与工程实践4.1 STM32 HAL FreeRTOS 多按键协同控制需求某手持终端含 3 个按键 ——MENU短按进菜单长按关机、UP短按向上翻页、DOWN短按向下翻页所有按键共用同一组 GPIOPB0/PB1/PB2需防误触。// 1. 定义按钮数组 button_t buttons[3]; QueueHandle_t event_queue; // 2. 初始化在 MX_GPIO_Init() 后 void button_init_all(void) { __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitTypeDef gpio {0}; gpio.Pin GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2; gpio.Mode GPIO_MODE_INPUT; gpio.Pull GPIO_PULLUP; // 所有按键共用上拉 gpio.Speed GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOB, gpio); event_queue xQueueCreate(10, sizeof(event_t)); const button_config_t cfgs[3] { [0] {.pinGPIO_PIN_0, .portGPIOB, .on_short_pressmenu_short, .on_long_presspower_long}, [1] {.pinGPIO_PIN_1, .portGPIOB, .on_short_pressup_short}, [2] {.pinGPIO_PIN_2, .portGPIOB, .on_short_pressdown_short} }; for (int i 0; i 3; i) { button_init(buttons[i], cfgs[i]); } } // 3. SysTick 中断中统一更新 void SysTick_Handler(void) { HAL_IncTick(); if (xTaskGetSchedulerState() ! taskSCHEDULER_NOT_STARTED) { button_tick(); // 内部遍历 buttons 数组 } } // 4. 主任务中消费事件 void event_task(void* pvParameters) { event_t evt; while (1) { if (xQueueReceive(event_queue, evt, portMAX_DELAY) pdTRUE) { switch (evt.type) { case EVENT_MENU_SHORT: enter_menu(); break; case EVENT_POWER_LONG: system_shutdown(); break; // ... } } } }✅工程优势3 个按钮共享SysTick更新CPU 占用率恒定无额外定时器资源消耗回调函数将“硬件事件”转为“业务事件”解耦驱动层与应用层system_shutdown()可在回调中安全调用HAL_PWR_EnterSTANDBYMode()因回调在中断上下文需确保HAL_PWR_EnterSTANDBYMode()支持中断调用STM32 HAL v1.12.0 已修复。4.2 超低功耗场景RTC 周期唤醒 按键扫描需求纽扣电池供电的温湿度记录仪要求待机电流 1μA仅在按键按下或定时唤醒时工作。// 利用 RTC Alarm 每 30 秒唤醒一次唤醒后扫描所有按键 void rtc_alarm_callback(void) { // 1. 使能 GPIO 时钟并配置为输入 __HAL_RCC_GPIOA_CLK_ENABLE(); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_All, GPIO_PIN_SET); // 清除所有输出锁存 HAL_GPIO_DeInit(GPIOA, GPIO_PIN_All); GPIO_InitTypeDef gpio {0}; gpio.Pin BTN_MENU_PIN | BTN_UP_PIN; gpio.Mode GPIO_MODE_INPUT; gpio.Pull GPIO_PULLUP; HAL_GPIO_Init(GPIOA, gpio); // 2. 短暂延时让上拉稳定10μs for (volatile int i 0; i 100; i); // 3. 单次 updateelapsed_ms 0仅采样不推进时间 button_update(menu_btn, 0); button_update(up_btn, 0); // 4. 若检测到按下进入全功能模式 if (button_is_pressed(menu_btn) || button_is_pressed(up_btn)) { enter_active_mode(); } else { // 无按键立即返回待机 HAL_PWR_EnterSTANDBYMode(); } }✅关键技巧button_update(btn, 0)允许零时间推进仅执行电平采样与状态比对待机前关闭所有 GPIO 时钟避免漏电流利用 RTC Alarm 的亚秒级精度±1ppm替代高功耗 SysTick。5. 高级配置与定制化开发5.1 自定义消抖算法替换默认阈值判断默认采用“连续 N 次采样一致”策略。若需更鲁棒的滤波如对抗 ESD 干扰可重写button_sample_pin()// 在 button_port.c 中实现弱符号可被用户覆盖 __weak GPIO_PinState button_sample_pin(const button_t* btn) { // 默认直接读取 return HAL_GPIO_ReadPin(btn-config-port, btn-config-pin); } // 用户自定义带 RC 滤波验证 GPIO_PinState button_sample_pin(const button_t* btn) { static uint8_t filter_buf[4] {0}; // 4 点滑动窗口 static uint8_t idx 0; GPIO_PinState raw HAL_GPIO_ReadPin(btn-config-port, btn-config-pin); filter_buf[idx] raw; idx (idx 1) 0x03; // 统计窗口内高电平数量≥3 判为高 uint8_t high_cnt 0; for (int i 0; i 4; i) { high_cnt (filter_buf[i] GPIO_PIN_SET) ? 1 : 0; } return (high_cnt 3) ? GPIO_PIN_SET : GPIO_PIN_RESET; }5.2 多按键组合识别Shift Key// 检测 MENU UP 同时按下用于工厂模式 bool is_menu_up_combo(void) { return button_is_pressed(menu_btn) button_is_pressed(up_btn) (button_get_press_time_ms(menu_btn) 200) // 防误触 (button_get_press_time_ms(up_btn) 200); } // 在主循环中调用 if (is_menu_up_combo()) { enter_factory_mode(); }button_get_press_time_ms()返回当前按下持续时间毫秒精度为button_tick()调用周期。5.3 与 LVGL 图形库集成// LVGL 输入设备驱动 void lvgl_button_read(lv_indev_drv_t* drv, lv_indev_data_t* data) { static uint32_t last_press 0; if (button_is_pressed(lvgl_btn)) { >
