[007] [STM32] 以面向对象的思想编写按键程序

已于 2022-03-30 16:29:38 修改
阅读量2.4k 收藏 54
点赞数 8
分类专栏： STM32 文章标签： stm32 单片机 arm
于 2022-02-19 17:33:25 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/kouxi1/article/details/123008273
版权
STM32
Contents
CubeMX配置
按键管理框架
按键驱动层
按键驱动框架层
按键管理层
应用示例

本文为百问网&韦东山【物联网智能家居实战训练营】课程笔记

声明：本项目参考：MultiButton

1 CubeMX配置

在这里插入图片描述

  1. RCC：配置HSE为晶体/陶瓷谐振器
  2. SYS：Debug选择SW模式
  3. 时钟：选择HSE作为PLL时钟源，将其改为8MHz（默认），然后选择PLLCLK作为系统时钟源，设为系统时钟为72MHz
  4. 按键引脚：PA0（wk_up）下拉输入，PA15（key1）和PC5（key0）上拉输入
  5. LED引脚：PA8（红灯）和PD2（黄灯）设为推挽输出，默认输出高电平
  6. TIM6：向上计数模式（TIM6&7只支持向上计数），psc = 72 - 1，arr = 1000 - 1，即1ms更新中断，然后配置NVIC使能TIM6全局中断
  7. USART1：TX-PA9，RX-PA10，用于打印按键触发事件信息
  8. 以单独的c/h文件生成MDK工程

2 按键管理框架

2.1 按键驱动层

按键底层驱动通过CubeMX配置相应引脚GPIO模式，然后调用HAL库初始化：

void MX_GPIO_Init(void)
{
  GPIO_InitTypeDef GPIO_InitStruct = {0};

  __HAL_RCC_GPIOA_CLK_ENABLE();
  __HAL_RCC_GPIOC_CLK_ENABLE();

  GPIO_InitStruct.Pin = WKUP_Pin;
  GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
  GPIO_InitStruct.Pull = GPIO_PULLDOWN;
  HAL_GPIO_Init(WKUP_GPIO_Port, &GPIO_InitStruct);

  GPIO_InitStruct.Pin = KEY0_Pin;
  GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
  GPIO_InitStruct.Pull = GPIO_PULLUP;
  HAL_GPIO_Init(KEY0_GPIO_Port, &GPIO_InitStruct);

  GPIO_InitStruct.Pin = KEY1_Pin;
  GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
  GPIO_InitStruct.Pull = GPIO_PULLUP;
  HAL_GPIO_Init(KEY1_GPIO_Port, &GPIO_InitStruct);
}

2.2 按键驱动框架层

按键驱动框架比较简单，将获取IO电平的HAL库函数二次封装一下即可：

uint8_t wkup_key_read_pin(void)
{
    return HAL_GPIO_ReadPin(WKUP_GPIO_Port, WKUP_Pin);
}

uint8_t key0_read_pin(void)
{
    return HAL_GPIO_ReadPin(KEY0_GPIO_Port, KEY0_Pin);
}

uint8_t key1_read_pin(void)
{
    return HAL_GPIO_ReadPin(KEY1_GPIO_Port, KEY1_Pin);
}

2.3 按键管理层

2.3.1 按键对象状态

enum key_state {
    Init_None_State = 0,        /* 初始未按下状态 */
    Init_Press_State,           /* 初次按下状态 */
    Press_Check_State,          /* 连击检查状态 */
    Continuous_Press_State,     /* 连续按下状态 */
    Long_Press_State,           /* 长按状态 */
};

2.3.2 按键对象事件

