差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- cc2640r2f:application_architecture [2017/09/01 20:24]
wuyl
+++ cc2640r2f:application_architecture [2019/08/29 19:55]
jaylee ↷ 页面cc2640r2f:ble_stack_app:app:application_architecture被移动至cc2640r2f:application_architecture
@@ 行 3: / 行 3: @@
 # 应用程序 #
-这个章节将详细讲解 CC2640R2F BLE5.0 的应用程序框架，我们希望已经按照学习线路图储备了<a href ="..\..\cc2640r2f_architecture\software_and_hardware\overview\overview.html"> CC2640R2F平台的软硬件架构知识 </a>，明白应用工程区分App 和 Stack 工程管理。
+本章节将详细讲解 CC2640R2F BLE5.0 的应用程序框架，我们希望您已经按照学习线路图储备了<a href ="http://docs.leconiot.com/doku.php?id=cc2640r2f:cc2640r2f_architecture:software_and_hardware:overview:overview"> CC2640R2F平台的软硬件架构知识 </a>，明白应用工程区分 App 和 Stack 工程管理。
-本章主要内容是围绕 TI-RTOS 的 App 应用程序框架。
+本章主要内容是围绕基于 TI-RTOS 的 App 应用程序框架。
 ![](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/image43.jpeg)
+图1. 应用程序框架图
 以 simple_peripheral Demo 应用程序部分为例，包括以下内容：
@@ 行 60: / 行 62: @@
 ### 介绍 ###
-在<a href="..\..\cc2640r2f_architecture\software_and_hardware\software\software_architecture.html">软件架构</a>章节阐述了由于历史兼容原因会把整个应用工程区分 App 和 Stack 两个工程管理。因此，无法采用常规 API 调用和全局变量方式完成消息传递，App 和 Stack 之间的通信就需要重新考虑了。TI 引入了 ICALL 消息机制完成 App 和 Stack 独立工程管理的相互通信，接下来就着重理解原理和代码实现。
+在<a href="http://docs.leconiot.com/doku.php?id=cc2640r2f:cc2640r2f_architecture:software_and_hardware:software:software_architecture">软件架构</a>章节阐述了由于历史兼容原因会把整个应用工程区分 App 和 Stack 两个工程管理。因此，无法采用常规 API 调用和全局变量方式完成消息传递，App 和 Stack 之间的通信就需要重新考虑了。TI 引入了 ICALL 消息机制完成 App 和 Stack 独立工程管理的相互通信，接下来就着重理解原理和代码实现。
 Indirect Call Framework (** ICall 消息框架**)是基于 TI-RTOS 提供服务（例如，同步线程、消息、事件）并完成 BLE 协议栈和应用程序在两个工程的消息交互的框架，它能够保证应用程序和协议栈在统一的 TI-RTOS 环境中完成高效运行、相互通信和资源共享。
-ICall 架构的核心组件是其消息调度( dispatcher )，消息调度的帮助程序在两个镜像/工程中完成 BLE5-Stack 协议栈以及库配置中的应用程序交互。尽管大多数 ICall 交互在 BLE5-Stack API（例如 GAP，HCI 等）中已经被抽象化（已经被封装为消息原语函数），但是必须理解它们在 BLE-Stack 和多线程 RTOS 环境中正常运行的基础架构。
+ICall 架构的核心组件是其消息调度( dispatcher )，消息调度帮助程序在两个 镜像/工程 中完成 BLE5-Stack 协议栈以及库配置中同应用程序交互。尽管大多数 ICall 交互在 BLE5-Stack API（例如 GAP，HCI 等）中已经被抽象化（已经被封装为消息原语函数），但是还是需要理解它们在 BLE-Stack 和多线程 RTOS 环境中正常运行的基础架构。
 ** ICALL **源码在应用工程（例如本文的 simple_peripheral ）的 ICALL BLE/ICALL 文件夹路径。
-![ICall 应用-协议栈 抽象](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/image68.jpeg)
+![](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/image68.jpeg)
+图2. ICall 应用-协议栈 抽象
 ### ICall BLE5 协议栈服务端 ###
