BLE_HID例程增加报表描述符使用
我们一般hid类设备都是键鼠设备居多，在此还是以CH582的Hid_keyboard程序为例，修改其中的hidkeyboardservice.c文件，
增加了：
全键盘、
多媒体键（如音量+，音量-，静音等）、
系统控制键（电脑休眠、电脑关机），由于蓝牙在部分电脑中休眠期间蓝牙驱动是关闭的，因此无法通过蓝牙唤醒电脑，
鼠标数据上传，
如下，大家自行参阅拷贝：
举例： 在下方hidReportMap中每个设备都会有一个ID号，比方说第一个报表为常规键盘（8字节数据），其ID号为1，调用HidDev_Report函数发送即可：
如果在调用HidDev_Report后发现数据返回值为非0，代表数据Notify通道未打开，参考这篇处理方法：BLE_HID类设备连接上主机后发数据返回错误码解决方法
void Hid_Keyboardreport(uint8_t keycode) { uint8_t HID_KeyboardBuf[8]={0}; HID_KeyboardBuf[0] = 0x00; HID_KeyboardBuf[1] = 0x00; HID_KeyboardBuf[2] = keycode&0xff; HID_KeyboardBuf[3] = 0x00; HID_KeyboardBuf[4] = 0x00; HID_KeyboardBuf[5] = 0x00; HID_KeyboardBuf[6] = 0x00; HID_KeyboardBuf[7] = 0x00; uint8_t i = HidDev_Report(HID_RPT_ID_KEY_IN, HID_REPORT_TYPE_INPUT,8, HID_KeyboardBuf);//这里HID_RPT_IN_KEY_IN填ID=1即可，HID_REPORT_TYPE_INPUT为输入到蓝牙方向，8为数据长度，HID_KeyboardBuf为要传入的数据；
printf("send status:0x%x\n",i);//返回数据传输状态，0为成功，非0为失败；
}
#define HID_NUM_REPORTS 10 // HID Report IDs for the service #define HID_RPT_ID_KEY_IN 1 // Keyboard input report ID #define HID_RPT_ID_MOUSE_IN 6 // Mouse input report ID #define HID_RPT_ID_LED_OUT 1 // LED output report ID #define HID_RPT_ID_FEATURE 1 // Feature report ID #define HID_RPT_ID_KEYBIT_IN 3 #define HID_RPT_ID_KEYCONSUME_IN 5 // Consumer input report ID #define HID_RPT_ID_HIDx_IN 2 #define HID_RPT_ID_SYS_IN 7 // HID feature flags #define HID_FEATURE_FLAGS HID_FLAGS_REMOTE_WAKE
/********************************** (C) COPYRIGHT ******************************* * File Name : hidkbdservice.c * Author : Z * Version : V1.0 * Date : 2023/10/13 * Description : 键盘服务 ********************************************************************************* /********************************************************************* * INCLUDES */ #include "CONFIG.h" #include "hidkbdservice.h" #include "hiddev.h" #include "battservice.h" /********************************************************************* * MACROS */ /********************************************************************* * CONSTANTS */ /********************************************************************* * TYPEDEFS */ /********************************************************************* * GLOBAL VARIABLES */ // HID service const uint8_t hidServUUID[ATT_BT_UUID_SIZE] = { LO_UINT16(HID_SERV_UUID), HI_UINT16(HID_SERV_UUID)}; // HID Boot Keyboard Input Report characteristic const uint8_t hidBootKeyInputUUID[ATT_BT_UUID_SIZE] = { LO_UINT16(BOOT_KEY_INPUT_UUID), HI_UINT16(BOOT_KEY_INPUT_UUID)}; // HID Boot Keyboard Output Report characteristic const uint8_t hidBootKeyOutputUUID[ATT_BT_UUID_SIZE] = { LO_UINT16(BOOT_KEY_OUTPUT_UUID), HI_UINT16(BOOT_KEY_OUTPUT_UUID)}; // HID Information characteristic const uint8_t hidInfoUUID[ATT_BT_UUID_SIZE] = { LO_UINT16(HID_INFORMATION_UUID), HI_UINT16(HID_INFORMATION_UUID)}; // HID Report Map characteristic const uint8_t hidReportMapUUID[ATT_BT_UUID_SIZE] = { LO_UINT16(REPORT_MAP_UUID), HI_UINT16(REPORT_MAP_UUID)}; // HID Control Point characteristic const uint8_t hidControlPointUUID[ATT_BT_UUID_SIZE] = { LO_UINT16(HID_CTRL_PT_UUID), HI_UINT16(HID_CTRL_PT_UUID)}; // HID Report characteristic const uint8_t hidReportUUID[ATT_BT_UUID_SIZE] = { LO_UINT16(REPORT_UUID), HI_UINT16(REPORT_UUID)}; // HID Protocol Mode characteristic const uint8_t hidProtocolModeUUID[ATT_BT_UUID_SIZE] = { LO_UINT16(PROTOCOL_MODE_UUID), HI_UINT16(PROTOCOL_MODE_UUID)}; /********************************************************************* * EXTERNAL VARIABLES */ /********************************************************************* * EXTERNAL FUNCTIONS */ /********************************************************************* * LOCAL VARIABLES */ // HID Information characteristic value static const uint8_t hidInfo[HID_INFORMATION_LEN] = { LO_UINT16(0x0111), HI_UINT16(0x0111), // bcdHID (USB HID version) 0x00, // bCountryCode HID_FEATURE_FLAGS // Flags }; // HID Report Map characteristic value static const uint8 hidReportMap[] = { /*************Normal Keyboard(8Bytes)***************/ 0x05, 0x01, // Usage Pg (Generic Desktop) 0x09, 0x06, // Usage (Keyboard) 0xA1, 0x01, // Collection: (Application) 0x85, 0x01, // ReportID (1) // 0x05, 0x07, // Usage Pg (Key Codes) 0x19, 0xE0, // Usage Min (224) 0x29, 0xE7, // Usage Max (231) 0x15, 0x00, // Log Min (0) 0x25, 0x01, // Log Max (1) // // Modifier byte 0x75, 0x01, // Report Size (1) 0x95, 0x08, // Report Count (8) 0x81, 0x02, // Input: (Data, Variable, Absolute) // // Reserved byte 0x95, 0x01, // Report Count (1) 0x75, 0x08, // Report Size (8) 0x81, 0x01, // Input: (Constant) // // LED report 0x95, 0x05, // Report Count (5) 0x75, 0x01, // Report Size (1) 0x05, 0x08, // Usage Pg (LEDs) 0x19, 0x01, // Usage Min (1) 0x29, 0x05, // Usage Max (5) 0x91, 0x02, // Output: (Data, Variable, Absolute) // // LED report padding 0x95, 0x01, // Report Count (1) 0x75, 0x03, // Report Size (3) 0x91, 0x01, // Output: (Constant) // // Key arrays (6 bytes) 0x95, 0x06, // Report Count (6) 0x75, 0x08, // Report Size (8) 0x15, 0x00, // Log Min (0) 0x25, 0x65, // Log Max (101) 0x05, 0x07, // Usage Pg (Key Codes) 0x19, 0x00, // Usage Min (0) 0x29, 0x65, // Usage Max (101) 0x81, 0x00, // Input: (Data, Array) // 0xC0 , // End Collection /***************** Bit Keyboard(15Bytes) **********************/ 0x05, 0x01, // Usage Pg () 0x09, 0x06, // Usage (Keyboard) 0xA1, 0x01, // Collection: (Application) 0x85, 0x03, // ReportID(3) 0x05, 0x07, // Usage Pg (Key Codes) 0x19, 0x04, // Usage Min 0x29, 0x70, // Usage Max 0x15, 0x00, // Log Min (0) 0x25, 0x01, // Log Max (1) // Modifier byte 0x75, 0x01, // Report Size (1) 0x95, 0x78, // Report Count 0x81, 0x02, // Input: (Data, Variable, Absolute) // 0xC0, // End Collection /********************* Consume Key ***************************/ 0x05,0x0C, //0 GLOBAL_USAGE_PAGE(Consumer) 0x09,0x01, //2 LOCAL_USAGE( Consumer Control ) 0xA1,0x01, //4 MAIN_COLLECTION(Applicatior) 0x85,0x05, //6 GLOBAL_REPORT_ID(5) 0x15,0x00, //8 GLOBAL_LOGICAL_MINIMUM(0) 0x26,0xFF,0x1F, //10 GLOBAL_LOCAL_MAXIMUM(8191/8191) 0x19,0x00, //13 LOCAL_USAGE_MINIMUM(0) 0x2A,0xFF,0x1F, //15 LOCAL_USAGE_MAXIMUM(8191) 0x75,0x10, //18 GLOBAL_REPORT_SIZE(16) 0x95,0x01, //20 GLOBAL_REPORT_COUNT(1) 0x81,0x00, //22 MAIN_INPUT(data array absolute NoWrap linear PreferredState NoNullPosition NonVolatile ) Input 2.0 0xC0, //24 MAIN_COLLECTION_END /********************* System Control Key ***************************/ 0x05, 0x01, 0x09, 0x80, 0xA1, 0x01, 0x85, 0x07, //report ID (7) 0x05, 0x01, 0x19, 0x81, 0x29, 0x83, 0x15, 0x00, 0x25, 0x01, 0x95, 0x03, 0x75, 0x01, 0x81, 0x02, 0x95, 0x01, 0x75, 0x05, 0x81, 0x01, 0xc0, /********************* Mouse ***************************/ 0x05,0x01, //0 GLOBAL_USAGE_PAGE(Generic Desktop Controls) 0x09,0x02, //2 LOCAL_USAGE(Mouse) 0xA1,0x01, //4 MAIN_COLLECTION(Applicatior) 0x85,0x06, //6 GLOBAL_REPORT_ID(6) 0x09,0x01, //8 LOCAL_USAGE(Pointer) 0xA1,0x00, //10 MAIN_COLLECTION(Physical) 0x05,0x09, //12 GLOBAL_USAGE_PAGE(Button) 0x19,0x01, //14 LOCAL_USAGE_MINIMUM(1) 0x29,0x03, //16 LOCAL_USAGE_MAXIMUM(3) 0x15,0x00, //18 GLOBAL_LOGICAL_MINIMUM(0) 0x25,0x01, //20 GLOBAL_LOCAL_MAXIMUM(1) 0x75,0x01, //22 GLOBAL_REPORT_SIZE(1) 0x95,0x08, //24 GLOBAL_REPORT_COUNT(8) 0x81,0x02, //26 MAIN_INPUT(data var absolute NoWrap linear PreferredState NoNullPosition NonVolatile ) Input 1.0 0x05,0x01, //28 GLOBAL_USAGE_PAGE(Generic Desktop Controls) 0x09,0x30, //30 LOCAL_USAGE(X) 0x09,0x31, //32 LOCAL_USAGE(Y) 0x09,0x38, //34 LOCAL_USAGE(Wheel) 0x15,0x81, //36 GLOBAL_LOGICAL_MINIMUM(-127) 0x25,0x7F, //38 GLOBAL_LOCAL_MAXIMUM(127) 0x75,0x08, //40 GLOBAL_REPORT_SIZE(8) 0x95,0x03, //42 GLOBAL_REPORT_COUNT(3) 0x81,0x06, //44 MAIN_INPUT(data var relative NoWrap linear PreferredState NoNullPosition NonVolatile ) Input 4.0 0xC0, //46 MAIN_COLLECTION_END /********************* END ***************************/ 0xC0, //47 MAIN_COLLECTION_END }; // HID report map length uint16 hidReportMapLen = sizeof(hidReportMap); //uint16 hidReportMapLen1 = sizeof(hidReportMap1); // HID report mapping table static hidRptMap_t hidRptMap[HID_NUM_REPORTS]; /********************************************************************* * Profile Attributes - variables */ // HID Service attribute static const gattAttrType_t hidService = { ATT_BT_UUID_SIZE, hidServUUID }; // Include attribute (Battery service) static uint16 include = GATT_INVALID_HANDLE; // HID Information characteristic static uint8 hidInfoProps = GATT_PROP_READ; // HID Report Map characteristic static uint8 hidReportMapProps = GATT_PROP_READ; // HID External Report Reference Descriptor static uint8 hidExtReportRefDesc[ATT_BT_UUID_SIZE] = { LO_UINT16(BATT_LEVEL_UUID), HI_UINT16(BATT_LEVEL_UUID) }; // HID Control Point characteristic static uint8 hidControlPointProps = GATT_PROP_WRITE_NO_RSP; static uint8 hidControlPoint; // HID Protocol Mode characteristic static uint8 hidProtocolModeProps = GATT_PROP_READ | GATT_PROP_WRITE_NO_RSP; uint8 hidProtocolMode = HID_PROTOCOL_MODE_REPORT; // HID Report characteristic, key input static uint8 hidReportKeyInProps = GATT_PROP_READ | GATT_PROP_NOTIFY; static uint8 hidReportKeyIn; static gattCharCfg_t hidReportKeyInClientCharCfg[GATT_MAX_NUM_CONN]; // HID Report Reference characteristic descriptor, key input static uint8 hidReportRefKeyIn[HID_REPORT_REF_LEN] = { HID_RPT_ID_KEY_IN, HID_REPORT_TYPE_INPUT }; // HID Report characteristic, HIDx input static uint8 hidReportHIDxInProps = GATT_PROP_READ | GATT_PROP_NOTIFY; static uint8 hidReportHIDxIn; static gattCharCfg_t hidReportHIDxInClientCharCfg[GATT_MAX_NUM_CONN]; // HID Report Reference characteristic descriptor, HIDx input static uint8 hidReportRefHIDxIn[HID_REPORT_REF_LEN] = { HID_RPT_ID_HIDx_IN, HID_REPORT_TYPE_INPUT }; // HID Report characteristic, KEYbit input static uint8 hidReportkeybitInProps = GATT_PROP_READ | GATT_PROP_NOTIFY; static uint8 hidReportkeybitIn; static gattCharCfg_t hidReportkeybitInClientCharCfg[GATT_MAX_NUM_CONN]; // HID Report Reference characteristic descriptor, keybit input static uint8 hidReportRefkeybitIn[HID_REPORT_REF_LEN] = { HID_RPT_ID_KEYBIT_IN, HID_REPORT_TYPE_INPUT }; // HID Report characteristic, KEYConsume input static uint8 hidReportkeyConsumeInProps = GATT_PROP_READ | GATT_PROP_NOTIFY; static uint8 hidReportkeyConsumeIn; gattCharCfg_t hidReportkeyConsumeInClientCharCfg[GATT_MAX_NUM_CONN]; // HID Report Reference characteristic descriptor, keyConsume input static uint8 hidReportRefkeyConsumeIn[HID_REPORT_REF_LEN] = { HID_RPT_ID_KEYCONSUME_IN, HID_REPORT_TYPE_INPUT }; // HID Report characteristic, KEYsys input static uint8 hidReportkeysysInProps = GATT_PROP_READ | GATT_PROP_NOTIFY; static uint8 hidReportkeysysIn; static gattCharCfg_t hidReportkeysysInClientCharCfg[GATT_MAX_NUM_CONN]; // HID Report Reference characteristic descriptor, keysys input static uint8 hidReportRefkeysysIn[HID_REPORT_REF_LEN] = { HID_RPT_ID_SYS_IN, HID_REPORT_TYPE_INPUT }; // HID Report characteristic, mouse input static uint8 hidReportmouseInProps = GATT_PROP_READ | GATT_PROP_NOTIFY; static uint8 hidReportmoouseIn; static gattCharCfg_t hidReportmouseInClientCharCfg[GATT_MAX_NUM_CONN]; // HID Report Reference characteristic descriptor, keysys input static uint8 hidReportRefmouseIn[HID_REPORT_REF_LEN] = { HID_RPT_ID_MOUSE_IN, HID_REPORT_TYPE_INPUT }; // HID Report characteristic, LED output static uint8 hidReportLedOutProps = GATT_PROP_READ | GATT_PROP_WRITE | GATT_PROP_WRITE_NO_RSP; static uint8 hidReportLedOut; // HID Report Reference characteristic descriptor, LED output static uint8 hidReportRefLedOut[HID_REPORT_REF_LEN] = { HID_RPT_ID_LED_OUT, HID_REPORT_TYPE_OUTPUT }; // HID Boot Keyboard Input Report static uint8 hidReportBootKeyInProps = GATT_PROP_READ | GATT_PROP_NOTIFY; static uint8 hidReportBootKeyIn; static gattCharCfg_t hidReportBootKeyInClientCharCfg[GATT_MAX_NUM_CONN]; // HID Boot Keyboard Output Report static uint8 hidReportBootKeyOutProps = GATT_PROP_READ | GATT_PROP_WRITE | GATT_PROP_WRITE_NO_RSP; static uint8 hidReportBootKeyOut; // Feature Report static uint8 hidReportFeatureProps = GATT_PROP_READ | GATT_PROP_WRITE; static uint8 hidReportFeature; // HID Report Reference characteristic descriptor, Feature static uint8 hidReportRefFeature[HID_REPORT_REF_LEN] = { HID_RPT_ID_FEATURE, HID_REPORT_TYPE_FEATURE }; /********************************************************************* * Profile Attributes - Table */ static gattAttribute_t hidAttrTbl[] = { // HID Service { { ATT_BT_UUID_SIZE, primaryServiceUUID }, /* type */ GATT_PERMIT_READ, /* permissions */ 0, /* handle */ (uint8 *) &hidService /* pValue */ }, // Included service (battery) { { ATT_BT_UUID_SIZE, includeUUID }, GATT_PERMIT_READ, 0, (uint8 *)&include }, // HID Information characteristic declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidInfoProps }, // HID Information characteristic { { ATT_BT_UUID_SIZE, hidInfoUUID }, GATT_PERMIT_ENCRYPT_READ, 0, (uint8 *) hidInfo }, // HID Control Point characteristic declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidControlPointProps }, // HID Control Point characteristic { { ATT_BT_UUID_SIZE, hidControlPointUUID }, GATT_PERMIT_ENCRYPT_WRITE, 0, &hidControlPoint }, // HID Protocol Mode characteristic declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidProtocolModeProps }, // HID Protocol Mode characteristic { { ATT_BT_UUID_SIZE, hidProtocolModeUUID }, GATT_PERMIT_ENCRYPT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, &hidProtocolMode }, // HID Report Map characteristic declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportMapProps }, // HID Report Map characteristic { { ATT_BT_UUID_SIZE, hidReportMapUUID }, GATT_PERMIT_ENCRYPT_READ, 0, (uint8 *) hidReportMap }, // HID External Report Reference Descriptor { { ATT_BT_UUID_SIZE, extReportRefUUID }, GATT_PERMIT_READ, 0, hidExtReportRefDesc }, /****************** hid key **************************/ // HID Report characteristic, key input declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportKeyInProps }, // HID Report characteristic, key input { { ATT_BT_UUID_SIZE, hidReportUUID }, GATT_PERMIT_ENCRYPT_READ, 0, &hidReportKeyIn }, // HID Report characteristic client characteristic configuration { { ATT_BT_UUID_SIZE, clientCharCfgUUID }, GATT_PERMIT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, (uint8 *) &hidReportKeyInClientCharCfg }, // HID Report Reference characteristic descriptor, key input { { ATT_BT_UUID_SIZE, reportRefUUID }, GATT_PERMIT_READ, 0, hidReportRefKeyIn }, /****************** hid HIDx **************************/ // HID Report characteristic, HIDx input declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportHIDxInProps }, // HID Report characteristic, Consumer input { { ATT_BT_UUID_SIZE, hidReportUUID }, GATT_PERMIT_ENCRYPT_READ, 0, &hidReportHIDxIn }, // HID Report characteristic client characteristic configuration { { ATT_BT_UUID_SIZE, clientCharCfgUUID }, GATT_PERMIT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, (uint8 *) &hidReportHIDxInClientCharCfg }, // HID Report Reference characteristic descriptor, Consumer input { { ATT_BT_UUID_SIZE, reportRefUUID }, GATT_PERMIT_READ, 0, hidReportRefHIDxIn }, /****************** hid bit **************************/ { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportkeybitInProps }, // HID Report characteristic, bit input { { ATT_BT_UUID_SIZE, hidReportUUID }, GATT_PERMIT_ENCRYPT_READ, 0, &hidReportkeybitIn }, // HID Report characteristic client characteristic configuration { { ATT_BT_UUID_SIZE, clientCharCfgUUID }, GATT_PERMIT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, (uint8 *) &hidReportkeybitInClientCharCfg }, // HID Report Reference characteristic descriptor, bit input { { ATT_BT_UUID_SIZE, reportRefUUID }, GATT_PERMIT_READ, 0, hidReportRefkeybitIn }, /****************** hid consume **************************/ { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportkeyConsumeInProps }, // HID Report characteristic, Consumer input { { ATT_BT_UUID_SIZE, hidReportUUID }, GATT_PERMIT_ENCRYPT_READ, 0, &hidReportkeyConsumeIn }, // HID Report characteristic client characteristic configuration { { ATT_BT_UUID_SIZE, clientCharCfgUUID }, GATT_PERMIT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, (uint8 *) &hidReportkeyConsumeInClientCharCfg }, // HID Report Reference characteristic descriptor, Consumer input { { ATT_BT_UUID_SIZE, reportRefUUID }, GATT_PERMIT_READ, 0, hidReportRefkeyConsumeIn }, /****************** hid sys **************************/ { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportkeysysInProps }, // HID Report characteristic, Consumer input { { ATT_BT_UUID_SIZE, hidReportUUID }, GATT_PERMIT_ENCRYPT_READ, 0, &hidReportkeysysIn }, // HID Report characteristic client characteristic configuration { { ATT_BT_UUID_SIZE, clientCharCfgUUID }, GATT_PERMIT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, (uint8 *) &hidReportkeysysInClientCharCfg }, // HID Report Reference characteristic descriptor, Consumer input { { ATT_BT_UUID_SIZE, reportRefUUID }, GATT_PERMIT_READ, 0, hidReportRefkeysysIn }, /****************** hid mouse **************************/ { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportmouseInProps }, // HID Report characteristic, Consumer input { { ATT_BT_UUID_SIZE, hidReportUUID }, GATT_PERMIT_ENCRYPT_READ, 0, &hidReportmoouseIn }, // HID Report characteristic client characteristic configuration { { ATT_BT_UUID_SIZE, clientCharCfgUUID }, GATT_PERMIT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, (uint8 *) &hidReportmouseInClientCharCfg }, // HID Report Reference characteristic descriptor, Consumer input { { ATT_BT_UUID_SIZE, reportRefUUID }, GATT_PERMIT_READ, 0, hidReportRefmouseIn }, /***************************led*********************************/ // HID Report characteristic, LED output declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportLedOutProps }, // HID Report characteristic, LED output { { ATT_BT_UUID_SIZE, hidReportUUID }, GATT_PERMIT_ENCRYPT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, &hidReportLedOut }, // HID Report Reference characteristic descriptor, LED output { { ATT_BT_UUID_SIZE, reportRefUUID }, GATT_PERMIT_READ, 0, hidReportRefLedOut }, /**********************boot key*******************************/ // HID Boot Keyboard Input Report declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportBootKeyInProps }, // HID Boot Keyboard Input Report { { ATT_BT_UUID_SIZE, hidBootKeyInputUUID }, GATT_PERMIT_ENCRYPT_READ, 0, &hidReportBootKeyIn }, // HID Boot Keyboard Input Report characteristic client characteristic configuration { { ATT_BT_UUID_SIZE, clientCharCfgUUID }, GATT_PERMIT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, (uint8 *) &hidReportBootKeyInClientCharCfg }, // HID Boot Keyboard Output Report declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportBootKeyOutProps }, // HID Boot Keyboard Output Report { { ATT_BT_UUID_SIZE, hidBootKeyOutputUUID }, GATT_PERMIT_ENCRYPT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, &hidReportBootKeyOut }, /**************************feature*******************************/ // Feature Report declaration { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &hidReportFeatureProps }, // Feature Report { { ATT_BT_UUID_SIZE, hidReportUUID}, GATT_PERMIT_ENCRYPT_READ | GATT_PERMIT_ENCRYPT_WRITE, 0, &hidReportFeature }, // HID Report Reference characteristic descriptor, feature { { ATT_BT_UUID_SIZE, reportRefUUID }, GATT_PERMIT_READ, 0, hidReportRefFeature }, }; // Attribute index enumeration-- these indexes match array elements above enum { HID_SERVICE_IDX, // HID Service HID_INCLUDED_SERVICE_IDX, // Included Service HID_INFO_DECL_IDX, // HID Information characteristic declaration HID_INFO_IDX, // HID Information characteristic HID_CONTROL_POINT_DECL_IDX, // HID Control Point characteristic declaration HID_CONTROL_POINT_IDX, // HID Control Point characteristic HID_PROTOCOL_MODE_DECL_IDX, // HID Protocol Mode characteristic declaration HID_PROTOCOL_MODE_IDX, // HID Protocol Mode characteristic HID_REPORT_MAP_DECL_IDX, // HID Report Map characteristic declaration HID_REPORT_MAP_IDX, // HID Report Map characteristic HID_EXT_REPORT_REF_DESC_IDX, // HID External Report Reference Descriptor HID_REPORT_KEY_IN_DECL_IDX, // HID Report characteristic, key input declaration HID_REPORT_KEY_IN_IDX, // HID Report characteristic, key input HID_REPORT_KEY_IN_CCCD_IDX, // HID Report characteristic client characteristic configuration HID_REPORT_REF_KEY_IN_IDX, // HID Report Reference characteristic descriptor, key input HID_REPORT_HIDx_IN_DECL_IDX, // HID Report characteristic, key input declaration HID_REPORT_HIDx_IN_IDX, // HID Report characteristic, key input HID_REPORT_HIDx_IN_CCCD_IDX, // HID Report characteristic client characteristic configuration HID_REPORT_REF_HIDx_IN_IDX, // HID Report Reference characteristic descriptor, key input HID_REPORT_KEYBIT_IN_DECL_IDX, // HID Report characteristic, key input declaration HID_REPORT_KEYBIT_IN_IDX, // HID Report characteristic, key input HID_REPORT_KEYBIT_IN_CCCD_IDX, // HID Report characteristic client characteristic configuration HID_REPORT_REF_Keybit_IN_IDX, // HID Report Reference characteristic descriptor, key input HID_REPORT_CONSUME_IN_DECL_IDX, // HID Report characteristic, key input declaration HID_REPORT_CONSUME_IN_IDX, // HID Report characteristic, key input HID_REPORT_CONSUME_IN_CCCD_IDX, // HID Report characteristic client characteristic configuration HID_REPORT_REF_Consume_IN_IDX, // HID Report Reference characteristic descriptor, key input HID_REPORT_SYS_IN_DECL_IDX, // HID Report characteristic, key input declaration HID_REPORT_SYS_IN_IDX, // HID Report characteristic, key input HID_REPORT_SYS_IN_CCCD_IDX, // HID Report characteristic client characteristic configuration HID_REPORT_REF_Sys_IN_IDX, // HID Report Reference characteristic descriptor, key input HID_REPORT_MOUSE_IN_DECL_IDX, // HID Report characteristic, MOUSE input declaration HID_REPORT_MOUSE_IN_IDX, // HID Report characteristic, MOUSE input HID_REPORT_MOUSE_IN_CCCD_IDX, // HID Report characteristic client characteristic configuration HID_REPORT_REF_MOUSE_IN_IDX, // HID Report Reference characteristic descriptor, MOUSE input HID_REPORT_LED_OUT_DECL_IDX, // HID Report characteristic, LED output declaration HID_REPORT_LED_OUT_IDX, // HID Report characteristic, LED output HID_REPORT_REF_LED_OUT_IDX, // HID Report Reference characteristic descriptor, LED output HID_BOOT_KEY_IN_DECL_IDX, // HID Boot Keyboard Input Report declaration HID_BOOT_KEY_IN_IDX, // HID Boot Keyboard Input Report HID_BOOT_KEY_IN_CCCD_IDX, // HID Boot Keyboard Input Report characteristic client characteristic configuration HID_BOOT_KEY_OUT_DECL_IDX, // HID Boot Keyboard Output Report declaration HID_BOOT_KEY_OUT_IDX, // HID Boot Keyboard Output Report HID_FEATURE_DECL_IDX, // Feature Report declaration HID_FEATURE_IDX, // Feature Report HID_REPORT_REF_FEATURE_IDX // HID Report Reference characteristic descriptor, feature }; /********************************************************************* * LOCAL FUNCTIONS */ /********************************************************************* * PROFILE CALLBACKS */ // Service Callbacks gattServiceCBs_t hidKbdCBs = { HidDev_ReadAttrCB, // Read callback function pointer HidDev_WriteAttrCB, // Write callback function pointer NULL // Authorization callback function pointer }; /********************************************************************* * PUBLIC FUNCTIONS */ /********************************************************************* * @fn Hid_AddService * * @brief Initializes the HID Service by registering * GATT attributes with the GATT server. * * @return Success or Failure */ bStatus_t Hid_AddService( void ) { uint8 status = SUCCESS; // Initialize Client Characteristic Configuration attributes GATTServApp_InitCharCfg( INVALID_CONNHANDLE, hidReportKeyInClientCharCfg ); GATTServApp_InitCharCfg( INVALID_CONNHANDLE, hidReportHIDxInClientCharCfg ); GATTServApp_InitCharCfg( INVALID_CONNHANDLE, hidReportkeybitInClientCharCfg ); GATTServApp_InitCharCfg( INVALID_CONNHANDLE, hidReportkeyConsumeInClientCharCfg ); GATTServApp_InitCharCfg( INVALID_CONNHANDLE, hidReportBootKeyInClientCharCfg ); GATTServApp_InitCharCfg( INVALID_CONNHANDLE, hidReportkeysysInClientCharCfg ); GATTServApp_InitCharCfg( INVALID_CONNHANDLE, hidReportmouseInClientCharCfg ); // Register GATT attribute list and CBs with GATT Server App status = GATTServApp_RegisterService( hidAttrTbl, GATT_NUM_ATTRS( hidAttrTbl ),GATT_MAX_ENCRYPT_KEY_SIZE, &hidKbdCBs ); // Set up included service Batt_GetParameter( BATT_PARAM_SERVICE_HANDLE, &GATT_INCLUDED_HANDLE( hidAttrTbl, HID_INCLUDED_SERVICE_IDX ) ); // Construct map of reports to characteristic handles // Each report is uniquely identified via its ID and type uint8_t i = 0; // Consume input report hidRptMap[i].id = hidReportRefkeyConsumeIn[0]; hidRptMap[i].type = hidReportRefkeyConsumeIn[1]; hidRptMap[i].handle = hidAttrTbl[HID_REPORT_CONSUME_IN_IDX].handle; hidRptMap[i].cccdHandle = hidAttrTbl[HID_REPORT_CONSUME_IN_CCCD_IDX].handle; hidRptMap[i].mode = HID_PROTOCOL_MODE_REPORT; i++; // Key input report hidRptMap[i].id = hidReportRefKeyIn[0]; hidRptMap[i].type = hidReportRefKeyIn[1]; hidRptMap[i].handle = hidAttrTbl[HID_REPORT_KEY_IN_IDX].handle; hidRptMap[i].cccdHandle = hidAttrTbl[HID_REPORT_KEY_IN_CCCD_IDX].handle; hidRptMap[i].mode = HID_PROTOCOL_MODE_REPORT; i++; // HIDx input report hidRptMap[i].id = hidReportRefHIDxIn[0]; hidRptMap[i].type = hidReportRefHIDxIn[1]; hidRptMap[i].handle = hidAttrTbl[HID_REPORT_HIDx_IN_IDX].handle; hidRptMap[i].cccdHandle = hidAttrTbl[HID_REPORT_HIDx_IN_CCCD_IDX].handle; hidRptMap[i].mode = HID_PROTOCOL_MODE_REPORT; i++; // bit input report hidRptMap[i].id = hidReportRefkeybitIn[0]; hidRptMap[i].type = hidReportRefkeybitIn[1]; hidRptMap[i].handle = hidAttrTbl[HID_REPORT_KEYBIT_IN_IDX].handle; hidRptMap[i].cccdHandle = hidAttrTbl[HID_REPORT_KEYBIT_IN_CCCD_IDX].handle; hidRptMap[i].mode = HID_PROTOCOL_MODE_REPORT; i++; // Sys input report hidRptMap[i].id = hidReportRefkeysysIn[0]; hidRptMap[i].type = hidReportRefkeysysIn[1]; hidRptMap[i].handle = hidAttrTbl[HID_REPORT_SYS_IN_IDX].handle; hidRptMap[i].cccdHandle = hidAttrTbl[HID_REPORT_SYS_IN_CCCD_IDX].handle; hidRptMap[i].mode = HID_PROTOCOL_MODE_REPORT; i++; // MOUSE input report hidRptMap[i].id = hidReportRefmouseIn[0]; hidRptMap[i].type = hidReportRefmouseIn[1]; hidRptMap[i].handle = hidAttrTbl[HID_REPORT_MOUSE_IN_IDX].handle; hidRptMap[i].cccdHandle = hidAttrTbl[HID_REPORT_MOUSE_IN_CCCD_IDX].handle; hidRptMap[i].mode = HID_PROTOCOL_MODE_REPORT; i++; // LED output report hidRptMap[i].id = hidReportRefLedOut[0]; hidRptMap[i].type = hidReportRefLedOut[1]; hidRptMap[i].handle = hidAttrTbl[HID_REPORT_LED_OUT_IDX].handle; hidRptMap[i].cccdHandle = 0; hidRptMap[i].mode = HID_PROTOCOL_MODE_REPORT; i++; // Boot keyboard input report // Use same ID and type as key input report hidRptMap[i].id = hidReportRefKeyIn[0]; hidRptMap[i].type = hidReportRefKeyIn[1]; hidRptMap[i].handle = hidAttrTbl[HID_BOOT_KEY_IN_IDX].handle; hidRptMap[i].cccdHandle = hidAttrTbl[HID_BOOT_KEY_IN_CCCD_IDX].handle; hidRptMap[i].mode = HID_PROTOCOL_MODE_BOOT; i++; // Boot keyboard output report // Use same ID and type as LED output report hidRptMap[i].id = hidReportRefLedOut[0]; hidRptMap[i].type = hidReportRefLedOut[1]; hidRptMap[i].handle = hidAttrTbl[HID_BOOT_KEY_OUT_IDX].handle; hidRptMap[i].cccdHandle = 0; hidRptMap[i].mode = HID_PROTOCOL_MODE_BOOT; i++; // Feature report hidRptMap[i].id = hidReportRefFeature[0]; hidRptMap[i].type = hidReportRefFeature[1]; hidRptMap[i].handle = hidAttrTbl[HID_FEATURE_IDX].handle; hidRptMap[i].cccdHandle = 0; hidRptMap[i].mode = HID_PROTOCOL_MODE_REPORT; i++; // Battery level input report Batt_GetParameter( BATT_PARAM_BATT_LEVEL_IN_REPORT, &(hidRptMap[i]) ); // Setup report ID map HidDev_RegisterReports( HID_NUM_REPORTS, hidRptMap ); return ( status ); } /********************************************************************* * @fn Hid_SetParameter * * @brief Set a HID Kbd parameter. * * @param id - HID report ID. * @param type - HID report type. * @param uuid - attribute uuid. * @param len - length of data to right. * @param pValue - pointer to data to write. This is dependent on * the input parameters and WILL be cast to the appropriate * data type (example: data type of uint16_t will be cast to * uint16_t pointer). * * @return GATT status code. */ uint8 Hid_SetParameter( uint8 id, uint8 type, uint16 uuid, uint8 len, void *pValue ) { bStatus_t ret = SUCCESS; switch ( uuid ) { case REPORT_UUID: if ( type == HID_REPORT_TYPE_OUTPUT ) { if ( len == 1 ) { hidReportLedOut = *((uint8 *)pValue); } else { ret = ATT_ERR_INVALID_VALUE_SIZE; } } else if ( type == HID_REPORT_TYPE_FEATURE ) { if ( len == 1 ) { hidReportFeature = *((uint8 *)pValue); } else { ret = ATT_ERR_INVALID_VALUE_SIZE; } } else { ret = ATT_ERR_ATTR_NOT_FOUND; } break; case BOOT_KEY_OUTPUT_UUID: if ( len == 1 ) { hidReportBootKeyOut = *((uint8 *)pValue); } else { ret = ATT_ERR_INVALID_VALUE_SIZE; } break; default: // ignore the request break; } return ( ret ); } /********************************************************************* * @fn Hid_GetParameter * * @brief Get a HID Kbd parameter. * * @param id - HID report ID. * @param type - HID report type. * @param uuid - attribute uuid. * @param pLen - length of data to be read * @param pValue - pointer to data to get. This is dependent on * the input parameters and WILL be cast to the appropriate * data type (example: data type of uint16_t will be cast to * uint16_t pointer). * * @return GATT status code. */ uint8 Hid_GetParameter( uint8 id, uint8 type, uint16 uuid, uint16 *pLen, void *pValue ) { switch ( uuid ) { case REPORT_UUID: if ( type == HID_REPORT_TYPE_OUTPUT ) { *((uint8 *)pValue) = hidReportLedOut; *pLen = 1; } else if ( type == HID_REPORT_TYPE_FEATURE ) { *((uint8 *)pValue) = hidReportFeature; *pLen = 1; } else { *pLen = 0; } break; case BOOT_KEY_OUTPUT_UUID: *((uint8 *)pValue) = hidReportBootKeyOut; *pLen = 1; break; default: *pLen = 0; break; } return ( SUCCESS ); }/********************************************************************* *********************************************************************/
