服务中新建特性

从新建私人服务的过程中我们知道,我们并不关心服务中特性建立的具体细节,而是把官方已经写好的服务添加到我们的工程中,并根据自己的需求对其中的参数进行了修改。而如果要在一个服务中获取多个特性的值,或对多个特性进行写入数据操作,就需要新建多个特性。这里使用的还是ble_lbs.c这个文件,将在上一节的基础上分析这个文件。


在ble_lbs_init()函数中,添加一个特性这样表示:

err_code = button_char_add(p_lbs, p_lbs_init);

VERIFY_SUCCESS(err_code);

我们通过编写xxx_char_add()这个函数来添加一个特性,这里是添加一个按键的通知特性,所以函数命名为button_char_add()。

在xxx_char_add()函数中,主要完成了两个工作:

(1)特性参数配置:

ble_gatts_char_md_t char_md; //特性参数结构体定义,通过设置其中的参数来设置特性参数

ble_gatts_attr_md_t cccd_md; //attr_md结构体定义,用来配置cccd参数

//配置特性参数

  //配置ccmd的安全级别和储存位置

    memset(&cccd_md, 0, sizeof(cccd_md));

    BLE_GAP_CONN_SEC_MODE_SET_OPEN(&cccd_md.read_perm);            //可读

    BLE_GAP_CONN_SEC_MODE_SET_OPEN(&cccd_md.write_perm);          //可写

    cccd_md.vloc = BLE_GATTS_VLOC_STACK;                          //储存在堆栈中

    memset(&char_md, 0, sizeof(char_md));

    char_md.char_props.read  = 1;                      //该特性可读

    char_md.char_props.notify = 1;                      //该特性可通知

    char_md.p_char_user_desc  = NULL;                  //不使用描述符

    char_md.p_char_pf        = NULL;                  //不使用CPF

    char_md.p_user_desc_md    = NULL;                  //无属性元数据

    char_md.p_cccd_md        = &cccd_md;              //使用cccd描述符

    char_md.p_sccd_md        = NULL;                  //不使用服务端描述符

(2)GATT属性配置

ble_gatts_attr_t           attr_char_value;

ble_uuid_t                    ble_uuid;

 ble_gatts_attr_md_t    attr_md;    //GATT属性结构体定义

//配置GATT属性

    memset(&attr_md, 0, sizeof(attr_md));

    BLE_GAP_CONN_SEC_MODE_SET_OPEN(&attr_md.read_perm);       //可读

    BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS(&attr_md.write_perm);//不可写

    attr_md.vloc    = BLE_GATTS_VLOC_STACK;                        //储存在堆栈中

    attr_md.rd_auth = 0;                                            //读写无需应用程序授权

    attr_md.wr_auth = 0;                                            //

    attr_md.vlen    = 0;                                            //读写长度不可变

    memset(&attr_char_value, 0, sizeof(attr_char_value));

   ble_uuid.type = p_lbs->uuid_type;                  //uuid类型    

   ble_uuid.uuid =   LBS_UUID_BUTTON_CHAR;       //uuid

    attr_char_value.p_uuid    = &ble_uuid;  //配置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  = sizeof(uint8_t);      //最大长度

    attr_char_value.p_value  = NULL;                   //属性数据指针

(3)在特性参数和GATT参数设定后,要设置操作句柄。在xxx_char_add()的输入参数中,第一个输入参数是该服务的结构体指针,可以跳转到该结构体的定义中查看:

struct ble_lbs_s

{

    uint16_t                    service_handle;    

    ble_gatts_char_handles_t    led_char_handles;   

    ble_gatts_char_handles_t    button_char_handles;    //需添加的操作句柄

    uint8_t                    uuid_type;         

    ble_lbs_led_write_handler_t led_write_handler; 

};

(4)句柄设置完成后,需要把上面设置好的特性和GATT添加到协议栈中GATT层中作为数据接口,使用sd_ble_gatts_characteristic_add()函数,及xxx_char_add()的最后一部分。

return sd_ble_gatts_characteristic_add(p_lbs->service_handle,

                                          &char_md,

                                          &attr_char_value,

                                          &p_lbs->button_char_handles);

第1个参数是特性要加入的服务的句柄,指向你定义的这个点灯的服务。

第2个参数是特性的结构体&char_ md,它是-一个全局变量,它包含了前面特性设置的参数(读,写,通知等)。

第3个参数是值属性的描述结构体&attr _char_ value, 它包含了它的UUID,长度和初始值。

第4个参数是返回的特性和描述符的唯一句柄,这个句柄可以在以后用于区别服务里不同的特性。比如本例里返回变量button_ char_ handles (按键特性的句柄)作为唯一的按键通知的句柄。如果这个服务里有其他特性,则每种特性都有自己唯一声明的操作句柄。

(5)最后在服务初始化函数中调用,这个在最前面已经说了。


完成了新特性的建立后,我们还需要完善回调函数。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,761评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,953评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,998评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,248评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,130评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,145评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,550评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,236评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,510评论 1 291
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,601评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,376评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,247评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,613评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,911评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,191评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,532评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,739评论 2 335

推荐阅读更多精彩内容