enum key_event { 
    Press_Down = 0,             /* 按键按下，每次按下都触发 */
    Press_Up,                   /* 按键弹起，每次松开都触发 */
    Singe_Click,                /* 单击触发(仅触发一次) */
    Double_Click,               /* 双击触发(仅触发一次) */
    Short_Press_Repeat,         /* 每次短按时都会触发(按下次数>=2) */
    Long_Press_Start,           /* 首次进入长按状态触发(仅触发一次) */
    Long_Press_Hold,            /* 长按保持状态触发(每经过一个循环长按间隔触发一次) */
    Event_Sum,                  /* 事件总数 */
    None_Press                  /* 未按下 */
};

2.3.3 按键对象句柄结构体

struct key_handle
{
    uint16_t tick;                                          	  /* 按键系统时间片 */
    uint8_t repeat_cnt     : 4;                             	  /* 按键短按次数 */
    uint8_t event   	   : 4;                             	  /* 触发事件 */
    uint8_t state          : 3;                             	  /* 按键状态 */
    uint8_t debounce_tick  : 3;                             	  /* 消抖时间片 */
    uint8_t active_level   : 1;                                   /* 按键有效按下电平 */
    uint8_t key_level      : 1;                             	  /* 按键引脚当前电平 */
    uint8_t (* pin_read)(void);                         	      /* 获取按键引脚电平 */
    void (* event_callback[Event_Sum])(struct key_handle* key);   /* 按键事件回调函数 */
    struct key_handle* next;                                      /* 单向链表next指针 */
};
typedef struct key_handle *key_handle_t;

2.3.4 初始化按键对象

static key_handle_t _key_slist_head = NULL;  // 按键管理单链表头结点

/**
 * @brief   初始化按键对象
 * @param   key             按键对象句柄
 * @param   gpio_pin_read   获取按键电平函数指针
 * @param   active_level    按键按下有效电平
 * @return  0: succeed -1: failed
 */
int8_t key_init(struct key_handle *key, uint8_t (*gpio_pin_read)(void), uint8_t active_level)
{
    if (key == NULL)
        return -1;
    memset(key, 0, sizeof(struct key_handle));
    key->event = None_Press;
    key->active_level = active_level;
    key->pin_read = gpio_pin_read;
    key->key_level = key->pin_read();

    return 0;
}

2.3.5 注册按键

/**
 * @brief   注册按键:将按键对象插入到按键管理链表中
 * @param   key 按键对象句柄
 * @return  0: succeed -1: failed
 */
int8_t key_handle_register(struct key_handle *key)
{
    struct key_handle *key_slist_node = _key_slist_head;  // 获取头指针的地址 (无头结点单链表)

    if (key == NULL)
        return -1;

    // 尾插(不带头结点的单链表, 头指针需做特殊判断)
    if (_key_slist_head == NULL) // 头指针为空==表空
    {
        _key_slist_head = key;
        key->next = NULL;
        return 0;
    }

    while(key_slist_node)
    {
        if (key_slist_node == key) return -1;       // 重复注册
        if(key_slist_node->next == NULL) break;     // 已经遍历到最后一个节点,必须在此跳出循环, 否则key_slist_node==NULL
        key_slist_node = key_slist_node->next;
    }
    key_slist_node->next = key;  
    key->next = NULL; 

    return 0;
}

2.3.6 脱离按键

/**
 * @brief   脱离按键:将按键对象从按键管理链表中脱离
 * @param   key 按键对象句柄
 * @return  0: succeed -1: failed
 */
int8_t key_handle_detach(struct key_handle *key)
{
    // 解1级引用指向指针变量, 解2级引用指向指针变量所指向的变量 
    struct key_handle **key_slist_node = &_key_slist_head;  // 指向头指针, 直接操作原指针变量(不然最后无法修改头指针)
    struct key_handle *node_temp;
    if (key == NULL || _key_slist_head == NULL)
        return -1;

    while(*key_slist_node && *key_slist_node != key)
    {
        node_temp = *key_slist_node;
        if((*key_slist_node)->next == NULL) break;
        key_slist_node = &node_temp->next;     // 不能直接解1级引用赋值，会破坏原链表
    }

    if (*key_slist_node != key)
        return -1;
    *key_slist_node = (*key_slist_node)->next;

    return 0;
}

