📄 os_mbox.lst
字号:
341 1 return (OS_NO_ERR);
342 1 }
343 #endif
344
345 /*$PAGE*/
346 /*
347 *********************************************************************************************************
348 * POST MESSAGE TO A MAILBOX
349 *
350 * Description: This function sends a message to a mailbox
351 *
352 * Arguments : pevent is a pointer to the event control block associated with the desired mailbox
353 *
354 * msg is a pointer to the message to send. You MUST NOT send a NULL pointer.
355 *
356 * opt determines the type of POST performed:
357 * OS_POST_OPT_NONE POST to a single waiting task
358 * (Identical to OSMboxPost())
359 * OS_POST_OPT_BROADCAST POST to ALL tasks that are waiting on the mailbox
360 *
361 * Returns : OS_NO_ERR The call was successful and the message was sent
362 * OS_MBOX_FULL If the mailbox already contains a message. You can can only send one
363 * message at a time and thus, the message MUST be consumed before you
364 * are allowed to send another one.
C51 COMPILER V8.08 OS_MBOX 08/19/2008 10:59:09 PAGE 7
365 * OS_ERR_EVENT_TYPE If you are attempting to post to a non mailbox.
366 * OS_ERR_PEVENT_NULL If 'pevent' is a NULL pointer
367 * OS_ERR_POST_NULL_PTR If you are attempting to post a NULL pointer
368 *
369 * Warning : Interrupts can be disabled for a long time if you do a 'broadcast'. In fact, the
370 * interrupt disable time is proportional to the number of tasks waiting on the mailbox.
371 *********************************************************************************************************
372 */
373
374 #if OS_MBOX_POST_OPT_EN > 0
INT8U OSMboxPostOpt (OS_EVENT *pevent, void *msg, INT8U opt) reentrant
{
#if OS_CRITICAL_METHOD == 3 /* Allocate storage for CPU status register */
OS_CPU_SR cpu_sr;
#endif
#if OS_ARG_CHK_EN > 0
if (pevent == (OS_EVENT *)0) { /* Validate 'pevent' */
return (OS_ERR_PEVENT_NULL);
}
if (msg == (void *)0) { /* Make sure we are not posting a NULL pointer */
return (OS_ERR_POST_NULL_PTR);
}
if (pevent->OSEventType != OS_EVENT_TYPE_MBOX) { /* Validate event block type */
return (OS_ERR_EVENT_TYPE);
}
#endif
OS_ENTER_CRITICAL();
if (pevent->OSEventGrp != 0x00) { /* See if any task pending on mailbox */
if ((opt & OS_POST_OPT_BROADCAST) != 0x00) { /* Do we need to post msg to ALL waiting tasks ? */
while (pevent->OSEventGrp != 0x00) { /* Yes, Post to ALL tasks waiting on mailbox */
-
OS_EventTaskRdy(pevent, msg, OS_STAT_MBOX);
}
} else {
OS_EventTaskRdy(pevent, msg, OS_STAT_MBOX); /* No, Post to HPT waiting on mbox */
}
OS_EXIT_CRITICAL();
OS_Sched(); /* Find highest priority task ready to run */
return (OS_NO_ERR);
}
if (pevent->OSEventPtr != (void *)0) { /* Make sure mailbox doesn't already have a msg */
OS_EXIT_CRITICAL();
return (OS_MBOX_FULL);
}
pevent->OSEventPtr = msg; /* Place message in mailbox */
OS_EXIT_CRITICAL();
return (OS_NO_ERR);
}
#endif
415
416 /*$PAGE*/
417 /*
418 *********************************************************************************************************
419 * QUERY A MESSAGE MAILBOX
420 *
421 * Description: This function obtains information about a message mailbox.
422 *
423 * Arguments : pevent is a pointer to the event control block associated with the desired mailbox
424 *
425 * ppdata is a pointer to a structure that will contain information about the message
C51 COMPILER V8.08 OS_MBOX 08/19/2008 10:59:09 PAGE 8
426 * mailbox.
427 *
428 * Returns : OS_NO_ERR The call was successful and the message was sent
429 * OS_ERR_EVENT_TYPE If you are attempting to obtain data from a non mailbox.
430 * OS_ERR_PEVENT_NULL If 'pevent' is a NULL pointer
431 *********************************************************************************************************
432 */
433
434 #if OS_MBOX_QUERY_EN > 0
INT8U OSMboxQuery (OS_EVENT *pevent, OS_MBOX_DATA *ppdata) reentrant
{
#if OS_CRITICAL_METHOD == 3 /* Allocate storage for CPU status register */
OS_CPU_SR cpu_sr;
#endif
INT8U *psrc;
INT8U *pdest;
#if OS_ARG_CHK_EN > 0
if (pevent == (OS_EVENT *)0) { /* Validate 'pevent' */
return (OS_ERR_PEVENT_NULL);
}
if (pevent->OSEventType != OS_EVENT_TYPE_MBOX) { /* Validate event block type */
return (OS_ERR_EVENT_TYPE);
}
#endif
OS_ENTER_CRITICAL();
ppdata->OSEventGrp = pevent->OSEventGrp; /* Copy message mailbox wait list */
psrc = &pevent->OSEventTbl[0];
pdest = &ppdata->OSEventTbl[0];
#if OS_EVENT_TBL_SIZE > 0
*pdest++ = *psrc++;
#endif
#if OS_EVENT_TBL_SIZE > 1
*pdest++ = *psrc++;
#endif
#if OS_EVENT_TBL_SIZE > 2
*pdest++ = *psrc++;
#endif
#if OS_EVENT_TBL_SIZE > 3
*pdest++ = *psrc++;
#endif
#if OS_EVENT_TBL_SIZE > 4
*pdest++ = *psrc++;
#endif
#if OS_EVENT_TBL_SIZE > 5
*pdest++ = *psrc++;
#endif
#if OS_EVENT_TBL_SIZE > 6
*pdest++ = *psrc++;
#endif
#if OS_EVENT_TBL_SIZE > 7
*pdest = *psrc;
#endif
C51 COMPILER V8.08 OS_MBOX 08/19/2008 10:59:09 PAGE 9
ppdata->OSMsg = pevent->OSEventPtr; /* Get message from mailbox */
OS_EXIT_CRITICAL();
return (OS_NO_ERR);
}
#endif /* OS_MBOX_QUERY_EN */
493 #endif /* OS_MBOX_EN */
MODULE INFORMATION: STATIC OVERLAYABLE
CODE SIZE = 998 ----
CONSTANT SIZE = ---- ----
XDATA SIZE = ---- ----
PDATA SIZE = ---- ----
DATA SIZE = ---- ----
IDATA SIZE = ---- ----
BIT SIZE = ---- ----
EDATA SIZE = ---- ----
HDATA SIZE = ---- ----
XDATA CONST SIZE = ---- ----
FAR CONST SIZE = ---- ----
END OF MODULE INFORMATION.
C51 COMPILATION COMPLETE. 0 WARNING(S), 0 ERROR(S)
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -