原创支持单击、双击、弹起、长按的按键驱动程序

已于 2022-05-30 18:19:07 修改
阅读量532 收藏 4
点赞数
文章标签： c++ c语言 开发语言
于 2022-05-30 18:13:52 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/istars2005/article/details/125051303
版权

头文件  KeyDriver.h

/*
 * @Author: Neo Wang
 * @Date: 2022-04-27 16:01:15
 * @LastEditTime: 2022-05-16 11:53:50
 */
#ifndef __KEY_DRIVER_H_
#define __KEY_DRIVER_H_

#include <stdio.h>
#include <string.h>
#include <stdlib.h>

#include "driver/gpio.h"


typedef signed int s32_t;
typedef unsigned int u32_t;
typedef signed short s16_t;
typedef unsigned short u16_t;
typedef signed char s8_t;
typedef unsigned char u8_t;


#define MAX_KEY_SIZE            (32)        // 最多支持按键数量
#define DEFAULT_RND_TIM         (30)        // 默认循环调用时间 30ms
#define DEFAULT_KEY_INTERVAL    (20)        // 默认连击间隔 20x30=600ms
#define DEFAULT_CB_PRESS_CNT    (100)       // 默认长按回调计数 100x30=3000ms

#define GET_PIN_STATUS(k)       gpio_get_level(k)        // 读取单一按键函数, 不同平台读取函数不同，
                                                         //  返回值要求为bool, 按下返回0

typedef struct KeyStruct {
    struct sta {
        u8_t press    : 1;      // 按下标记
        u8_t click    : 1;      // 单击标记
        u8_t upClick  : 1;      // 弹起标记
        u8_t pressExe : 1;      // 长按执行标记        
    } sta;
    u16_t keyNumber;            // 按键号(和硬件相关)
    u16_t clickCnt;             // 按键次数
    u16_t clickCntDown;         // 按键间隔时间
    u16_t pressCnt;             // 长按时间(执行次数)
    u16_t pressCBCnt;           // 长按回调时间
    void (*clickCallback)(u16_t, u16_t);   // 单击回调 传入参数为键号和点击次数
    void (*upClickCallback)(u16_t, u16_t); // 弹起回调 传入参数为键号和点击次数
    void (*pressCallback)(u16_t, u16_t);   // 长按回调 传入参数为键号和长按时间
} KeyStruct;

void ScanKeyboard(void) ;
void SetKeyInterval(u16_t tim) ;
void SetKeyboardRoundTime(u16_t tim) ;
s16_t GetKeyPressTime(u16_t num) ;
int KeyInsert(struct KeyStruct *k) ;
int KeyAdd(u16_t num, u16_t tim, void (*clickCB)(u16_t, u16_t), void (*uplickCB)(u16_t, u16_t), void (*lpressCB)(u16_t, u16_t)) ;

#endif

按键驱动程序源码

/* 
    按键驱动程序
    实现按键的单击 双击 多击等操作
    实现按键的弹起检测操作
    实现按键长按操作

    使用方式  :
    把 void ScanKeyboard(void) 放在一个可以定时执行的任务或者系统嘀嗒中
    在执行之前先配置定时执行的间隔时间 < void SetKeyboardRoundTime(u16_t tim) >，不配置的话默认采用30ms；
        如果配置的时间和实际循环时间不同， 则会影响长按键响应时间和连击间隔时间的准确性
    配置按键连击的间隔时间 < void SetKeyInterval(u16_t tim)  > , 不配置的话，默认连击间隔时间是600ms
    采用 < int KeyInsert(struct KeyStruct *k)  > 或者 < int KeyAdd(u16_t, u16_t, void (*)(u16_t), void (*)(void), void (*)(u16_t))  >
        添加按键,注意添加的顺序对应按键的键号
    根据需要编写对应功能的回调函数,不需要的功能需要配置回调为 NULL
    * 单击和弹起回调函数的传入值是点击次数
    * 长按回调函数传入值是按下时间长度 单位ms


    注意: 
        1. 根据不同的平台需要自己修改头文件中的 #define GET_PIN_STATUS(k)  
            用来读取单一按键的高低电平值,返回值要求为 bool,而且按下为0弹起为1
        2. 配置按键间隔时间应该放在配置循环时间之后

*/