2.3.7 注册事件回调函数

/**
 * @brief   注册按键事件触发回调函数
 * @param   key             按键对象句柄
 * @param   event           触发事件类型
 * @param   event_callback  事件回调函数
 * @return  0: succeed -1: failed
 */
int8_t key_event_callback_register(struct key_handle *key, uint8_t event, void (* event_callback)(key_handle_t key))
{
    if (key == NULL || event >= Event_Sum)
        return -1;
    key->event_callback[event] = event_callback;

    return 0;
}

2.3.8 按键状态机

在这里插入图片描述

状态符号按键对象状态含义
state0Init_None_State初始未按下状态
state1Init_Press_State初次按下状态
state2Press_Check_State连击检查状态
state3Continuous_Press_State连续按下状态
state5Long_Press_State长按状态
/**
 * @brief   处理所有按键对象的状态机
 * @param   key 按键对象句柄
 * @return  None
 */
static void key_handler(struct key_handle *key)
{
    uint8_t key_level_temp = key->pin_read();

    if(key->state != Init_None_State) key->tick++;

    /* 按键消抖(按键状态发生变化保持DEBOUNCE_TICK时间片开始保存按键引脚电平) */
    if(key_level_temp != key->key_level)
    {
        if(++(key->debounce_tick) >= DEBOUNCE_TICK)
        {
            key->key_level = key_level_temp;
            key->debounce_tick = 0;
        }
    }
    else
    {
        key->debounce_tick = 0;
    }
        
    /* 按键状态机 */
    switch (key->state)
    {
    case Init_None_State:
        /* 初始态-> 初始按下态  Press_Down */
        if(key->key_level == key->active_level)   
        {
            key->event = (uint8_t)Press_Down;
            __KEY_EVENT_CALL(Press_Down);
            key->tick  = 0;
            key->repeat_cnt = 1;
            key->state  = Init_Press_State;
        }
        else
        {
            key->event = (uint8_t)None_Press;
        }    
        break;

    case Init_Press_State:
        /* 第一次按下松开：初始按下态->连击检查态  Press_Up */
        if(key->key_level != key->active_level)
        {
            key->event = (uint8_t)Press_Up;
            __KEY_EVENT_CALL(Press_Up);
            key->tick = 0;
            key->state = Press_Check_State;

        }
        /* 第一次按下后长按(>LONG_PRESS_START_TICK)：初始按下态->长按态  Long_Press_Start */
        else if(key->tick > LONG_PRESS_START_TICK)
        { 
            key->event = (uint8_t)Long_Press_Start;
            __KEY_EVENT_CALL(Long_Press_Start);
            key->state = Long_Press_State;
        }
        break;

    case Press_Check_State:
        /* 松开后再次按下：连击检查态->连击态 Press_Down & Short_Press_Repeat */
        if(key->key_level == key->active_level)
        {
            key->event = (uint8_t)Press_Down;
            __KEY_EVENT_CALL(Press_Down);
            key->repeat_cnt++;
            __KEY_EVENT_CALL(Short_Press_Repeat);
            key->tick = 0;
            key->state = Continuous_Press_State;
        } 
        /* 松开后再次没有按下(>SHORT_PRESS_START_TICK)：连击检查态->初始态 repeat_cnt=1: Singe_Click; repeat_cnt=2: Double_Click */
        else if(key->tick > SHORT_PRESS_START_TICK)
        {                
            if(key->repeat_cnt == 1)
            {
                key->event = (uint8_t)Singe_Click;
                __KEY_EVENT_CALL(Singe_Click);
            }
            /* 连击态松开后会返回此条件下触发  todo: <可以做n连击判断> */
            else if(key->repeat_cnt == 2)
            {
                key->event = (uint8_t)Double_Click;
                __KEY_EVENT_CALL(Double_Click);
            }
            key->state = Init_None_State;
        }
        break;

    case Continuous_Press_State:
        /* 连击后松开：连击态->连击检查态(< SHORT_PRESS_START_TICK)) : 连击态->初始态(>= SHORT_PRESS_START_TICK) */
        if(key->key_level != key->active_level)
        {
            key->event = (uint8_t)Press_Up;
            __KEY_EVENT_CALL(Press_Up);

            if(key->tick < SHORT_PRESS_START_TICK)
            {
                key->tick = 0;
                key->state = Press_Check_State;
            }
            else
            {
                key->state = Init_None_State;
            }
        }
        /* 连击后长按(>SHORT_TICKS): 连击态 -> 初始态 */
        else if(key->tick > SHORT_PRESS_START_TICK)
        {
            key->state = Init_Press_State;  // 可以回到Init_None_State/Init_Press_State
        }
        break;

    case Long_Press_State:
        /* 长按保持  Long_Press_Hold */
        if(key->key_level == key->active_level)
        {
            key->event = (uint8_t)Long_Press_Hold;
            if (key->tick % LONG_HOLD_CYCLE_TICK == 0)     
            {
                __KEY_EVENT_CALL(Long_Press_Hold);
            }
        }
        /* 长按松开：长按态-> 初始态 */
        else
        {
            key->event = (uint8_t)Press_Up;
            __KEY_EVENT_CALL(Press_Up);

            key->state = Init_None_State;
        }
        break;
    }  
}

