DA1458x DISS Database的组成结构 -- Device Information Service 分析（一）

最新推荐文章于 2024-06-04 17:36:28 发布
最新推荐文章于 2024-06-04 17:36:28 发布
阅读量1.1k 收藏 4
点赞数
分类专栏： DA1458x
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/daoshuti/article/details/78534502
版权

Overview

本文基于DA1458x SDK 5.0.4。
Device Information Service 以下简称DIS or DISS。DISS的代码主要有以下两个组C文件组成

DISS

另，DISS是依赖于APP_TASK任务来调度管理的。具体框架如下图（摘自Dialog官方文档）

DA1458X_SDK_ARCH

Full DISS Database Description （DISS Database 分析）

DISS的Database的变量名为 diss_att_db
由以下19个成员组成

No.NameDescription
1DIS_IDX_SVCDevice Information Service Declaration
2DIS_IDX_MANUFACTURER_NAME_CHARManufacturer Name Characteristic Declaration
3DIS_IDX_MANUFACTURER_NAME_VALManufacturer Name Characteristic Value
4DIS_IDX_MODEL_NB_STR_CHARModel Number String Characteristic Declaration
5DIS_IDX_MODEL_NB_STR_VALModel Number String Characteristic Value
6DIS_IDX_SERIAL_NB_STR_CHARSerial Number String Characteristic Declaration
7DIS_IDX_SERIAL_NB_STR_VALSerial Number String Characteristic Value
8DIS_IDX_HARD_REV_STR_CHARHardware Revision String Characteristic Declaration
9DIS_IDX_HARD_REV_STR_VALHardware Revision String Characteristic Value
10DIS_IDX_FIRM_REV_STR_CHARFirmware Revision String Characteristic Declaration
11DIS_IDX_FIRM_REV_STR_VALFirmware Revision String Characteristic Value
12DIS_IDX_SW_REV_STR_CHARSoftware Revision String Characteristic Declaration
13DIS_IDX_SW_REV_STR_VALSoftware Revision String Characteristic Value
14DIS_IDX_SYSTEM_ID_CHARSystem ID Characteristic Declaration
15DIS_IDX_SYSTEM_ID_VALSystem ID Characteristic Value
16DIS_IDX_IEEE_CHARIEEE 11073-20601 Regulatory Certification Data List Characteristic Declaration
17DIS_IDX_IEEE_VALIEEE 11073-20601 Regulatory Certification Data List Characteristic Value
18DIS_IDX_PNP_ID_CHARPnP ID Characteristic Declaration
19DIS_IDX_PNP_ID_VALPnP ID Characteristic Value

这个变量非常重要，本文我们就围绕着它来一步步来分析。

diss_att_db结构体数组索引

首先这是一个结构体数组的索引，该索引采取的是枚举类型，方便阅读和理解。

///Attributes State Machine
enum
{
    DIS_IDX_SVC,

    DIS_IDX_MANUFACTURER_NAME_CHAR,
    DIS_IDX_MANUFACTURER_NAME_VAL,

    DIS_IDX_MODEL_NB_STR_CHAR,
    DIS_IDX_MODEL_NB_STR_VAL,

    DIS_IDX_SERIAL_NB_STR_CHAR,
    DIS_IDX_SERIAL_NB_STR_VAL,

    DIS_IDX_HARD_REV_STR_CHAR,
    DIS_IDX_HARD_REV_STR_VAL,

    DIS_IDX_FIRM_REV_STR_CHAR,
    DIS_IDX_FIRM_REV_STR_VAL,

    DIS_IDX_SW_REV_STR_CHAR,
    DIS_IDX_SW_REV_STR_VAL,

    DIS_IDX_SYSTEM_ID_CHAR,
    DIS_IDX_SYSTEM_ID_VAL,

    DIS_IDX_IEEE_CHAR,
    DIS_IDX_IEEE_VAL,

    DIS_IDX_PNP_ID_CHAR,
    DIS_IDX_PNP_ID_VAL,

