* 导师视频讲解：[**去听课**](https://www.bilibili.com/video/BV1k34y1D7Vz/) >[success] **技术支持说明：** >**1**.一般以自主学习为主 > **2**.可到官方问答社区中提问：[**去提问**](https://bbs.csdn.net/forums/zigbee) > **3**.工程师**会尽快**解答社区问题，但他们是一线开发，【**难以保证**】解答时效，解答辛苦，感谢理解！ <br/> 本节课将直接以实验的方式讲解如何使用HAL按键驱动API，本节课的实验内容是按下按键后闪烁LED。 ### HAL提供了完善按键驱动API，其定义在在hal\_key.h和hal\_key.c中，如下图所示。  ### #### **按键的定义与映射** 打开头文件hal\_led.h，可以找到如下代码：  其中的SW\_1到SW\_5是方向按键，用得很少，故不展开讲解。SW\_6和SW\_7是常规按键。 ### 与LED类似，可以在头文件hal\_board\_cfg.h中配置按键与CC2530引脚的对接关系。以下是SW\_6的默认是配置，代码如下： ### ``` /* S1 按键 */ #define PUSH1_BV BV(1) #define PUSH1_SBIT P0_1 //按键按下时的电平 #if defined (HAL_BOARD_CC2530EB_REV17) #define PUSH1_POLARITY ACTIVE_HIGH #elif defined (HAL_BOARD_CC2530EB_REV13) #define PUSH1_POLARITY ACTIVE_LOW #else #error Unknown Board Indentifier #endif ``` ### 通常，这个按键已经能满足大多数设备需求了。配套的ZigBee开发板中的按键连接的引脚正是P0\_1。然而，我们按键的电路是按下时为低电平，未按下时为高电平，所以还需要修改一下配置，修改后的配置代码如下： ### ``` /* S1 按键 */ #define PUSH1_BV BV(1) #define PUSH1_SBIT P0_1 //表示低电平时驱动按键 #define PUSH1_POLARITY ACTIVE_LOW ``` >[info] 在前面的章节中已经讲解过按键的电路，有需要的读者可以翻阅一下。 <br/> ## **处理按键事件** 由于按键是受OSAL的调度的，所以在Z-Stack中使用按键之前，必须要现在OSAL中注册。可以在应用层中注册，应用层的初始化函数zclSampleSw_Init默认已经完成了此注册工作，如图所示：  ### 注册后，如果按键被按下，那么就会产生一个应用层的系统事件KEY\_CHANGE。打开zcl\_samplesw.c文件中的zclSampleSw\_event\_loop函数，可以找到KEY\_CHANGE事件的处理函数zclSampleSw\_HandleKeys，如图所示。  ### 事件处理函数zclSampleSw\_HandleKeys的代码定义如下：  ### zclSampleSw\_HandleKeys函数默认的工作内容是在LCD显示屏中显示按键按下的信息。开发者可在此处添加按键事件处理代码，例如前面章节讲解过的闪烁LED，代码如下：  <br/> ## **启用按键的宏定义** 与LED类似，在使用按键前，需要启用按键对应的宏定义HAL\_KEY。在下图中的Defined sybols中输入以下代码。 ### ``` HAL_KEY=TRUE ISR_KEYINTERRUPT ``` ###  ### 定义宏ISR\_KEYINTERRUPT是因为系统是使用中断的方式检测按键行为的，读者暂时大概了解一下即可。 <br/> ## **调试仿真** 编译工程后把程序烧录到开发板中，并且全速运行后，当按键被按下时可以看到LED闪烁。 <br/> <br/> ## **项目定制** * 如需项目定制开发，可扫码添加项目经理好友（注明“**项目定制**”） * 定制范围：**NB-IoT**、**CATn（4G）**、**WiFi**、**ZigBee**、**BLE Mesh**以及**STM32**、**嵌入式Linux**等IoT技术方案 * 善学坊官网：[www.sxf-iot.com](https://www.sxf-iot.com/)  * 非项目定制**勿扰**，此处**非**技术支持