2.3.9 遍历调用按键对象

/**
 * @brief   每经过一个滴答周期调用一次按键处理函数(裸机放1ms中断, OS放线程或中断)
 * @param   None
 * @return  None
 */
void key_tick(void)
{
    struct key_handle *key_slist_node;
    static uint8_t tick_cnt = 0;

    if (++tick_cnt < CHECK_TICK)
        return;
    
    for (key_slist_node = _key_slist_head; key_slist_node != NULL; key_slist_node = key_slist_node->next)
    {
        key_handler(key_slist_node);
    }
    tick_cnt = 0;
}

注意：裸机环境下，函数必须在中断中(默认1ms，可修改)调用，上RTOS可以在线程上下文中检测。

3 应用示例

static struct key_handle _key0;
static void key0_event_callback(key_handle_t key)
{
    switch(key->event)
    {
    case Press_Down:
        UART_DEBUG("key0 press down");
    break;

    case Press_Up:
        UART_DEBUG("key0 press up");
    break;

    case Singe_Click:
        UART_DEBUG("key0 single click");
    break;

    case Double_Click:
        UART_DEBUG("key0 double click");
    break;

    case Short_Press_Repeat:
        UART_DEBUG("key0 short press repeat");
    break;

    case Long_Press_Start:
        UART_DEBUG("key0 long press start");
    break;

    case Long_Press_Hold:
        key_handle_detach(&_key0);
        UART_DEBUG("key0 long press hold");
    break;

    default:
    break;
    }
}

void key_test_sample(void)
{
    key_init(&_key0, key0_read_pin, GPIO_PIN_RESET);
    key_event_callback_register(&_key0, Press_Down,         key0_event_callback);
    key_event_callback_register(&_key0, Press_Up,           key0_event_callback);
    key_event_callback_register(&_key0, Singe_Click,        key0_event_callback);
    key_event_callback_register(&_key0, Double_Click,       key0_event_callback);
    key_event_callback_register(&_key0, Short_Press_Repeat, key0_event_callback);
    key_event_callback_register(&_key0, Long_Press_Start,   key0_event_callback);
    key_event_callback_register(&_key0, Long_Press_Hold,    key0_event_callback);
    key_handle_register(&_key0);
}

在定时器中断回调函数里检测：

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
    if (htim->Instance == TIM6)
    {
        key_tick();
    }
}

串口打印信息：
在这里插入图片描述

代码已开源到gitee：以面向对象思想编写的按键管理框架

END

