基于TI-RTOS的CC2650DK开发（17）---支持模块_bios_getthreadtype-程序员宅基地

技术标签： TI-RTOS  CC2650  

第六章 支持模块
本章描述为管理整体应用程序行为所提供的一些基础支持特征及配置参数的APIs所对应的模块。

6.1 应用支持和管理模块
SYS/BIOS和XDCtools提供了数个模块用于支持和管理整个应用程序行为。以下模块提供了属于这个类别的APIs和配置设置：
  • BIOS Module (ti.sysbios.BIOS): 负责SYS/BIOS启动和全局参数维护。见6.2节。
  • SysMin (xdc.runtime.SysMin):系统模块的推荐代理。见6.3.1节。
  • SysCallback (xdc.runtime.SysCallback):自定义系统行为代理。见6.3.2节。
  • Program (xdc.cfg.Program):作为配置命名空间的根。见6.4节。
  • Startup (xdc.runtime.Startup):管理应用程序启动和初始化。见6.5节。
  • Reset (xdc.runtime.Reset):在系统重启后，允许指定目标reset函数立即运行。见6.6节。
  • Error (xdc.runtime.Error):提供处理错误的机制。见6.7节。
  • Text (xdc.runtime.Text):管理字符串与公共子串。见6.8节。
  • Memory (xdc.runtime.Memory):管理内存使用。见第7章。

6.2 BIOS模块
BIOS模块负责设置SYS/BIOS所使用的全局参数，并负责执行SYS/BIOS启动顺序。关于启动顺序的详细信息，请参考3.1节。

BIOS模块的包路径是ti.sysbios.BIOS，所以SYS/BIOS应用将使用以下#include声明：
#include <ti/sysbios/BIOS.h>
配置文件（*.cfg）应声明如下：
var BIOS = xdc.useModule( 'ti.sysbios.BIOS');
以下是SYS/BIOS应用常用的BIOS模块APIs：
  • BIOS_start() — 应用程序的main()函数在把控制权交给SYS/BIOS线程调度前必须调用此函数作为将要执行的最终语句。在所有应用程序所需要的初始化都被执行之后，应调用此函数。此函数执行所有剩余的SYS/BIOS初始化并将控制权转交给准备运行的最高优先级Task。如果Tasks不可用，控制权直接转交给Idle Loop。BIOS_start()函数不会返回。
  • BIOS_getCpuFreq() — 此函数返回以Hz为单位的CPU频率。见第5章获取有关时间的信息。5.2节所提供的一个例子使用了此函数。
  • BIOS_setCpuFreq() — 此函数设置以Hz为单位的CPU频率。见第5章获取有关时间的信息。5.2节所提供的一个例子使用了此函数。
  • BIOS_exit() — 当你希望SYS/BIOS应用程序结束时，调用此函数。BIOS_exit()不返回调用BIOS_start()的那个函数。相反，BIOS_exit()调用System_exit()并中止。所有被System_atexit()或ANSI C标准库atexit()限制的函数都会执行。SYS/BIOS应用程序的BIOS_exit()内会调用System_exit()，因为在调用System_exit()之前BIOS_exit()先执行内部清理。如果应用程序需要因一个错误条件而终止，应调用System_abort()或System_abortSpin()。
  • BIOS_getThreadType() — 此函数返回调用此函数的线程类型。可用的线程类型有BIOS_ThreadType_Hwi，BIOS_ThreadType_Swi，BIOS_ThreadType_Task，和BIOS_ThreadType_Main。
BIOS模块定义了BIOS_WAIT_FOREVER和BIOS_NO_WAIT常量，可用于APIs的timeout参数。

BIOS模块提供了几个配置参数控制全局SYS/BIOS行为。例如，BIOS.heapSize和BIOS.heapSection在7.7.2节描述。BIOS.libType配置参数在SYS/BIOS库建立时用于选择版本，它在2.4.5节描述。各种通过设置BIOS模块配置参数以减少SYS/BIOS应用的尺寸的途径可参考附录C和附录D。

可参考API参考帮助（CDOC）中的ti.sysbios.BIOS模块获取关于APIs和配置参数的详细信息。

6.3 系统模块
系统模块提供基础的低层次“系统”服务，例如字符输出，printf-like输出和退出处理。