#include "KeyDriver.h"


struct KeyStruct *_gKeyBuffer[MAX_KEY_SIZE];    // 按键buffer，采用数组方式
u16_t _gRoundTime = DEFAULT_RND_TIM;            // 循环时间
u16_t _gInterval = DEFAULT_KEY_INTERVAL;        // 间隔时间
u16_t _gBtnSize = 0;                            // 按键数量

/**
 * @brief 按键扫描函数
 *        需要定时执行,执行时间需要根据实际时间使用SetKeyboardRoundTime来配置 * 
 */
void ScanKeyboard(void) {
    u8_t tssta = 0;
    for(int i=0; i<_gBtnSize; i++) {
        tssta = !GET_PIN_STATUS(_gKeyBuffer[i]->keyNumber);
        _gKeyBuffer[i]->sta.click = tssta & (tssta ^ _gKeyBuffer[i]->sta.press);
        _gKeyBuffer[i]->clickCntDown = _gKeyBuffer[i]->clickCntDown ? _gKeyBuffer[i]->clickCntDown-1 : 0;
        if(_gKeyBuffer[i]->clickCntDown == 0)
            _gKeyBuffer[i]->clickCnt = 0;
        if(_gKeyBuffer[i]->sta.press != tssta) {
            _gKeyBuffer[i]->sta.upClick = tssta ^ _gKeyBuffer[i]->sta.press ^ _gKeyBuffer[i]->sta.click;
            if(_gKeyBuffer[i]->sta.click != 0) {
                _gKeyBuffer[i]->clickCnt += 1;
                _gKeyBuffer[i]->clickCntDown = _gInterval;
            }
        } else 
            _gKeyBuffer[i]->sta.upClick = 0;
        _gKeyBuffer[i]->sta.press = tssta;
        _gKeyBuffer[i]->pressCnt = (tssta ? _gKeyBuffer[i]->pressCnt+1 : 0);
        
        if(_gKeyBuffer[i]->sta.click == 1 && _gKeyBuffer[i]->clickCallback != NULL) {
            _gKeyBuffer[i]->clickCallback(i, _gKeyBuffer[i]->clickCnt);
        } else if(_gKeyBuffer[i]->sta.upClick == 1 && _gKeyBuffer[i]->upClickCallback != NULL) {
            _gKeyBuffer[i]->upClickCallback(i, _gKeyBuffer[i]->clickCnt);
        }
        if((_gKeyBuffer[i]->pressCallback != NULL) && (_gKeyBuffer[i]->pressCnt >= _gKeyBuffer[i]->pressCBCnt)) {
            if(_gKeyBuffer[i]->sta.pressExe == 0) {
                _gKeyBuffer[i]->sta.pressExe = 1;
                _gKeyBuffer[i]->pressCallback(i, _gKeyBuffer[i]->pressCnt*_gRoundTime);
            }
        } else 
            _gKeyBuffer[i]->sta.pressExe = 0;
    }
}

/**
 * @brief 配置双击和多连击之间的按键间隔时间
 * 
 * @param tim 
 */
void SetKeyInterval(u16_t tim) {
    _gInterval = tim/_gRoundTime;
}

/**
 * @brief 配置循环时间
 * 
 * @param tim 
 */
void SetKeyboardRoundTime(u16_t tim) {
    u16_t tsInterval = _gRoundTime * _gInterval;
    _gRoundTime = tim;
    _gInterval = tsInterval / tim;  // 重新计算连击间隔时间
}

/**
 * @brief 获取对应按键的按下时间,可以用来判断多个按键按下的时常
 * 
 * @param num 按键号 执行KeyAdd或者KeyInsert的顺序就是按键号
 * @return s16_t 
 */
s16_t GetKeyPressTime(u16_t num) {
    if(num < _gBtnSize) {
        return _gKeyBuffer[num]->pressCnt * _gRoundTime;
    }
    return -1;
}

/**
 * @brief 采用直接添加结构体的方式添加按键
 *        添加失败返回 -1
 * @param k 
 * @return int 
 */
int KeyInsert(struct KeyStruct *k) {
    if(_gBtnSize >= MAX_KEY_SIZE)
        return -1;
    if(k->pressCBCnt < _gInterval)
        k->pressCBCnt = DEFAULT_CB_PRESS_CNT;
    _gKeyBuffer[_gBtnSize] = k;
    _gBtnSize += 1;
    return 0;
}