-如上图所示，** ICALL **实现包含一个客户端实体（例如我们的应用程序）和一个服务器实体（即这里的 BLE5.0 协议栈）之间的通信。
+如图 2 所示，** ICALL **实现包含一个客户端实体（例如我们的应用程序）和一个服务器实体（即这里的 BLE5.0 协议栈）之间的通信。
 > **注意** ：正确区分** ICALL **框架的 CS 架构以及 GATT 服务器和客户端的架构，后者主要由 BLE 协议栈所定义实现。
@@ 行 89: / 行 93: @@
 ### ICALL 原语服务 ###
-ICALl 一系列的原语服务都被抽象成基于 RTOS 相关的函数接口。由于共享资源和线程之间的通信，应用程序必须使用以下 ICALL 原语服务功能：
+ICALl 一系列的原语服务都被抽象成基于 RTOS 相关的函数接口。由于共享资源和多线程之间的通信，应用程序必须使用以下 ICALL 原语服务功能：
 * 消息传递和线程同步
@@ 行 98: / 行 102: @@
 ** ICall **同协议栈的消息传递和线程同步都是是基于 TI-RTOS 多线程。
-** ICall **两个任务在消息队列发送一个阻塞消息时实现消息传递。发送方动态分配一段内存，将消息的内容写入内存，将这段内存发送（即排队）到接收线程，然后再使用事件标志。接受任务在收到事件标志后唤醒，复制内存消息并处理，之后再将这段内存块释放。
+** ICall **通过一个任务在消息队列给另外一个任务发送一个阻塞消息时实现消息传递。发送方动态分配一段内存，将消息的内容写入内存，将这段内存发送（即排队）到接收线程，然后再使用事件标志。接受任务在收到事件标志后唤醒，复制内存消息并处理，之后再将这段内存块释放。
 协议栈使用 ICall 通知和发送消息到应用程序，ICall 传递这些服务消息，应用程序任务接收它然后处理。
@@ 行 108: / 行 112: @@
 ### ICALL 初始化和注册 ###
-要实例和初始化 ICall 服务，应用程序必须在启动 TI-RTOS 内核调度程序之前调用 main（）中的代码片段中的函数：
+要实例和初始化 ICall 服务，应用程序必须在启动 TI-RTOS 内核调度程序之前调用 main（）代码片段中的函数：
 使用 ICall 的必需代码。
@@ 行 114: / 行 118: @@
 ```C
 /* 初始化 ICall 模块 */
-ICall _init （）;
+ICall_init();
-/* 启动协议栈任务 - 优先级 */
+/* 将协议栈作作为任务创建 */
-ICall _createRemoteTasks （）;
+ICall _createRemoteTasks ();
 ```
-调用 ICall_init（）初始化 ICALL 原语服务（例如，堆管理）和框架，调用 ICall _createRemoteTasks（）创建但不启动 BLE5-Stack 任务。在使用ICall 协议服务之前，服务器和客户端分别完成登记和注册。服务端在编译的时候就需要登记一个服务，登记函数使用一个全局的唯一标识符区分每个服务并作为通信地址。例如，BLE协议使用 `ICALL_SERVICE_CLASS_BLE` 做些蓝牙协议栈 ICALL的消息交互的标识。
+调用 ICall_init()初始化 ICALL 原语服务（例如，初始化堆管理）和框架，调用 ICall _createRemoteTasks()创建但不启动 BLE5-Stack 任务。在使用ICall 协议服务之前，服务器和客户端分别完成登记和注册。服务端在编译的时候就需要登记一个服务，登记函数使用一个全局的唯一标识符区分每个服务并作为通信地址。例如，BLE协议使用 `ICALL_SERVICE_CLASS_BLE` 做些蓝牙协议栈 ICALL的消息交互的标识。
 服务端的登记在 `osal_icall_ble.c` 文件：
@@ 行 131: / 行 135: @@
 客户端在 ICALL 调度程序发送和/或接收消息之前需要注册。
