本项目是一个小巧简单易用的事件驱动型按键驱动模块，可无限量扩展按键，按键事件的回调异步处理方式可以简化你的程序结构，去除冗余的按键处理硬编码，让你的按键业务逻辑更清晰。  

## 1、使用方法

1.先申请一个按键结构

```c
struct Button button1;
```

2.初始化按键对象，绑定按键的GPIO电平读取接口**read\_button\_pin()** ，后一个参数设置有效触发电平

```c
button_init(&button1, read_button_pin, 0, 0);
```

3.注册按键事件

```c
button_attach(&button1, SINGLE_CLICK, Callback_SINGLE_CLICK_Handler);
button_attach(&button1, DOUBLE_CLICK, Callback_DOUBLE_Click_Handler);
/* ... */
```

4.启动按键

```c
button_start(&button1);
```

5.设置一个5ms间隔的定时器循环调用后台处理函数

```c
while(1) {
    /* ... */
    if(timer_ticks == 5) {
        timer_ticks = 0;

        button_ticks();
    }
}
```

## 2、特性

本项目使用C语言实现，基于面向对象方式设计思路，每个按键对象单独用一份数据结构管理：

```c
struct Button {
	uint16_t ticks;
	uint8_t  repeat: 4;
	uint8_t  event : 4;
	uint8_t  state : 3;
	uint8_t  debounce_cnt : 3;
	uint8_t  active_level : 1;
	uint8_t  button_level : 1;
	uint8_t  button_id;
	uint8_t  (*hal_button_Level)(uint8_t  button_id_);
	BtnCallback  cb[number_of_event];
	struct Button* next;
};
```

这样每个按键使用单向链表相连，依次进入 button\_handler(struct Button\* handle) 状态机处理，所以每个按键的状态彼此独立。

## 3、按键事件

| 事件 | 说明 |
| --- | --- |
| PRESS\_DOWN | 按键按下，每次按下都触发 |
| PRESS\_UP | 按键弹起，每次松开都触发 |
| PRESS\_REPEAT | 重复按下触发，变量repeat计数连击次数 |
| SINGLE\_CLICK | 单击按键事件 |
| DOUBLE\_CLICK | 双击按键事件 |
| LONG\_PRESS\_START | 达到长按时间阈值时触发一次 |
| LONG\_PRESS\_HOLD | 长按期间一直触发 |

## 4、示例

以下为使用片段，省略部分回调函数的实现。GPIO 映射、各事件回调和5ms定时器接口需由具体项目提供。

```c
#include "button.h"

enum { BTN1_ID = 0 };

struct Button btn1;

uint8_t read_button_GPIO(uint8_t button_id)
{
	// you can share the GPIO read function with multiple Buttons
	switch(button_id)
	{
		case BTN1_ID:
			return HAL_GPIO_ReadPin(B1_GPIO_Port, B1_Pin);
			break;

		default:
			return 0;
			break;
	}
}
void BTN1_PRESS_DOWN_Handler(void* btn)
{
	//do something...
}

void BTN1_PRESS_UP_Handler(void* btn)
{
	//do something...
}

/* ... */

int main()
{
	button_init(&btn1, read_button_GPIO, 0, BTN1_ID);
	button_attach(&btn1, PRESS_DOWN,       BTN1_PRESS_DOWN_Handler);
	button_attach(&btn1, PRESS_UP,         BTN1_PRESS_UP_Handler);
	button_attach(&btn1, PRESS_REPEAT,     BTN1_PRESS_REPEAT_Handler);
	button_attach(&btn1, SINGLE_CLICK,     BTN1_SINGLE_Click_Handler);
	button_attach(&btn1, DOUBLE_CLICK,     BTN1_DOUBLE_Click_Handler);
	button_attach(&btn1, LONG_PRESS_START, BTN1_LONG_PRESS_START_Handler);
	button_attach(&btn1, LONG_PRESS_HOLD,  BTN1_LONG_PRESS_HOLD_Handler);
	button_start(&btn1);

	//make the timer invoking the button_ticks() interval 5ms.
	//This function is implemented by yourself.
	__timer_start(button_ticks, 0, 5);

	while(1)
	{}
}
```

本项目是一个小巧简单易用的事件驱动型按键驱动模块，可无限量扩展按键，按键事件的回调异步处理方式可以简化你的程序结构，去除冗余的按键处理硬编码，让你的按键业务逻辑更清晰。

嵌入式C语言实现事件型按键驱动

介绍事件驱动型按键模块的初始化、GPIO读取、事件回调、5ms后台调度和单向链表结构，列出七种按键事件，并给出STM32 GPIO接口的使用片段。

嵌入式工程师

硬件

轻量级C语言事件驱动按键模块，基于面向对象链表设计，支持无限扩展按键。集成单击、双击、长按及重复触发等丰富事件，回调异步处理简化代码结构，有效管理GPIO按键状态机，提升业务逻辑清晰度。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

嵌入式C语言实现事件型按键驱动-腾讯云开发者社区-腾讯云

嵌入式C语言实现事件型按键驱动

嵌入式C语言实现事件型按键驱动

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