uCOSii消息邮箱管理 (MESSAGE MAILBOX MANAGEMENT)
消息邮箱主要用于中断和任务之间进行邮件传递，或者是在任务与任务之间进行邮件交换。
1、消息邮箱管理重点需要了解下面几个函数
消息邮箱指针=OSMboxCreate(消息邮箱数据块指针) 建立并初始化一个消息邮箱,在初始化时，通常将“消息邮箱数据块指针”设置为0,，如：MailBoxes_Event = OSMboxCreate( (void*)0 );
OSMboxAccept(消息邮箱指针)返回指针不为0，则表示接收到消息邮箱的新数据，同时会清除”消息邮箱的数据块”指针，允许再次发送邮箱新数据。
OSMboxPend(消息邮箱指针,0,&err);*per=OS_ERR_NONE，且返回指针不为0，则表示接收到消息邮箱的新数据，同时会清除”消息邮箱的数据块”指针，允许再次发送邮箱新数据。
OSMboxPost(消息邮箱指针pevent, 消息邮箱数据块指针); 返回值OS_ERR_NONE，且pevent->OSEventPtr = pmsg才表示消息邮箱发送成功
OSMboxPostOpt(消息邮箱指针pevent, 消息邮箱数据块指针, opt) 返回值OS_ERR_NONE，且pevent->OSEventPtr = pmsg才表示消息邮箱发送成功
OSMboxDel() 删除消息邮箱(消息邮箱指针、删除条件、出错代码指针)
OSMboxQuery() 查询一个邮箱的当前状态(信号量指针、状态数据结构指针)
2、OSMboxPost (OS_EVENT *pevent, void *pmsg)发送邮件
//函数功能：返回值OS_ERR_NONE，且pevent->OSEventPtr = pmsg才表示消息邮箱发送成功
//注意：为了能够判断消息邮箱是否发送成功,最好使用两个或两个以上的邮箱数据块地址，防止发送过快,导致消息邮箱发送时出现漏发现象；
// pevent为消息邮箱的指针
//pmsg是指向”消息邮箱的数据块地址”
INT8U OSMboxPost (OS_EVENT *pevent,
void *pmsg)
{
#if OS_CRITICAL_METHOD == 3u
OS_CPU_SR cpu_sr = 0u;
#endif
#if OS_ARG_CHK_EN > 0u
if (pevent == (OS_EVENT *)0)
{//消息邮箱的指针为0
return (OS_ERR_PEVENT_NULL);
}
if (pmsg == (void *)0)
{//消息邮箱的数据块地址为0
return (OS_ERR_POST_NULL_PTR);
}
#endif
if (pevent->OSEventType != OS_EVENT_TYPE_MBOX)
{//该事件类型不是消息邮箱
return (OS_ERR_EVENT_TYPE);
}
OS_ENTER_CRITICAL();//进入临界区(无法被中断打断),需要定义cpu_sr变量
///发现”消息邮箱挂起的任务” ///
if (pevent->OSEventGrp != 0u)
{//查询是否有”消息邮箱挂起的任务”，若有，则立即发送邮件
(void)OS_EventTaskRdy(pevent, pmsg, OS_STAT_MBOX, OS_STAT_PEND_OK);
//向pevent所指的消息邮箱发送邮件，发送内容为pmsg指针
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
OS_Sched();//发现有更高优先级的任务在企图运行,执行任务调度
return (OS_ERR_NONE);
}
///没有发现”消息邮箱挂起的任务” ///
if (pevent->OSEventPtr != (void *)0)//查询邮箱中的内容是否被接收
{//上次发送的消息邮箱中的内容没有被读取，取消发送邮件
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
return (OS_ERR_MBOX_FULL);//没有执行发送消息邮箱,就退出了
}
/上次发送的消息邮箱中的内容已经被读取/
pevent->OSEventPtr = pmsg;
//向pevent所指的消息邮箱发送邮件，发送内容为pmsg指针
//pmsg是指向”消息邮箱的数据块地址”
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
return (OS_ERR_NONE); //执行发送消息邮箱后,才退出
}
3、OSMboxPostOpt (OS_EVENT *pevent, void *pmsg,INT8U opt)
opt = OS_POST_OPT_BROADCAST=0x01，群发邮件
opt! = OS_POST_OPT_BROADCAST=0x01，点对点发送邮件
//函数功能：返回值OS_ERR_NONE，且pevent->OSEventPtr = pmsg才表示消息邮箱发送成功
//注意：为了能够判断消息邮箱是否发送成功,最好使用两个或两个以上的邮箱数据块地址，防止发送过快,导致消息邮箱发送时出现漏发现象；
// pevent为消息邮箱的指针
//pmsg是指向”消息邮箱的数据块地址”
//opt = OS_POST_OPT_BROADCAST=0x01， 群发邮件
// opt! = OS_POST_OPT_BROADCAST=0x01, 点对点发送邮件
//opt &OS_POST_OPT_NO_SCHED==0，需要执行任务调度
INT8U OSMboxPostOpt (OS_EVENT *pevent,
void *pmsg,
INT8U opt)
{
#if OS_CRITICAL_METHOD == 3u
OS_CPU_SR cpu_sr = 0u;
#endif
#if OS_ARG_CHK_EN > 0u
if (pevent == (OS_EVENT *)0)
{//消息邮箱的指针为0
return (OS_ERR_PEVENT_NULL);
}
if (pmsg == (void *)0)
{//消息邮箱的数据块地址为0
return (OS_ERR_POST_NULL_PTR);
}
#endif
if (pevent->OSEventType != OS_EVENT_TYPE_MBOX)
{//该事件类型不是消息邮箱
return (OS_ERR_EVENT_TYPE);
}
OS_ENTER_CRITICAL();//进入临界区(无法被中断打断),需要定义cpu_sr变量
///发现”消息邮箱挂起的任务” ///
if (pevent->OSEventGrp != 0u)
{//查询是否有”消息邮箱挂起的任务”
if ((opt & OS_POST_OPT_BROADCAST) != 0x00u)//群发邮件
{
while (pevent->OSEventGrp != 0u)
{//循环查询是否有”消息邮箱挂起的任务”
(void)OS_EventTaskRdy(pevent, pmsg, OS_STAT_MBOX, OS_STAT_PEND_OK);
//向pevent所指的消息邮箱发送邮件，发送内容为pmsg指针
}
}
else//点对点发送邮件
{
(void)OS_EventTaskRdy(pevent, pmsg, OS_STAT_MBOX, OS_STAT_PEND_OK);
//向pevent所指的消息邮箱发送邮件，发送内容为pmsg指针
}
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
if ((opt & OS_POST_OPT_NO_SCHED) == 0u)
{
OS_Sched();//发现有更高优先级的任务在企图运行,执行任务调度
}
return (OS_ERR_NONE);//邮件发完，返回
}
///没有发现”消息邮箱挂起的任务” ///
if (pevent->OSEventPtr != (void *)0) //查询邮箱中的内容是否被接收
{//上次发送的邮件没有被接收
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
return (OS_ERR_MBOX_FULL); //没有执行发送消息邮箱,就退出了
}
/上次发送的消息邮箱中的内容已经被读取/
pevent->OSEventPtr = pmsg;
//向pevent所指的消息邮箱发送邮件，发送内容为pmsg指针
//pmsg是指向”消息邮箱的数据块地址”
OS_EXIT_CRITICAL();
return (OS_ERR_NONE); //执行发送消息邮箱后,才退出
}
4、OSMboxAccept (OS_EVENT *pevent)无等待接收邮件
函数功能：返回指针不为0，则表示接收到消息邮箱的新数据，同时会清除”消息邮箱的数据块”指针，允许再次发送邮箱新数据。
// pevent为消息邮箱的指针
//返回指针就是”消息邮箱的数据块首地址”
void *OSMboxAccept (OS_EVENT *pevent)
{
void *pmsg;
#if OS_CRITICAL_METHOD == 3u
OS_CPU_SR cpu_sr = 0u;
#endif
#if OS_ARG_CHK_EN > 0u
if (pevent == (OS_EVENT *)0)
{//pevent指针为0
return ((void *)0);
}
#endif
if (pevent->OSEventType != OS_EVENT_TYPE_MBOX)
{//事件类型不是消息邮箱
return ((void *)0);
}
OS_ENTER_CRITICAL();//进入临界区(无法被中断打断),需要定义cpu_sr变量
pmsg = pevent->OSEventPtr; //接收邮件，读取”消息邮箱的数据块首地址”
pevent->OSEventPtr = (void *)0;
//新邮箱数据接收到后，则立即清除”消息邮箱的数据块”指针，便于下次发送邮箱新数据
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
return (pmsg); //返回”邮箱数据块首地址”
}
5、*OSMboxPend (OS_EVENT *pevent, INT32U timeout, INT8U *perr)
timeout=0任务会一直挂起，直到收到新邮件
timeout!=0任务在timeout个节拍内，若收到新邮件，则退出，否则，超时退出邮件接收
函数功能：*per= OS_ERR_NONE，且返回指针不为0，则表示接收到消息邮箱的新数据，同时会清除”消息邮箱的数据块”指针，允许再次发送邮箱新数据。
// pevent为消息邮箱的指针
// timeout为等待时间；timeout=0任务会一直挂起，直到收到新邮件
//返回指针就是”消息邮箱的数据块首地址”
void *OSMboxPend (OS_EVENT *pevent,
INT32U timeout,
INT8U *perr)
{
void *pmsg;
#if OS_CRITICAL_METHOD == 3u
OS_CPU_SR cpu_sr = 0u;
#endif
#ifdef OS_SAFETY_CRITICAL
if (perr == (INT8U *)0)
{// perr指针为0
OS_SAFETY_CRITICAL_EXCEPTION();//这句看不懂,不要关心
}
#endif
#if OS_ARG_CHK_EN > 0u
if (pevent == (OS_EVENT *)0)
{// pevent指针为0
*perr = OS_ERR_PEVENT_NULL;
return ((void *)0);
}
#endif
if (pevent->OSEventType != OS_EVENT_TYPE_MBOX)
{//事件类型不是消息邮箱
*perr = OS_ERR_EVENT_TYPE;
return ((void *)0);
}
if (OSIntNesting > 0u)
{//中断嵌套级别大于0
*perr = OS_ERR_PEND_ISR;
return ((void *)0);
}
if (OSLockNesting > 0u)
{//多任务锁定嵌套级别大于0
*perr = OS_ERR_PEND_LOCKED;
return ((void *)0);
}
OS_ENTER_CRITICAL();//进入临界区(无法被中断打断),需要定义cpu_sr变量
pmsg = pevent->OSEventPtr; //接收邮件，读取”消息邮箱的数据块首地址”
if (pmsg != (void *)0)
{//”消息邮箱的数据块首地址”不为0，表示”消息邮箱的新数据”被收到
pevent->OSEventPtr = (void *)0;
//新邮箱数据接收到后，则立即清除”消息邮箱的数据块”指针，便于下次发送邮箱新数据
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
*perr = OS_ERR_NONE;
return (pmsg); //返回”邮箱数据块首地址”
}
///没有收到”消息邮箱的新数据”/
OSTCBCur->OSTCBStat |= OS_STAT_MBOX;
OSTCBCur->OSTCBStatPend=OS_STAT_PEND_OK; // 消息不可用，设置任务将进入等待
OSTCBCur->OSTCBDly = timeout;//设置任务延迟的节拍数
OS_EventTaskWait(pevent);// 暂停当前任务，直到发生事件或超时为止
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
OS_Sched();//发现有更高优先级的任务在企图运行,执行任务调度
//其他任务执行完后，回到当前任务//
OS_ENTER_CRITICAL();//进入临界区(无法被中断打断),需要定义cpu_sr变量
switch (OSTCBCur->OSTCBStatPend)
{
case OS_STAT_PEND_OK: //任务已经等到”消息邮箱的新数据”
pmsg = OSTCBCur->OSTCBMsg;//读取邮箱数据块首地址
*perr = OS_ERR_NONE;
break;
case OS_STAT_PEND_ABORT://任务没有等到”消息邮箱的新数据”
pmsg = (void *)0;
*perr = OS_ERR_PEND_ABORT;
break;
case OS_STAT_PEND_TO: //任务因”没有等到消息邮箱的新数据”导致超时
default:
OS_EventTaskRemove(OSTCBCur, pevent);
pmsg = (void *)0;
*perr = OS_ERR_TIMEOUT;
break;
}
OSTCBCur->OSTCBStat = OS_STAT_RDY;//设置当前任务状态为准备状态
OSTCBCur->OSTCBStatPend=OS_STAT_PEND_OK; // 消息不可用，设置任务将进入等待
OSTCBCur->OSTCBEventPtr= (OS_EVENT *)0;//清除消息邮箱的指针
#if (OS_EVENT_MULTI_EN > 0u)
OSTCBCur->OSTCBEventMultiPtr = (OS_EVENT **)0;
#endif
OSTCBCur->OSTCBMsg= (void *)0;
//新邮箱数据接收到后，则立即清除”消息邮箱的数据块”指针，便于下次发送邮箱新数据
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
return (pmsg); //返回”邮箱数据块首地址”
}
//延时ticks节拍数
void OSTimeDly (INT32U ticks)
{
INT8U y;
#if OS_CRITICAL_METHOD == 3u
OS_CPU_SR cpu_sr = 0u;
#endif
if (OSIntNesting > 0u)
{
return;
}
if (OSLockNesting > 0u)
{
return;
}
if (ticks > 0u)
{
OS_ENTER_CRITICAL();//进入临界区(无法被中断打断),需要定义cpu_sr变量
y = OSTCBCur->OSTCBY;
OSRdyTbl[y] &= (OS_PRIO)~OSTCBCur->OSTCBBitX;
if (OSRdyTbl[y] == 0u)
{
OSRdyGrp &= (OS_PRIO)~OSTCBCur->OSTCBBitY;
}
OSTCBCur->OSTCBDly = ticks;//装载时钟节拍数
OS_EXIT_CRITICAL();//退出临界区(可以被中断打断)
OS_Sched();//发现有更高优先级的任务在企图运行,执行任务调度
}
}
