uc/os—II下的九个C语言文件功能函数大全
一、OS_CORE.C
(1)void OSInit (void)
(2)void OSIntEnter (void)
(3)void OSIntExit (void)
(4)void OSSchedLock (void) // 给调度器上锁
(5)void OSSchedUnlock (void) // 给调度器解锁,成对使用
(6)void OSStart (void) // 启动多任务过程,在启动之前必须调用
OSInit(),并已建立一个任务。其中OS
StartHighRdy()必须调用OSTaskSwHoo
k(),并令OSRunning = TRUE.
(7)void OSStatInit (void) // 确定CPU 使用率
(8)void OSTimeTick (void) // 时钟节拍服务函数,在每个时钟节拍
了解每个任务的延时情况,使其中已经
到了延时时限的非挂起任务进入就绪
状态
(9)INT16U OSVersion (void) // 返回uc/os的版本号*100
(10)void OS_Dummy (void) // 不做任何事情,被OSTaskDel() 所调
用
(11)INT8U OS_EventTaskRdy (OS_EVENT *pevent, void *msg, INT8U ms
k)
// 使一个正在等待的任务进入就绪状态,
在调用函数OS***Post发送一个事
件时被调用
(12)void OS_EventTaskWait (OS_EVENT *pevent)
// 因为一个事件未发生而挂起一个任务
时被调用
(13)void OS_EventTO (OS_EVENT *pevent)
// 使一个等待超时的任务进入就绪状态(14)void OS_EventWaitListInit (OS_EVENT *pevent)
// 把OSEventGrp及任务等待表中的每
一位清零,即令ECB中不含任务等待,
被OS***Create()调用
(15)void OS_Sched (void) // 实现任务级的调度
(16)void OS_TaskIdle (void *pdata) // 空闲任务,为使CPU 在没有用户
任务时有事可做
(17)void OS_TaskStat (void *pdata) // 统计任务,每秒计算一次CPU在单
位时间内的使用时间,并将计算结果
以百分数的形式存放在OSCPUUsag
e中,以便应用程序访问它来了解c
pu的利用率
(18)INT8U OS_TCBInit (INT8U prio, // 任务的优先级别,存于OSTCBP
rio
OS_STK *ptos, // 任务堆栈顶指针,存于OSTCBStkPt
r
OS_STK *pbos, // 任务堆栈栈底指针,存于OSTCBSt
kBottom
INT16U id, // 任务的标识符,存于OSTCBID
INT32U stk_size, // 任务堆栈长度,存于OSTCBStkSize
void *pext, // 任务控制块的扩展指针,存于OSTC
BExtPtr
INT16U opt) // 任务控制块的选择项,存于OSTCB
Opt
// 为用户程序分配任务控制块及对其进
行初始化
备注:INT8U const OSUnMapTbl[ ] 是uc/os 为提高查找速度而定义的一个数组
二、OS_FLAG.C
(1)OS_FLAG_GRP *OSFlagCreate (OS_FLAGS flags, // 信号量的初始值
INT8U *err) // 错误信息
// 信号量集的创建函数
(2)void OS_FlagInit (void) // initialize the event flag module,是
uc/os的内部函数,应用程序不得调用该
函数
(3)OS_FLAG_GRP *OSFlagDel (OS_FLAG_GRP *pgrp, // 所要删除的信号量集指针
INT8U opt, // 选择项
INT8U *err)
// 删除信号量集
(4)OS_FLAGS OSFlagPend (OS_FLAG_GRP *pgrp, // 所要请求的信号量集的指针
OS_FLAGS flags, // 滤波器
INT8U wait_type, // 等待类型
INT16U timeout, // 延时时限
INT8U *err) // 错误信息
// 请求信号量集
(5)OS_FLAGS OSFlagAccept (OS_FLAG_GRP *pgrp, // 所请求的信号量集指针
OS_FLAGS flags, // 请求的信号
INT8U wait_type, // 逻辑运算类型
INT8U *err) // 错误信息
// 无等待的请求一个信号量集
(6)OS_FLAGS OSFlagPost (OS_FLAG_GRP *pgrp,
OS_FLAGS flags, // 所要选择发送的信号
INT8U opt, // 信号有效的选项
INT8U *err)
// 向信号量集发送信号
(7)OS_FLAGS OSFlagQuery (OS_FLAG_GRP *pgrp, // 待查询的信号量集的指针
INT8U *err)
// 查询信号量的状态,返回被查询信号量集标
志组的成员OSFlagFlags
(8)static void OS_FlagBlock (OS_FLAG_GRP *pgrp, // 信号量集指针
OS_FLAG_NODE *pnode, // 待添加的等待任务节点指针
OS_FLAGS flags, // 指定等待信号的数据
INT8U wait_type, // 信号与等待之间的逻辑
INT16U timeout) // 等待时限
// 添加节点,在请求信号量集函数OSFlagPend()
中被调用
(9)static BOOLEAN OS_FlagTaskRdy (OS_FLAG_NODE *pnode,
OS_FLAGS flags_rdy)
// 期望的事件标志为已经置位,从而使一个任务准备运行
(10)void OS_FlagUnlink (OS_FLAG_NODE *pnode)
// 删除节点,在OSFlagPost() 中被调用
三、OS_MBOX.C
(1)void *OSMboxAccept (OS_EVENT *pevent)
// 无等待的请求消息邮箱
(2)OS_EVENT *OSMboxCreate (void *msg)
// 创建一个消息邮箱
(3)OS_EVENT *OSMboxDel (OS_EVENT *pevent, INT8U opt, INT8U *er r)
// 删除消息邮箱
(4)void *OSMboxPend (OS_EVENT *pevent, INT16U timeout, INT8U *err)
// 请求消息邮箱,查看OSEventPtr是否为NULL (5)INT8U OSMboxPost (OS_EVENT *pevent, void *msg)
// 向消息邮箱发送消息
(6)INT8U OSMboxPostOpt (OS_EVENT *pevent, void *msg, INT8U opt)
// 以广播形式向事件等待任务表中的所有任务发送消息
(7)INT8U OSMboxQuery (OS_EVENT *pevent, OS_MBOX_DATA *pdata)
// 状态查询
四、OS_MEM.C
(1)OS_MEM *OSMemCreate (void *addr, INT32U nblks, INT32U blksize, INT8U *err)
// 创建动态内存
(2)void *OSMemGet (OS_MEM *pmem, INT8U *err)
// 请求获得一个内存块
(3)INT8U OSMemPut (OS_MEM *pmem, void *pblk)
// 释放一个内存块
(4)INT8U OSMemQuery (OS_MEM *pmem, OS_MEM_DATA *pdata)
// 查询动态内存的状态
(5)void OS_MemInit (void) // 初始化动态内存
五、OS_MUTEX.C
(1)INT8U OSMutexAccept (OS_EVENT *pevent, INT8U *err)
// 无等待时间的请求信号量(2)OS_EVENT *OSMutexCreate (INT8U prio, INT8U *err)
// 创建互斥型信号量
(3)OS_EVENT *OSMutexDel (OS_EVENT *pevent, INT8U opt, INT8U *er r)
// 删除互斥型信号量
(4)void OSMutexPend (OS_EVENT *pevent, INT16U timeout, INT8U *err)
// 有等待时间的请求信号量
(5)INT8U OSMutexPost (OS_EVENT *pevent)
// 发送(释放)互斥型信号量
(6)INT8U OSMutexQuery (OS_EVENT *pevent, OS_MUTEX_DATA *pdat a)
// 获取互斥型信号量的当前状态
六、OS_Q.C
(1)void *OSQAccept (OS_EVENT *pevent)
// 无等待的请求一个消息队列
(2)OS_EVENT *OSQCreate (void **start, INT16U size)
// 创建一个消息队列
(3)OS_EVENT *OSQDel (OS_EVENT *pevent, INT8U opt, INT8U *err)
// 删除消息队列
(4)INT8U OSQFlush (OS_EVENT *pevent)
// 清空消息队列
(5)void *OSQPend (OS_EVENT *pevent, INT16U timeout, INT8U *err)
// 有等待的请求一个消息队列
(6)INT8U OSQPost (OS_EVENT *pevent, void *msg)
// 以“先进先出”的方式向消息队列发送消息
(7)INT8U OSQPostFront (OS_EVENT *pevent, void *msg)
// 以“后进先出”的方式向消息队列发送消息(8)INT8U OSQPostOpt (OS_EVENT *pevent, void *msg, INT8U opt)
// 以“广播”方式向消息队列发送消息
(9)INT8U OSQQuery (OS_EVENT *pevent, OS_Q_DATA *pdata)
// 获取消息队列的当前状态
(10)void OS_QInit (void)
// 消息队列初始化
七、OS_SEM.C
(1)INT16U OSSemAccept (OS_EVENT *pevent)
// 无等待的请求信号量
(2)OS_EVENT *OSSemCreate (INT16U cnt)
// 创建信号量
(3)OS_EVENT *OSSemDel (OS_EVENT *pevent, INT8U opt, INT8U *err)
// 删除信号量
(4)void OSSemPend (OS_EVENT *pevent, INT16U timeout, INT8U *err)
// 有等待的请求信号量
(5)INT8U OSSemPost (OS_EVENT *pevent)
// 发送(释放)信号量
(6)INT8U OSSemQuery (OS_EVENT *pevent, OS_SEM_DATA *pdata)
// 获取信号量的当前状态
八、OS_TASK.C
(1)INT8U OSTaskChangePrio (INT8U oldprio, INT8U newprio)
// 任务优先级别的改变
(2)INT8U OSTaskCreate (void (*task)(void *pd), void *pdata, OS_STK *pt os, INT8U prio)
// 任务的创建
(3)INT8U OSTaskCreateExt (void (*task)(void *pd), // 指向任务的指针
void *pdata, // 传递给任务的参数
OS_STK *ptos, // 指向任务堆栈栈顶的指针
INT8U prio, // 创建任务的优先级
INT16U id, // 任务的标识
OS_STK *pbos, // 任务堆栈栈底的指针
INT32U stk_size, // 任务堆栈的长度
void *pext, // 指向附加数据域的指针
INT16U opt) // 用于设定操作的选项
// 任务的另一种创建函数,更加灵活,但也增加了额外的开销
(4)INT8U OSTaskDel (INT8U prio) // 任务的删除
(5)INT8U OSTaskDelReq (INT8U prio) // 请求删除任务函数
(6)INT8U OSTaskResume (INT8U prio) // 任务的恢复
(7)INT8U OSTaskStkChk (INT8U prio, OS_STK_DATA *pdata)
// 校核空余内存的数量
(8)INT8U OSTaskSuspend (INT8U prio) // 任务的挂起,可用来挂起自
身或除空闲任务之外的任何任务(9)INT8U OSTaskQuery (INT8U prio, OS_TCB *pdata)
// 任务的查询
九、OS_TIME.C
(1)void OSTimeDly (INT16U ticks) // 以时钟节拍数为单位延时
(2)INT8U OSTimeDlyHMSM (INT8U hours, INT8U minutes, INT8U second s, INT16U milli)
// 用时、分、秒、毫秒为单位延时
(3)INT8U OSTimeDlyResume (INT8U prio)
// 取消延时,若任务比正在运行的任务级别高,则立即引发一
次调度
(4)INT32U OSTimeGet (void) // 获取OSTime 值
(5)void OSTimeSet (INT32U ticks) // 设置OSTime 值
注:INT32U OSTime // 全局变量,用以
系统发生的时钟节拍