阅读 56

OS_CORE.C(9)

本篇介绍以下几个函数:

OSVersion()获得版本号函数、

OS_Dummy()虚拟函数、

OS_EventTaskRdy (OS_EVENT *pevent, void *msg, INT8U msk)使任务进入就绪态的函数、

OS_EventTaskWait (OS_EVENT *pevent)使任务进入等待状态的函数、

OS_EventTaskWaitMulti(OS_EVENT **pevents_wait)使任务进入等待状态的函数(多任务下)、\

\

OSVersion()获得版本号函数:

/*$PAGE*/
/*
*********************************************************************************************************
*                                             GET VERSION
*												获得版本号
* Description: This function is used to return the version number of uC/OS-II.  The returned value
*              corresponds to uC/OS-II's version number multiplied by 100.  In other words, version 2.00
*              would be returned as 200.
*这个函数是返回一个uC/OS-II的版本值. 这个返回值乘100是uC/OS-II的版本号. 
* Arguments  : none
*
* Returns    : the version number of uC/OS-II multiplied by 100.
*********************************************************************************************************
*/
INT16U  OSVersion(void)
{
	return (OS_VERSION);
}
复制代码

OS_Dummy()虚拟函数:\

/*$PAGE*/
/*
*********************************************************************************************************
*                                            DUMMY FUNCTION
*												虚拟函数
* Description: This function doesn't do anything.  It is called by OSTaskDel().
*这个函数不做任务工作. 它是随便访问OSTaskDel()函数.
* Arguments  : none
*
* Returns    : none
*********************************************************************************************************
*/

#if OS_TASK_DEL_EN > 0u
void  OS_Dummy(void)
{
}
#endif
复制代码

OS_EventTaskRdy (OS_EVENT *pevent, void *msg, INT8U msk)使任务进入就绪态的 函数:

