BLE观察者模式回调机制解析

鱼鹰谈单片机 2023-11-26 20:00

nRF5 SDK从版本14开始,对事件回调机制做了更新,引入了观察者模式,以解耦不同BLE Layer对BLE事件的回调函数。

实现这套机制用到了Flash的段(Section),将RAM中的函数调用与Flash中的段操作结合到一起,这个想法很新颖。

本文尝试理解和追踪整个回调过程,并写一段代码验证我们的思路。

一、观察者模式简介

面向对象编程世界里有许多著名的设计模式,其中一种叫观察者模式,它解决的问题是:在某场景下对象之间存在一对多的依赖关系,当中心对象的状态发生改变,其他所有依赖于它的对象都能得到通知并自动更新。

观察者模式中有几种角色:观察者(Observer),主题(Subject)和发布者(Publisher)。

多个观察者可以独立的订阅(Subscribe)一个主题,当该主题收到发布者推送的数据,将数据通知(Notify)给各个观察者进行后续处理。

实现观察者模式,观察者端需要实现一个订阅功能,将自己的句柄和回调函数传递给主题。主机端应该有一个列表,所有订阅它的观察者句柄和回调函数都保存在该列表中,当需要通知时,则遍历列表中的各个句柄,分别执行各自的回调函数。发布者给主题发数据,则简单的暴露一个接口即可。

更进一步的,在代码中要将句柄和回调函数封装成一个结构体,这样就可以方便传参。观察者准备一个函数,将该结构体保存到一个列表中,这个函数称为订阅。主题准备一个函数,读取该列表,遍历获得各个结构体,并执行回调,这个函数称为通知。

设计这个列表是关键。

最简单的办法是准备一个内存数组,订阅函数即写数组,通知函数即读数组。

nRF5 SDK选择了另一种方式,使用Flash的段。

二、Flash段简介

本文使用SEGGER Embedded Studio开发工具进行介绍,它后端使用arm gcc编译器,需要用到它的链接文件(.ld)和map文件(.map)。

Flash的段是指在Flash中指定一块空间,包含首地址和空间长度,并设定一个段名。段名以点(.)开头。

C语言开发中经常提及的段有代码段.text,常量段.rodata等。

利用__attribute__关键字,可以为变量指定段名,以下代码将变量my_var存放在段.my_section中:

static my_type_t my_var __attribute__ ((section(".my_section"))) __attribute__((used)) = {    .handler    = handler,    .p_context  = NULL};

还需要在内存布局文件中,设定好该段的起始地址和长度。编译SES工程,将生成链接文件(.ld),可以看到诸如以下代码:

.sdh_ble_observers ALIGN(__pwr_mgmt_data_end__ , 4) : AT(ALIGN(__pwr_mgmt_data_end__ , 4)){__sdh_ble_observers_start__ = .;__start_sdh_ble_observers =   __sdh_ble_observers_start__;KEEP(*(SORT(.sdh_ble_observers*)))}__sdh_ble_observers_end__ = __sdh_ble_observers_start__ + SIZEOF(.sdh_ble_observers);__sdh_ble_observers_size__ = SIZEOF(.sdh_ble_observers);

其中xx_start__表示起始地址, xx_size__表示长度,xx_end__表示结束地址。

注意到一个关键行:KEEP(*(SORT(.sdh_ble_observers*)))。

该行使用了通配符,.sdh_ble_observers*末尾的星号表示任意字符,所以我们可能在代码中看到形如.sdh_ble_observers1这种段名。SORT表示将这些通配符所匹配的段按名称增序排列。

查看map文件,可以看到如下记录:

.sdh_ble_observers                0x0000000000030ae4       0x30                0x0000000000030ae4                __sdh_ble_observers_start__ = .                0x0000000000030ae4                __start_sdh_ble_observers = __sdh_ble_observers_start__ *(SORT_BY_NAME(.sdh_ble_observers*)) .sdh_ble_observers0                0x0000000000030ae4        0x8 Output/ble_app_blinky_pca10040_s132 Debug/Obj/ble_conn_state.o .sdh_ble_observers1                0x0000000000030aec        0x8 Output/ble_app_blinky_pca10040_s132 Debug/Obj/main.o .sdh_ble_observers1                0x0000000000030af4        0x8 Output/ble_app_blinky_pca10040_s132 Debug/Obj/ble_conn_params.o .sdh_ble_observers2                0x0000000000030afc       0x10 Output/ble_app_blinky_pca10040_s132 Debug/Obj/main.o

