CC2642的GGS使用笔记
一、前言
我们了解BLE的GATT之前需要了解一些基本的概念：
（1）Profile,字面意思简介、概述、形象印象、轮廓、配置文件，在BLE中，我们可能把它理解成配置文件较好，Profile有一些是BLE SIG规定的，有些可以是我们自定义的。
（2）Service,字面意思服务，在GATT中可以有多个服务，同样地，服务有些是BLE SIG定义的，有些是我们自定义的，习惯性叫这些服务为GATT服务。
（3）Characteristic, 字面意思特征，它存在于Service里面，就好比房间是一个服务，里面的装饰配置之类的是特征，而这些特征决定了房间的用处，也就是服务的用处。
（4）Attribute,字面意思是属性，可以这么理解，它描述的是特征的细节，比如描述特征的读写权限，特征的内容（值），特征的简介描述，还有特征的配置。
二、GGS相关的API
下面列举几个我们GGS常用的协议栈API：
- bStatus_t GGS_SetParameter( uint8 param, uint8 len, void *value )
描述：设置GAP GATT服务参数
参数：
param: Profile参数ID, 取的值可以参考gapgattserver.h的宏定义，其实就是下面表格列出的值：
| GGS_DEVICE_NAME_ATT |
|---|
| GGS_APPEARANCE_ATT |
| GGS_DEVICE_NAME_ATT |
| GGS_APPEARANCE_ATT |
| GGS_PERI_CONN_PARAM_ATT |
| GGS_CENT_ADDR_RES_ATT |
| GGS_RESOLVABLE_PRIVATE_ADDRESS_ONLY_ATT |
len: 要写入的字节个数
value: 指向要写的数据
比如我们在APP的初始化处初始蓝牙设备的名称，可以这么写：
uint8_t Ble_deviceName[] = "BoBo.cn";
GGS_SetParameter(GGS_DEVICE_NAME_ATT, strlen(Ble_deviceName), Ble_deviceName);
- bStatus_t GAP_SetParamValue(uint16_t paramID, uint16_t paramValue)
描述：设置GAP参数值
参数：
paramID, 这个参数可以参考Gap_ParamIDs_t枚举
paramValue, 值
bStatus_t GGS_AddService( uint32 services )
描述：添加一个功能到GGS上
参数：services，该参数是32位，每个位代表一个功能服务，较常用的是bit1，也就是GAP_SERVICE。 - bStatus_t GATTServApp_AddService( uint32 services )
描述：添加一个功能到GATT服务上，我们将一个服务注册到GATT服务上之后，在蓝牙建立连接过程中客户端就能发现该服务，如果注册的回调函数功能正常的话，就能够正常的使用该服务。
参数：
services，该参数是32位，每个位代表一个功能服务，大多数情况下推荐0xFFFFFFFF,即GATT_ALL_SERVICES - bStatus_t GATTServApp_RegisterService( gattAttribute_t *pAttrs, uint16 numAttrs, uint8 encKeySize, CONST gattServiceCBs_t *pServiceCBs )
描述：向GATT服务应用注册服务的属性列表和回调函数
参数：
pAttrs, 指向属性列表的指针
numAttrs, 属性单元个数
encKeySize, 服务所需的最小加密钥匙字节大小（7~16个字节）
pServiceCBs, 指向服务回调函数的指针
这个API很重要，我们有必要看看结构体gattAttribute_t和gattServiceCBs_t的原型：
typedef struct attAttribute_t
{
/// @brief GATT Attribute Type format.
struct
{
uint8 len; //!< UUID的长度
const uint8 *uuid; //!< 指向UUID
} type; //!< 属性类型 (2或者16字节UUIDs)
uint8 permissions; //!< 属性的权限
uint16 handle; //!< 属性的句柄 - 由属性服务器内部分配
uint8* const pValue; //!< 属性值 - 字节个数不超过512
} gattAttribute_t;
typedef struct
{
pfnGATTReadAttrCB_t pfnReadAttrCB; //!< 指向读ATT函数
pfnGATTWriteAttrCB_t pfnWriteAttrCB; //!< 指向写ATT函数
pfnGATTAuthorizeAttrCB_t pfnAuthorizeAttrCB; //!< 指向认证函数
} gattServiceCBs_t;
上面三个函数类型如下：
typedef bStatus_t (*pfnGATTReadAttrCB_t)( uint16 connHandle, gattAttribute_t *pAttr,
uint8 *pValue, uint16 *pLen, uint16 offset,
uint16 maxLen, uint8 method );
typedef bStatus_t (*pfnGATTWriteAttrCB_t)( uint16 connHandle, gattAttribute_t *pAttr,
uint8 *pValue, uint16 len, uint16 offset,
uint8 method );
typedef bStatus_t (*pfnGATTAuthorizeAttrCB_t)( uint16 connHandle, gattAttribute_t *pAttr,
uint8 opcode );
- bStatus_t GATTServApp_ProcessCharCfg( gattCharCfg_t *charCfgTbl, uint8 *pValue, uint8 authenticated, gattAttribute_t *attrTbl, uint16 numAttrs, uint8 taskId, pfnGATTReadAttrCB_t pfnReadAttrCB )
描述：处理客户端特征配置的改变
参数：
charCfgTbl,特征配置表
pValue, 指向属性内容
authenticated, 是否需要认证
attrTbl, 服务属性列表
numAttrs, 服务属性列表单元个数
taskId, 确认通知的任务ID
pfnReadAttrCB, Att读回调函数，GATTServApp_ProcessCharCfg最后会通过该函数给客户端发送数据 - bStatus_t GATTServApp_ProcessCCCWriteReq( uint16 connHandle, gattAttribute_t *pAttr, uint8 *pValue, uint16 len, uint16 offset, uint16 validCfg )
描述：处理客户端特征配置写请求，这个函数配合UUID 0x2902使用
参数：
connHandle, 客户端的连接句柄
pAttr, 指向属性表
pValue, 指向写入的数据
Len, 待写的字节数
offset,偏移字节写入
validCfg, 配置选项，值可以是GATT_CLIENT_CFG_NOTIFY或者GATT_CLIENT_CFG_INDICATE，或者两者都选（或逻辑）。
三、实现一个数据透传服务
下面写一个服务，两个特征，一个支持写，一个支持读和notify
直接上代码：
- icce_service.c
/*
* icce_service.c
*
* Created on: 2023年4月15日
* Author: 28596
*/
/*********************************************************************
* INCLUDES
*/
#include // Comment this in to use xdc.runtime.Log
#include - icce_service.h
/*
* icce_service.h
*
* Created on: 2023年4月15日
* Author: 28596xx
*/
#ifndef PROFILES_ICCE_SERVICE_H_
#define PROFILES_ICCE_SERVICE_H_
#ifdef __cplusplus
extern "C"
{
#endif
/*********************************************************************
* INCLUDES
*/
#include 将上面这两个文件添加到工程，ICCE_test() 用一个定时器每5s执行一次。编译下载到CC2642，运行之后用手机就能发现我们这个服务了。
color=gray