Overview
本文基于DA1458x SDK 5.0.4。
Battery Service 以下简称BAS or BASS。BASS的代码主要有以下两个组C文件组成
另,BASS是依赖于APP_TASK任务来调度管理的。具体框架如下图(摘自Dialog官方文档)
Full BAS Database Description (BAS Database 分析)
BASS的Database的变量名为 bas_att_db,由以下5个成员组成
No. | Name | Description |
---|---|---|
1 | BAS_IDX_SVC | Battery Service Declaration |
2 | BAS_IDX_BATT_LVL_CHAR | Battery Level Characteristic Declaration |
3 | BAS_IDX_BATT_LVL_VAL | Battery Level Characteristic Value |
4 | BAS_IDX_BATT_LVL_NTF_CFG | Battery Level Characteristic - Client Characteristic Configuration Descriptor |
5 | BAS_IDX_BATT_LVL_PRES_FMT | Battery Level Characteristic - Characteristic Presentation Format Descriptor |
这个变量非常重要,本文我们就围绕着它来一步步来分析。
bas_att_db结构体数组索引
首先这是一个结构体数组的索引,该索引采取的是枚举类型,方便阅读和理解。
/// Battery Service Attributes Indexes
enum
{
BAS_IDX_SVC,
BAS_IDX_BATT_LVL_CHAR,
BAS_IDX_BATT_LVL_VAL,
BAS_IDX_BATT_LVL_NTF_CFG,
BAS_IDX_BATT_LVL_PRES_FMT,
BAS_IDX_NB,
};
接下来我们看下attm_desc这个结构体的定义
struct attm_desc 结构体的定义
这个结构体的定义如下
/// Attribute description (used to create database)
struct attm_desc
{
/// Element UUID
uint16_t uuid;
/// Attribute permission
uint16_t perm;
/// Maximum length of the element
att_size_t max_length;
/// Current length of the element
att_size_t length;
/// Element value array
uint8_t* value;
};
我们可以看到,第一个成员是16位UUID,用来记录这个Attribute(属性)的UUID;
第二个成员是Attribute permission(属性权限);
第三个成员是Maximum length of the element(元素的最大长度);
第四个成员是Current length of the element(当前元素的长处);
第五个成员是Element Value array(元素数组)。
uuid和perm为16bit无符号整型变量,value为uint8_t数组指针,att_size_t类型其实uint16_t
/// Attribute length type
typedef uint16_t att_size_t;
bas_att_db定义
定义如下(bass.c文件中)
/*
* BAS ATTRIBUTES DEFINITION
****************************************************************************************
*/
/// Full BAS Database Description - Used to add attributes into the database
const struct attm_desc bas_att_db[BAS_IDX_NB] =
{
// Battery Service Declaration
[BAS_IDX_SVC] = {ATT_DECL_PRIMARY_SERVICE, PERM(RD, ENABLE), sizeof(bas_svc),
sizeof(bas_svc), (uint8_t *)&bas_svc},
// Battery Level Characteristic Declaration
[BAS_IDX_BATT_LVL_CHAR] = {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(bas_batt_level_char),
sizeof(bas_batt_level_char), (uint8_t *)&bas_batt_level_char},
// Battery Level Characteristic Value
[BAS_IDX_BATT_LVL_VAL] = {ATT_CHAR_BATTERY_LEVEL, PERM(RD, ENABLE), sizeof(uint8_t),
0, NULL},
// Battery Level Characteristic - Client Characteristic Configuration Descriptor
[BAS_IDX_BATT_LVL_NTF_CFG] = {ATT_DESC_CLIENT_CHAR_CFG, PERM(RD, ENABLE)|PERM(WR, ENABLE), sizeof(uint16_t),
0, NULL},
// Battery Level Characteristic - Characteristic Presentation Format Descriptor
[BAS_IDX_BATT_LVL_PRES_FMT] = {ATT_DESC_CHAR_PRES_FORMAT, PERM(RD, ENABLE), sizeof(struct prf_char_pres_fmt),
0, NULL},
};
由上述定义我们来一个个分析bas_att_db的五个成员变量。
[BAS_IDX_SVC]
首先是[BAS_IDX_SVC]成员变量。
BAS_IDX_SVC的value是bas_svc 变量,具体如下:
const att_svc_desc_t bas_svc = ATT_SVC_BATTERY_SERVICE;
我们可以看到bas_svc 被赋值为一个枚举类型变量,具体值为0x180F。
类似的还有ATT_SVC_GENERIC_ACCESS、ATT_SVC_GENERIC_ATTRIBUTE、ATT_SVC_DEVICE_INFO、ATT_SVC_HID等。
具体定义如下:
/// Common 16-bit Universal Unique Identifier
enum {
ATT_INVALID_UUID = 0,
/*----------------- SERVICES ---------------------*/
/// Generic Access Profile
ATT_SVC_GENERIC_ACCESS = 0x1800,
/// Attribute Profile
ATT_SVC_GENERIC_ATTRIBUTE,
...
/// Device Information Service
ATT_SVC_DEVICE_INFO = 0x180A,
...
/// Battery Service
ATT_SVC_BATTERY_SERVICE,
/// Blood Pressure Service
ATT_SVC_BLOOD_PRESSURE = 0x1810,
/// Alert Notification Service
ATT_SVC_ALERT_NTF = 0x1811,
/// HID Service
ATT_SVC_HID = 0x1812,
...
}
[BAS_IDX_BATT_LVL_CHAR]
关于BAS_IDX_BATT_LVL_CHAR成员,它的value比较特殊,是att_char_desc结构体变量强转为(uint8_t *)。该变量定义如下:
/// Battery Level characteristic
const struct att_char_desc bas_batt_level_char = ATT_CHAR(ATT_CHAR_PROP_RD, 0, ATT_CHAR_BATTERY_LEVEL);
struct att_char_desc定义如下:
/// Characteristic Value Descriptor
struct att_char_desc
{
/// properties
uint8_t prop;//属性
/// attribute handle
uint8_t attr_hdl[ATT_HANDLE_LEN];//句柄索引
/// attribute type
uint8_t attr_type[ATT_UUID_16_LEN];//UUID值
};
定义bas_batt_level_char变量时,使用ATT_CHAR宏函数填充结构体,原型如下
/// macro to fill an attribute characteristic
#define ATT_CHAR(prop, handle, type) {(prop), \
{(uint8_t)((handle)), (uint8_t)((handle) >> 8)}, \
{(uint8_t)((type)), (uint8_t)((type) >> 8)} };
[BAS_IDX_BATT_LVL_VAL]、[BAS_IDX_BATT_LVL_NTF_CFG]、[BAS_IDX_BATT_LVL_PRES_FMT]
这个三个变量都没填充value值
小结
成员 | 定义 | 描述 |
---|---|---|
[BAS_IDX_SVC] | {ATT_DECL_PRIMARY_SERVICE,PERM(RD, ENABLE),sizeof(bas_svc),sizeof(bas_svc),(uint8_t *)&bas_svc} | Battery Service Declaration |
[BAS_IDX_BATT_LVL_CHAR] | {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(bas_batt_level_char),sizeof(bas_batt_level_char), (uint8_t *)&bas_batt_level_char} | Battery Level Characteristic Declaration |
[BAS_IDX_BATT_LVL_VAL] | {ATT_CHAR_BATTERY_LEVEL, PERM(RD, ENABLE), sizeof(uint8_t),0, NULL} | Battery Level Characteristic Value |
[BAS_IDX_BATT_LVL_NTF_CFG] | {ATT_DESC_CLIENT_CHAR_CFG,PERM(RD, ENABLE)|PERM(WR, ENABLE),sizeof(uint16_t),0, NULL} | Battery Level Characteristic - Client Characteristic Configuration Descriptor |
[BAS_IDX_BATT_LVL_PRES_FMT] | {ATT_DESC_CHAR_PRES_FORMAT, PERM(RD, ENABLE), sizeof(struct prf_char_pres_fmt),0, NULL} | Battery Level Characteristic - Characteristic Presentation Format Descriptor |
Database类型总结
UUID | 类型 | 值 |
---|---|---|
ATT_DECL_PRIMARY_SERVICE | DECLARATIONS | 0x2800 |
ATT_DECL_CHARACTERISTIC | DECLARATIONS | 0x2803 |
ATT_CHAR_BATTERY_LEVEL | CHARACTERISTICS | 0x2A19 |
ATT_DESC_CLIENT_CHAR_CFG | DESCRIPTORS | 0x2902 |
ATT_DESC_CHAR_PRES_FORMAT | DESCRIPTORS | 0x2904 |