|
|
|
@ -98,11 +98,11 @@
|
|
|
|
|
* Asynchronous IPC |
|
|
|
|
* ---------------- |
|
|
|
|
* To use asynchronous IPC one needs to initialize a message queue using |
|
|
|
|
* @ref msg_init_queue(). Messages sent to a thread with a message queue that |
|
|
|
|
* isn't full are never dropped and the sending never blocks, even when using |
|
|
|
|
* @ref msg_send(). If the queue is full and the sending thread has a higher |
|
|
|
|
* priority than the receiving thread the send-behavior is equivalent to |
|
|
|
|
* synchronous mode. |
|
|
|
|
* @ref msg_init_queue() (note that it **must** be of a size equal to a power of |
|
|
|
|
* two). Messages sent to a thread with a message queue that isn't full are |
|
|
|
|
* never dropped and the sending never blocks, even when using @ref msg_send(). |
|
|
|
|
* If the queue is full and the sending thread has a higher priority than the |
|
|
|
|
* receiving thread the send-behavior is equivalent to synchronous mode. |
|
|
|
|
* |
|
|
|
|
* ~~~~~~~~~~~~~~~~~~~~~~~~ {.c} |
|
|
|
|
* #include <inttypes.h> |
|
|
|
@ -365,6 +365,8 @@ int msg_avail(void);
|
|
|
|
|
/**
|
|
|
|
|
* @brief Initialize the current thread's message queue. |
|
|
|
|
* |
|
|
|
|
* @pre @p num **MUST BE A POWER OF TWO!** |
|
|
|
|
* |
|
|
|
|
* @param[in] array Pointer to preallocated array of ``msg_t`` structures, must |
|
|
|
|
* not be NULL. |
|
|
|
|
* @param[in] num Number of ``msg_t`` structures in array. |
|
|
|
|