/**
 * @brief 
 * 
 * @param num 按键号，对应硬件管脚号
 * @param tim 长按回调时间 毫秒
 * @param clickCB 点击回调函数
 * @param uplickCB 弹起回调函数
 * @param lpressCB 长按回调函数
 * @return int 
 */
int KeyAdd(u16_t num, u16_t tim, void (*clickCB)(u16_t, u16_t), void (*uplickCB)(u16_t, u16_t), void (*lpressCB)(u16_t, u16_t)) {
    if(_gBtnSize >= MAX_KEY_SIZE)
        return -1;
    struct KeyStruct *k = malloc(sizeof(struct KeyStruct));
    if(k == NULL)
        return -2;
    memset(k,0,sizeof(struct KeyStruct));
    k->keyNumber = num;
    k->pressCBCnt = tim/_gRoundTime;
    k->clickCallback = clickCB;
    k->upClickCallback = uplickCB;
    k->pressCallback = lpressCB;
    if(k->pressCBCnt < _gInterval)
        k->pressCBCnt = DEFAULT_CB_PRESS_CNT;
    _gKeyBuffer[_gBtnSize] = k;
    _gBtnSize += 1;
    return 0;
}

使用说明看源代码顶端的说明部分

示例

#define GPIO_INPUT_SW1 11


void keyLpress(u16_t k, u16_t t) {  // 长按1秒回调
    printf("Key %d Long press  %d", k,t);
}

void keyClick(u16_t k, u16_t c) { // 按键回调    
    printf("Click %d  cnt=%d",k,c);
}

void keyUpClick(u16_t k, u16_t c) { // 按键回调    
    printf("UpClick %d  cnt=%d",k,c);
}


SetKeyboardRoundTime(100);
KeyAdd(GPIO_INPUT_SW1,1000,keyClick,keyUpClick,keyLpress);  // 注册按键


// 其中这部分是ESP32中的定义
#define GET_PIN_STATUS(k)       gpio_get_level(k)

STM32使用的话需要修改一下单按键读取的部分

也就是  #define GET_PIN_STATUS(k)

这里的定义

我一般采用下面的这种定义方式，里面的地址是STM32F10X的地址

其他系列需要修改

//-另外一种定义方式
#define nPA(n)     (0x20+n)
#define nPB(n)     (0x30+n)
#define nPC(n)     (0x40+n)
#define nPD(n)     (0x50+n)
#define nPE(n)     (0x60+n)
#define nPF(n)     (0x70+n)
#define nPG(n)     (0x80+n)

#define nRCC(PIN)      (1<<(PIN>>4))                                            // 转换为端口时钟
#define nPIN(PIN)      (1<<(PIN&0x0f))                                          // 转换为管脚号
#define nGIO(PIN)      ((GPIO_TypeDef *)(((PIN&0xF0)<<6) + APB2PERIPH_BASE))    // 转换为端口号


#define GPIO_PinOutHL(pin,sta)      (nGIO(pin)->BSRR = (nPIN(pin)<<(((sta)==0)<<4)))   // GPIO按位输出指定电平
#define GPIO_PinOutHigh(pin)        (nGIO(pin)->BSRR = nPIN(pin))                      // GPIO按位输出高
#define GPIO_PinOutLow(pin)         (nGIO(pin)->BRR  = nPIN(pin))                      // GPIO按位输出低
#define GPIO_PinOutRev(pin)         (nGIO(pin)->ODR ^= nPIN(pin))                      // GPIO按位输出反
#define GPIO_PortOutHigh(port,pin)  (nGIO(port)->BSRR = pin)                           // GPIO端口输出高  暂时有问题
#define GPIO_PortOutLow(port,pin)   (nGIO(port)->BRR  = pin)                           // GPIO端口输出低  暂时有问题
#define GPIO_PortOutRev(port,pin)   (nGIO(port)->ODR ^= pin)                           // GPIO端口输出反  暂时有问题