-对于使用 BLE5API的客户端（例如应用程序任务），客户端必须首先向ICall注册其任务 。该注册通常发生在应用程序的任务初始化功能中。下面的代码片段是 `simple_peripheral_init` 在 simple_peripheral.c 中注册。
+对于使用 BLE5 的客户端（例如这里的应用程序任务），客户端必须首先向ICall注册其任务 。该注册通常发生在应用程序的任务初始化功能中。下面的代码片段是 `simple_peripheral_init` 在 simple_peripheral.c 中注册。
 ```C
 //ICALL客户端注册
-ICall _registerApp （＆selfEntity ，＆syncEvent ）;
+ICall _registerApp (&selfEntity ，&syncEvent);
 ```
 完成客户端注册前需要传入结构体变量 `selfEntity` 和 `syncEvent` ，其值在函数返回时被初始化，服务端通过这两个变量来进行消息传递。`syncEvent` 参数表示事件标识，`selfEntity` 表示处理消息的目的任务，也是客户端实体以后通信的源地址。每个注册 ICALL 的客户端都需要使用唯一的 `syncEvent` 和`selfEntity` 。
@@ 行 151: / 行 155: @@
 ```
-`handle` 是构造的 Event_Handle 的句柄（标识符）。
+`handle` 是构造的 Event_Handle 事件句柄（标识符）。
 `andMask` 和 `orMask` 为用户选择要阻塞/挂起的事件标志。
-`timeout` 是以毫秒为单位的超时周期。如果在此超时时间范围内后尚未返回，该函数将返回。
+`timeout` 是以毫秒为单位的超时周期。如果在此超时时间范围内后事件尚未被Post，该函数将返回。
 `Event_pend` 函数表示阻塞当前任务等待某一事件标志位发生。
@@ 行 166: / 行 170: @@
 ```
-以上的事件句柄 `handle` 由服务端 ICall _enrollService（）和 ICall _registerApp（）调用后获得。
+以上的事件句柄 `handle` 由服务端 ICall _enrollService()和 ICall _registerApp()调用后获得。
 > **危险**:  不要从协议栈回调中调用 ICall 函数，此操作可能导致 ICall 中止（使用 ICall_abort（））并中断系统。
@@ 行 172: / 行 176: @@
 ### 示例 ICall 用法 ###
-下图显示了一个通过 ICall 框架从应用程序发送到 BLE5-Stack 的示例命令，并将相应的返回值传回给应用程序。
+图 3 显示了一个通过 ICall 框架从应用程序发送到 BLE5-Stack 的示例命令，并将相应的返回值传回给应用程序。
 ICall _init（）完成初始化 ICall 模块实例，ICall_createRemoteTasks（）使用已知地址的入口函数为协议栈创建任务。
@@ 行 182: / 行 186: @@
 协议命令不在应用程序的线程中执行，而是封装在ICall消息中执行，是由 ICall 框架发送到 BLE5-Stack 任务。该命令被发送到 ICALL 调度程序，它在 BLE5-Stack 上下文中调度和执行；同时应用程序线程阻塞，直到接收到相应的命令状态消息；BLE5-Stack 完成执行命令，然后通过 ICall 将命令状态消息响应发送回应用程序线程。这种交换的示例图如下所示。
-![ ICall 消息传递示例](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/IcallBlcok.png)
+![](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/IcallBlcok.png)
+图3. ICall 消息传递示例
+有了以上理论知识储备，我们尝试解决以下问题：
 ### BLE-Stack 工程是如何作为 App 中 TI-RTOS 的一个任务运行的 ###
@@ 行 225: / 行 233: @@
 * 任务实体