系统模块的包路径是xdc.runtime.System，所以SYS/BIOS应用将使用以下#include声明：
#include <xdc/runtime/System.h>
配置文件（*.cfg）将使用以下声明：
var System = xdc.useModule( 'xdc.runtime.System');
以下为SYS/BIOS应用常用的系统模块APIs：
  • System_printf() — 有几个函数提供了类似printf的功能。这些函数包括 These include System_putch()，System_sprintf()，System_vprintf()，System_aprintf() (IArg类型的参数)和system_vsnprintf()（打印指定数量的字符。使用可变参数列表传递参数到字符缓冲）。

我们强力推荐SYS/BIOS应用调用System_printf()和它的相关函数代替标准printf()函数。系统模块提供了熟悉的但拥有更少选项的printf-like函数。内在占用比传统printf()更少。System_printf()允许用户指定要处理的字符输出使用一个系统提供者 （见6.3.1节和6.3.2节）。

相比日志模块打印函数更推荐使用 系统模块打印函数 ，因为系统模块函数更易于使用在各种情况下。日志模块常用于主机仪表工具，它有更多的选项来禁用/可用日志。获取使用日志模块有关UIA的详细信息，请参考
System Analyzer User’s Guide（ SPRUH43）。

  • System_abort() — 当应用程序需要非正常中止，可调用此函数并返回一个错误信息。此函数允许你返回一个描述所发生错误的字符串。当此函数被调用，系统gate将进入，SupportProxy的abort函数被调用，然后调用System.abortFxn。没有绑定System_atexit()或ANSI C标准库函数atexit()的退出函数被调用。
  • System_flush() — 此函数发送所有的缓冲输出字符到输出设备中。它还发出一个断点到IDE。因为这个调用会使目标停止，调用它会影响实时执行的细节。输出字符的目的地由SupportProxy模块决定。
  • System_exit() — SYS/BIOS应用程序推荐使用BIOS_exit()而不是System_exit()函数。BIOS_exit()函数在调用System_exit()前执行内部清理。System_exit()可以在Task内调用，但不能在Swi或Hwi内调用。
  • System_atexit() — 在调用System_exit()时调用此函数为内部执行的函数栈添加一个退出句柄。System.maxAtexitHandlers配置属性控制多少退出句柄可以入栈，默认值为8。

系统模块使用一个支持代理模块实现低层次服务需求。所使用的实现由System.SupportProxy配置参数指定，默认使用SysMin模块（见6.3.1）。其它选项是SysCallback模块（6.3.2节）。

系统模块是带gate的。其它模块可使用通过Gate_enterSystem()和Gate_leaveSystem()来使用它们的gate。

Exit函数
默认情况下，当应用程序无错误退出，系统模块调用它的标准退出函数，也就是依次调用ANSI C标准exit()函数。如果希望应用程序无限期延长，以调试应用程序状态，在配置中添加以下声明：
System.exitFxn = System.exitSpin;
配置此“spin”函数也减少了应用程序的代码尺寸。System_exitSpin() API将不会被应用程序直接调用。

你也可以在运行时使用C代码System_atexit()函数指定多个退出句柄。一个自定义退出句柄的原型是：
typedef Void (*System_AtexitHandler)(Int)

Abort函数
默认情况下，当应用程序因为一个错误条件中止，系统模块调用它的标准abort函数，也就是依次调用ANSI C标准abort()函数。如果希望应用程序无限期延长，以调试应用程序状态，在配置中添加以下声明：
System.abortFxn = System.abortSpin;
配置此“spin”函数也减少了应用程序的代码尺寸。System_abortSpin() API将不会被应用程序直接调用。一个自定义中止句柄原型是：
typedef Void (*System_AbortFxn)();

6.3.1 SysMin模块
SysMin模块是大多数SYS/BIOS例程和模板中使用得最多的SupportrProxy模块。此模块提供了系统SupportProxy所需要函数实现。其中包含了呈现缓冲字符，输出单个字符和执行退出和中止动作。

大多数应用程序推荐使用SysMin模块，因为它将字符放入环形缓冲，这样RTOS Object Viewer（ROV）工具可以知道如何寻找和呈现。

此模块在目标中维护了一个内部环形缓冲以存储“输出”字符。当缓冲满后，数据重写。当调用函数以呈现缓冲，内部环形缓冲中的字符将使用配置outputFxn“输出”。除非你提供了一个自定义的outputFxn。对于TI目标，TI C运行时支持库使用HOSTwrite()函数输出字符缓冲。对于非TI目标，则使用ANSI C标准库函数fwrite()。

应用程序不应直接调用SysMin函数，但SysMin模块提供配置参数以控制缓存站点用于存储内部输出及包含此缓存的内存片段。配置文件（*.cfg）可通过以下方式使用此模块：
var BIOS = xdc.useModule( 'xdc.runtime.SysMin');

