一、硬件連接
| 按鍵名稱 | 引腳 | 控制方法 |
|---|---|---|
| UP | DIO_19 | 按下觸發(fā) |
| DOWN | DIO_12 | 按下觸發(fā) |
| LEFT | DIO_15 | 按下觸發(fā) |
| RIGHT | DIO_18 | 按下觸發(fā) |
| SELECT | DIO_11 | 按下觸發(fā) |
二、移植文件
鏈接：https://pan.baidu.com/s/13bouzcp4L2rHKm9mXgm72A 提取碼：1f78
將 board_key.c 和 board_key.h 兩個(gè)文件拖拽至CCS工程的Application文件夾下
添加文件過程中，選項(xiàng)選擇如下
2.1 board_key.c
/*********************************************************************
* INCLUDES
*/
#include <stdbool.h>
#include <ti/sysbios/knl/Clock.h>
#include <ti/sysbios/family/arm/m3/Hwi.h>
#include <ti/sysbios/knl/Semaphore.h>
#include <ti/sysbios/knl/Queue.h>
#include <ti/drivers/pin/PINCC26XX.h>
#ifdef USE_ICALL
#include <icall.h>
#endif
#include <inc/hw_ints.h>
#include "util.h"
#include "board_key.h"
#include "board.h"
/*********************************************************************
* LOCAL VARIABLES
*/
// 鍵值
static uint8_t s_keysPressed;
// 按鍵消抖時(shí)鐘
static Clock_Struct s_keyChangeClock;
// 對應(yīng)應(yīng)用層回調(diào)函數(shù)的函數(shù)指針
static keysPressedCB_t s_appKeyChangeHandler = NULL;
// Memory for the GPIO module to construct a Hwi
static Hwi_Struct s_callbackHwiKeys;
// 按鍵IO配置
static PIN_Config s_keyPinsCfg[] =
{
Board_KEY_SELECT | PIN_GPIO_OUTPUT_DIS | PIN_INPUT_EN | PIN_PULLUP,
Board_KEY_UP | PIN_GPIO_OUTPUT_DIS | PIN_INPUT_EN | PIN_PULLUP,
Board_KEY_DOWN | PIN_GPIO_OUTPUT_DIS | PIN_INPUT_EN | PIN_PULLUP,
Board_KEY_LEFT | PIN_GPIO_OUTPUT_DIS | PIN_INPUT_EN | PIN_PULLUP,
Board_KEY_RIGHT | PIN_GPIO_OUTPUT_DIS | PIN_INPUT_EN | PIN_PULLUP,
PIN_TERMINATE
};
// 按鍵IO狀態(tài)結(jié)構(gòu)體
static PIN_State s_keyPins;
// 按鍵IO句柄結(jié)構(gòu)體
static PIN_Handle s_hKeyPins;
/*********************************************************************
* LOCAL FUNCTIONS
*/
/**
@brief 按鍵驅(qū)動回調(diào)函數(shù)
@param none
@return none
*/
static void board_keyCallback(PIN_Handle hPin, PIN_Id pinId)
{
// 清除鍵值
s_keysPressed = 0;
// 判斷按鍵是否按下
if(PIN_getInputValue(Board_KEY_SELECT) == 0)
{
// 保存鍵值
s_keysPressed |= KEY_SELECT;
}
if(PIN_getInputValue(Board_KEY_UP) == 0)
{
s_keysPressed |= KEY_UP;
}
if(PIN_getInputValue(Board_KEY_DOWN) == 0)
{
s_keysPressed |= KEY_DOWN;
}
if(PIN_getInputValue(Board_KEY_LEFT) == 0)
{
s_keysPressed |= KEY_LEFT;
}
if(PIN_getInputValue(Board_KEY_RIGHT) == 0)
{
s_keysPressed |= KEY_RIGHT;
}
// 啟動定時(shí)器進(jìn)行消抖
Util_startClock(&s_keyChangeClock);
}
/**
@brief 按鍵驅(qū)動的消抖處理函數(shù)
@param none
@return none
*/
static void board_keyChangeHandler(UArg a0)
{
// 判斷是否有注冊
if(s_appKeyChangeHandler != NULL)
{
// 消抖
if(PIN_getInputValue(Board_KEY_SELECT) == 0)
{
s_keysPressed |= KEY_SELECT;
}
if(PIN_getInputValue(Board_KEY_UP) == 0)
{
s_keysPressed |= KEY_UP;
}
if(PIN_getInputValue(Board_KEY_DOWN) == 0)
{
s_keysPressed |= KEY_DOWN;
}
if(PIN_getInputValue(Board_KEY_LEFT) == 0)
{
s_keysPressed |= KEY_LEFT;
}
if(PIN_getInputValue(Board_KEY_RIGHT) == 0)
{
s_keysPressed |= KEY_RIGHT;
}
// 調(diào)用按鍵應(yīng)用層處理函數(shù)
(*s_appKeyChangeHandler)(s_keysPressed);
}
}
/*********************************************************************
* PUBLIC FUNCTIONS
*/
/**
@brief 按鍵驅(qū)動的初始化函數(shù)
@param appKeyCB 按鍵回調(diào)函數(shù)
@return none
*/
void Board_initKeys(keysPressedCB_t appKeyCB)
{
// 初始化按鍵的IO
s_hKeyPins = PIN_open(&s_keyPins, s_keyPinsCfg);
// 注冊回調(diào)函數(shù)
PIN_registerIntCb(s_hKeyPins, board_keyCallback);
// 修改成雙沿中斷觸發(fā)，以避免睡眠之后中斷不靈
PIN_setConfig(s_hKeyPins, PIN_BM_IRQ, Board_KEY_SELECT | PIN_IRQ_BOTHEDGES); // PIN_IRQ_NEGEDGE
PIN_setConfig(s_hKeyPins, PIN_BM_IRQ, Board_KEY_UP | PIN_IRQ_BOTHEDGES);
PIN_setConfig(s_hKeyPins, PIN_BM_IRQ, Board_KEY_DOWN | PIN_IRQ_BOTHEDGES);
PIN_setConfig(s_hKeyPins, PIN_BM_IRQ, Board_KEY_LEFT | PIN_IRQ_BOTHEDGES);
PIN_setConfig(s_hKeyPins, PIN_BM_IRQ, Board_KEY_RIGHT | PIN_IRQ_BOTHEDGES);
// 低功耗下的配置
#ifdef POWER_SAVING
PIN_setConfig(s_hKeyPins, PINCC26XX_BM_WAKEUP, Board_KEY_SELECT | PINCC26XX_WAKEUP_NEGEDGE);
PIN_setConfig(s_hKeyPins, PINCC26XX_BM_WAKEUP, Board_KEY_UP | PINCC26XX_WAKEUP_NEGEDGE);
PIN_setConfig(s_hKeyPins, PINCC26XX_BM_WAKEUP, Board_KEY_DOWN | PINCC26XX_WAKEUP_NEGEDGE);
PIN_setConfig(s_hKeyPins, PINCC26XX_BM_WAKEUP, Board_KEY_LEFT | PINCC26XX_WAKEUP_NEGEDGE);
PIN_setConfig(s_hKeyPins, PINCC26XX_BM_WAKEUP, Board_KEY_RIGHT | PINCC26XX_WAKEUP_NEGEDGE);
#endif // POWER_SAVING
// 初始化按鍵定時(shí)事件
Util_constructClock(&s_keyChangeClock, board_keyChangeHandler,
KEY_DEBOUNCE_TIMEOUT, 0, false, 0);
// 保存應(yīng)用層的函數(shù)指針
s_appKeyChangeHandler = appKeyCB;
}
/*************************************END OF FILE*************************************/
2.2 board_key.h
#ifndef _BOARD_KEY_H_
#define _BOARD_KEY_H_
#ifdef __cplusplus
extern "C" {
#endif
/*********************************************************************
* DEFINITIONS
*/
// 鍵值
#define KEY_SELECT 0x0001
#define KEY_UP 0x0002
#define KEY_DOWN 0x0004
#define KEY_LEFT 0x0008
#define KEY_RIGHT 0x0010
#define Board_KEY_UP IOID_19
#define Board_KEY_DOWN IOID_12
#define Board_KEY_LEFT IOID_15
#define Board_KEY_RIGHT IOID_18
#define Board_KEY_SELECT IOID_11
// 超時(shí)時(shí)間
#define KEY_DEBOUNCE_TIMEOUT 20 // 200
/*********************************************************************
* TYPEDEFS
*/
typedef void (*keysPressedCB_t)(uint8_t keysPressed);
/*********************************************************************
* API FUNCTIONS
*/
void Board_initKeys(keysPressedCB_t appKeyCB);
#ifdef __cplusplus
}
#endif
#endif /* _BOARD_KEY_H_ */
三、API調(diào)用
需包含頭文件 board_key.h
Board_initKeys
| 功能 | 初始化按鍵引腳 |
|---|---|
| 函數(shù)定義 | void Board_initKeys(keysPressedCB_t appKeyCB) |
| 參數(shù) | 按鍵事件處理回調(diào)函數(shù) |
| 返回 | 無 |
四、使用例子
1）添加頭文件（例 multi_role.c 中）
#include "board_key.h"
2）添加初始化代碼（multi_role.c 的 multi_role_init 函數(shù)末尾中）
// 初始化按鍵
Board_initKeys(multi_role_keyChangeHandler);
3）添加按鍵改變產(chǎn)生按鍵事件函數(shù)
/**
@brief Key event handler function.
@param bit field for key events.
@return None.
*/
void multi_role_keyChangeHandler(uint8_t keys)
{
uint8_t *pData;
// Allocate space for the event data.
if ((pData = ICall_malloc(sizeof(uint8_t))))
{
// Store the key data
*pData = keys;
// Queue the event.
multi_role_enqueueMsg(MR_KEY_CHANGE_EVT, pData);
}
}
4）注冊按鍵事件（multi_role.c 的 multi_role_processAppMsg 函數(shù)中）
/**
@brief Process an incoming callback from a profile.
@param pMsg - message to process.
@return None.
*/
static void multi_role_processAppMsg(mrEvt_t *pMsg)
{
switch (pMsg->event)
{
/*------------------按鍵事件處理--------------------*/
case MR_KEY_CHANGE_EVT:
multi_role_handleKeys(*(pMsg->pData));
// Free the app data
ICall_free(pMsg->pData);
break;
default:
// Do nothing.
break;
}
}
5）添加按鍵處理函數(shù)
/**
@brief Handles all key events for this device.
@param keys - bit field for key events. Valid entries:
HAL_KEY_SW_2
HAL_KEY_SW_1
@return None.
*/
static void multi_role_handleKeys(uint8_t keys)
{
if (keys & KEY_LEFT)
{
// Check if the key is still pressed
if (PIN_getInputValue(Board_KEY_LEFT) == 0)
{
// 自定義處理
}
}
else if (keys & KEY_UP)
{
// Check if the key is still pressed
if (PIN_getInputValue(Board_KEY_UP) == 0)
{
// 自定義處理
}
}
}
6）編譯錯(cuò)誤
如果工程的Properties-->Build-->ARM Compiler-->Predefined Symbols開了CC2640R2DK_7ID的宏，產(chǎn)生如下錯(cuò)誤：
在blestack\boards\CC2640R2DK_7ID\Board.h中，把這幾行注釋掉
//#define Board_KEY_DOWN CC2650DK_7ID_KEY_DOWN
//#define Board_KEY_LEFT CC2650DK_7ID_KEY_LEFT
//#define Board_KEY_RIGHT CC2650DK_7ID_KEY_RIGHT
//#define Board_KEY_SELECT CC2650DK_7ID_KEY_SELECT
//#define Board_KEY_UP CC2650DK_7ID_KEY_UP
? 由 Leung 寫于 2019 年 1 月 22 日
