nrf52832学习笔记(6)添加uuid总结
uuid是通用唯一标识码的意思，保证同一时空同一时空中所有机器标识唯一（百度这样说的）
下面总结下nrf52832怎么添加uuid.
可以做一下分类
- 添加蓝牙技术联盟定义的uuid
- 添加自定义的uuid
这2类又各可以分成下面2个
- 添加服务的uuid
- 添加特性的uuid
在总结之前先看下nordic提供的关于uuid的2个结构体
typedef struct
{
uint8_t uuid128[16]; /**< Little-Endian UUID bytes. */
} ble_uuid128_t;
typedef struct
{
uint16_t uuid; /**< 16-bit UUID value or octets 12-13 of 128-bit UUID. */
uint8_t type; /**< UUID type, see @ref BLE_UUID_TYPES. If type is @ref BLE_UUID_TYPE_UNKNOWN, the value of uuid is undefined. */
} ble_uuid_t;
ble_uuid128_t 是定义128bit（16字节）uuid的结构体，采用小端模式
ble_uuid_t 是定义16bit（2字节）uuid的结构体，还用一个type元素标识是那种类型的uuid，type可以取以下值,
#define BLE_UUID_TYPE_UNKNOWN 0x00 /**< Invalid UUID type. */
#define BLE_UUID_TYPE_BLE 0x01 /**< Bluetooth SIG UUID (16-bit). */
#define BLE_UUID_TYPE_VENDOR_BEGIN 0x02 /**< Vendor UUID types start at this index (128-bit). */
1.添加蓝牙技术联盟定义的uuid
比如心电的例子中
a.添加服务的uuid
心电服务是SIG定义好的服务，所以添加SIG定义uuid
- 定义16bit uuid
ble_uuid_t ble_uuid;
- 对结构体赋值
BLE_UUID_BLE_ASSIGN(ble_uuid, BLE_UUID_HEART_RATE_SERVICE);
这个宏展开如下
#define BLE_UUID_BLE_ASSIGN(instance, value) do {\
instance.type = BLE_UUID_TYPE_BLE; \
instance.uuid = value;} while(0)
就是把结构体里的type赋值成BLE_UUID_TYPE_BLE （SIG），16bit uuid赋值成BLE_UUID_HEART_RATE_SERVICE
- 调用添加服务申明的api，把uuid添加到属性表中
err_code = sd_ble_gatts_service_add(BLE_GATTS_SRVC_TYPE_PRIMARY,
&ble_uuid,
&p_hrs->service_handle);
BLE_GATTS_SRVC_TYPE_PRIMARY 标识该申明的服务是首要服务
&ble_uuid 就是16bit uuid 结构体地址
&p_hrs->service_handle 是这个申明服务的操作句柄
b.添加特性的uuid
- 定义16bit uuid
ble_uuid_t ble_uuid;
- 对结构体赋值
BLE_UUID_BLE_ASSIGN(ble_uuid, BLE_UUID_HEART_RATE_MEASUREMENT_CHAR);
就是把结构体里的type赋值成BLE_UUID_TYPE_BLE （SIG），16bit uuid赋值成BLE_UUID_HEART_RATE_MEASUREMENT_CHAR
- 调用添加特性申明的api，把uuid添加到属性表中
//属性值
memset(&attr_char_value, 0, sizeof(attr_char_value));
attr_char_value.p_uuid = &ble_uuid;
attr_char_value.p_attr_md = &attr_md;
attr_char_value.init_len = hrm_encode(p_hrs, INITIAL_VALUE_HRM, encoded_initial_hrm);
attr_char_value.init_offs = 0;
attr_char_value.max_len = MAX_HRM_LEN;
attr_char_value.p_value = NULL;//encoded_initial_hrm;
return sd_ble_gatts_characteristic_add(p_hrs->service_handle,
&char_md,
&attr_char_value,
&p_hrs->hrm_handles);
p_hrs->service_handle 是这个特性所属服务的句柄
&char_md 是特性标识符结构体地址
&attr_char_value 是特性值结构体地址，其中attr_char_value.p_uuid就是指向ble_uuid（16bit uuid）的地址
&p_hrs->hrm_handles 是这个特性的句柄
2.添加自定义的uuid
蓝牙串口的例子就是自定义的uuid
a.添加服务的uuid
- 定义128bit uuid
#define NUS_BASE_UUID {{0x9E, 0xCA, 0xDC, 0x24, 0x0E, 0xE5, 0xA9, 0xE0, 0x93, 0xF3, 0xA3, 0xB5, 0x00, 0x00, 0x40, 0x6E}}
/**< Used vendor specific UUID. */
ble_uuid128_t nus_base_uuid = NUS_BASE_UUID;
这里定义的同时赋值了，注意是小端字节序
- 把基础uuid添加进协议栈
err_code = sd_ble_uuid_vs_add(&nus_base_uuid, &p_nus->uuid_type);
&p_nus->uuid_type 会返回添加进去的uuid类型
- 调用添加服务申明的api，把uuid添加到属性表中
这里还要用定义16bit uuid 用于服务申明api的入口参数
ble_uuid.type = p_nus->uuid_type; //类型
ble_uuid.uuid = BLE_UUID_NUS_SERVICE;//服务的uuid
// Add the service.
err_code = sd_ble_gatts_service_add(BLE_GATTS_SRVC_TYPE_PRIMARY,
&ble_uuid,
&p_nus->service_handle);
a.添加特性的uuid
和前面特性uuid添加一样，如下
//1.定义16bit uuid结构体
ble_uuid_t ble_uuid;
//2.赋值
ble_uuid.type = p_nus->uuid_type;
ble_uuid.uuid = BLE_UUID_NUS_RX_CHARACTERISTIC;
//3.特性申明
memset(&attr_char_value, 0, sizeof(attr_char_value));
attr_char_value.p_uuid = &ble_uuid;
attr_char_value.p_attr_md = &attr_md;
attr_char_value.init_len = sizeof(uint8_t);
attr_char_value.init_offs = 0;
attr_char_value.max_len = BLE_NUS_MAX_RX_CHAR_LEN;
return sd_ble_gatts_characteristic_add(p_nus->service_handle,
&char_md,
&attr_char_value,
&p_nus->rx_handles);
总结下，
- 官方的uuid就是定义16bit uuid结构体，赋值uuid类型和uuid值，是服务的uuid就调用服务申明api，是特性uuid就调用特性申明api
- 自定义uuid就要先定义128bit uuid结构体，调用
sd_ble_uuid_vs_add把基础uuid添加进协议栈中并获得uuid类型，然后再定义16bit uuid结构体，赋值uuid类型和uuid值，是服务的uuid就调用服务申明api，是特性uuid就调用特性申明api
还有不管是官方还是自定义的uuid都不要忘了在广播初始化时添加uuid列表，不然手机扫描的话扫描不出uuid信息
m_adv_uuids是一个结构体数组