6.3.2 SysCallback模块
SysCallback是SysMin代理模块的替代模块。它需要你提供自定义函数来处理abort、exit、flush、putch和ready动作。如果需要在应用程序中定制输出行为，则使用此模块。

6.4 Program模块
Program模块作为配置命名空间的“根”。它在配置中使用，但不提供任何C APIs。关于配置命名空间请参考2.3.10节。
配置文件无需useModule()声明来启用此模块。
Program模块提供配置参数来控制运行时内存尺寸。包括Program.stack，控制应用栈尺寸，它由单个Task分别使用。

Program模块还提供配置参数控制自动生成链接命令文件的内容。这包括Program.sectMap[]数组（见7.3.2节）和Program.sectionsExclude参数（见7.3.4节）。

参考API参考帮助（CDOC）的xdc.cfg.Program模块获取有关APIs和配置参数的详细内容。

6.5 Startup模块
Startup模块管理最早期的C的main()函数调用前的启动初始化。这些初始化通常有以下内容组成：设置硬件，指定控制看门狗定时器的寄存器，访问内存，缓存设置，时钟速度等等。

除了允许用户添加自定义启动函数的配置参数外，此模块还提供允许模块自动运行、添加初始化函数到启动顺序的服务。

配置文件（*.cfg）使用如下声明启用Startup模块：
var BIOS = xdc.useModule( 'xdc.runtime.Startup');
参考3.1节获取startup进程概览，包括在哪个函数配置启动模块运行顺序，以及一个配置脚本实例演示了用户提供的启动函数在每个可能控制点及启动顺序上的安装。

参考 Texas Instruments Processors Wiki了解指定目标的启动顺序的详细内容。

6.6 Reset模块
Reset模块使得你通过配置Reset.fxns[]数组属性来定义一个初始reset函数。Reset函数早在应用程序启动时及指定平台硬件初始化时就调用了。

注意只有特定系列的目标在运行程序前执行设备的reset。因此，reset函数并不支持所有平台。不要在这个函数中放置您打算携带的代码。反而应使用Startup模块来定义跨平台应用启动函数。

配置文件（*.cfg）使用如下代码启用Reset模块：
var BIOS = xdc.useModule( 'xdc.runtime.Reset');
Reset模块允许你配置一个数组的启动函数，让你可为各种外设启动活动提供不同函数。

参考3.1节获取startup进程概览，包括在哪个函数配置启动模块运行顺序，以及一个配置脚本实例演示了用户提供的启动函数在每个可能控制点及启动顺序上的安装。

6.7 Error模块
Error模块提供机制用于在程序中引发、检查和处理错误。Error模块的包路径是xdc.runtime.Error，所以使用Error APIs的SYS/BIOS应用程序就包含以下#include声明：
#include <xdc/runtime/Error.h>
配置文件（*.cfg）应使用如下声明包含Error模块：
var BIOS = xdc.useModule( 'xdc.runtime.Error');
数个SYS/BIOS APIs ，尤其是那是创建对象和分配内存的APIs，都有一个参数为Error_Block类型。9.3节描述了几个管理它们的错误块和几个APIs，包括Error_init()和Error_check()。

下面为SYS/BIOS应用程序经常用到的Error模块APIs：
  • Error_init() — 将错误块加入它的初始状态。
  • Error_check() — 如果引发了一个错误，则返回true。
  • Error_getData() — 获取一个错误的参数列表。
  • Error_getMsg() — 获取一个错误的“printf”格式字符串。
  • Error_print() — 使用System_printf()打印一个错误。
  • Error_raise() — 引发一个错误。

下例在System_printf()中调用Error APIs：
System_printf(Error_getMsg(eb),
              Error_getData(eb)->arg[ 0],
              Error_getData(eb)->arg[ 1]);

下例引发一个错误以回应错误条件：
if (val %  2)
{
    Error_raise(eb, Error_E_generic,  "Value is not a multiple of 2",  0);
}

你可以通过配置Error.policy、Error.policyFxn和Error.raiseHook参数来决定SYS/BIOS应用程序如何响应以引发错误。

默认情况下，Error.policy通过调用函数返回错误Error_UNWIND。如果Error.policy是Error_TERMINATE，所有引发的错误是致命的，并通过调用Error_raise()而不返回到调用者。

默认情况下，Error.policyFxn是Error_policyDefault()，它根据Error.policy处理错误并在返回调用者或中止前将错误录入日志。或者，你可以使用Error_policySpin()，一个简单的无限循环，来最小化内存占用。