-arg0 的参数地址要区分工程编译选项，这点已经在<a href ="..\..\cc2640r2f_architecture\software_and_hardware\software\software_architecture.html">软件架构</a>章节详细讲解过。`FlashROM_StackLirary` 链接的编译在静态库中的 `startup_entry` 函数中。
+arg0 的参数地址要区分工程编译选项，这点已经在<a href ="http://docs.leconiot.com/doku.php?id=cc2640r2f:cc2640r2f_architecture:software_and_hardware:software:software_architecture">软件架构</a>章节详细讲解过。`FlashROM_StackLirary` 链接的编译在静态库中的 `startup_entry` 函数中。
 ```C
@@ 行 341: / 行 349: @@
 ### 如何调试协议栈任务 ###
-因为协议栈任务分布在另外一个工程，所以没有向原来那样直接加断点调试。经过前面的学习，我们已经了解协议栈是如何作为一个任务在应用工程中启动的，找到协议任务入口地址就是调试协议栈任务的关键。
+因为协议栈任务分布在另外一个工程，所以没有向原来那样直接加断点调试。已经了解协议栈是如何作为一个任务在应用工程中启动的，那么调试协议栈任务的关键是找到协议任务入口地址。
 在调试协议栈任务之前，建议将分别设置协议栈和应用工程优化等级 Project -> Opitons -> C/C++ Compiler Optimizations -> Level -> None 为无，这对正常调试协议栈任务至关重要。
 ![](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/Opitimaizations.jpg)
+图4 .设置优化等级
 `FlashROM` 编译选项的协议栈任务入口地址在 `iar_boundary.xcl` 中给出，对于 `FlashROM_StackLibrary` 编译选项，可以通过编译生成的 *.map 文件查找`startup_entry` 符号从而找到入口地址。
@@ 行 350: / 行 360: @@
 ![](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/FlashRomEntry.jpg)
 ![](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/LibEntry.jpg)
+图5 .找到入口地址
 拿到协议栈任务的入口地址后，就可以在汇编窗口 View -> Disassembly 直接输入该地址，然后加上断点，等待协议栈任务创建后运行，从而跳转到协议栈工程进行调试。
 ![](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/DisassemblyWindow.png)
+图6 .如何用协议栈工程进行调试
 如果不知道协议栈任务的入口地址，则直接通过创建协议栈任务的任务实体入口，跳转到 `ICall_taskEntry` -> `entryfn` ，然后按** F11 **进入协议栈任务调试。
 ![](http://www.leconiot.com/md_res/cc2640r2f/ble_stack_app/app/Images/EntryFn.png)
+图7 .如何进入协议栈任务调试
 >**注意**：这里 F11 Step Into 可能会优化选项跳转失败，所以建议关闭优化选项或者直接到聚焦到汇编窗口 BX R2 F11 跳转。
@@ 行 368: / 行 384: @@
 ### 应用程序初始化功能 ###
-<a href="..\..\cc2640r2f_architecture\ti_rtos\tirtos_overivew.html"> TI-RTOS 概述</a>详细介绍如何了任务构建。构建任务并启动 SYS / BIOS 内核调度程序后，构造过程中传递的函数会在任务准备就绪时运行（例如 SimpleBLEPeripheral_taskFxn ）。任务实体函数运行前这里会先运行任务初始化。
+<a href="http://docs.leconiot.com/doku.php?id=cc2640r2f:cc2640r2f_architecture:ti_rtos:tirtos_overivew"> TI-RTOS 概述</a>详细介绍了任务构建。构建任务并启动 SYS / BIOS 内核调度程序后，构造过程中传递的函数会在任务准备就绪时运行（例如 SimpleBLEPeripheral_taskFxn ）。任务实体函数运行前这里会先运行任务初始化。
 simple_peripheral 任务函数伪代码
@@ 行 465: / 行 481: @@
 当为一个事件选择一个事件值的时候，该值对于给定的任务必须是唯一的，并且必须是 2 的幂（只有 1 bit 被设置为 1 ）。这样做的原因是 `pEvt->event` 变量被初始化为 `uint16_t` 类型，也就是最多运行允许 16 个事件。有一个不能使用的事件值是已经用于 BLE5-Stack OSAL 全局事件（ bcomdef.h 中所述）的事件值。
-清单49. BLE OSAL事件在 bcomdef.h 中定义。
+清单1. BLE OSAL事件在 bcomdef.h 中定义。
 ```C

文档中心

用户工具

站点工具

差别

页面工具