嵌入式实时操作系统uCOSII第12章 配置手册.pdf

《嵌入式实时操作系统uCOSII第12章 配置手册.pdf》由会员分享，可在线阅读，更多相关《嵌入式实时操作系统uCOSII第12章 配置手册.pdf（7页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、310-C/OS-II:实时操作系统内核实时操作系统内核 第 12 章 配置手册配置手册 本章将介绍C/OS-II 中的初始化配置项。由于C/OS-II 向用户提供源代码，初始化配置项由一系列#define constant 语句构成，都在文件 OS_CFG.H 中。用户的工程文件组中都应该包含这个文件。本节介绍每个用#define constant 定义的常量，介绍的顺序和它们在 OS_CFG.H 中出现的顺序是相同的。表 12.1 列出了常量控制的C/OS-II 函数。“类型”为函数所属的类型，“置 1”表示当定义常量为 1 时可以打开相应的函数，“其他常量”为与这个函数有关的其他控制常量

2、。注意编译工程文件时要包含 OS_CFG.H，使定义的常量生效。表 T12.1 C/OS-II 函数和相关的常量（#define constant 定义）表表 T12.1 C/OS-II 函数和相关常量函数和相关常量 类型类型 置置1 其他常量其他常量 杂相杂相 OSInit()无 OS_MAX_EVENTS OS_Q_EN and OS_MAX_QSOS_MEM_EN OS_TASK_IDLE_STK_SIZE OS_TASK_STAT_EN OS_TASK_STAT_STK_SIZEOSSchedLock()无 无 OSSchedUnlock()无 无 OSStart()无 无 OSSta

3、tInit()OS_TASK_STAT_EN&OS_TASK_CREATE_EXT_ENOS_TICKS_PER_SECOSVersion()无 无 中断处理中断处理 参考手册参考手册-311 OSIntEnter()无 无 OSIntExit()无 无 消息邮箱消息邮箱 OSMboxAccept()OS_MBOX_EN无 OSMboxCreate()OS_MBOX_ENOS_MAX_EVENTSOSMboxPend()OS_MBOX_EN无 OSMboxPost()OS_MBOX_EN无 OSMboxQuery()OS_MBOX_EN无 内存块管理内存块管理 OSMemCreate()OS_

4、MEM_ENOS_MAX_MEM_PARTOSMemGet()OS_MEM_EN无 OSMemPut()OS_MEM_EN无 OSMemQuery()OS_MEM_EN无 消息队列消息队列 OSQAccept()OS_Q_EN无 OSQCreate()OS_Q_ENOS_MAX_EVENTS OS_MAX_QSOSQFlush()OS_Q_EN无 OSQPend()OS_Q_EN无 OSQPost()OS_Q_EN无 OSQPostFront()OS_Q_EN无 OSQQuery()OS_Q_EN无 信号量管理信号量管理 OSSemAccept()OS_SEM_EN无 OSSemCreate(

5、)OS_SEM_ENOS_MAX_EVENTSOSSemPend()OS_SEM_EN无 OSSemPost()OS_SEM_EN无 OSSemQuery()OS_SEM_EN无 任务管理任务管理 OSTaskChangePrio()OS_TASK_CHANGE_PRIO_ENOS_LOWEST_PRIOOSTaskCreate()OS_TASK_CREATE_ENOS_MAX_TASKS OS_LOWEST_PRIOOSTaskCreateExt()OS_TASK_CREATE_EXT_ENOS_MAX_TASKS OS_STK_GROWTH OS_LOWEST_PRIOOSTaskDel(

6、)OS_TASK_DEL_ENOS_LOWEST_PRIOOSTaskDelReq()OS_TASK_DEL_ENOS_LOWEST_PRIOOSTaskResume()OS_TASK_SUSPEND_ENOS_LOWEST_PRIOOSTaskStkChk()OS_TASK_CREATE_EXT_EOS_LOWEST_PRIO312-C/OS-II:实时操作系统内核实时操作系统内核 NOSTaskSuspend()OS_TASK_SUSPEND_ENOS_LOWEST_PRIOOSTaskQuery()OS_LOWEST_PRIO时钟管理时钟管理 OSTimeDly()无 无 OSTimeD

7、lyHMSM()无 OS_TICKS_PER_SECOSTimeDlyResume()无 OS_LOWEST_PRIOOSTimeGet()无 无 OSTimeSet()无 无 OSTimeTick()无 无 用户定义函数用户定义函数 OSTaskCreateHook()OS_CPU_HOOKS_EN无 OSTaskDelHook()OS_CPU_HOOKS_EN无 OSTaskStatHook()OS_CPU_HOOKS_EN无 OSTaskSwHook()OS_CPU_HOOKS_EN无 OSTimeTickHook()OS_CPU_HOOKS_EN无 参考手册参考手册-313 OS_MA