/*$PAGE*/
/*
*********************************************************************************************************
*                             MAKE TASK READY TO RUN BASED ON EVENT OCCURING
*								使一个任务进入就绪态
* Description: This function is called by other uC/OS-II services and is used to ready a task that was
*              waiting for an event to occur.
*描述:该功能被其他oc/os-ii服务调用,用来使正在等待事件发生的任务进入就绪态。
* Arguments  : pevent      is a pointer to the event control block corresponding to the event.
*	参数:				--pevent指针指向与事件对应的事件控制块
*              pmsg        is a pointer to a message.  This pointer is used by message oriented services
*                          such as MAILBOXEs and QUEUEs.  The pointer is not used when called by other
*                          service functions.
*						--pmsg指针指向消息,只能面向消息的服务才能使用,例如邮箱和队列。其他的不能调用该函数。
*              msk         is a mask that is used to clear the status byte of the TCB.  For example,
*                          OSSemPost() will pass OS_STAT_SEM, OSMboxPost() will pass OS_STAT_MBOX etc.
*						--msk函数是一个掩码,用来清除TCB的状态字。例如,通过OSSemPost()函数清除OS_STAT_SEM;利用OSMboxPost()函数清除OS_STAT_MBOX。
*              pend_stat   is used to indicate the readied task's pending status:
*						--pend_stat用来表明已准备好的任务的挂起状态。挂起状态有以下两种:
*                          OS_STAT_PEND_OK      Task ready due to a post (or delete), not a timeout or
*                                               an abort.
											--挂起结束(正常结束):任务已经准备好进入就绪态。
*                          OS_STAT_PEND_ABORT   Task ready due to an abort.
											--取消挂起:任务被取消。
*
* Returns    : none
*
* Note       : This function is INTERNAL to uC/OS-II and your application should not call it.
这个函数是uC/OS-II内部函数,你不可以在应用程序调用它,调用此函数也应当关闭中断
*********************************************************************************************************
*/
#if (OS_EVENT_EN)
INT8U  OS_EventTaskRdy(OS_EVENT  *pevent,
	void      *pmsg,
	INT8U      msk,
	INT8U      pend_stat)
{
	OS_TCB   *ptcb;								/*指向TCB列表的指针*/
	INT8U     y;								/*存放字节索引*/
	INT8U     x;								/*存放任务在表中对应的具体位置*/
	INT8U     prio;								/*存放优先级(数字越小,优先级越高)*/
#if OS_LOWEST_PRIO > 63u					/*如果最低优先级大于63u(超出了范围)*/
	OS_PRIO  *ptbl;							/*设置一个专门存放超出范围的优先级指针ptb1*/
#endif

#if OS_LOWEST_PRIO <= 63u						/*如果最低优先级<=63*/
	y = OSUnMapTbl[pevent->OSEventGrp];         /* Find HPT waiting for message首先计算HPT任务在.OSEventTbl[]中的字节索引,其结果是一个从0到OS_LOWEST_PRIO/8+1之间的数                */
	x = OSUnMapTbl[pevent->OSEventTbl[y]];		/*判断HPT任务在.OSEventTbl[]中相应位的位置*/
	prio = (INT8U)((y << 3u) + x);              /* Find priority of task getting the msg 根据以上结果计算出HPT任务的优先级*/
#else											/*最低优先级>63*/
	if ((pevent->OSEventGrp & 0xFFu) != 0u)		/*存在事件控制块所在的组*/
	{   
		y = OSUnMapTbl[pevent->OSEventGrp & 0xFFu];		/*找到事件所在的组*/
	}
	else 
	{
		y = OSUnMapTbl[(OS_PRIO)(pevent->OSEventGrp >> 8u) & 0xFFu] + 8u;/*没有组,将y置为8(不在组内)*/
	}
	ptbl = &pevent->OSEventTbl[y];				/*ptb1指针指向上面求出的组的首地址*/
	if ((*ptbl & 0xFFu) != 0u)					/*如果该指针指向的这一行不为0,即存在有效值*/
	{	
		x = OSUnMapTbl[*ptbl & 0xFFu];			/*得到该任务在表中相应的位置*/
	}
	else {						
		x = OSUnMapTbl[(OS_PRIO)(*ptbl >> 8u) & 0xFFu] + 8u;/*为0,将x设为8(不在组内)*/
	}
	prio = (INT8U)((y << 4u) + x);            /* Find priority of task getting the msg找到得到消息的任务的优先级*/
											/*因为超过了63,所以此时y占了4位,所以左移4u。上面左移3u是因为y在63内,只占了3位*/
#endif

	ptcb = OSTCBPrioTbl[prio];        /* Point to this task's OS_TCB指针指向任务的TCB*/
	ptcb->OSTCBDly = 0u;              /* Prevent OSTimeTick() from readying task将OSTCBDly清为0*/
									/*因为最高优先级任务运行条件已经得到满足,必须停止OSTimeTick()函数对.OSTCBDly域的递减操作*/
#if ((OS_Q_EN > 0u) && (OS_MAX_QS > 0u)) || (OS_MBOX_EN > 0u)/*如果生成队列且队列数>0或者生成了邮箱*/
	ptcb->OSTCBMsg = pmsg;                      /* Send message directly to waiting task直接给等待的任务发送消息*/
#else
	pmsg = pmsg;                      /*pmsg不进行变化*//* Prevent compiler warning if not used防止编译警告*/
#endif
	ptcb->OSTCBStat &= (INT8U)~msk;                /* Clear bit associated with event type清除与事件类型相关的位*/
	ptcb->OSTCBStatPend = pend_stat;                 /* Set pend status of post or abort设置挂起状态*/

	/* See if task is ready (could be susp'd)看看任务是否已经准备好了(能否被挂起)*/
	if ((ptcb->OSTCBStat &   OS_STAT_SUSPEND) == OS_STAT_RDY) //已经准备好了,将任务设置为就绪态
	{
		OSRdyGrp |= ptcb->OSTCBBitY;           /* Put task in the ready to run list*/
		OSRdyTbl[y] |= ptcb->OSTCBBitX;
	}

	OS_EventTaskRemove(ptcb, pevent);         /* Remove this task from event wait list从事件等待列表中删除任务*/
#if (OS_EVENT_MULTI_EN > 0u)				/*如果是多任务*/
	if (ptcb->OSTCBEventMultiPtr != (OS_EVENT **)0) /*的确存在多任务*/
	{   
		OS_EventTaskRemoveMulti(ptcb, ptcb->OSTCBEventMultiPtr);/* Remove this task from events' wait lists将该任务从事件的等待列表中移除*/
		ptcb->OSTCBEventPtr = (OS_EVENT  *)pevent;/* Return event as first multi-pend event read返回读到的第一个多挂起事件*/
	}
#endif

	return (prio);//返回优先级
}
#endif
复制代码

