UCOS常用API函数指令
*********************************************************************************************************
* 消息邮箱管理 (MESSAGE MAILBOX MANAGEMENT)
*
* OSMboxAccept () 查看消息邮箱(消息邮箱指针)
* OSMboxCreate () 建立并初始化一个消息邮箱(msg 参数不为空含内容)
* OSMboxDel () 删除消息邮箱(消息邮箱指针、删除条件、出错代码指针)
* OSMboxPend () 等待一个消息邮箱函数(消息邮箱指针、允许等待的时钟节拍、代码错误指针)
* OSMboxPost () 发送消息函数(消息邮箱指针、即将实际发送给任务的消息)
* OSMboxPostOpt () 向邮箱发送一则消息(邮箱指针、消息、条件)
* OSMboxQuery () 查询一个邮箱的当前状态(信号量指针、状态数据结构指针)
*********************************************************************************************************
*********************************************************************************************************
* 内存管理项 (MEMORY MANAGEMENT)
*
* OSMemCreate () 建立并初始化一块内存区(起始地址、需要的内存块数目、内存块大小、返回错误的指针)
* OSMemGet () 从内存区分配一个内存块
* OSMemPut () 释放一个内存块，内存块必须释放回原先申请的内存区
* OSMemQuery () 得到内存区的信息
*********************************************************************************************************
*/
/*
*********************************************************************************************************
* 互斥型信号量项管理 (MUTUAL EXCLUSION SEMAPHORE MANAGEMENT)
*
* OSMutexAccept () 无等待地获取互斥型信号量[任务不挂起](信号量指针、错误代码)
* OSMutexCreate () 建立并初始化一个互斥型信号量(优先级继承优先级(PIP)、出错代码指针)
* OSMutexDel () 删除互斥型信号量(信号指针、删除条件、错误指针)
* OSMutexPend () 等待一个互斥型信号量(指针、等待超时时限、出错代码指针)
* OSMutexPost () 释放一个互斥型信号量(互斥型信号量指针)
* OSMutexQuery () 查询一个互斥型信号量的当前状态(互斥型信号量指针、状态数据结构指针)
*********************************************************************************************************
*/
*********************************************************************************************************
* 消息队列管理 (MESSAGE QUEUE MANAGEMENT)
*
* OSQAccept () 检查消息队列中是否已经有需要的消息(消息队列的指针)
* OSQCreate () 建立一个消息队列(消息内存区的基地址(指针数组)、消息内存区的大小)
* OSQDel () 删除一个消息队列(消息队列指针、删除条件、错误指针)
* OSQFlush () 清空消息队列(指向得到消息队列的指针)
* OSQPend () 任务等待消息队列中的消息(消息队列指针、允许等待的时钟节拍、代码错误指针)
* OSQPost () 向消息队列发送一则消息FIFO(消息队列指针、发送的消息)
* OSQPostFront () 向消息队列发送一则消息LIFO(消息队列指针、发送的消息)
* OSQPostOpt () 向消息队列发送一则消息LIFO(消息队列指针、发送的消息、发送条件)
* OSQQuery () 查询一个消息队列的当前状态(信号量指针、状态数据结构指针)
*********************************************************************************************************
*/
/*
*********************************************************************************************************
* 信号量管理 (SEMAPHORE MANAGEMENT)
*
* OSSemAccept() 无条件地等待请求一个信号量函数
* OSSemCreate() 建立并初始化一个信号量(输入一个信号量值)
* OSSemDel() 删除一个信号量(信号指针、删除条件、错误指针)
* OSSemPend () 等待一个信号量函数(信号量指针、允许等待的时钟节拍、代码错误指针)
* OSSemPost () 发出一个信号量函数(信号量指针)
* OSSemQuery () 查询一个信号量的当前状态(信号量指针、状态数据结构指针)
*********************************************************************************************************
*/
*********************************************************************************************************
* 任务管理 (TASK MANAGEMENT)
*
* OSTaskChangePrio () 改变一个任务的优先级(任务旧的优先级、任务新的优先级)
* OSTaskCreate () 建立任务(任务代码指针、传递参数指针、分配任务堆栈栈顶指针、任务优先级)
* OSTaskCreateExt () 建立扩展任务(任务代码指针/传递参数指针/分配任务堆栈栈顶指针/分配任务优先级
* //(未来的)优先级标识(与优先级相同)/分配任务堆栈栈底指针/指定堆栈的容量(检验用)
* //指向用户附加的数据域的指针/建立任务设定选项)
* OSTaskDel () 删除任务(任务的优先级)
* OSTaskDelReq () 请求一个任务删除其它任务或自身?(任务的优先级)
* OSTaskResume () 唤醒一个用OSTaskSuspend()函数挂起的任务(任务的优先级)
* OSTaskStkChk () 检查任务堆栈状态(任务优先级、检验堆栈数据结构)
* OSTaskSuspend () 无条件挂起一个任务(任务优先级)
* OSTaskQuery () 获取任务信息(任务指针、保存数据结构指针)
*********************************************************************************************************
*/
*********************************************************************************************************
* 时钟管理项 (TIME MANAGEMENT)
*
* OSTimeDly () 任务延时函数(时钟节拍数)
* OSTimeDlyHMSM () 将一个任务延时若干时间(设定时、分、秒、毫秒)
* OSTimeDlyResume () 唤醒一个用OSTimeDly()或OSTimeDlyHMSM()函数的任务(优先级)
* OSTimeGet () 获取当前系统时钟数值
* OSTimeSet () 设置当前系统时钟数值
*********************************************************************************************************
*/ 创建任务 :
INT8U OSTaskCreate (void (*task)(void *p_arg),
void *p_arg,
OS_STK *ptos,
INT8U prio)返回值为错误信息.以下不说明的默认都是错误信息;
扩展:
INT8U OSTaskCreateExt (void (*task)(void *p_arg),
void *p_arg,
OS_STK *ptos,
INT8U prio,
INT16U id,
OS_STK *pbos,
INT32U stk_size,
void *pext,
INT16U opt)挂起:
INT8U OSTaskSuspend (INT8U prio)恢复:
INT8U OSTaskResume (INT8U prio)改变优先级:
INT8U OSTaskChangePrio (INT8U oldprio,
INT8U newprio)任务删除:
INT8U OSTaskDel (INT8U prio)请求删除任务:
INT8U OSTaskDelReq (INT8U prio)查询任务信息: 查询信息都需要先定义一个指定的类型变量或者结构体来储存查询信息.
INT8U OSTaskQuery (INT8U prio,
OS_TCB *p_task_data)临界状态,和中断任务调度
OS_ENTER_CRITICAL() //进入临界 关中断
OS_EXIT_CRITICAL() //退出临界 开中断
OSIntEnter() //中断中使用 OSIntNesting+1
OSIntExit() //退出中断时使用 OSIntNesting-1 并调度
OSSchedLock() //任务调度器上锁 OSLockNesting+1
OSSchedUnlock() //任务调度器解锁 OSLockNesting-1
#define OS_TASK_SW() OSCtxSw()
OSIntCtxSW()与OSCtxSw()类似,只是因为在中断中使用所以,少了入栈等断点保护步骤.因为OSIntCtxSW()是中断函数中使用的调度.保护步骤在中断已经完成.
延时函数
void OSTimeDly (INT32U ticks); //任务延时ticks次心跳
INT8U OSTimeDlyHMSM (INT8U hours,
INT8U minutes,
INT8U seconds,
INT16U ms); //延时具体时间.最小单位(1000/OS_TICKS_PER_SEC)ms
INT8U OSTimeDlyResume (INT8U prio); //取消任务延时获取时间
INT32U OSTimeGet (void); //OSStart()时为0,心跳一次+1
void OSTimeSet (INT32U ticks) //设置信号量
OS_EVENT *SEM;
OS_EVENT *OSSemCreate (INT16U cnt);
void OSSemPend (OS_EVENT *pevent, INT16U timeout, INT8U *perr); //等待信号量需要先创建一个变量存放*perr 错误信息
INT16U OSSemAccept (OS_EVENT *pevent); //等待失败继续运行
INT8U OSSemPost (OS_EVENT *pevent); //发送信号量
OS_EVENT *OSSemDel (OS_EVENT *pevent, INT8U opt, INT8U *perr);//删除信号量
INT8U OSSemQuery (OS_EVENT *pevent, OS_SEM_DATA *p_sem_data); //查询信号量 需先创建OS_SEM_DATA结构体变量存储信息.
互斥信号量
OS_EVENT *OSMutexCreate (INT8U prio, INT8U *perr) ;//创建
void OSMutexPend (OS_EVENT *pevent, INT16U timeout, INT8U *perr);//等待请求
INT8U OSMutexPost (OS_EVENT *pevent) ;//发送
INT8U OSMutexQuery (OS_EVENT *pevent, OS_MUTEX_DATA *p_mutex_data); //查询
OS_EVENT *OSMutexDel (OS_EVENT *pevent, INT8U opt, INT8U *perr) ; //删除
BOOLEAN OSMutexAccept (OS_EVENT *pevent, INT8U *perr); //无等待请求
邮箱
OS_EVENT * BOX;
OS_EVENT *OSMboxCreate (void *pmsg); //*pmsg消息指针 返回值为邮箱指针
INT8U OSMboxPost (OS_EVENT *pevent, void *pmsg) ; //*pevent邮箱指针 *pmsg消息指针
INT8U OSMboxPostOpt (OS_EVENT *pevent, void *pmsg, INT8U opt);//广播 opt,OS_POST_OPT_NONE和post一样.OS_POST_OPT_BROADCAST,广播,OS_POST_OPT_NO_SCHED只发送不调度.
void *OSMboxPend (OS_EVENT *pevent, INT16U timeout, INT8U *perr);
void *OSMboxAccept (OS_EVENT *pevent); //无等待 返回值为消息指针
INT8U OSMboxQuery (OS_EVENT *pevent, OS_MBOX_DATA *p_mbox_data);
OS_EVENT *OSMboxDel (OS_EVENT *pevent, INT8U opt, INT8U *perr); //opt:OS_DEL_NO_PEND:没有被等待删除.OS_DEL_ALWAYS 强制删除.
消息队列
OS_EVENT *OSQCreate (void **start, INT16U size);
void *OSQAccept (OS_EVENT *pevent, INT8U *perr);
OS_EVENT *OSQDel (OS_EVENT *pevent, INT8U opt, INT8U *perr);
void *OSQPend (OS_EVENT *pevent, INT16U timeout, INT8U *perr);
INT8U OSQPost (OS_EVENT *pevent, void *pmsg);
INT8U OSQPostFront (OS_EVENT *pevent, void *pmsg); //后入先出
INT8U OSQPostOpt (OS_EVENT *pevent, void *pmsg, INT8U opt);//广播
INT8U OSQFlush (OS_EVENT *pevent); //清空队列
INT8U OSQQuery (OS_EVENT *pevent, OS_Q_DATA *p_q_data); //查询信号量集
OS_FLAG_GRP *OSFlagCreate (OS_FLAGS flags, INT8U *perr); //创建
OS_FLAGS OSFlagPend (OS_FLAG_GRP *pgrp, OS_FLAGS flags, INT8U wait_type, INT16U timeout, INT8U *perr);//请求
OS_FLAGS OSFlagAccept (OS_FLAG_GRP *pgrp, OS_FLAGS flags, INT8U wait_type, INT8U *perr); //无等待
OS_FLAGS OSFlagPost (OS_FLAG_GRP *pgrp, OS_FLAGS flags, INT8U opt, INT8U *perr); //发送
OS_FLAGS OSFlagQuery (OS_FLAG_GRP *pgrp, INT8U *perr); //查询
OS_FLAG_GRP *OSFlagDel (OS_FLAG_GRP *pgrp, INT8U opt, INT8U *perr); //