在map文件中,我们看到了多个名字相似的段.sdh_ble_observers[0, 1, 2],它们摆列在一起,Flash地址前后相接,并且它们长度之和等于.sdh_ble_observers段长度。

可以认为.sdh_ble_observers*是 .sdh_ble_observers的子段。

如何获取段内的数据呢?

一个是直接调用变量名,比如上面的my_var,另一种是通过段名,索引出其中的子段内容。SDK中提供了段操作的函数库nrf_section_iter, 如果已知一个段名,可以利用以下代码获取其中的子段内容:

nrf_section_iter_t  iter;for (nrf_section_iter_init(&iter, &my_section);        nrf_section_iter_get(&iter) != NULL;        nrf_section_iter_next(&iter)){    my_type_t     * p_section;    p_section = (my_type_t*)nrf_section_iter_get(&iter);}

三、BLE事件回调

以SDK15.1/ble_app_blinky工程为例, 追踪它的BLE回调事件的调用逻辑。

在main.c –> ble_stack_init()中,调用了:

NRF_SDH_BLE_OBSERVER(m_ble_observer, APP_BLE_OBSERVER_PRIO, ble_evt_handler, NULL);

其中ble_evt_handler是我们设定的BLE事件回调函数。

NRF_SDH_BLE_OBSERVER是一个异常复杂嵌套宏,经过层层解剖,该代码变成如下形式:

static nrf_sdh_ble_evt_observer_t m_ble_observer __attribute__ ((section(".sdh_ble_observers3"))) __attribute__((used)) ={    .handler    =ble_evt_handler,    .p_context  = NULL};

这个代码在 .sdh_ble_observers3 段中定义一个结构体变量,并且将回调函数设定为参数。

那ble_evt_handler()是在什么地方调用的呢?

找到nrf_sdh_ble.c -> nrf_sdh_ble_evts_poll(),看见关键代码:

nrf_section_iter_t  iter;for (nrf_section_iter_init(&iter, &sdh_ble_observers);        nrf_section_iter_get(&iter) != NULL;        nrf_section_iter_next(&iter)){    nrf_sdh_ble_evt_observer_t * p_observer;    nrf_sdh_ble_evt_handler_t    handler;
p_observer = (nrf_sdh_ble_evt_observer_t *)nrf_section_iter_get(&iter); handler = p_observer->handler;
handler(p_ble_evt, p_observer->p_context);}

这正是我们上面分析的,通过段名来获取所有的子段内容,然后执行其回调函数。

仍然在该文件中,进一步找到关键代码:

NRF_SDH_STACK_OBSERVER(m_nrf_sdh_ble_evts_poll, NRF_SDH_BLE_STACK_OBSERVER_PRIO) ={    .handler   = nrf_sdh_ble_evts_poll,    .p_context = NULL,};

与上面类似,这是个嵌套宏,经过层层解剖,得到如下代码:

static nrf_sdh_stack_observer_t m_nrf_sdh_ble_evts_poll __attribute__ ((section(".sdh_stack_observers2"))) __attribute__((used)) ={    .handler    =nrf_sdh_ble_evts_poll,    .p_context  = NULL};

那 nrf_sdh_ble_evts_poll()是在什么地方调用的呢?

找到nrf_sdh.c -> nrf_sdh_evts_poll(),看见关键代码:

for (nrf_section_iter_init(&iter, &sdh_stack_observers);        nrf_section_iter_get(&iter) != NULL;        nrf_section_iter_next(&iter)){    nrf_sdh_stack_observer_t    * p_observer;    nrf_sdh_stack_evt_handler_t   handler;
p_observer = (nrf_sdh_stack_observer_t *) nrf_section_iter_get(&iter); handler = p_observer->handler;
handler(p_observer->p_context);}

进一步,看到该函数的调用地点:

void SD_EVT_IRQHandler(void){    nrf_sdh_evts_poll();}

SD_EVT_IRQHandler是BLE事件的中断处理函数,一旦芯片产生BLE事件,都会进入到这个中断处理函数中。按照上面的追踪思路反向推导,就能够调用到最初的ble_evt_handler回调函数。

至此我们搞清楚了BLE事件回调的跳转逻辑。

四、几处细节

(1)SD_EVT_IRQHandler 是什么

它是BLE事件中断。

经过多次重定义跳转,我们找到它最初的名字:SWI2_EGU2_IRQHandler。