#define GPIO_PinIn(pin)             ((nGIO(pin)->IDR & nPIN(pin)) != 0)      // 读取单一端口状态
#define GPIO_PortIn(pin)            (nGIO(pin)->IDR )                        // 读取端口状态(输入该端口任何一个管脚即可)

#define GPIO_PinOutSta(pin)         ((nGIO(pin)->ODR & nPIN(pin)) != 0)      // 读取单一端口输出状态
#define GPIO_PortOutSta(port)       (nGIO(pin)->ODR )                        // 读取端口输出状态(输入该端口任何一个管脚即可)

使用方式如下

// 修改读取IO的接口
#define GET_PIN_STATUS(k)    GPIO_PinIn(k)



#define GPIO_INPUT_SW1  nPA(1)


SetKeyboardRoundTime(100);
KeyAdd(GPIO_INPUT_SW1,800,keyClick,NULL,keyLpress);  // 注册按键

istars2005
关注
  • 0
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
C语言处理按键的 单击（短按），长按，双击，多击 处理
ZenNaiHeQiao的专栏
01-08 1万+
【一】： （1）如果为按键按下到释放的一个过程，t1 如果大于 250ms 认为按键有效 否则 按键无效，不做处理。 （2）如果联系两个双脉冲，脉冲之间相差时间t2 < 1S 认为是 双按键 否则 判定为两次不相干的按键行为。 （3）如果按下时间t3 >=5s 判定为长按键 【二】 按键的处理函数 void APP_KEY_Task(void) 每5ms 调用一次 该函数需...
【按键】[独立按键] - 2：双击
热门推荐
z21109的专栏
03-29 1万+
二、[双击]程序 1.双击介绍 双击的判定 在完成第一次【单击】之后，在一定的时间间隔内（本程序使用的是300ms），接着完成第二次【单击】,及判定为【双击】。 双击的响应 1）在预设的时间间隔内完成第二次【单击】，按键释放后，响应返回有效键值【双击】。 2）如果第二次按下键并一直按住，当按住的时间超过设定的时间间隔（300ms）后，会响应第一个【单击】，并返回有效键值【单击】。 注：【单
C语言实现事件驱动型按键驱动模块程序
03-04
C语言实现，用于嵌入式尤其单片机系统，小巧简单易用的事件驱动型按键驱动模块，可无限量扩展按键，按键事件的回调异步处理方式可以简化你的程序结构，按键业务逻辑更清晰。c语言源代码；修订了原版的bug，更易用。使用介绍参见博客：https://blog.csdn.net/weixin_41034400/article/details/114357718
简洁的c代码实现按键长按、短按、单击、双击程序
dear_Wally的博客
01-04 4794
【代码】简洁的c代码实现按键长按、短按、单击、双击程序。
STM32CubeMX | MultiButton：一个小巧简单易用的事件驱动型按键驱动模块实现按键单机、双击、多击、长按
^_^
11-22 2330
STM32CubeMX | MultiButton：一个小巧简单易用的事件驱动型按键驱动模块实现按键单机、双击、多击、长按 目录STM32CubeMX | MultiButton：一个小巧简单易用的事件驱动型按键驱动模块实现按键单机、双击、多击、长按简介STM32基础工程生成移植使用效果测试 开发测试环境： WIN10 STM32F103RB STM32CubeMX 简介 MultiButton 是一个小巧简单易用的事件驱动型按键驱动模块，可无限量扩展按键，按键事件的回调异步处理方式可以简化你的程
按键状态机（实现单击，长按，双击）的模块分享
xdedmbb的博客
03-23 4628
此文章为学习经验分享，帮助和我一样的小白理解按键的状态机，能够自己实现想要实现的功能。（附函数模块哦）
按键的单击双击三击和长按
08-06
本文将深入探讨如何在单片机环境中实现按键的单击、双击、三击以及长按功能，同时会提及如何利用定时器来优化这些操作，使其更易于移植到不同平台。 首先，我们来看按键的基本原理。在硬件层面，按键通常连接到...
按键实现单击、双击、长按 方便移植版本
07-09
本文将详细介绍如何使用C语言在单片机环境下实现按键的单击、双击和长按功能，并探讨这种实现方式的可移植性。 首先，我们需要理解单片机中的按键基本原理。按键通常连接到单片机的I/O引脚，当按键未按下时，引脚...
STC8单片机的按键单击、双击、长按的代码实现
06-24
综上所述，实现STC8单片机的按键单击、双击和长按功能涉及硬件接口设计、中断服务程序、时间管理和代码的可移植性。通过理解这些知识点，我们可以有效地处理按键输入，并将其应用到各种嵌入式系统中。
嵌入式STM32按键状态机-单击双击长按操作
06-02
本程序使用定时器，运用状态机的思想，实现了单按键的单击长按操作。 代码简洁规范，可读性强，移植性强。 实验器材: 自制开发板，STM32F03C8T6平台 实验目的: 学习定时器中断、按键使用。实现单击双击长按操作 ...
按键单击+双击+长按.rar
06-24
本资源“按键单击+双击+长按.rar”提供了一个经典的按键扫描程序，该程序支持单击、双击和长按三种操作模式，并且在实现双击时能避免误触发单击事件。这在单片机编程中非常实用，特别是对于那些需要通过简单按键进行...
按键长按短按双击（多击）
2302_76668302的博客
05-16 326
/10MS扫描一次。#define DOUBLE_CLICK_TIME 250 // 双击间隔时间（毫秒）void Timer0_Init() //1毫秒@11.0592MHz。#define LONG_PRESS_TIME 500 // 按键长按时间（毫秒）////双击时间计数。void Timer0_Isr(void) interrupt 1//1MS进一次。//定时器时钟1T模式。//定时器0开始计时。//使能定时器0中断。
单片机双击 长按 c语言,单片机三种按键模式 单击 双击 长按
weixin_36060539的博客
05-24 613
{//中间间隔时间太长 判断为的单击double_key=0;count_single=0;return 1;//单击执行的指令}if(Forever_count>time){//长按不放double_key=0;count_single=0;}}return 0;}/**************************************************************...
长短按触发c语言程序,分析一个按键程序（长按 短按 双击）
weixin_34644635的博客
05-17 1459
STATE_KIDEL：如果有按键，查表，看是第几个按键。(排除8个IO口中，你不用做按键的那些IO。另外也是keyport中是从0开始的，而记在temp中是从0开始的)。Key_ThisValue=temp+1； 当前键值KeyState=STATTE_KDOWN； 按键状态KeyDn_Cnt=KEY_LONGTIME； 按键按下持续时间置为KEY_LONGTIME，减到0就表示...
按键连续点击的c语言程序,长按键C语言程序
weixin_29428137的博客
05-17 1053
长按键C语言程序zhchxgh | 2009-07-04 01:46:51 阅读：8246 发布文章一共用了四个按钮.#define_KEYDOWN_TEST_TIME(20)unsignedcharIsKeyDown(volatileunsignedcharValue,unsignedcharpin){unsignedlongCurSta...
按键连续点击的c语言程序,单片机按键程序单击双击长按有不同功能(c语言源程序)...
weixin_39728213的博客
05-17 1012
uchar S_key = 2,D_key = 1,L_key = 3,N_key = 0;bit b_key_led;bit b_key_smg;uchar key_drive(void){static uchar key_state;static uint key_time = 0;uchar key_return;key_return = N_key;switch(key_state){ca...
单片机双击 长按 c语言,51单片机按键检测源程序（实现单击、双击、长按等功能）...
weixin_35919125的博客
05-24 3150
原理：将按键这一事件的过程划分成如下几个状态：//stata 函数运行状态//0： 初始状态//1： 第一洗按键按下//2： 第一次长按抬起//3： 第一次短按抬起//4： 第二次按键按下//5： 第二次按键抬起利用定时器记录系统运行时间，根据系统运行时间来确定按键时间间隔，根据不同的时间间隔来判断当前按键事件处于哪一过程以及是否结束该事件。主函数中应循环调用按键检测函数，调用间隔不超过100ms...
正点原子STM32开发板实现按键单击，双击，长按程序。
weixin_48507818的博客
04-15 777
正点原子stm32实现按键单双击，长按程序
独立按键单击,双击,长按c语言程序
最新发布
10-22
然后，在主程序中，可以通过判断中断标志位的变化来实现按键的单击、双击和长按功能。以下是一个简单的示例代码： #include "reg51.h" //引入相关的头文件，具体根据使用的单片机而定 volatile unsigned int click...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值