8、X_EVENTS OS_MAX_EVENTS 定义系统中最大的事件控制块的数量。系统中的每一个消息邮箱，消息队列，信号量都需要一个事件控制块。例如，系统中有 10 个消息邮箱，5 个消息队列，3 个信号量，则 OS_MAX_EVENTS 最小应该为 18。只要程序中用到了消息邮箱，消息队列或是信号量，则 OS_MAX_EVENTS 最小应该设置为 2。OS_MAX_MEM_PARTS OS_MAX_MEM_PARTS 定义系统中最大的内存块数，内存块将由内存管理函数操作（定义在文件 OS_MEM.C 中）。如果要使用内存块，OS_MAX_MEM_PARTS 最小应该设置为 2，常量OS_MEM

9、_EN 也要同时置 1。OS_MAX_QS OS_MAX_QS 定义系统中最大的消息队列数。要使用消息队列，常量 OS_Q_EN 也要同时置 1。如果要使用消息队列，OS_MAX_ QS 最小应该设置为 2。OS_MAX_TASKS OS_MAX_MEM_TASKS 定义用户程序中最大的任务数。OS_MAX_MEM_TASKS 不能大于 62，这是由于C/OS-II 保留了两个系统使用的任务。如果设定 OS_MAX_MEM_TASKS 刚好等于所需任务数，则建立新任务时要注意检查是否超过限定。而 OS_MAX_MEM_TASKS 设定的太大则会浪费内存。OS_LOWEST_PRIO OS_LO

10、WEST_PRIO 设定系统中的任务最低优先级（最大优先级数）。设定 OS_LOWEST_PRIO可以节省用于任务控制块的内存。C/OS-II 中优先级数从 0（最高优先级）到 63（最低优先级）。设定 OS_LOWEST_PRIO 小于 63 意味着不会建立优先级数大于 OS_LOWEST_PRIO 的任务。C/OS-II 中保留两个优先级系统自用：OS_LOWEST_PRIO 和 OS_LOWEST_PRIO-1。其中OS_LOWEST_PRIO 留给系统的空闲任务（Idle task）(OSTaskIdle（）)。OS_LOWEST_PRIO-1留给统计任务（OSTaskStat（）。用

11、户任务的优先级可以从 0 到 OS_LOWEST_PRIO-2。OS_LOWEST_PRIO 和 OS_MAX_TASKS 之间没有什么关系。例如，可以设 OS_MAX_TASKS314-C/OS-II:实时操作系统内核实时操作系统内核 为 10 而 OS_LOWEST_PRIO 为 32。此时系统最多可有 10 个任务，用户任务的优先级可以是 0 到 30。当然，OS_LOWEST_PRIO 设定的优先级也要够用，例如设 OS_MAX_TASKS 为 20，而OS_LOWEST_PRIO 为 10，优先级就不够用了。OS_TASK_IDLE_STK_SIZE OS_TASK_IDLE_STK

12、_SIZE 设置C/OS-II 中空闲任务（Idle task）堆栈的容量。注意堆栈容量的单位不是字节，而是 OS_STK（C/OS-II 中堆栈统一用 OS_STK 声明，根据不同的硬件环境，OS_STK 可为不同的长度-译者注）。空闲任务堆栈的容量取决于所使用的处理器，以及预期的最大中断嵌套数。虽然空闲任务几乎不做什么工作，但还是要预留足够的堆栈空间保存 CPU寄存器的内容，以及可能出现的中断嵌套情况。OS_TASK_STAT_EN OS_TASK_STAT_EN 设定系统是否使用C/OS-II 中的统计任务（statistic task）及其初始化函数。如果设为 1，则使用统计任务 OS

13、TaskStat（）。统计任务每秒运行一次，计算当前系统 CPU 使用率，结果保存在 8 位变量 OSCPUUsage 中。每次运行，OSTaskStat（）都将调用 OSTaskStatHook（）函数，用户自定义的统计功能可以放在这个函数中。详细情况请参考 OS_CORE.C 文件。统计任务 OSTaskStat（）的优先级总是设为 OS_LOWEST_PRIO-1。当 OS_TASK_STAT_EN 设为 0 的时候，全局变量 OSCPUUsage，OSIdleCtrMax，OSIdleCtrRun和 OSStatRdy 都不声明，以节省内存空间。OS_TASK_STAT_STK_SIZ

