【CC2640R2F】香瓜CC2640R2F之自定义服务
本文最后修改时间：2017年11月15日 20:00
一、本节简介
本节以simple_peripheral工程为例，介绍如何添加自定义服务。
二、实验平台
1）CC2640R2F平台
①协议栈版本：CC2640R2 SDK v1.40.00.45
②编译软件：CCS7.3.0.00019
③硬件平台：香瓜CC2640R2F开发板
④仿真器：香瓜XDS100V3下载器
2）手机平台
①手机型号：红米1S
②安卓版本：安卓4.3
③安卓app：BLE Reader
三、版权声明
1）作者：甜甜的大香瓜
2）声明：喝水不忘挖井人，转载请注明出处。
3）纠错/业务合作：[email protected]
4）香瓜BLE之CC2640R2F群：557278427
5）本文出处：原创连载资料《简单粗暴学蓝牙5》
6）完整开源资料下载地址（电脑端打开）：
https://shop217632629.taobao.com/?spm=2013.1.1000126.d21.hd2o8i
7）香瓜CC2640R2F开发板购买链接：
https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w4023-16963296339.8.21bfc58419sWKt&id=558653143169
8）香瓜XDS100V3下载器购买链接：
https://item.taobao.com/item.htm?spm=a230r.1.14.1.1d150040zvJBco&id=558356989143&ns=1&abbucket=6#detail
四、实验前提
1、在进行本文步骤前，请先阅读以下章节：
1）《简单粗暴学蓝牙5》的“第一章至第四章”章节。
2、在进行本文步骤前，请先实现以下章节：
1）《简单粗暴学蓝牙5》的“第三章 软件的安装及使用”章节。
五、基础知识
1、服务、特征值、UUID、句柄是什么？
答：
1）服务（server）
一个工程可以有多个服务，比如按键服务、心率计服务、温度计服务。
2）特征值（characteristic ）
一个服务可以有多个特征值，特征值是主从机传输数据的媒介，像运人渡河的小船。
3）UUID（通用唯一识别码/Universally Unique Identifier）
UUID 类似于服务、特征值的“身份证号码”，具有唯一性。
完整的UUID有128bit（16字节）的大小，而CC2640R2F的协议栈默认使用的UUID是简写版16bit（2字节）的UUID，如下文添加的香瓜服务的UUID为“0xFFFE”，实际上它最终会被填充为128bit（16字节）的UUID进行数据通信。
4）句柄（handle）
句柄类似于“学生的学号”，它是每次设备上电后蓝牙协议栈分配的一个号码，注意不要把它当做定值。最常见的是连接句柄（连接后分配的句柄，例如第一台连接上的设备连接句柄可能为0x0000、第二台连接上的设备连接句柄可能为0x0001）、特征值句柄（设备上电后每个特征值都有个句柄，例如某服务的特征值1句柄可能为0x0025、特征值4句柄可能为0x002e）。
举个例子，假设香瓜的蓝牙设备中有2个服务，温湿度服务（假设UUID为0x1110）和电量服务（假设UUID为0x2220）。
其中温湿度服务中包含了温度特征值（假设UUID为0x1111）、湿度特征值（假设UUID为0x1112）。
此时你想用另一个CC2640R2F作为主机读取温度值，那么CC2640R2F主机会做如下事情：
1）连接设备：扫描并连接香瓜的蓝牙设备。
2）发现服务：查找设备的服务中是否包含UUID为0x1110的服务（温湿度服务）。
3）发现特征值：查找UUID为0x1110的服务（温湿度服务）中是否包含UUID为0x1111的特征值（温度特征值）。
4）获得特征值句柄：查找到温度特征值后，获取问读特征值句柄，假设为0x0038。
5）利用句柄来读取温度值：使用0x0038的句柄发送读指令，则此时CC2640R2F主机可读取到CC2640R2F从机中的温度值。
2、simple_peripheral工程有哪些服务？
答：
在PROFILES文件夹下的文件，均属于服务。例如设备信息服务（包含设备基本信息）、从机服务（作为从机所需的服务，主机工程则有主机服务）等。
其中工程师要关心的是“simple_gatt_profile”服务，这个服务是用于蓝牙的数据通信的服务。
在此服务中，包含了5个不同类型的特征值。工程师可在此基础上增、删、减、改特征值。
3、为什么要添加自定义服务？
答：
1）新服务可以完全独立于项目中，不影响工程中已有服务。
2）添加新服务后的灵活性很高，你可以把它作为气压采集服务，也可以把它作为温度采集服务。
3）香瓜在此自定义服务中添加了一个可读、可写、可通知的特征值通道，直接给工程师一个最实用的特征值通道，简单易添加。
4）原有的“simple_gatt_profile”服务中的5个特征值往往在实际项目中难以全都用上，造成了资源占用的浪费。有了香瓜自定义服务后，可删除原有的无用服务，而不用在原服务中一个一个地删除无用特征值。
5）方便其他开发人员阅读你的代码，开发人员只需要关注你新写的服务，而不用到各个服务去查找你改动过的地方。
4、特征值的读、写、notify属性有什么区别？
答：读、写、notify属性是特征值中最常用的属性。
特征值是一个变量或者一个数组，它被定义在server端，它是client端与server端之间传输数据的缓冲区。
比如添加一个char6[20]，它的值初始化为1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、16、17、18、19、20。
当char6具有读、写属性时，client端可以通过GATT_ReadCharValue、GATT_WriteCharValue进行读、写server端的char6。
当char6具有notify通知属性时，server端可以主动将char6的值通知给client机。
5、简介notify通知的两种方式
答：
1）GATT_Notification
在从机代码中使用，由从机主动通知，且不需要主机发出请求和回应。
2）GATTServApp_ProcessCharCfg
在从机代码中使用，需要主机发送一次“通知请求”给从机，从机收到“通知请求”才发送通知。
注：实际上这个函数里依然会调用GATT_Notification这个函数。
6、什么是CCC？
答：
Client Characteristic Configuration，俗称CCC。
notify属性的特征值，会多读、写属性的特征值多一个CCC。
从机要想使用notify函数时能正常发送出数据，就必须保证CCC是被打开的。
7、CCC如何打开？
答：notify开关可由主机端或者从机端打开，但应尽量保证由主机来打开比较合适，毕竟它是“主机”，“主机“就该有主动权。
1）主机端打开（推荐）
先获取到CCC的特征值句柄，然后利用CCC的特征值句柄往CCC的特征值中写入0x0001。
2）从机端打开（不推荐）
GATTServApp_WriteCharCfg(connHandle, simpleProfileChar4Config, 0x0001);8、如何获取CCC的句柄？
答：先获取到这个CCC所属的特征值的特征值句柄，然后将该特征值句柄+1。
例如，想要获取到char6的CCC的句柄，就必须先获取到char6的特征值句柄，假设获取到的值是0x0035，则CCC的特征值句柄就是0x0036。之所以加1，是因为char6的CCC所在属性表的位置，正好在char6的特征值后面。
9、是否可以直接在主机代码中使用0x0036当做char6的CCC句柄？
答：可以，但是不推荐。
由于句柄是协议栈自动分配的，代码编译好之后，特征值句柄是固定的。但是一旦你在char6之前添加了一个特征值，那么char6的CCC句柄也会往后推算，这时候你的0x0036显然就没用了。
因此强烈推荐下文中使用的方法，自动获取句柄，详情自己看代码。
10、属性表是什么？
答：它是一个服务中的数组，用来存放该服务下的服务信息、所有特征值信息。每个特征值一般为3个参数，而notify属性的特征值一般为4个参数（多一个notify开关的参数）。
六、硬件原理
暂无
七、实验步骤
1、编写并添加自定义的服务
1）写一个自定义的服务源文件GUA_Profile.c（存放在“……\simplelink_cc2640r2_sdk_1_40_00_45\examples\rtos\CC2640R2_LAUNCHXL\ble5stack\simple_peripheral\src\app\GUA”路径下）
//**********************************************************************
//name: GUA_profile.c
//introduce: 香瓜自定义的服务，内含一个可读、可写、可通知的特征值
//author: 甜甜的大香瓜
//email: [email protected]
//QQ group: 香瓜BLE之CC2640R2F(557278427)
//shop:
//https://shop217632629.taobao.com/?spm=2013.1.1000126.d21.hd2o8i
//changetime: 2017.11.06
//**********************************************************************
#include
#include "bcomdef.h"
#include "OSAL.h"
#include "linkdb.h"
#include "att.h"
#include "gatt.h"
#include "gatt_uuid.h"
#include "gattservapp.h"
#include "gapbondmgr.h"
#include "GUA_Profile.h"
/*********************************************************************
* MACROS
*/
/*********************************************************************
* CONSTANTS
*/
//属性表的数据长度
#define SERVAPP_NUM_ATTR_SUPPORTED 5
//属性在属性表中的偏移值
#define ATTRTBL_GUA_CHAR1_IDX 2 //char1在属性表的偏移值
#define ATTRTBL_GUA_CHAR1_CCC_IDX 3 //char1的notify开关在属性表的偏移值
/*********************************************************************
* TYPEDEFS
*/
/*********************************************************************
* GLOBAL VARIABLES
*/
// GUA Service UUID: 0xFFE0
CONST uint8 GUAServUUID[ATT_BT_UUID_SIZE] =
{
LO_UINT16(GUAPROFILE_SERV_UUID), HI_UINT16(GUAPROFILE_SERV_UUID)
};
// GUA char1 UUID: 0xFFE1
CONST uint8 GUAChar1UUID[ATT_BT_UUID_SIZE] =
{
LO_UINT16(GUAPROFILE_CHAR1_UUID), HI_UINT16(GUAPROFILE_CHAR1_UUID)
};
/*********************************************************************
* EXTERNAL VARIABLES
*/
/*********************************************************************
* EXTERNAL FUNCTIONS
*/
/*********************************************************************
* LOCAL VARIABLES
*/
static GUAProfileCBs_t *GUAProfile_AppCBs = NULL;
/*********************************************************************
* Profile Attributes - variables
*/
// GUA Service attribute
static CONST gattAttrType_t GUAProfile_Service = { ATT_BT_UUID_SIZE, GUAServUUID };
// GUA Characteristic 1 Properties
static uint8 GUAProfile_Char1_Props = GATT_PROP_READ | GATT_PROP_WRITE | GATT_PROP_NOTIFY;
// GUA Characteristic 1 Value
static uint8 GUAProfile_Char1[GUAPROFILE_CHAR1_LEN] = {0};
// GUA Characteristic 1 Configs
static gattCharCfg_t *GUAProfile_Char1_Config;
// GUA Characteristic 1 User Description
static uint8 GUAProfile_Char1_UserDesp[10] = "GUA Char1\0";
/*********************************************************************
* Profile Attributes - Table
*/
static gattAttribute_t GUAProfileAttrTbl[SERVAPP_NUM_ATTR_SUPPORTED] =
{
// GUA Service
{
{ ATT_BT_UUID_SIZE, primaryServiceUUID }, /* type */
GATT_PERMIT_READ, /* permissions */
0, /* handle */
(uint8 *)&GUAProfile_Service /* pValue */
},
// GUA Characteristic 1 Declaration
{
{ ATT_BT_UUID_SIZE, characterUUID },
GATT_PERMIT_READ,
0,
&GUAProfile_Char1_Props
},
// GUA Characteristic 1 Value
{
{ ATT_BT_UUID_SIZE, GUAChar1UUID },
GATT_PERMIT_READ | GATT_PERMIT_WRITE,
0,
GUAProfile_Char1
},
// GUA Characteristic 1 configuration
{
{ ATT_BT_UUID_SIZE, clientCharCfgUUID },
GATT_PERMIT_READ | GATT_PERMIT_WRITE,
0,
(uint8 *)&GUAProfile_Char1_Config
},
// GUA Characteristic 1 User Description
{
{ ATT_BT_UUID_SIZE, charUserDescUUID },
GATT_PERMIT_READ,
0,
GUAProfile_Char1_UserDesp
},
};
/*********************************************************************
* LOCAL FUNCTIONS
*/
static uint8 GUAProfile_ReadAttrCB( uint16 connHandle, gattAttribute_t *pAttr,
uint8 *pValue, uint16 *pLen, uint16 offset, uint16 maxLen, uint8 method );
static bStatus_t GUAProfile_WriteAttrCB( uint16 connHandle, gattAttribute_t *pAttr,
uint8 *pValue, uint16 len, uint16 offset, uint8 method );
/*********************************************************************
* PROFILE CALLBACKS
*/
// GUAProfile Service Callbacks
CONST gattServiceCBs_t GUAProfileCBs =
{
GUAProfile_ReadAttrCB, // Read callback function pointer
GUAProfile_WriteAttrCB, // Write callback function pointer
NULL // Authorization callback function pointer
};
/*********************************************************************
* PUBLIC FUNCTIONS
*/
/*********************************************************************
* @fn GUAProfile_AddService
*
* @brief Initializes the GUA service by registering
* GATT attributes with the GATT server.
*
* @param services - services to add. This is a bit map and can
* contain more than one service.
*
* @return Success or Failure
*/
bStatus_t GUAProfile_AddService( uint32 services )
{
uint8 status = SUCCESS;
// Allocate Client Characteristic Configuration table
GUAProfile_Char1_Config = (gattCharCfg_t *)ICall_malloc( sizeof(gattCharCfg_t) *
linkDBNumConns );
if ( GUAProfile_Char1_Config == NULL )
{
return ( bleMemAllocError );
}
// Initialize Client Characteristic Configuration attributes
GATTServApp_InitCharCfg( INVALID_CONNHANDLE, GUAProfile_Char1_Config );
if ( services & GUAPROFILE_SERVICE )
{
// Register GATT attribute list and CBs with GATT Server App
status = GATTServApp_RegisterService( GUAProfileAttrTbl,
GATT_NUM_ATTRS( GUAProfileAttrTbl ),
GATT_MAX_ENCRYPT_KEY_SIZE,
&GUAProfileCBs );
}
return ( status );
}
/*********************************************************************
* @fn GUAProfile_RegisterAppCBs
*
* @brief Registers the application callback function. Only call
* this function once.
*
* @param callbacks - pointer to application callbacks.
*
* @return SUCCESS or bleAlreadyInRequestedMode
*/
bStatus_t GUAProfile_RegisterAppCBs( GUAProfileCBs_t *appCallbacks )
{
if ( appCallbacks )
{
GUAProfile_AppCBs = appCallbacks;
return ( SUCCESS );
}
else
{
return ( bleAlreadyInRequestedMode );
}
}
/*********************************************************************
* @fn GUAProfile_SetParameter
*
* @brief Set a GUA Profile parameter.
*
* @param param - Profile parameter ID
* @param len - length of data to right
* @param pValue - pointer to data to write. This is dependent on
* the parameter ID and WILL be cast to the appropriate
* data type (example: data type of uint16 will be cast to
* uint16 pointer).
*
* @return bStatus_t
*/
bStatus_t GUAProfile_SetParameter( uint8 param, uint8 len, void *pValue )
{
bStatus_t ret = SUCCESS;
switch ( param )
{
case GUAPROFILE_CHAR1:
if ( len == GUAPROFILE_CHAR1_LEN )
{
VOID memcpy( GUAProfile_Char1, pValue, GUAPROFILE_CHAR1_LEN );
}
else
{
ret = bleInvalidRange;
}
break;
default:
ret = INVALIDPARAMETER;
break;
}
return ( ret );
}
/*********************************************************************
* @fn GUAProfile_GetParameter
*
* @brief Get a GUA Profile parameter.
*
* @param param - Profile parameter ID
* @param pValue - pointer to data to put. This is dependent on
* the parameter ID and WILL be cast to the appropriate
* data type (example: data type of uint16 will be cast to
* uint16 pointer).
*
* @return bStatus_t
*/
bStatus_t GUAProfile_GetParameter( uint8 param, void *pValue )
{
bStatus_t ret = SUCCESS;
switch ( param )
{
case GUAPROFILE_CHAR1:
VOID memcpy( pValue, GUAProfile_Char1, GUAPROFILE_CHAR1_LEN );
break;
default:
ret = INVALIDPARAMETER;
break;
}
return ( ret );
}
/*********************************************************************
* @fn GUAProfile_ReadAttrCB
*
* @brief Read an attribute.
*
* @param connHandle - connection message was received on
* @param pAttr - pointer to attribute
* @param pValue - pointer to data to be read
* @param pLen - length of data to be read
* @param offset - offset of the first octet to be read
* @param maxLen - maximum length of data to be read
*
* @return Success or Failure
*/
static uint8 GUAProfile_ReadAttrCB( uint16 connHandle, gattAttribute_t *pAttr,
uint8 *pValue, uint16 *pLen, uint16 offset, uint16 maxLen, uint8_t method )
{
bStatus_t status = SUCCESS;
// If attribute permissions require authorization to read, return error
if ( gattPermitAuthorRead( pAttr->permissions ) )
{
// Insufficient authorization
return ( ATT_ERR_INSUFFICIENT_AUTHOR );
}
// Make sure it's not a blob operation (no attributes in the profile are long
if ( offset > 0 )
{
return ( ATT_ERR_ATTR_NOT_LONG );
}
if ( pAttr->type.len == ATT_BT_UUID_SIZE )
{
// 16-bit UUID
uint16 uuid = BUILD_UINT16( pAttr->type.uuid[0], pAttr->type.uuid[1]);
switch ( uuid )
{
// No need for "GATT_SERVICE_UUID" or "GATT_CLIENT_CHAR_CFG_UUID" cases;
// gattserverapp handles this type for reads
// GUA characteristic does not have read permissions, but because it
// can be sent as a notification, it must be included here
case GUAPROFILE_CHAR1_UUID:
*pLen = GUAPROFILE_CHAR1_LEN;
VOID memcpy( pValue, pAttr->pValue, GUAPROFILE_CHAR1_LEN );
break;
default:
// Should never get here!
*pLen = 0;
status = ATT_ERR_ATTR_NOT_FOUND;
break;
}
}
else
{
// 128-bit UUID
*pLen = 0;
status = ATT_ERR_INVALID_HANDLE;
}
return ( status );
}
/*********************************************************************
* @fn GUAProfile_WriteAttrCB
*
* @brief Validate attribute data prior to a write operation
*
* @param connHandle - connection message was received on
* @param pAttr - pointer to attribute
* @param pValue - pointer to data to be written
* @param len - length of data
* @param offset - offset of the first octet to be written
*
* @return Success or Failure
*/
static bStatus_t GUAProfile_WriteAttrCB( uint16 connHandle, gattAttribute_t *pAttr,
uint8 *pValue, uint16 len, uint16 offset, uint8_t method )
{
bStatus_t status = SUCCESS;
uint8 notifyApp = 0xFF;
// If attribute permissions require authorization to write, return error
if ( gattPermitAuthorWrite( pAttr->permissions ) )
{
// Insufficient authorization
return ( ATT_ERR_INSUFFICIENT_AUTHOR );
}
if ( pAttr->type.len == ATT_BT_UUID_SIZE )
{
// 16-bit UUID
uint16 uuid = BUILD_UINT16( pAttr->type.uuid[0], pAttr->type.uuid[1]);
switch ( uuid )
{
case GUAPROFILE_CHAR1_UUID:
if ( offset == 0 )
{
if ( len != GUAPROFILE_CHAR1_LEN )
{
status = ATT_ERR_INVALID_VALUE_SIZE;
}
}
else
{
status = ATT_ERR_ATTR_NOT_LONG;
}
//将接收到的数据写进特征值中，并且置标志位
if ( status == SUCCESS )
{
VOID memcpy( pAttr->pValue, pValue, GUAPROFILE_CHAR1_LEN );
notifyApp = GUAPROFILE_CHAR1;
}
break;
case GATT_CLIENT_CHAR_CFG_UUID:
//char1通道，则打开notify开关
if ( pAttr->handle == GUAProfileAttrTbl[ATTRTBL_GUA_CHAR1_CCC_IDX].handle )//GUA CHAR1 NOTIFY
{
status = GATTServApp_ProcessCCCWriteReq( connHandle, pAttr, pValue, len,
offset, GATT_CLIENT_CFG_NOTIFY );
}
else
{
status = ATT_ERR_INVALID_HANDLE;
}
break;
default:
status = ATT_ERR_ATTR_NOT_FOUND;
break;
}
}
else
{
// 128-bit UUID
status = ATT_ERR_INVALID_HANDLE;
}
// If a charactersitic value changed then callback function to notify application of change
if ( (notifyApp != 0xFF ) && GUAProfile_AppCBs && GUAProfile_AppCBs->pfnGUAProfileChange )
{
GUAProfile_AppCBs->pfnGUAProfileChange( notifyApp );
}
return ( status );
}
//**********************************************************************
//name: GUA_Profile_Notify
//introduce: 香瓜的notify发送函数
//parameter: nGUA_Param:特征值通道参数
// nGUA_ConnHandle:连接句柄
// pGUA_Value:要通知的数据
// nGUA_Len:要通知的数据长度，范围为0~SIMPLEPROFILE_CHAR6，最多20个字节
//return: none
//author: 甜甜的大香瓜
//email: [email protected]
//QQ group: 香瓜BLE之CC2640R2F(557278427)
//shop:
//https://shop217632629.taobao.com/?spm=2013.1.1000126.d21.hd2o8i
//changetime: 2017.11.06
//**********************************************************************
void GUA_Profile_Notify(GUA_U8 nGUA_Param, GUA_U16 nGUA_ConnHandle, GUA_U8 *pGUA_Value, GUA_U8 nGUA_Len)
{
attHandleValueNoti_t stGUA_Noti;
GUA_U16 nGUA_Value;
switch(nGUA_Param)
{
//特征值1
case GUAPROFILE_CHAR1:
{
//读出CCC
nGUA_Value = GATTServApp_ReadCharCfg(nGUA_ConnHandle, GUAProfile_Char1_Config);
//判断CCC是否被打开
if(nGUA_Value & GATT_CLIENT_CFG_NOTIFY)
{
//分配发送数据缓冲区
stGUA_Noti.pValue = GATT_bm_alloc(nGUA_ConnHandle, ATT_HANDLE_VALUE_NOTI, GUAPROFILE_CHAR1_LEN, NULL);
//分配成功，则发送数据
if(stGUA_Noti.pValue != NULL)
{
//填充数据
stGUA_Noti.handle = GUAProfileAttrTbl[ATTRTBL_GUA_CHAR1_IDX].handle;
stGUA_Noti.len = nGUA_Len;
memcpy( stGUA_Noti.pValue, pGUA_Value, nGUA_Len);
//发送数据
if (GATT_Notification(nGUA_ConnHandle, &stGUA_Noti, FALSE) != SUCCESS)
{
GATT_bm_free((gattMsg_t *)&stGUA_Noti, ATT_HANDLE_VALUE_NOTI);
}
}
}
break;
}
default:
break;
}
}
2）写一个自定义的服务头文件GUA_Profile.h（存放在“……\simplelink_cc2640r2_sdk_1_40_00_45\examples\rtos\CC2640R2_LAUNCHXL\ble5stack\simple_peripheral\src\app\GUA”路径下）
//**********************************************************************
//name: GUA_profile.h
//introduce: 香瓜自定义的服务的头文件，内含一个可读、可写、可通知的特征值
//author: 甜甜的大香瓜
//email: [email protected]
//QQ group: 香瓜BLE之CC2640R2F(557278427)
//shop:
//https://shop217632629.taobao.com/?spm=2013.1.1000126.d21.hd2o8i
//changetime: 2017.11.06
//**********************************************************************
#ifndef _GUA_PROFILE_H_
#define _GUA_PROFILE_H_
#ifdef __cplusplus
extern "C"
{
#endif
/*********************************************************************
* INCLUDES
*/
/*********************************************************************
* CONSTANTS
*/
// Profile Parameters
#define GUAPROFILE_CHAR1 0 // RW uint8 - Profile GUA Characteristic 1 value
// GUA Service UUID
#define GUAPROFILE_SERV_UUID 0xFFE0
// GUA CHAR1 UUID
#define GUAPROFILE_CHAR1_UUID 0xFFE1
// GUA Profile Services bit fields
#define GUAPROFILE_SERVICE 0x00000001
// Length of GUA Characteristic 1 in bytes
#define GUAPROFILE_CHAR1_LEN 20
/*********************************************************************
* TYPEDEFS
*/
/*********************************************************************
* MACROS
*/
/*********************************************************************
* Profile Callbacks
*/
// Callback when a characteristic value has changed
typedef void (*GUAProfileChange_t)( uint8 paramID );
typedef struct
{
GUAProfileChange_t pfnGUAProfileChange; // Called when characteristic value changes
} GUAProfileCBs_t;
/*********************************************************************
* API FUNCTIONS
*/
/*
* GUAProfile_AddService- Initializes the GUA service by registering
* GATT attributes with the GATT server.
*
* @param services - services to add. This is a bit map and can
* contain more than one service.
*/
extern bStatus_t GUAProfile_AddService( uint32 services );
/*
* GUAProfile_RegisterAppCBs - Registers the application callback function.
* Only call this function once.
*
* appCallbacks - pointer to application callbacks.
*/
extern bStatus_t GUAProfile_RegisterAppCBs( GUAProfileCBs_t *appCallbacks );
/*
* GUAProfile_SetParameter - Set a Simple Key Profile parameter.
*
* param - Profile parameter ID
* len - length of data to right
* pValue - pointer to data to write. This is dependent on
* the parameter ID and WILL be cast to the appropriate
* data type (example: data type of uint16 will be cast to
* uint16 pointer).
*/
extern bStatus_t GUAProfile_SetParameter( uint8 param, uint8 len, void *pValue );
/*
* GUA_GetParameter - Get a Simple Key Profile parameter.
*
* param - Profile parameter ID
* pValue - pointer to data to write. This is dependent on
* the parameter ID and WILL be cast to the appropriate
* data type (example: data type of uint16 will be cast to
* uint16 pointer).
*/
extern bStatus_t GUAProfile_GetParameter( uint8 param, void *pValue );
/*********************宏定义************************/
//类型宏
#ifndef GUA_C
typedef char GUA_C;
#endif
#ifndef GUA_U8
typedef unsigned char GUA_U8;
#endif
#ifndef GUA_8
typedef signed char GUA_8;
#endif
#ifndef GUA_U16
typedef unsigned short GUA_U16;
#endif
#ifndef GUA_16
typedef signed short GUA_16;
#endif
#ifndef GUA_U32
typedef unsigned long GUA_U32;
#endif
#ifndef GUA_32
typedef signed long GUA_32;
#endif
#ifndef GUA_U64
typedef unsigned long long GUA_U64;
#endif
#ifndef GUA_64
typedef signed long long GUA_64;
#endif
/*********************函数声明************************/
extern void GUA_Profile_Notify(GUA_U8 nGUA_Param, GUA_U16 nGUA_ConnHandle, GUA_U8 *pGUA_Value, GUA_U8 nGUA_Len);
/*********************************************************************
*********************************************************************/
#ifdef __cplusplus
}
#endif
#endif /* GUA_PROFILE_H */
2、工程中添加驱动文件GUA_Profile.c和GUA_Profile.h
注：拖拽至CCS工程的Application文件夹下
添加文件过程中，选项选择如下
3、应用层调用
1）添加头文件（simple_peripheral.c中）
//GUA
#include "GUA_Profile.h"
//GUA 2）添加初始化代码（simple_peripheral.c的SimpleBLEPeripheral_init函数末尾中）
//GUA
//增加服务
GUAProfile_AddService(GATT_ALL_SERVICES);
//初始化特征值
uint8 GUAProfile_Char1Value[GUAPROFILE_CHAR1_LEN] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
GUAProfile_SetParameter(GUAPROFILE_CHAR1, GUAPROFILE_CHAR1_LEN, &GUAProfile_Char1Value);
//添加回调函数
VOID GUAProfile_RegisterAppCBs(&simpleBLEPeripheral_GUAProfileCBs);
//GUA3）定义服务的回调函数及处理函数（simple_peripheral.c中）
//GUA
//**********************************************************************
//name: GUA_Profile_ChangeCB
//introduce: 香瓜服务的应用层回调函数
//parameter: nGUA_ParamID：特征值ID
//return: none
//author: 甜甜的大香瓜
//email: [email protected]
//QQ group: 香瓜BLE之CC2640R2F(557278427)
//shop:
//https://shop217632629.taobao.com/?spm=2013.1.1000126.d21.hd2o8i
//changetime: 2017.11.06
//**********************************************************************
static void GUA_Profile_ChangeCB(GUA_U8 nGUA_ParamID)
{
SimpleBLEPeripheral_enqueueMsg(SBP_GUA_CHAR_CHANGE_EVT, nGUA_ParamID);
}
//**********************************************************************
//name: GUA_Profile_CharValueChangeEvt
//introduce: 香瓜服务的应用层处理函数
//parameter: nGUA_ParamID：特征值ID
//return: none
//author: 甜甜的大香瓜
//email: [email protected]
//QQ group: 香瓜BLE之CC2640R2F(557278427)
//shop:
//https://shop217632629.taobao.com/?spm=2013.1.1000126.d21.hd2o8i
//changetime: 2017.11.06
//**********************************************************************
static void GUA_Profile_CharValueChangeEvt(GUA_U8 nGUA_ParamID)
{
GUA_U16 nGUA_ConnHandle;
GUA_U8 naGUA_Buf[20] = {0};
GUA_U8 *pGUA_Value = naGUA_Buf;
//判断是哪个特征值
switch(nGUA_ParamID)
{
//特征值1
case GUAPROFILE_CHAR1:
{
//获取连接句柄
GAPRole_GetParameter(GAPROLE_CONNHANDLE, &nGUA_ConnHandle);
//写一个20字节的测试缓冲区的数据
for(GUA_U8 i = 0; i < 20; i++)
{
*(pGUA_Value + i) = i;
}
//发送数据
GUA_Profile_Notify(GUAPROFILE_CHAR1, nGUA_ConnHandle, pGUA_Value, 20);
break;
}
//其他
default:
break;
}
}
//GUA
4）声明服务的回调函数和处理函数（simple_peripheral.c中）
//GUA
static void GUA_Profile_ChangeCB(GUA_U8 nGUA_ParamID);
static void GUA_Profile_CharValueChangeEvt(GUA_U8 nGUA_ParamID);
//GUA5）注册回调函数（simple_peripheral.c中）
//GUA
//GUA Profile Callbacks
static GUAProfileCBs_t simpleBLEPeripheral_GUAProfileCBs =
{
GUA_Profile_ChangeCB // Charactersitic value change callback
};
//GUA6）添加香瓜服务处理事件（simple_peripheral.c中）
①添加香瓜服务处理事件的宏定义
//GUA
#define SBP_GUA_CHAR_CHANGE_EVT 0x0010
//GUA②添加香瓜服务处理事件的处理部分（替换simple_peripheral.c中的SimpleBLEPeripheral_processAppMsg函数）
//GUA
static void SimpleBLEPeripheral_processAppMsg(sbpEvt_t *pMsg)
{
switch (pMsg->hdr.event)
{
case SBP_STATE_CHANGE_EVT:
SimpleBLEPeripheral_processStateChangeEvt((gaprole_States_t)pMsg->
hdr.state);
break;
case SBP_CHAR_CHANGE_EVT:
SimpleBLEPeripheral_processCharValueChangeEvt(pMsg->hdr.state);
break;
#if !defined(Display_DISABLE_ALL)
case SBP_KEY_CHANGE_EVT:
SimpleBLEPeripheral_handleKeys(pMsg->hdr.state);
break;
#endif // !Display_DISABLE_ALL
case SBP_GUA_CHAR_CHANGE_EVT:
GUA_Profile_CharValueChangeEvt(pMsg->hdr.state);
break;
default:
// Do nothing.
break;
}
}
//GUA八、注意事项
1、手机可能缓存了之前固件的数据（在更新过固件后，都需要清除手机端的缓存！！！），因此要清除缓存，清除缓存的方法如下：
方法一：关闭app、关闭蓝牙总开关、打开蓝牙总开关、打开app。
方法二：手机重启。
九、实验结果
可见上图实现了使用香瓜服务中的特征值进行的收发。
因此，实验成功。