    DIS_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;

diss_att_db定义

定义如下（diss.c文件中） 

/*
 * DIS ATTRIBUTES
 ****************************************************************************************
 */

/// Full DIS Database Description - Used to add attributes into the database
const struct attm_desc diss_att_db[DIS_IDX_NB] =
{
    // Device Information Service Declaration
    [DIS_IDX_SVC]                           =   {ATT_DECL_PRIMARY_SERVICE, PERM(RD, ENABLE), sizeof(diss_dis_svc),
                                                 sizeof(diss_dis_svc), (uint8_t *)&diss_dis_svc},

    // Manufacturer Name Characteristic Declaration
    [DIS_IDX_MANUFACTURER_NAME_CHAR]        =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_manufacturer_name_char),
                                                 sizeof(diss_manufacturer_name_char), (uint8_t *)&diss_manufacturer_name_char},
    // Manufacturer Name Characteristic Value
    [DIS_IDX_MANUFACTURER_NAME_VAL]         =   {ATT_CHAR_MANUF_NAME, PERM(RD, ENABLE), DIS_VAL_MAX_LEN, 0, NULL},

    // Model Number String Characteristic Declaration
    [DIS_IDX_MODEL_NB_STR_CHAR]             =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_model_nb_str_char),
                                                 sizeof(diss_model_nb_str_char), (uint8_t *)&diss_model_nb_str_char},
    // Model Number String Characteristic Value
    [DIS_IDX_MODEL_NB_STR_VAL]              =   {ATT_CHAR_MODEL_NB, PERM(RD, ENABLE), DIS_VAL_MAX_LEN, 0, NULL},

    // Serial Number String Characteristic Declaration
    [DIS_IDX_SERIAL_NB_STR_CHAR]            =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_serial_nb_str_char),
                                                 sizeof(diss_serial_nb_str_char), (uint8_t *)&diss_serial_nb_str_char},
    // Serial Number String Characteristic Value
    [DIS_IDX_SERIAL_NB_STR_VAL]             =   {ATT_CHAR_SERIAL_NB, PERM(RD, ENABLE), DIS_VAL_MAX_LEN, 0, NULL},

    // Hardware Revision String Characteristic Declaration
    [DIS_IDX_HARD_REV_STR_CHAR]             =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_hard_rev_str_char),
                                                 sizeof(diss_hard_rev_str_char), (uint8_t *)&diss_hard_rev_str_char},
    // Hardware Revision String Characteristic Value
    [DIS_IDX_HARD_REV_STR_VAL]              =   {ATT_CHAR_HW_REV, PERM(RD, ENABLE), DIS_VAL_MAX_LEN, 0, NULL},

    // Firmware Revision String Characteristic Declaration
    [DIS_IDX_FIRM_REV_STR_CHAR]             =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_firm_rev_str_char),
                                                 sizeof(diss_firm_rev_str_char), (uint8_t *)&diss_firm_rev_str_char},
    // Firmware Revision String Characteristic Value
    [DIS_IDX_FIRM_REV_STR_VAL]              =   {ATT_CHAR_FW_REV, PERM(RD, ENABLE), DIS_VAL_MAX_LEN, 0, NULL},

    // Software Revision String Characteristic Declaration
    [DIS_IDX_SW_REV_STR_CHAR]               =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_sw_rev_str_char),
                                                 sizeof(diss_sw_rev_str_char), (uint8_t *)&diss_sw_rev_str_char},
    // Software Revision String Characteristic Value
    [DIS_IDX_SW_REV_STR_VAL]                =   {ATT_CHAR_SW_REV, PERM(RD, ENABLE), DIS_VAL_MAX_LEN, 0, NULL},

    // System ID Characteristic Declaration
    [DIS_IDX_SYSTEM_ID_CHAR]                =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_system_id_char),
                                                 sizeof(diss_system_id_char), (uint8_t *)&diss_system_id_char},
    // System ID Characteristic Value
    [DIS_IDX_SYSTEM_ID_VAL]                 =   {ATT_CHAR_SYS_ID, PERM(RD, ENABLE), DIS_SYS_ID_LEN, 0, NULL},

    // IEEE 11073-20601 Regulatory Certification Data List Characteristic Declaration
    [DIS_IDX_IEEE_CHAR]                     =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_ieee_char),
                                                 sizeof(diss_ieee_char), (uint8_t *)&diss_ieee_char},
    // IEEE 11073-20601 Regulatory Certification Data List Characteristic Value
    [DIS_IDX_IEEE_VAL]                      =   {ATT_CHAR_IEEE_CERTIF, PERM(RD, ENABLE), DIS_VAL_MAX_LEN, 0, NULL},

    // PnP ID Characteristic Declaration
    [DIS_IDX_PNP_ID_CHAR]                   =   {ATT_DECL_CHARACTERISTIC, PERM(RD, ENABLE), sizeof(diss_pnp_id_char),
                                                 sizeof(diss_pnp_id_char), (uint8_t *)&diss_pnp_id_char},
    // PnP ID Characteristic Value
    [DIS_IDX_PNP_ID_VAL]                    =   {ATT_CHAR_PNP_ID, PERM(RD, ENABLE), DIS_PNP_ID_LEN, 0, NULL},
};

由上述定义我们来一个个分析bas_att_db的五个成员变量。

[DIS_IDX_SVC]

首先是[DIS_IDX_SVC]成员变量。
DIS_IDX_SVC的value是diss_dis_svc变量，具体如下：

const att_svc_desc_t diss_dis_svc = ATT_SVC_BATTERY_SERVICE;