14、E OS_TASK_STAT_STK_SIZE 设置C/OS-II 中统计任务（statistic task）堆栈的容量。注意单位不是字节，而是 OS_STK（C/OS-II 中堆栈统一用 OS_STK 声明，根据不同的硬件环境，OS_STK可为不同的长度-译者注）。统计任务堆栈的容量取决于所使用的处理器类型，以及如下的操作：?进行 32 位算术运算所需的堆栈空间。?调用 OSTimeDly（）所需的堆栈空间。?调用 OSTaskStatHook（）所需的堆栈空间。?预计最大的中断嵌套数。如 果 想 在 统 计 任 务 中 进 行 堆 栈 检 查，判 断 实 际 的 堆 栈 使 用，用 户 需

15、 要 设OS_TASK_CREATE_EXT_EN 为 1，并使用 OSTaskCreateExt（）函数建立任务。参考手册参考手册-315 OS_CPU_HOOKS_EN 此常量设定是否在文件 OS_CPU_C.C 中声明对外接口函数（hook function），设为 1 为声明。C/OS-II 中提供了 5 个对外接口函数，可以在文件 OS_CPU_C.C 中声明，也可以在用户自己的代码中声明：?OSTaskCreateHook（）?OSTaskDelHook（）?OSTaskStatHook（）?OSTaskSwHook（）?OSTimeTickHook（）OS_MBOX_EN OS_

16、MBOX_EN 控制是否使用C/OS-II 中的消息邮箱函数及其相关数据结构，设为 1 为使用。如果不使用，则关闭此常量节省内存。OS_MEM_EN OS_MEM_EN 控制是否使用C/OS-II 中的内存块管理函数及其相关数据结构，设为 1 为使用。如果不使用，则关闭此常量节省内存。OS_Q_EN OS_Q_EN 控制是否使用C/OS-II 中的消息队列函数及其相关数据结构，设为 1 为使用。如果不使用，则关闭此常量节省内存。如果 OS_Q_EN 设为 0，则语句#define constant OS_MAX_QS无效。OS_SEM_EN OS_SEM_EN 控制是否使用C/OS-II 中的

17、信号量管理函数及其相关数据结构，设为 1 为使用。如果不使用，则关闭此常量节省内存。OS_TASK_CHANGE_PRIO_EN 此常量控制是否使用C/OS-II 中的 OSTaskChangePrio（）函数，设为 1 为使用。如果在应用程序中不需要改变运行任务的优先级，则将此常量设为 0 节省内存。316-C/OS-II:实时操作系统内核实时操作系统内核 OS_TASK_CREATE_EN 此常量控制是否使用C/OS-II 中的 OSTaskCreate（）函数，设为 1 为使用。在C/OS-II 中推荐用户使用 OSTaskCreateExt（）函数建立任务。如果不使用 OSTaskCr

18、eate（）函数，将OS_TASK_CREATE_EN设 为0可 以 节 省 内 存。注 意OS_TASK_CREATE_EN和OS_TASK_CREATE_EXT_EN 至少有一个要为 1，当然如果都使用也可以。OS_TASK_CREATE_EXT_EN 此常量控制是否使用C/OS-II 中的 OSTaskCreateExt（）函数，设为 1 为使用。该函数为扩展的，功能更全的任务建立函数。如果不使用该函数，将 OS_TASK_CREATE_EXT_EN 设为 0 可以节省内存。注意，如果要使用堆栈检查函数 OSTaskStkChk（），则必须用 OSTaskCreateExt（）建立任务。

19、OS_TASK_DEL_EN 此常量控制是否使用C/OS-II 中的 OSTaskDel（）函数，设为 1 为使用。如果在应用程序中不使用删除任务函数，将 OS_TASK_DEL_EN 设为 0 可以节省内存。OS_TASK_SUSPEND_EN 此常量控制是否使用C/OS-II 中的 OSTaskSuspend（）和 OSTaskResume（）函数，设为 1 为使用。如果在应用程序中不使用任务挂起-唤醒函数，将 OS_TASK_SUSPEND_EN 设为 0 可以节省内存。OS_TICKS_PER_SEC 此常量标识调用 OSTimeTick（）函数的频率。用户需要在自己的初始化程序中保证 OSTimeTick（）按所设定的频率调用（即系统硬件定时器中断发生的频率-译者注）。在函数 OSStatInit（），OSTaskStat（）和 OSTimeDlyHMSM（）中都会用到 OS_TICKS_PER_SEC。