在ses_startup_nrf52.s文件中,看出它是一个中断向量:

/* External Interrupts */  .word   POWER_CLOCK_IRQHandler  .word   RADIO_IRQHandler  .word   UARTE0_UART0_IRQHandler// ....  .word   COMP_LPCOMP_IRQHandler  .word   SWI0_EGU0_IRQHandler  .word   SWI1_EGU1_IRQHandler  .word   SWI2_EGU2_IRQHandler  .word   SWI3_EGU3_IRQHandler

为什么它就代表了BLE的事件中断呢?

在芯片手册的Memory章节,找到Instantiation小节,列出了全部的中断向量地址:

比较这个列表与上面的中断向量定义,发现它们是一一对应,严格按顺序排列的。所以排到SWI2_EGU2_IRQHandler所在的位置,就代表了SWI2和EGU2的中断向量,无论它取什么名字。

注意,SWI2和EGU2使用了同样的向量地址,所以它们共享一个中断向量,于是向量名称写成SWI2_EGU2_IRQHandler。

(2)为什么要索引两次

在nrf_sdh_evts_poll函数中,调用了 nrf_sdh_ble_evts_poll(),然后再调用我们的ble_evt_handler,为什么要索引两次呢?

仔细看代码发现,nrf_sdh_evts_poll处理了BLE和SOC两种事件。而ble_evt_handler只是BLE事件。

这是因为SWI2和EGU2这二者共享一个中断向量,它们出了给出BLE事件中断,还会给出SOC相关的中断,比如时钟Clock等。

(3)APP_BLE_OBSERVER_PRIO是什么

它代表了优先级。

前面提到.ld文件中使用了SORT对所有子段进行增序排列,优先级数值小的排前面,大的排后面,在索引子段内容时候,总是先执行高优先级(数值小)的回调函数,后执行低优先级(数值大)的回调函数,相同优先级的回调则不能确定执行顺序。

(4)观察者角色

在上面的分析中,NRF_SDH_BLE_OBSERVER意味着订阅函数,main.c中的BLE处理相当于一个观察者。

SDK中将订阅函数进一步封装成BLE_XXX_DEF()的宏形式,比如GATT的订阅函数宏:

NRF_BLE_GATT_DEF(_name)

许多BLE库都提供了订阅函数宏,使用时候只需在main.c中声明它们。

BLE通用订阅函数宏:#define BLE_ADVERTISING_DEF(_name)#define BLE_DB_DISCOVERY_DEF(_name)#define BLE_LINK_CTX_MANAGER_DEF()#define NRF_BLE_SCAN_DEF(_name)#define NRF_BLE_GATT_DEF(_name)#define NRF_BLE_QWR_DEF(_name)
BLE Profile订阅函数宏:#define BLE_BAS_DEF(_name)#define BLE_BPS_DEF(_name)#define BLE_CSCS_DEF(_name)#define BLE_GLS_DEF(_name)#define BLE_HIDS_DEF()#define BLE_HRS_DEF(_name)#define BLE_HTS_DEF(_name)#define BLE_LBS_DEF(_name)...

如果我们创建一个自定义的Profile,也应该提供一个这样的订阅函数宏。

nrf_sdh_ble_evts_poll和nrf_sdh_evts_poll相当于通知函数,nrf_sdh.c和nrf_sdh_ble.c充当主题角色。

发布者是芯片, SD_EVT_IRQHandler中断就是发布者向主题推送数据接口。

五、验证

尝试写一段代码,验证这种段操作的观察者模式。

先定义一个段:syq_sections

