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 等知识!
评论
  • 日前,商务部等部门办公厅印发《手机、平板、智能手表(手环)购新补贴实施方案》明确,个人消费者购买手机、平板、智能手表(手环)3类数码产品(单件销售价格不超过6000元),可享受购新补贴。每人每类可补贴1件,每件补贴比例为减去生产、流通环节及移动运营商所有优惠后最终销售价格的15%,每件最高不超过500元。目前,京东已经做好了承接手机、平板等数码产品国补优惠的落地准备工作,未来随着各省市关于手机、平板等品类的国补开启,京东将第一时间率先上线,满足消费者的换新升级需求。为保障国补的真实有效发放,基于
    华尔街科技眼 2025-01-17 10:44 69浏览
  • 百佳泰特为您整理2025年1月各大Logo的最新规格信息,本月有更新信息的logo有HDMI、Wi-Fi、Bluetooth、DisplayHDR、ClearMR、Intel EVO。HDMI®▶ 2025年1月6日,HDMI Forum, Inc. 宣布即将发布HDMI规范2.2版本。新规范将支持更高的分辨率和刷新率,并提供更多高质量选项。更快的96Gbps 带宽可满足数据密集型沉浸式和虚拟应用对传输的要求,如 AR/VR/MR、空间现实和光场显示,以及各种商业应用,如大型数字标牌、医疗成像和
    百佳泰测试实验室 2025-01-16 15:41 128浏览
  • 随着消费者对汽车驾乘体验的要求不断攀升,汽车照明系统作为确保道路安全、提升驾驶体验以及实现车辆与环境交互的重要组成,日益受到业界的高度重视。近日,2024 DVN(上海)国际汽车照明研讨会圆满落幕。作为照明与传感创新的全球领导者,艾迈斯欧司朗受邀参与主题演讲,并现场展示了其多项前沿技术。本届研讨会汇聚来自全球各地400余名汽车、照明、光源及Tier 2供应商的专业人士及专家共聚一堂。在研讨会第一环节中,艾迈斯欧司朗系统解决方案工程副总裁 Joachim Reill以深厚的专业素养,主持该环节多位
    艾迈斯欧司朗 2025-01-16 20:51 64浏览
  • 近期,智能家居领域Matter标准的制定者,全球最具影响力的科技联盟之一,连接标准联盟(Connectivity Standards Alliance,简称CSA)“利好”频出,不仅为智能家居领域的设备制造商们提供了更为快速便捷的Matter认证流程,而且苹果、三星与谷歌等智能家居平台厂商都表示会接纳CSA的Matter认证体系,并计划将其整合至各自的“Works with”项目中。那么,在本轮“利好”背景下,智能家居的设备制造商们该如何捉住机会,“掘金”万亿市场呢?重认证快通道计划,为家居设备
    华普微HOPERF 2025-01-16 10:22 133浏览
  • 晶台光耦KL817和KL3053在小家电产品(如微波炉等)辅助电源中的广泛应用。具备小功率、高性能、高度集成以及低待机功耗的特点,同时支持宽输入电压范围。▲光耦在实物应用中的产品图其一次侧集成了交流电压过零检测与信号输出功能,该功能产生的过零信号可用于精确控制继电器、可控硅等器件的过零开关动作,从而有效减小开关应力,显著提升器件的使用寿命。通过高度的集成化和先进的控制技术,该电源大幅减少了所需的外围器件数量,不仅降低了系统成本和体积,还进一步增强了整体的可靠性。▲电路示意图该电路的过零检测信号由
    晶台光耦 2025-01-16 10:12 84浏览
  • 一个易用且轻量化的UI可以大大提高用户的使用效率和满意度——通过快速启动、直观操作和及时反馈,帮助用户快速上手并高效完成任务;轻量化设计则可以减少资源占用,提升启动和运行速度,增强产品竞争力。LVGL(Light and Versatile Graphics Library)是一个免费开源的图形库,专为嵌入式系统设计。它以轻量级、高效和易于使用而著称,支持多种屏幕分辨率和硬件配置,并提供了丰富的GUI组件,能够帮助开发者轻松构建出美观且功能强大的用户界面。近期,飞凌嵌入式为基于NXP i.MX9
    飞凌嵌入式 2025-01-16 13:15 120浏览
  • 随着智慧科技的快速发展,智能显示器的生态圈应用变得越来越丰富多元,智能显示器不仅仅是传统的显示设备,透过结合人工智能(AI)和语音助理,它还可以成为家庭、办公室和商业环境中的核心互动接口。提供多元且个性化的服务,如智能家居控制、影音串流拨放、实时信息显示等,极大提升了使用体验。此外,智能家居系统的整合能力也不容小觑,透过智能装置之间的无缝连接,形成了强大的多元应用生态圈。企业也利用智能显示器进行会议展示和多方远程合作,大大提高效率和互动性。Smart Display Ecosystem示意图,作
    百佳泰测试实验室 2025-01-16 15:37 130浏览
  • 实用性高值得收藏!! (时源芯微)时源专注于EMC整改与服务,配备完整器件 TVS全称Transient Voltage Suppre,亦称TVS管、瞬态抑制二极管等,有单向和双向之分。单向TVS 一般应用于直流供电电路,双向TVS 应用于电压交变的电路。在直流电路的应用中,TVS被并联接入电路中。在电路处于正常运行状态时,TVS会保持截止状态,从而不对电路的正常工作产生任何影响。然而,一旦电路中出现异常的过电压,并且这个电压达到TVS的击穿阈值时,TVS的状态就会
    时源芯微 2025-01-16 14:23 128浏览
  • 80,000人到访的国际大展上,艾迈斯欧司朗有哪些亮点?感未来,光无限。近日,在慕尼黑electronica 2024现场,ams OSRAM通过多款创新DEMO展示,以及数场前瞻洞察分享,全面展示自身融合传感器、发射器及集成电路技术,精准捕捉并呈现环境信息的卓越能力。同时,ams OSRAM通过展会期间与客户、用户等行业人士,以及媒体朋友的深度交流,向业界传达其以光电技术为笔、以创新为墨,书写智能未来的深度思考。electronica 2024electronica 2024构建了一个高度国际
    艾迈斯欧司朗 2025-01-16 20:45 59浏览
  •  光伏及击穿,都可视之为 复合的逆过程,但是,复合、光伏与击穿,不单是进程的方向相反,偏置状态也不一样,复合的工况,是正偏,光伏是零偏,击穿与漂移则是反偏,光伏的能源是外来的,而击穿消耗的是结区自身和电源的能量,漂移的载流子是 客席载流子,须借外延层才能引入,客席载流子 不受反偏PN结的空乏区阻碍,能漂不能漂,只取决于反偏PN结是否处于外延层的「射程」范围,而穿通的成因,则是因耗尽层的过度扩张,致使跟 端子、外延层或其他空乏区 碰触,当耗尽层融通,耐压 (反向阻断能力) 即告彻底丧失,
    MrCU204 2025-01-17 11:30 82浏览
  • 故障现象 一辆2007款法拉利599 GTB车,搭载6.0 L V12自然吸气发动机(图1),累计行驶里程约为6万km。该车因发动机故障灯异常点亮进厂检修。 图1 发动机的布置 故障诊断接车后试车,发动机怠速轻微抖动,发动机故障灯长亮。用故障检测仪检测,发现发动机控制单元(NCM)中存储有故障代码“P0300 多缸失火”“P0309 气缸9失火”“P0307 气缸7失火”,初步判断发动机存在失火故障。考虑到该车使用年数较长,决定先使用虹科Pico汽车示波器进行相对压缩测试,以
    虹科Pico汽车示波器 2025-01-15 17:30 85浏览
  • 全球领先的光学解决方案供应商艾迈斯欧司朗(SIX:AMS)近日宣布,与汽车技术领先者法雷奥合作,采用创新的开放系统协议(OSP)技术,旨在改变汽车内饰照明方式,革新汽车行业座舱照明理念。结合艾迈斯欧司朗开创性的OSIRE® E3731i智能LED和法雷奥的动态环境照明系统,两家公司将为车辆内饰设计和功能设立一套全新标准。汽车内饰照明的作用日益凸显,座舱设计的主流趋势应满足终端用户的需求:即易于使用、个性化,并能提供符合用户生活方式的清晰信息。因此,动态环境照明带来了众多新机遇。智能LED的应用已
    艾迈斯欧司朗 2025-01-15 19:00 71浏览
  • 电竞鼠标应用环境与客户需求电竞行业近年来发展迅速,「鼠标延迟」已成为决定游戏体验与比赛结果的关键因素。从技术角度来看,传统鼠标的延迟大约为20毫秒,入门级电竞鼠标通常为5毫秒,而高阶电竞鼠标的延迟可降低至仅2毫秒。这些差异看似微小,但在竞技激烈的游戏中,尤其在对反应和速度要求极高的场景中,每一毫秒的优化都可能带来致胜的优势。电竞比赛的普及促使玩家更加渴望降低鼠标延迟以提升竞技表现。他们希望通过精确的测试,了解不同操作系统与设定对延迟的具体影响,并寻求最佳配置方案来获得竞技优势。这样的需求推动市场
    百佳泰测试实验室 2025-01-16 15:45 171浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