English | 简体中文 | 繁體中文 | 日本語 | Deutsch | 한국어
按钮是一种简单的开关机制用于控制机器或过程的某些方面。 按钮通常由硬质材料制成,通常是塑料或金属。 表面通常是平坦的或形状适合人的手指或手以便容易地被压下或推动。 按钮通常是偏置开关,尽管许多非偏置按钮(由于其物理性质)仍然需要弹簧才能返回到未按下的状态。
LibDriver BUTTON是LibDriver推出的BUTTON全功能驱动,该驱动提供按压检测、释放检测、单击检测、双击检测、三击检测、重复按键检测、短按检测、长按检测等功能并且它符合MISRA标准。
LibDriver BUTTON支持单按钮检测,可以以更高效的方法运行, 如果您需要多按键或者矩阵按键检测, 请参考https://gitee.com/libdriver/multi_button。
/src目录包含了LibDriver BUTTON的源文件。
/interface目录包含了LibDriver BUTTON与平台无关的GPIO总线模板。
/test目录包含了LibDriver BUTTON驱动测试程序,该程序可以简单的测试芯片必要功能。
/example目录包含了LibDriver BUTTON编程范例。
/doc目录包含了LibDriver BUTTON离线文档。
/datasheet目录包含了BUTTON数据手册。
/project目录包含了常用Linux与单片机开发板的工程样例。所有工程均采用shell脚本作为调试方法,详细内容可参考每个工程里面的README.md。
/misra目录包含了LibDriver MISRA代码扫描结果。
参考/interface目录下与平台无关的GPIO总线模板,完成指定平台的GPIO总线驱动。
将/src目录,您使用平台的接口驱动和您开发的驱动加入工程,如果您想要使用默认的范例驱动,可以将/example目录加入您的工程。
您可以参考/example目录下的编程范例完成适合您的驱动,如果您想要使用默认的编程范例,以下是它们的使用方法。
#include "driver_button_basic.h"
uint8_t res;
uint8_t (*g_gpio_irq)(uint8_t) = NULL;
uint8_t (*g_period_irq)(void) = NULL;
static void a_receive_callback(button_t *data)
{
switch (data->status)
{
case BUTTON_STATUS_PRESS :
{
break;
}
case BUTTON_STATUS_RELEASE :
{
break;
}
case BUTTON_STATUS_SINGLE_CLICK :
{
button_interface_debug_print("button: irq single click.\n");
break;
}
case BUTTON_STATUS_DOUBLE_CLICK :
{
button_interface_debug_print("button: irq double click.\n");
break;
}
case BUTTON_STATUS_TRIPLE_CLICK :
{
button_interface_debug_print("button: irq triple click.\n");
break;
}
case BUTTON_STATUS_REPEAT_CLICK :
{
button_interface_debug_print("button: irq repeat click with %d times.\n", data->times);
break;
}
case BUTTON_STATUS_SHORT_PRESS_START :
{
button_interface_debug_print("button: irq short press start.\n");
break;
}
case BUTTON_STATUS_SHORT_PRESS_END :
{
button_interface_debug_print("button: irq short press end.\n");
break;
}
case BUTTON_STATUS_LONG_PRESS_START :
{
button_interface_debug_print("button: irq long press start.\n");
break;
}
case BUTTON_STATUS_LONG_PRESS_HOLD :
{
button_interface_debug_print("button: irq long press hold.\n");
break;
}
case BUTTON_STATUS_LONG_PRESS_END :
{
button_interface_debug_print("button: irq long press end.\n");
break;
}
default :
{
button_interface_debug_print("button: irq unknown status.\n");
break;
}
}
}
/* gpio init */
res = gpio_interrupt_init();
if (res != 0)
{
return 1;
}
/* set the irq */
g_gpio_irq = button_basic_irq_handler;
g_period_irq = button_basic_period_handler;
/* basic init */
res = button_basic_init(a_receive_callback);
if (res != 0)
{
(void)gpio_interrupt_deinit();
g_gpio_irq = NULL;
g_period_irq = NULL;
}
...
while (1)
{
...
}
...
/* basic deinit */
(void)button_basic_deinit();
/* gpio deinit */
(void)gpio_interrupt_deinit();
g_gpio_irq = NULL;
g_period_irq = NULL;
return 0;
在线文档: https://www.libdriver.com/docs/button/index.html。
离线文档: /doc/html/index.html。
请参考CONTRIBUTING.md。
版权 (c) 2015 - 现在 LibDriver 版权所有
MIT 许可证(MIT)
特此免费授予任何获得本软件副本和相关文档文件(下称“软件”)的人不受限制地处置该软件的权利,包括不受限制地使用、复制、修改、合并、发布、分发、转授许可和/或出售该软件副本,以及再授权被配发了本软件的人如上的权利,须在下列条件下:
上述版权声明和本许可声明应包含在该软件的所有副本或实质成分中。
本软件是“如此”提供的,没有任何形式的明示或暗示的保证,包括但不限于对适销性、特定用途的适用性和不侵权的保证。在任何情况下,作者或版权持有人都不对任何索赔、损害或其他责任负责,无论这些追责来自合同、侵权或其它行为中,还是产生于、源于或有关于本软件以及本软件的使用或其它处置。
请联系lishifenging@outlook.com。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。