typedef void (*syq_handler_t)(uint8_t const evt_code, void * p_context);
typedef struct{ syq_handler_t handler; //!< BLE event handler. void * p_context; //!< A parameter to the event handler.} const syq_type_t;
NRF_SECTION_SET_DEF(syq_sections, syq_type_t, NRF_SDH_BLE_OBSERVER_PRIO_LEVELS);

设定三个不同优先级的段变量:

void syq_handler1(uint8_t const evt_code, void * p_context){    NRF_LOG_INFO("handler1 is triggered");}
static syq_type_t m_syq_1 __attribute__ ((section(".syq_sections1"))) __attribute__((used)) = { .handler = syq_handler1, .p_context = NULL};
void syq_handler2(uint8_t const evt_code, void * p_context){ NRF_LOG_INFO("handler2 is triggered");}
static syq_type_t m_syq_2 __attribute__ ((section(".syq_sections2"))) __attribute__((used)) = { .handler = syq_handler2, .p_context = NULL};
void syq_handler3(uint8_t const evt_code, void * p_context){ NRF_LOG_INFO("handler3 is triggered");}
static syq_type_t m_syq_3 __attribute__ ((section(".syq_sections3"))) __attribute__((used)) = { .handler = syq_handler3, .p_context = NULL};

在主函数中执行索引:

nrf_section_iter_t  iter;for (nrf_section_iter_init(&iter, &syq_sections);        nrf_section_iter_get(&iter) != NULL;        nrf_section_iter_next(&iter)) {    syq_type_t * p_observer;    syq_handler_t    handler;
p_observer = (syq_type_t *)nrf_section_iter_get(&iter); handler = p_observer->handler;
handler(1, p_observer->p_context);}

这样就可以依次执行三个不同优先级的回调函数,打印结果如下:

利用这套做法,实现了一个简单的观察者模式。

本文来源网络,免费传达知识,版权归原作者所有。如涉及作品版权问题,请联系我进行删除。


点击阅读原文可跳转至链接查看。

鱼鹰谈单片机 面向软件开发进阶读者,分享包括但不限于 C 语言、KEIL、STM32、51 等知识!
评论
  • RDDI-DAP错误通常与调试接口相关,特别是在使用CMSIS-DAP协议进行嵌入式系统开发时。以下是一些可能的原因和解决方法: 1. 硬件连接问题:     检查调试器(如ST-Link)与目标板之间的连接是否牢固。     确保所有必要的引脚都已正确连接,没有松动或短路。 2. 电源问题:     确保目标板和调试器都有足够的电源供应。     检查电源电压是否符合目标板的规格要求。 3. 固件问题: &n
    丙丁先生 2024-12-01 17:37 100浏览
  • 遇到部分串口工具不支持1500000波特率,这时候就需要进行修改,本文以触觉智能RK3562开发板修改系统波特率为115200为例,介绍瑞芯微方案主板Linux修改系统串口波特率教程。温馨提示:瑞芯微方案主板/开发板串口波特率只支持115200或1500000。修改Loader打印波特率查看对应芯片的MINIALL.ini确定要修改的bin文件#查看对应芯片的MINIALL.ini cat rkbin/RKBOOT/RK3562MINIALL.ini修改uart baudrate参数修改以下目
    Industio_触觉智能 2024-12-03 11:28 87浏览
  • 光伏逆变器是一种高效的能量转换设备,它能够将光伏太阳能板(PV)产生的不稳定的直流电压转换成与市电频率同步的交流电。这种转换后的电能不仅可以回馈至商用输电网络,还能供独立电网系统使用。光伏逆变器在商业光伏储能电站和家庭独立储能系统等应用领域中得到了广泛的应用。光耦合器,以其高速信号传输、出色的共模抑制比以及单向信号传输和光电隔离的特性,在光伏逆变器中扮演着至关重要的角色。它确保了系统的安全隔离、干扰的有效隔离以及通信信号的精准传输。光耦合器的使用不仅提高了系统的稳定性和安全性,而且由于其低功耗的
    晶台光耦 2024-12-02 10:40 120浏览
  • 作为优秀工程师的你,已身经百战、阅板无数!请先醒醒,新的项目来了,这是一个既要、又要、还要的产品需求,ARM核心板中一个处理器怎么能实现这么丰富的外围接口?踌躇之际,你偶阅此文。于是,“潘多拉”的魔盒打开了!没错,USB资源就是你打开新世界得钥匙,它能做哪些扩展呢?1.1  USB扩网口通用ARM处理器大多带两路网口,如果项目中有多路网路接口的需求,一般会选择在主板外部加交换机/路由器。当然,出于成本考虑,也可以将Switch芯片集成到ARM核心板或底板上,如KSZ9897、
    万象奥科 2024-12-03 10:24 68浏览
  • 最近几年,新能源汽车愈发受到消费者的青睐,其销量也是一路走高。据中汽协公布的数据显示,2024年10月,新能源汽车产销分别完成146.3万辆和143万辆,同比分别增长48%和49.6%。而结合各家新能源车企所公布的销量数据来看,比亚迪再度夺得了销冠宝座,其10月新能源汽车销量达到了502657辆,同比增长66.53%。众所周知,比亚迪是新能源汽车领域的重要参与者,其一举一动向来为外界所关注。日前,比亚迪汽车旗下品牌方程豹汽车推出了新车方程豹豹8,该款车型一上市就迅速吸引了消费者的目光,成为SUV
    刘旷 2024-12-02 09:32 119浏览
  • 《高速PCB设计经验规则应用实践》+PCB绘制学习与验证读书首先看目录,我感兴趣的是这一节;作者在书中列举了一条经典规则,然后进行详细分析,通过公式推导图表列举说明了传统的这一规则是受到电容加工特点影响的,在使用了MLCC陶瓷电容后这一条规则已经不再实用了。图书还列举了高速PCB设计需要的专业工具和仿真软件,当然由于篇幅所限,只是介绍了一点点设计步骤;我最感兴趣的部分还是元件布局的经验规则,在这里列举如下:在这里,演示一下,我根据书本知识进行电机驱动的布局:这也算知行合一吧。对于布局书中有一句:
    wuyu2009 2024-11-30 20:30 124浏览
  •         温度传感器的精度受哪些因素影响,要先看所用的温度传感器输出哪种信号,不同信号输出的温度传感器影响精度的因素也不同。        现在常用的温度传感器输出信号有以下几种:电阻信号、电流信号、电压信号、数字信号等。以输出电阻信号的温度传感器为例,还细分为正温度系数温度传感器和负温度系数温度传感器,常用的铂电阻PT100/1000温度传感器就是正温度系数,就是说随着温度的升高,输出的电阻值会增大。对于输出
    锦正茂科技 2024-12-03 11:50 109浏览
  • 戴上XR眼镜去“追龙”是种什么体验?2024年11月30日,由上海自然博物馆(上海科技馆分馆)与三湘印象联合出品、三湘印象旗下观印象艺术发展有限公司(下简称“观印象”)承制的《又见恐龙》XR嘉年华在上海自然博物馆重磅开幕。该体验项目将于12月1日正式对公众开放,持续至2025年3月30日。双向奔赴,恐龙IP撞上元宇宙不久前,上海市经济和信息化委员会等部门联合印发了《上海市超高清视听产业发展行动方案》,特别提到“支持博物馆、主题乐园等场所推动超高清视听技术应用,丰富线下文旅消费体验”。作为上海自然
    电子与消费 2024-11-30 22:03 98浏览
  • TOF多区传感器: ND06   ND06是一款微型多区高集成度ToF测距传感器,其支持24个区域(6 x 4)同步测距,测距范围远达5m,具有测距范围广、精度高、测距稳定等特点。适用于投影仪的无感自动对焦和梯形校正、AIoT、手势识别、智能面板和智能灯具等多种场景。                 如果用ND06进行手势识别,只需要经过三个步骤: 第一步&
    esad0 2024-12-04 11:20 50浏览
  • 当前,智能汽车产业迎来重大变局,随着人工智能、5G、大数据等新一代信息技术的迅猛发展,智能网联汽车正呈现强劲发展势头。11月26日,在2024紫光展锐全球合作伙伴大会汽车电子生态论坛上,紫光展锐与上汽海外出行联合发布搭载紫光展锐A7870的上汽海外MG量产车型,并发布A7710系列UWB数字钥匙解决方案平台,可应用于数字钥匙、活体检测、脚踢雷达、自动泊车等多种智能汽车场景。 联合发布量产车型,推动汽车智能化出海紫光展锐与上汽海外出行达成战略合作,联合发布搭载紫光展锐A7870的量产车型
    紫光展锐 2024-12-03 11:38 101浏览
  • 概述 说明(三)探讨的是比较器一般带有滞回(Hysteresis)功能,为了解决输入信号转换速率不够的问题。前文还提到,即便使能滞回(Hysteresis)功能,还是无法解决SiPM读出测试系统需要解决的问题。本文在说明(三)的基础上,继续探讨为SiPM读出测试系统寻求合适的模拟脉冲检出方案。前四代SiPM使用的高速比较器指标缺陷 由于前端模拟信号属于典型的指数脉冲,所以下降沿转换速率(Slew Rate)过慢,导致比较器检出出现不必要的问题。尽管比较器可以使能滞回(Hysteresis)模块功
    coyoo 2024-12-03 12:20 111浏览
  • 11-29学习笔记11-29学习笔记习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习笔记&记录学习习笔记&记学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&学习学习笔记&记录学习学习笔记&记录学习学习笔记&记
    youyeye 2024-12-02 23:58 71浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