# MultiButton
## 简介
MultiButton 是一个小巧简单易用的事件驱动型按键驱动模块,可无限量扩展按键,按键事件的回调异步处理方式可以简化你的程序结构,去除冗余的按键处理硬编码,让你的按键业务逻辑更清晰。
## 使用方法
1.先申请一个按键结构
```
struct Button button1;
```
2.初始化按键对象,绑定按键的GPIO电平读取接口**read_button_pin()** ,后一个参数设置有效触发电平
```
button_init(&button1, read_button_pin, 0);
```
3.注册按键事件
```
button_attach(&button1, SINGLE_CLICK, Callback_SINGLE_CLICK_Handler);
button_attach(&button1, DOUBLE_CLICK, Callback_DOUBLE_Click_Handler);
...
```
4.启动按键
```
button_start(&button1);
```
5.设置一个5ms间隔的定时器循环调用后台处理函数
```
while(1) {
...
if(timer_ticks == 5) {
timer_ticks = 0;
button_ticks();
}
}
```
## 特性
MultiButton 使用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 (*hal_button_Level)(void);
BtnCallback cb[number_of_event];
struct Button* next;
};
```
这样每个按键使用单向链表相连,依次进入 button_handler(struct Button* handle) 状态机处理,所以每个按键的状态彼此独立。
## 按键事件
事件 | 说明
---|---
PRESS_DOWN | 按键按下,每次按下都触发
PRESS_UP | 按键弹起,每次松开都触发
PRESS_REPEAT | 重复按下触发,变量repeat计数连击次数
SINGLE_CLICK | 单击按键事件
DOUBLE_CLICK | 双击按键事件
LONG_RRESS_START | 达到长按时间阈值时触发一次
LONG_PRESS_HOLD | 长按期间一直触发
## Examples
```
#include "button.h"
struct Button btn1;
int read_button1_GPIO()
{
return HAL_GPIO_ReadPin(B1_GPIO_Port, B1_Pin);
}
int main()
{
button_init(&btn1, read_button1_GPIO, 0);
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_RRESS_START, BTN1_LONG_RRESS_START_Handler);
button_attach(&btn2, 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)
{}
}
void BTN1_PRESS_DOWN_Handler(void* btn)
{
//do something...
}
void BTN1_PRESS_UP_Handler(void* btn)
{
//do something...
}
...
```
没有合适的资源?快使用搜索试试~ 我知道了~
资源推荐
资源详情
资源评论
收起资源包目录
STM32_ADS1220_ads1220_STM32F103_stm32电压_ (308个子文件)
2505.axf 460KB
GS_CC_05_back_20191111.axf 403KB
SZ_5Channel.axf 401KB
Preprocessing.axf 353KB
08_keilkilll.bat 387B
GbkToUtf_8.c 197KB
Utf8ToGbk.c 146KB
stm32f10x_tim.c 107KB
stm32f10x_flash.c 61KB
stm32f10x_rcc.c 50KB
stm32f10x_adc.c 46KB
stm32f10x_i2c.c 45KB
stm32f10x_can.c 44KB
stm32f10x_usart.c 37KB
system_stm32f10x.c 36KB
stm32f10x_fsmc.c 35KB
stm32f10x_spi.c 30KB
stm32f10x_dma.c 29KB
stm32f10x_sdio.c 28KB
spi.c 23KB
stm32f10x_gpio.c 23KB
dhcp.c 22KB
bsp_spi_flash.c 19KB
stm32f429_decode.c 19KB
stm32f10x_dac.c 19KB
core_cm3.c 17KB
usb_decode.c 15KB
socket.c 14KB
usart.c 12KB
tcs3400_1.c 12KB
stm32f10x_cec.c 11KB
ads1220.c 11KB
w5500.c 11KB
utility.c 11KB
send_to_pad.c 10KB
timer.c 10KB
bsp_i2c_ee.c 9KB
stm32f10x_pwr.c 9KB
httputil.c 9KB
stm32f10x_rtc.c 8KB
bsp_i2c.c 8KB
stm32f10x_bkp.c 8KB
bsp_i2c_gpio.c 8KB
bsp_i2c_ee.c 7KB
rtc.c 7KB
misc.c 7KB
stm32f10x_exti.c 7KB
device_print.c 7KB
multi_button.c 6KB
GPS.c 6KB
w5500_conf.c 6KB
stm32f10x_wwdg.c 6KB
button_process.c 5KB
button_process.c 5KB
at24cxx.c 5KB
mpu6050.c 5KB
stm32f10x_it.c 5KB
stm32f10x_dbgmcu.c 5KB
http_server.c 5KB
multi_button.c 5KB
multi_button.c 5KB
stm32f10x_iwdg.c 5KB
tcp_demo.c 4KB
i2c.c 4KB
tcs3400.c 4KB
PID_Cal.c 3KB
stm32f10x_crc.c 3KB
io_ctrl.c 3KB
74HC595.c 3KB
adc.c 3KB
key.c 3KB
Paper_Cut.c 3KB
buff_ring_8bit.c 3KB
bsp_usart1.c 2KB
bsp_TiMbase.c 2KB
event_async.c 2KB
PID.C 2KB
pspid.c 2KB
event_inquire.c 2KB
timer.c 2KB
example_callback.c 2KB
example_callback.c 2KB
LM75A.c 1KB
main.c 1KB
wdg.c 1KB
send_to_stm32f429.c 1KB
IO_CTRL.c 1KB
delay.c 849B
wdg.c 713B
example_poll.c 705B
example_poll.c 705B
button_process.c 119B
w5500_conf.crf 364KB
stm32f10x_tim.crf 362KB
utility.crf 361KB
w5500.crf 359KB
tcp_demo.crf 358KB
socket.crf 357KB
main.crf 357KB
ads1220.crf 348KB
共 308 条
- 1
- 2
- 3
- 4
慕酒
- 粉丝: 48
- 资源: 4823
下载权益
C知道特权
VIP文章
课程特权
开通VIP
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
- 1
- 2
- 3
前往页