isr_mbx_send

#include <rtl.h>

void isr_mbx_send (
    OS_ID mailbox,          /* The mailbox to put the message in */
    void* message_ptr );    /* Pointer to the message */

The isr_mbx_send function puts the pointer to the message message_ptr in the mailbox if the mailbox is not already full. The isr_mbx_send function does not cause the current task to sleep even if there is no space in the mailbox to put the message.

When an interrupt receives a protocol frame (for example TCP-IP, UDP, or ISDN), you can call the isr_mbx_send function from the interrupt to pass the protocol frame as a message to a task.

The isr_mbx_send function is in the RL-RTX library. The prototype is defined in rtl.h.

Note

• You must declare and initialize the mailbox object before you perform any operation on it.
• You can call the isr_mbx_send function only from IRQ interrupt functions. You cannot call it from FIQ interrupt functions.
• If the mailbox is full, the RTX kernel ignores the message since it cannot be put into the mailbox, and calls the error function. Thus before sending a message using isr_mbx_send, you must use the isr_mbx_check function to check if the mailbox is full.

None.

isr_mbx_check, isr_mbx_receive, os_mbx_declare, os_mbx_init

#include <RTL.h>

os_mbx_declare (mailbox1, 20);

void timer1 (void) __irq {
   ..
  isr_mbx_send (&mailbox1, msg);
   ..
}