流程图为:



\

关于这个函数中的计算优先级的方法:blog.sina.com.cn/s/blog_4a39…

\

\

每个任务的就绪态标志都放入就绪表中,就绪表中有两个变量OSRdyGrp和OSRdyTbl[]。

OSRdyGrp是一个8位的变量,用来记录哪几列有就绪任务bit0~bit7。

OSRdyTbl[列号]用来记录某行中那几个位被置位。

假设有个prio为20的任务,那么填入这两个变量的值应当这么操作:先算出 OSRdyGrp中的位置 20 / 8 = 2即BIT2,再算 OSRdyTbl[ OSRdyGrp]中的位置 20 % 8 = 4即BIT4, 那么看下图可知20的位置确实在表[2][4]的位置 ​OSRdyGrp |= BIT2  ​  ​ ​OSRdyTbl[2] |= ​BIT4。

\

OSRdyGrp和 OSRdyTbl[ OSRdyGrp]都是8个位的变量 ,这8个位可以是一个置为,也可以是多个置位,总计可以有2^8 64种数值,即0~63,那我们要找最高优先级的任务就是要找矩阵中数值最小的那个任务。这张表就是列出了0~63中为1的最小bit号,\

假设bit2 bit4 bit6置为,那么这个值应当是2^6+2^4+2^2 = 84;它最小置位位应当是BIT2,这是我们看出来的,那么我把84(54h)代入第二个表查下,的确是2。这样就能确定最高优先级任务的行列号了

我们看下面的代码

y = OSUnMapTbl[OSRdyGrp];//确定行号

OSPrioHighRdy = (INT8U)((y << 3u) + OSUnMapTbl[OSRdyTbl[y]]);//确定列号

计算优先级的方法也显而易见了:就绪列表或事件表中求索引号-》同一个表求相应位的位置-》计算优先级。

这个函数比较费解的,一个是求优先级的方法;一个是查表以及进行的逻辑运算。需要认真研究才可以搞懂。

OS_EventTaskWait (OS_EVENT *pevent)使任务进入等待状态的函数:\

当某个任务须等待一个事件的发生时,信号量、互斥型信号量、邮箱以及消息队列会通过相应的PEND函数调用本函数,使当前任务从就绪任务表中脱离就绪态,并放到相应的事件控制块ECB的等待任务表中。\

/*$PAGE*/
/*2018/2/7
*********************************************************************************************************
*                                   MAKE TASK WAIT FOR EVENT TO OCCUR
*									使一个任务进入等待某事件发生状态 
* Description: This function is called by other uC/OS-II services to suspend a task because an event has
*              not occurred.
*描述:这个功能被其他uc/os-ii服务调用,当事件没有发生时挂起该任务
* Arguments  : pevent   is a pointer to the event control block for which the task will be waiting for.
*参数:					--pevent是指向事件控制块的指针
* Returns    : none
*返回值:无
* Note       : This function is INTERNAL to uC/OS-II and your application should not call it.
注释:该功能为内部功能函数,你的应用程序不能调用
*********************************************************************************************************
*/
#if (OS_EVENT_EN)								/*如果可以生成事件*/
void  OS_EventTaskWait(OS_EVENT *pevent)		/*使任务进入等待函数*/
{
	INT8U  y;

	OSTCBCur->OSTCBEventPtr = pevent;           /*将指向事件控制块的指针赋给当前任务控制块中指向事件的指针,建立任务与事件控制块ECB之间的链接*/

	pevent->OSEventTbl[OSTCBCur->OSTCBY] |= OSTCBCur->OSTCBBitX;    /* Put task in waiting list将任务放置在等待列表中*/
	pevent->OSEventGrp |= OSTCBCur->OSTCBBitY;

	y = OSTCBCur->OSTCBY;            /* Task no longer ready任务不再为就绪态*/

	OSRdyTbl[y] &= (OS_PRIO)~OSTCBCur->OSTCBBitX;
	if (OSRdyTbl[y] == 0u)  /*将任务从就绪任务表中删除*/
	{                     
		OSRdyGrp &= (OS_PRIO)~OSTCBCur->OSTCBBitY;
	}
}
#endif
复制代码