你可以指定一个Error.raiseHook函数在错误引发时被调用，甚至在Error.policy是TERMINATE时。默认情况下，此函数设置为Error_print()，它将错误格式化并通过System_printf()输出。设置此配置参数为null表示没有函数hook被调用。

6.8 Text模块
Text模块高效管理携带公共子串的字符串集合。集合拥有高度公共性，所使用的存储空间远远少于使用普通表格存储独立字符串。使用压缩表示的文本字符串的所有可用空间被限制在64K字符内。

为了进一步节省空间，“压缩”表示甚至无需被载入目标内存。默认情况下，文本字符串是载入目标内存的，可以如附录D所示通过设置Text.isLoaded配置属性来避免它。

你可以在运行时使用Text_isLoaded布尔常量来控制格式化串是否传递给System_printf()函数，代码如下：
if (Text_isLoaded)
{
    System_asprintf(tempStr, fmt, a1, a2, a3, a4, a5, a6, a7, a8);
}
else
{
    System_asprintf(tempStr,  "{evt: fmt=%p, args=[0x%x, 0x%x ...]}", fmt, a1, a2);
}

Text模块的包路径是xdc.runtime.Text，所以使用Text APIs和常量的SYS/BIOS应用程序应包含如下#include声明：
#include <xdc/runtime/Text.h>
配置文件（*.cfg）应使用如下声明：
var BIOS = xdc.useModule( 'xdc.runtime.Text');
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/abatei/article/details/53856295

智能推荐

什么是内部类？成员内部类、静态内部类、局部内部类和匿名内部类的区别及作用？_成员内部类和局部内部类的区别-程序员宅基地

文章浏览阅读3.4k次，点赞8次，收藏42次。一、什么是内部类？or 内部类的概念内部类是定义在另一个类中的类；下面类TestB是类TestA的内部类。即内部类对象引用了实例化该内部对象的外围类对象。public class TestA{ class TestB {}}二、 为什么需要内部类？or 内部类有什么作用？1、 内部类方法可以访问该类定义所在的作用域中的数据，包括私有数据。2、内部类可以对同一个包中的其他类隐藏起来。3、 当想要定义一个回调函数且不想编写大量代码时，使用匿名内部类比较便捷。三、 内部类的分类成员内部_成员内部类和局部内部类的区别

分布式系统_分布式系统运维工具-程序员宅基地

文章浏览阅读118次。分布式系统要求拆分分布式思想的实质搭配要求分布式系统要求按照某些特定的规则将项目进行拆分。如果将一个项目的所有模板功能都写到一起，当某个模块出现问题时将直接导致整个服务器出现问题。拆分按照业务拆分为不同的服务器，有效的降低系统架构的耦合性在业务拆分的基础上可按照代码层级进行拆分(view、controller、service、pojo)分布式思想的实质分布式思想的实质是为了系统的..._分布式系统运维工具

用Exce分析l数据极简入门_exce l趋势分析数据量-程序员宅基地

文章浏览阅读174次。1.数据源准备2.数据处理step1：数据表处理应用函数：①VLOOKUP函数; ② CONCATENATE函数终表：step2：数据透视表统计分析（1） 透视表汇总不同渠道用户数, 金额（2）透视表汇总不同日期购买用户数，金额（3）透视表汇总不同用户购买订单数，金额step3：讲第二步结果可视化, 比如, 柱形图（1）不同渠道用户数, 金额（2）不同日期..._exce l趋势分析数据量

宁盾堡垒机双因素认证方案_horizon宁盾双因素配置-程序员宅基地

文章浏览阅读3.3k次。堡垒机可以为企业实现服务器、网络设备、数据库、安全设备等的集中管控和安全可靠运行，帮助IT运维人员提高工作效率。通俗来说，就是用来控制哪些人可以登录哪些资产（事先防范和事中控制），以及录像记录登录资产后做了什么事情（事后溯源）。由于堡垒机内部保存着企业所有的设备资产和权限关系，是企业内部信息安全的重要一环。但目前出现的以下问题产生了很大安全隐患：密码设置过于简单，容易被暴力破解；为方便记忆，设置统一的密码，一旦单点被破，极易引发全面危机。在单一的静态密码验证机制下，登录密码是堡垒机安全的唯一_horizon宁盾双因素配置

谷歌浏览器安装（Win、Linux、离线安装）_chrome linux debian离线安装依赖-程序员宅基地