我们可以看到diss_dis_svc被赋值为一个枚举类型变量，具体值为0x180A。
类似的还有ATT_SVC_GENERIC_ACCESS、ATT_SVC_GENERIC_ATTRIBUTE、ATT_SVC_BATTERY_SERVICE、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,
    ...
}

example

小结

DISS Database类型总结

No.Indexenum类型UUID
1DIS_IDX_SVCATT_DECL_PRIMARY_SERVICEDECLARATIONS0x2800
2DIS_IDX_MANUFACTURER_NAME_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
3DIS_IDX_MANUFACTURER_NAME_VALATT_CHAR_MANUF_NAMECHARACTERISTICS0x2A29
4DIS_IDX_MODEL_NB_STR_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
5DIS_IDX_MODEL_NB_STR_VALATT_CHAR_MODEL_NBCHARACTERISTICS0x2A24
6DIS_IDX_SERIAL_NB_STR_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
7DIS_IDX_SERIAL_NB_STR_VALATT_CHAR_SERIAL_NBCHARACTERISTICS0x2A25
8DIS_IDX_HARD_REV_STR_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
9DIS_IDX_HARD_REV_STR_VALATT_CHAR_HW_REVCHARACTERISTICS0x2A27
10DIS_IDX_FIRM_REV_STR_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
11DIS_IDX_FIRM_REV_STR_VALATT_CHAR_FW_REVCHARACTERISTICS0x2A26
12DIS_IDX_SW_REV_STR_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
13DIS_IDX_SW_REV_STR_VALATT_CHAR_SW_REVCHARACTERISTICS0x2A28
14DIS_IDX_SYSTEM_ID_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
15DIS_IDX_SYSTEM_ID_VALATT_CHAR_SYS_IDCHARACTERISTICS0x2A23
16DIS_IDX_IEEE_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
17DIS_IDX_IEEE_VALATT_CHAR_IEEE_CERTIFCHARACTERISTICS0x2A2A
18DIS_IDX_PNP_ID_CHARATT_DECL_CHARACTERISTICDECLARATIONS0x2803
19DIS_IDX_PNP_ID_VALATT_CHAR_PNP_IDCHARACTERISTICS0x2A50
导数题
关注
  • 0
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
设备信息服务1.1(Device Information Service 1.1)
技术学习
09-29 392
这里写目录标题一级目录二级目录三级目录 一级目录 二级目录 三级目录
DA14531学习笔记-DISS服务
weixin_51704569的博客
12-11 562
Dialog蓝牙芯片DA14531的学习
GATT之Device information Service
weixin_30512089的博客
08-19 940
许多开发者都在开发BLEPeripheral设备，当中往往包含本文要着急介绍的DeviceInformationService(DIS)服务，它是对设备的制作商，设备软硬件版本控制，生产信息披露的一个非常好的方式。因此也建议大家在开发时都加入这个由SIG定义的标准服务。 在bluetoothsig官方网站上，查看DeviceInformationService显示如下信息。 ...
借助调试工具理解BLE协议_3.Windows BLE调试工具
最新发布
huaqianzkh的专栏
06-04 1715
Windows BLE调试工具是一款运行在Windows下的BLE调试软件，实现了扫描、连接、获取BLE设备上的服务以及向服务写入和读取数据的功能。
NRF52832学习笔记（39）——设备信息服务(DIS)
Leung的博客
11-20 2526
一、简介 Device Information Service(DIS)服务，它是对设备的制造商，设备软硬件版本控制，生产信息披露的一个非常好的方式。因此也建议大家在开发时都加入这个由SIG定义的标准服务。DIS服务可通过使用GATT在LE、BR/EDR或HS设备上传输。 协议细节可在 Bluetooth SIG官网——设备信息服务1.1 中查看。 二、服务内容 Specification Name Specification Type Assign Number Specification Lev
第 8 章 Device information
weixin_34221332的博客
12-18 562
8.1.dmesg - print or control the kernel ring buffer dmesg neo@shenzhen:~/doc/Linux/xhtml$ dmesg Please enable JavaScript to view the <a href="https://dis...
Peripheral Drivers of DA1458x Software Platform----GPIO
ydgd118的博客
02-24 269
该驱动程序的源代码位于：sdk \ platform \ driver \ gpio。 一、 How to Use this Driver 1. 典型用法 ●在periph_setup.h中填充函数GPIO_reservations（）：为要使用的每个GPIO引脚添加带有适当参数的RESERVE_GPIO（）宏指令。 ●在periph_setup.h中填充函数set_pad_functions（）...
Diss-druha-semestralna-praca
03-30
【标题】"Diss-druha-semestralna-praca" 暗示这是一个关于学术研究或项目开发的文档，可能是一个大学的第二个学期的论文或项目。在IT行业中，这样的工作通常涉及到深入的技术实现和理论研究。由于标签是"Java"，...
Diss-Code-Review:查看代码上的GV
04-11
Diss代码审查 查看代码上的GV。 首先，这是Teil 1: Das Finden der Content Words 。 以后将使用它来创建几乎准备就绪的查找表。 循环表包含一个命令行工具，可在编写RDF时为您提供支持（即，它为大多数常用选项...
diss-spam-call:对骚扰电话，我们将以其人之身，还治其人之道
05-05
Diss Spam Call 更新记录 @19.04.09 更新：精简代码，仅保留diss骚扰电话的核心功能，增加验证码识别功能（识别度较低）。 @18.7.12 更新：当前版本已失效，百度离线包已增加验证码功能。尚无精力继续鼓捣。 功能 ...
cautious-computing-machine:Alyson的Diss数据和代码
03-29
对纯素食事件的调查数据进行分析，并在R版本4.0.3（2020-10-10）中进行分析-“兔宝宝-Wunnies怪胎”版权所有（C）2020 R统计计算基金会和RStudio版本1.3.1093:copyright: 2009-2020年RStudio，中国人民银行
Android Service完全解析，关于服务你所需知道的一切(上)
热门推荐
郭霖的专栏
10-31 29万+
相信大多数朋友对Service这个名词都不会陌生，没错，一个老练的Android程序员如果连Service都没听说过的话，那确实也太逊了。Service作为Android四大组件之一，在每一个应用程序中都扮演着非常重要的角色。它主要用于在后台处理一些耗时的逻辑，或者去执行某些需要长期运行的任务。必要的时候我们甚至可以在程序退出的情况下，让Service继续在后台保持运行状态。 不过，虽然Service几乎被每一个Android程序员所熟知，但并不是每个人都已经将Service的各个知识点都掌握得非常透彻。那
DA1458x BASS 初始化 -- Battery Service 分析（二）
王涵的博客
11-15 1601
OverviewBASS 分为两部分。一部分为Profile，另一部分为Application。 同样初始化也是分为两部分，一部分是BASS Profile初始化，另一部分是 BASS Application初始化。 BASS Profile 初始化本部分主要由bass.c和bass_task.c文件组成。 bass.c和bass_task.c一起构建起了一个rwip系统的TASK。 在Di
全面且简单明了的蓝牙服务及UUID介绍
tanqth的专栏
08-21 2万+
什么是蓝牙 蓝牙，是一种支持设备短距离通信（一般10m内）的无线电技术，能在包括移动电话、PDA、无线耳机、笔记本电脑、相关外设等众多设备之间进行无线信息交换。利用“蓝牙”技术，能够有效地简化移动通信终端设备之间的通信，也能够成功地简化设备与因特网Internet之间的通信，从而使数据传输变得更加迅速高效，为无线通信拓宽道路。 简单说，蓝牙就是一种使用无线电通信的技术去完成设备与设备间通讯与数据交换。 而我们通常使用的那些蓝牙耳机、蓝牙打印机、蓝牙手环、蓝牙鼠标等等设备，都是基于蓝牙通信技术对外提供某种（或
NRF51822蓝牙服务（6）——显示设备信息
SammySum的博客
12-10 1432
前言 有时候开发项目，我们希望能通过蓝牙直接读取到设备的信息，例如制造商、固件版本、硬件版本和软件版本等信息。所以，今天我们就直接使用官方提供的服务来实现这个需求。 实验分析 首先，我们需要把官方驱动例程添加到我们的工程（这里使用前面用到的串口例程）目录里面： 路径是：工程目录\components\ble\ble_services\ble_dis 接着，我们去看看官方提供给我们的接...
nrf51822代码阅读笔记三
碧海潮生
02-11 776
Device Information Service 这里来看下nordic nrf51822定义设备信息的service.This module implements the Device Information Service,这个模块用来实现设备信息服务。During initialization it adds the Device Information Service to the ...
DA1458x BASS Database的组成结构 -- Battery Service 分析（一）
王涵的博客
11-14 1130
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的变量
BLE芯片DA145XX系列：自定义GATT服务配置
zhangfls的博客
07-09 1083
Dialog的BLE芯片可以配置通用GATT服务以及自定义GATT服务，下面主要说明如何实现GATT服务的配置、GATT数据收发、配置BLE单次发送最大数据包MTU。
BLE UUID记录
低端玩家的记录地
03-18 5460
// Simple Profile Service UUID #define SIMPLEPROFILE_SERV_UUID 0xFFF0 // Key Pressed UUID #define SIMPLEPROFILE_CHAR1_UUID 0xFFF1 #define SIMPLEPROFILE_CHAR2_UUID
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值