\

OS_EventTaskWaitMulti(OS_EVENT **pevents_wait)使任务进入等待状态的函数(多任务下):\

/*$PAGE*/
/*2018/2/7
*********************************************************************************************************
*                          MAKE TASK WAIT FOR ANY OF MULTIPLE EVENTS TO OCCUR
*								多事件情况下的任务等待函数
* Description: This function is called by other uC/OS-II services to suspend a task because any one of
*              multiple events has not occurred.
*描述:该功能被uc/os-ii服务调用,当多事件中的任何一个发生时,挂起任务
* Arguments  : pevents_wait     is a pointer to an array of event control blocks, NULL-terminated, for
*                               which the task will be waiting for.
*参数:							--pevents_wait指向事件控制块数组的指针(指针的指针)。以null结尾。
* Returns    : none.
*返回值:无
* Note       : This function is INTERNAL to uC/OS-II and your application should not call it.
注释:该功能为uc/os-ii内部功能,你的应用程序不能调用它。
*********************************************************************************************************
*/
#if ((OS_EVENT_EN) && (OS_EVENT_MULTI_EN > 0u))						/*如果可以产生事件并且多事件数量>0*/
void  OS_EventTaskWaitMulti(OS_EVENT **pevents_wait)				/*调用函数*/
{
	OS_EVENT **pevents;
	OS_EVENT  *pevent;
	INT8U      y;

	OSTCBCur->OSTCBEventPtr = (OS_EVENT  *)0;						/*当前TCB的事件指针设置为0*/
	OSTCBCur->OSTCBEventMultiPtr = (OS_EVENT **)pevents_wait;       /*将事件等待指针赋给当前TCB中的多事件指针*/

	pevents = pevents_wait;
	pevent = *pevents;
	while (pevent != (OS_EVENT *)0) {                               /* Put task in waiting lists将任务放到等待列表中*/
		pevent->OSEventTbl[OSTCBCur->OSTCBY] |= OSTCBCur->OSTCBBitX;
		pevent->OSEventGrp |= OSTCBCur->OSTCBBitY;
		pevents++;
		pevent = *pevents;
	}

	y = OSTCBCur->OSTCBY;            /* Task no longer ready 此时该任务不再是就绪态 */
	OSRdyTbl[y] &= (OS_PRIO)~OSTCBCur->OSTCBBitX;
	if (OSRdyTbl[y] == 0u) {                      /* Clear event grp bit if this was only task pending */
		OSRdyGrp &= (OS_PRIO)~OSTCBCur->OSTCBBitY;/*清除*/
	}
}
#endif
复制代码

OS_EventTaskRemove(OS_TCB   *ptcb,OS_EVENT *pevent)从事件等待列表中移除任务函数:\

/*$PAGE*/
/*2018/2/7
*********************************************************************************************************
*                                   REMOVE TASK FROM EVENT WAIT LIST
*										从事件等待列表中移除任务函数
* Description: Remove a task from an event's wait list.
*描述:将任务从一个事件的等待列表中移除
* Arguments  : ptcb     is a pointer to the task to remove.
*参数:					--ptcb是一个指向要移除任务的指针
*              pevent   is a pointer to the event control block.
*						--pevent是一个指向事件控制块的指针
* Returns    : none
*返回值:无
* Note       : This function is INTERNAL to uC/OS-II and your application should not call it.
注释:该功能为内部函数,你的应用程序不能调用。
*********************************************************************************************************
*/
#if (OS_EVENT_EN)
void  OS_EventTaskRemove(OS_TCB   *ptcb,OS_EVENT *pevent)
{
	INT8U  y;

	y = ptcb->OSTCBY;
	pevent->OSEventTbl[y] &= (OS_PRIO)~ptcb->OSTCBBitX;    /* Remove task from wait list将人物从等待列表中移除*/
	if (pevent->OSEventTbl[y] == 0u) {
		pevent->OSEventGrp &= (OS_PRIO)~ptcb->OSTCBBitY;
	}
}
#endif
复制代码

后面这两个函数在前面的基础上就比较好理解了。不再赘述。

本篇博客重点还是放在两张表的学习上。
\

\

文章分类
代码人生
文章标签