柯西的彷徨
关注
  • 8
    点赞
  • 踩
  • 54
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 3
    评论
专栏目录
STM32面向对象_程序架构 整个工程DEMO 我自己常用的
11-13
STM32面向对象_程序架构 整个工程DEMO，我自己常用的；很多初学STM32编程的同学，常常对多任务调度、全局变量处理、编程规范处理的不专业或者很乱，本demo是我自己做STM32项目常用的编程架构，内含面向对象思想，奉献给初学者
在51和STM32单片机上使用面向对象的编程，第一篇：炫酷地点亮一盏LED灯源码工程
05-02
用C在单片机上实现面向对象，在51和STM32单片机上使用面向对象的编程，第一篇：炫酷地点亮一盏LED灯源码工程，在51和STM32单片机上使用面向对象的编程，第一篇：炫酷地点亮一盏LED灯源码工程
整理面向对象的三大特性笔记及所学的个别快捷键^ ^
weixin_43739366的博客
01-02 121
封装（private） 1.隐藏该隐藏的，显示该现显示的。 2.不提供具体细节。 3.一些关键的功能不提供对外修改的权限。 如果一个类的属性被private修饰，需要给外界提供一个可以联系的入口。 提供给使用者一个修改的方法，可以在方法中添加条件进行限制。 Set 修改----------get 获取 修改属性的方法 命名规范Set + 属性名 Set 没有返回值有参数（public void(...
STM32HAL-完全解耦面向对象思维的架构-时间轮片法使用（timeslice - pro）
最新发布
qq_36075612的博客
05-19 815
双向链表时间片论法
stm32操作LED C++面向对象编程操作
qq_43065556的博客
07-22 1758
stm32操作LED C++面向对象编程操作
stm32用面向对象的方法点亮指示灯，方便添加新成员和修改参数
weixin_42401119的博客
11-27 1577
面向对象思维操作指示灯
程序架构 程序算法 面向对象的编程思想以及程序架构造 STM32标准库 协议栈 RTOS源码(操作系统内核程序设计方法)
dianqicyuyan的博客
11-27 928
我最近也意识到了程序架构这一点 我用#CSDN#这个app发现了有技术含量的博客，小伙伴们求同去《单片机开发项目全局变量太多怎么管理？》, 一起来围观吧 https://blog.csdn.net/weixin_43982452/article/details/121387105?utm_source=app&app_version=4.19.0&code=app_1562916241&uLinkId=usr1mkqgl919blen ...
基于STM32F103移植华为LiteOS_任务挂起与恢复_面向对象编程思想之按键状态机
04-06
在本文中，我们将深入探讨如何基于STM32F103微控制器移植华为的轻量级操作系统LiteOS，并实现任务的挂起与恢复，以及利用面向对象编程思想设计按键状态机。华为LiteOS是一个专为物联网（IoT）设计的开源实时操作系统...
STM32仿真+程序豆浆机.zip
12-20
综上所述，STM32仿真和程序开发对于豆浆机的设计至关重要，从软件仿真到硬件调试，再到程序编写和优化，每一个环节都直接影响着豆浆机的性能和用户体验。在实际操作中，开发者需要深入理解STM32的特性和相关工具，...
基于stm32的按键实现菜单（二级界面）
03-09
我们需要编写驱动程序，用C语言实现SPI通信协议和OLED控制器的命令，以显示菜单文本和界面元素。 在编程过程中，我们可以使用HAL库或LL库，这两个库都是STM32官方提供的，简化了底层硬件操作。HAL库提供了一种面向...
STM32f0-按键中断和按键查询代码（HAL库函数）
05-06
STM32 HAL库是ST公司为STM32系列微控制器设计的高级层库，提供了面向对象的API（应用程序接口），使得开发者能够更快速地开发项目，同时降低了对底层硬件的理解要求。 ### 2. 按键硬件配置 在STM32F0上实现按键功能...
基于STM32的按键驱动程序-电路方案
04-21
该驱动可支持单个按键短按、长按和组合键。 代码里有详细注释，并附有使用说明书。 该驱动经过测试，若发现bug也请及时反馈。
薄膜按键stm32驱动程序.zip
04-16
这是一个薄膜键盘的按键驱动程序，已经用stm32测试过的，按下按键后通过串口打印出对应按键数字，很方便移植哈。
面向对象的C语言(OOPC)之按键.pdf
10-01
面向对象的C语言(OOPC)之按键.pdf
stm32按键程序
11-09
stm32按键程序代码 型号f103zet6型号的arm
万代触摸按键STM32驱动
04-28
代码为WTC6316,12 SPI驱动，由于万代触摸按键不为标准SPI接口，此程序以模拟方式实现
实验3 按键输入_STM32战舰按键输入实验_youthgy7_STM32按键_
10-03
HAL库提供了一套面向对象的API，简化了STM32的编程；而LL库则更接近底层，提供了更高性能但略复杂。两者都可用于实现按键输入，选择取决于项目需求和开发者熟悉程度。 8. **实验步骤** - 初始化STM32的系统时钟和...
stm32 设计一个按键驱动，可以检测单机，连击，长按等操作
gxt_kt的博客
03-15 1399
stm32 设计一个按键驱动，可以检测单机，连击，长按等操作 1.期望： 设计一个通用驱动代码： 不需要外部中断 不限制于stm32，可以快速移植到各种单片机 可以轻松识别单机，连击，长按 不需要堵塞延时，写在主函数也不会堵塞其它代码执行 代码尽量多次分层，减少计算量，写在中断也不会占用过长时间 使用宏定义，可以快速更改时间间隔 软件完美消抖，减少硬件电路设计 2.实现效果： 3.先来看驱动代码 使用宏定义，可以快速更改成想要的时间和方便移植 #define ERROR_TOUCH_T 50 //误触
STM32按键控制程序
dongjiejiao3583的博客
02-28 866
由于最近时间比较匆忙 已经有很久的时间没有写博客了 这次和大家分享的是STM32的一个按键的小程序 他的优点呢也是和上面一个LED一样就是便于移植 更改管脚方便 虽然都是些小程序 但是我觉得他们就像基础一样 基础打好了 你才能建立更高的大楼 学了1年半的电子 我深有体会 其实我们最难学的是基础 可是我们往往忽视了这些方面 只顾一头钻入 这个算法 那个算法 其实说个最简单的给你一份英文资...
stm32面向对象编程框架
07-18
STM32面向对象编程框架是一种适用于STM32微控制器的编程方式，它使用C++语言和面向对象的编程思想，帮助开发者更高效地进行嵌入式软件开发。 首先，面向对象编程框架通过封装、继承和多态等机制，将系统中的功能组织成一个个对象，并通过对象之间的交互实现系统的功能。这种方式使得代码更加模块化，易于维护和重用。 其次，面向对象编程框架提供了一系列的库函数和工具，用于简化STM32芯片的初始化和配置，如GPIO、定时器、中断等。这些库函数和工具可以提高开发效率，并降低开发人员对硬件细节的关注。 此外，STM32面向对象编程框架还支持多任务操作系统，例如FreeRTOS。通过使用任务、消息队列和信号量等机制，可以实现多个任务之间的并发执行，提高系统的响应能力和并行处理能力。 最后，面向对象编程框架还兼容其他常用的嵌入式开发工具，如Keil、IAR等，方便开发者在熟悉的开发环境下进行开发和调试。 总之，STM32面向对象编程框架提供了一种高效、可靠的嵌入式软件开发方式，通过封装、继承和多态等特性，简化了代码的管理和开发过程，并提供了丰富的库函数和工具，帮助开发者更轻松地实现系统功能。这种框架的使用为STM32开发带来了便利，也为嵌入式软件开发提供了更多的选择和灵活性。
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

柯西的彷徨

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值