文章浏览阅读7.7k次，点赞4次，收藏16次。Chrome作为一款挺不错的浏览器，其有着诸多的优良特性，并且支持跨平台。其支持（Windows、Linux、Mac OS X、BSD、Android），在绝大多数情况下，其的安装都很简单，但有时会由于网络原因，无法安装，所以在这里总结下Chrome的安装。Windows下的安装：在线安装：离线安装：Linux下的安装：在线安装：离线安装：..._chrome linux debian离线安装依赖

烤仔TVの尚书房 | 逃离北上广？不如押宝越南“北上广”-程序员宅基地

文章浏览阅读153次。中国发达城市榜单每天都在刷新，但无非是北上广轮流坐庄。北京拥有最顶尖的文化资源，上海是“摩登”的国际化大都市，广州是活力四射的千年商都。GDP和发展潜力是衡量城市的数字指...

随便推点

java spark的使用和配置_使用java调用spark注册进去的程序-程序员宅基地

文章浏览阅读3.3k次。前言spark在java使用比较少，多是scala的用法，我这里介绍一下我在项目中使用的代码配置详细算法的使用请点击我主页列表查看版本jar版本说明spark3.0.1scala2.12这个版本注意和spark版本对应，只是为了引jar包springboot版本2.3.2.RELEASEmaven<!-- spark --> <dependency> <gro_使用java调用spark注册进去的程序

汽车零部件开发工具巨头V公司全套bootloader中UDS协议栈源代码，自己完成底层外设驱动开发后，集成即可使用_uds协议栈 源代码-程序员宅基地

文章浏览阅读4.8k次。汽车零部件开发工具巨头V公司全套bootloader中UDS协议栈源代码，自己完成底层外设驱动开发后，集成即可使用，代码精简高效，大厂出品有量产保证。:139800617636213023darcy169_uds协议栈 源代码

AUTOSAR基础篇之OS(下)_autosar 定义了 5 种多核支持类型-程序员宅基地

文章浏览阅读4.6k次，点赞20次，收藏148次。AUTOSAR基础篇之OS(下)前言首先，请问大家几个小小的问题，你清楚：你知道多核OS在什么场景下使用吗？多核系统OS又是如何协同启动或者关闭的呢？AUTOSAR OS存在哪些功能安全等方面的要求呢？多核OS之间的启动关闭与单核相比又存在哪些异同呢？。。。。。。今天，我们来一起探索并回答这些问题。为了便于大家理解，以下是本文的主题大纲：[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-JCXrdI0k-1636287756923)(https://gite_autosar 定义了 5 种多核支持类型

VS报错无法打开自己写的头文件_vs2013打不开自己定义的头文件-程序员宅基地

文章浏览阅读2.2k次，点赞6次，收藏14次。原因：自己写的头文件没有被加入到方案的包含目录中去，无法被检索到，也就无法打开。将自己写的头文件都放入header files。然后在VS界面上，右键方案名，点击属性。将自己头文件夹的目录添加进去。_vs2013打不开自己定义的头文件

【Redis】Redis基础命令集详解_redis命令-程序员宅基地

文章浏览阅读3.3w次，点赞80次，收藏342次。此时，可以将系统中所有用户的 Session 数据全部保存到 Redis 中，用户在提交新的请求后，系统先从Redis 中查找相应的Session 数据，如果存在，则再进行相关操作，否则跳转到登录页面。此时，可以将系统中所有用户的 Session 数据全部保存到 Redis 中，用户在提交新的请求后，系统先从Redis 中查找相应的Session 数据，如果存在，则再进行相关操作，否则跳转到登录页面。当数据量很大时，count 的数量的指定可能会不起作用，Redis 会自动调整每次的遍历数目。_redis命令

URP渲染管线简介-程序员宅基地

文章浏览阅读449次，点赞3次，收藏3次。URP的设计目标是在保持高性能的同时，提供更多的渲染功能和自定义选项。与普通项目相比，会多出Presets文件夹，里面包含着一些设置，包括本色，声音，法线，贴图等设置。全局只有主光源和附加光源，主光源只支持平行光，附加光源数量有限制，主光源和附加光源在一次Pass中可以一起着色。URP：全局只有主光源和附加光源，主光源只支持平行光，附加光源数量有限制，一次Pass可以计算多个光源。可编程渲染管线：渲染策略是可以供程序员定制的，可以定制的有：光照计算和光源，深度测试，摄像机光照烘焙，后期处理策略等等。_urp渲染管线

推荐文章

热门文章

相关标签