From 1ea7355d85e316aadfd90468b3e808bb3dc95ee9 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sun, 16 Aug 2009 13:07:24 +0000
Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1073
 35acf78f-673a-0410-8e92-d51de3d6d3f4

---
 os/kernel/src/chmboxes.c | 244 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 244 insertions(+)
 create mode 100644 os/kernel/src/chmboxes.c

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
new file mode 100644
index 000000000..8a791a984
--- /dev/null
+++ b/os/kernel/src/chmboxes.c
@@ -0,0 +1,244 @@
+/*
+    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.
+
+    This file is part of ChibiOS/RT.
+
+    ChibiOS/RT is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 3 of the License, or
+    (at your option) any later version.
+
+    ChibiOS/RT is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+/**
+ * @file chmboxes.c
+ * @brief Mailboxes code.
+ * @addtogroup Mailboxes
+ * @{
+ */
+
+#include <ch.h>
+
+#if CH_USE_MAILBOXES
+/**
+ * @brief Initializes a Mailbox object.
+ *
+ * @param[out] mbp the pointer to the Mailbox structure to be initialized
+ * @param[in] buf the circular messages buffer
+ * @param[in] n the buffer size as number of @p msg_t
+ */
+void chMBInit(Mailbox *mbp, msg_t *buf, cnt_t n) {
+
+  chDbgCheck((mbp != NULL) && (buf != NULL) && (n > 0), "chMBInit");
+
+  mbp->mb_buffer = mbp->mb_wrptr = mbp->mb_rdptr = buf;
+  mbp->mb_top = &buf[n];
+  chSemInit(&mbp->mb_emptysem, n);
+  chSemInit(&mbp->mb_fullsem, 0);
+}
+
+/**
+ * @brief Resets a Mailbox object.
+ * @details All the waiting threads are resumed with status @p RDY_RESET and
+ *          the queued messages are lost.
+ *
+ * @param[in] mbp the pointer to an initialized Mailbox object
+ */
+void chMBReset(Mailbox *mbp) {
+
+  chDbgCheck(mbp != NULL, "chMBReset");
+
+  chSysLock();
+  mbp->mb_wrptr = mbp->mb_rdptr = mbp->mb_buffer;
+  chSemResetI(&mbp->mb_emptysem, mbp->mb_top - mbp->mb_buffer);
+  chSemResetI(&mbp->mb_fullsem, 0);
+  chSchRescheduleS();
+  chSysUnlock();
+}
+
+/**
+ * @brief Posts a message into a mailbox.
+ * @details The invoking thread waits until a empty slot in the mailbox becomes
+ *          available or the specified time runs out.
+ *
+ * @param[in] mbp the pointer to an initialized Mailbox object
+ * @param[in] msg the message to be posted on the mailbox
+ * @param[in] time the number of ticks before the operation timeouts,
+ *                 the following special values are allowed:
+ *                 - @a TIME_IMMEDIATE immediate timeout.
+ *                 - @a TIME_INFINITE no timeout.
+ *                 .
+ * @return The operation status.
+ * @retval RDY_OK if the message was correctly posted.
+ * @retval RDY_RESET if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT if the operation timed out.
+ */
+msg_t chMBPost(Mailbox *mbp, msg_t msg, systime_t time) {
+  msg_t rdymsg;
+
+  chSysLock();
+  rdymsg = chMBPostS(mbp, msg, time);
+  chSysUnlock();
+  return rdymsg;
+}
+
+/**
+ * @brief Posts a message into a mailbox.
+ * @details The invoking thread waits until a empty slot in the mailbox becomes
+ *          available or the specified time runs out.
+ *
+ * @param[in] mbp the pointer to an initialized Mailbox object
+ * @param[in] msg the message to be posted on the mailbox
+ * @param[in] time the number of ticks before the operation timeouts,
+ *                 the following special values are allowed:
+ *                 - @a TIME_IMMEDIATE immediate timeout.
+ *                 - @a TIME_INFINITE no timeout.
+ *                 .
+ * @return The operation status.
+ * @retval RDY_OK if the message was correctly posted.
+ * @retval RDY_RESET if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT if the operation timed out.
+ */
+msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
+  msg_t rdymsg;
+
+  chDbgCheck(mbp != NULL, "chMBPostS");
+
+  rdymsg = chSemWaitTimeoutS(&mbp->mb_emptysem, time);
+  if (rdymsg == RDY_OK) {
+    *mbp->mb_wrptr++ = msg;
+    if (mbp->mb_wrptr >= mbp->mb_top)
+      mbp->mb_wrptr = mbp->mb_buffer;
+    chSemSignalI(&mbp->mb_fullsem);
+    chSchRescheduleS();
+  }
+  return rdymsg;
+}
+
+/**
+ * @brief Posts an high priority message into a mailbox.
+ * @details The invoking thread waits until a empty slot in the mailbox becomes
+ *          available or the specified time runs out.
+ *
+ * @param[in] mbp the pointer to an initialized Mailbox object
+ * @param[in] msg the message to be posted on the mailbox
+ * @param[in] time the number of ticks before the operation timeouts,
+ *                 the following special values are allowed:
+ *                 - @a TIME_IMMEDIATE immediate timeout.
+ *                 - @a TIME_INFINITE no timeout.
+ *                 .
+ * @return The operation status.
+ * @retval RDY_OK if the message was correctly posted.
+ * @retval RDY_RESET if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT if the operation timed out.
+ */
+msg_t chMBPostAhead(Mailbox *mbp, msg_t msg, systime_t time) {
+  msg_t rdymsg;
+
+  chSysLock();
+  rdymsg = chMBPostAheadS(mbp, msg, time);
+  chSysUnlock();
+  return rdymsg;
+}
+
+/**
+ * @brief Posts an high priority message into a mailbox.
+ * @details The invoking thread waits until a empty slot in the mailbox becomes
+ *          available or the specified time runs out.
+ *
+ * @param[in] mbp the pointer to an initialized Mailbox object
+ * @param[in] msg the message to be posted on the mailbox
+ * @param[in] time the number of ticks before the operation timeouts,
+ *                 the following special values are allowed:
+ *                 - @a TIME_IMMEDIATE immediate timeout.
+ *                 - @a TIME_INFINITE no timeout.
+ *                 .
+ * @return The operation status.
+ * @retval RDY_OK if the message was correctly posted.
+ * @retval RDY_RESET if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT if the operation timed out.
+ */
+msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
+  msg_t rdymsg;
+
+  chDbgCheck(mbp != NULL, "chMBPostAheadS");
+
+  rdymsg = chSemWaitTimeoutS(&mbp->mb_emptysem, time);
+  if (rdymsg == RDY_OK) {
+    if (--mbp->mb_rdptr < mbp->mb_buffer)
+      mbp->mb_rdptr = mbp->mb_top - 1;
+    *mbp->mb_rdptr = msg;
+    chSemSignalI(&mbp->mb_fullsem);
+    chSchRescheduleS();
+  }
+  return rdymsg;
+}
+
+/**
+ * @brief Retrieves a message from a mailbox.
+ * @details The invoking thread waits until a message is posted in the mailbox
+ *          or the specified time runs out.
+ *
+ * @param[in] mbp the pointer to an initialized Mailbox object
+ * @param[out] msgp pointer to a message variable for the received message
+ * @param[in] time the number of ticks before the operation timeouts,
+ *                 the following special values are allowed:
+ *                 - @a TIME_IMMEDIATE immediate timeout.
+ *                 - @a TIME_INFINITE no timeout.
+ *                 .
+ * @return The operation status.
+ * @retval RDY_OK if a message was correctly fetched.
+ * @retval RDY_RESET if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT if the operation timed out.
+ */
+msg_t chMBFetch(Mailbox *mbp, msg_t *msgp, systime_t time) {
+  msg_t rdymsg;
+
+  chSysLock();
+  rdymsg = chMBFetchS(mbp, msgp, time);
+  chSysUnlock();
+  return rdymsg;
+}
+
+/**
+ * @brief Retrieves a message from a mailbox.
+ * @details The invoking thread waits until a message is posted in the mailbox
+ *          or the specified time runs out.
+ *
+ * @param[in] mbp the pointer to an initialized Mailbox object
+ * @param[out] msgp pointer to a message variable for the received message
+ * @param[in] time the number of ticks before the operation timeouts,
+ *                 the following special values are allowed:
+ *                 - @a TIME_IMMEDIATE immediate timeout.
+ *                 - @a TIME_INFINITE no timeout.
+ *                 .
+ * @return The operation status.
+ * @retval RDY_OK if a message was correctly fetched.
+ * @retval RDY_RESET if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT if the operation timed out.
+ */
+msg_t chMBFetchS(Mailbox *mbp, msg_t *msgp, systime_t time) {
+  msg_t rdymsg;
+
+  chDbgCheck((mbp != NULL) && (msgp != NULL), "chMBFetchS");
+
+  rdymsg = chSemWaitTimeoutS(&mbp->mb_fullsem, time);
+  if (rdymsg == RDY_OK) {
+    *msgp = *mbp->mb_rdptr++;
+    if (mbp->mb_rdptr >= mbp->mb_top)
+      mbp->mb_rdptr = mbp->mb_buffer;
+    chSemSignalI(&mbp->mb_emptysem);
+    chSchRescheduleS();
+  }
+  return rdymsg;
+}
+#endif /* CH_USE_MAILBOXES */
+
+/** @} */
-- 
cgit v1.2.3


From 397ccffac55ffd139d0e3e82add83e51413c1347 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sun, 30 Aug 2009 06:59:43 +0000
Subject: Documentation reorganization.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1133 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 8a791a984..569422ca7 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -20,7 +20,7 @@
 /**
  * @file chmboxes.c
  * @brief Mailboxes code.
- * @addtogroup Mailboxes
+ * @addtogroup mailboxes
  * @{
  */
 
-- 
cgit v1.2.3


From bdb7f4ab20bd3daf261ab93dfe733e0ff11dca0f Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Tue, 8 Dec 2009 17:37:49 +0000
Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1397
 35acf78f-673a-0410-8e92-d51de3d6d3f4

---
 os/kernel/src/chmboxes.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 569422ca7..3bcf687fc 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -24,7 +24,7 @@
  * @{
  */
 
-#include <ch.h>
+#include "ch.h"
 
 #if CH_USE_MAILBOXES
 /**
-- 
cgit v1.2.3


From f17db1931e95f5ebb42f557b6eead2bf1320db5a Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sat, 6 Feb 2010 10:55:53 +0000
Subject: Reformatted doxygen tags into the kernel sources to make them more
 readable.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1567 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 161 ++++++++++++++++++++++++-----------------------
 1 file changed, 81 insertions(+), 80 deletions(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 3bcf687fc..aee514f84 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -18,8 +18,9 @@
 */
 
 /**
- * @file chmboxes.c
- * @brief Mailboxes code.
+ * @file    chmboxes.c
+ * @brief   Mailboxes code.
+ *
  * @addtogroup mailboxes
  * @{
  */
@@ -28,11 +29,11 @@
 
 #if CH_USE_MAILBOXES
 /**
- * @brief Initializes a Mailbox object.
+ * @brief   Initializes a Mailbox object.
  *
- * @param[out] mbp the pointer to the Mailbox structure to be initialized
- * @param[in] buf the circular messages buffer
- * @param[in] n the buffer size as number of @p msg_t
+ * @param[out] mbp      the pointer to the Mailbox structure to be initialized
+ * @param[in] buf       the circular messages buffer
+ * @param[in] n         the buffer size as number of @p msg_t
  */
 void chMBInit(Mailbox *mbp, msg_t *buf, cnt_t n) {
 
@@ -45,11 +46,11 @@ void chMBInit(Mailbox *mbp, msg_t *buf, cnt_t n) {
 }
 
 /**
- * @brief Resets a Mailbox object.
+ * @brief   Resets a Mailbox object.
  * @details All the waiting threads are resumed with status @p RDY_RESET and
  *          the queued messages are lost.
  *
- * @param[in] mbp the pointer to an initialized Mailbox object
+ * @param[in] mbp       the pointer to an initialized Mailbox object
  */
 void chMBReset(Mailbox *mbp) {
 
@@ -64,21 +65,21 @@ void chMBReset(Mailbox *mbp) {
 }
 
 /**
- * @brief Posts a message into a mailbox.
+ * @brief   Posts a message into a mailbox.
  * @details The invoking thread waits until a empty slot in the mailbox becomes
  *          available or the specified time runs out.
  *
- * @param[in] mbp the pointer to an initialized Mailbox object
- * @param[in] msg the message to be posted on the mailbox
- * @param[in] time the number of ticks before the operation timeouts,
- *                 the following special values are allowed:
- *                 - @a TIME_IMMEDIATE immediate timeout.
- *                 - @a TIME_INFINITE no timeout.
- *                 .
- * @return The operation status.
- * @retval RDY_OK if the message was correctly posted.
- * @retval RDY_RESET if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT if the operation timed out.
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[in] msg       the message to be posted on the mailbox
+ * @param[in] time      the number of ticks before the operation timeouts,
+ *                      the following special values are allowed:
+ *                      - @a TIME_IMMEDIATE immediate timeout.
+ *                      - @a TIME_INFINITE no timeout.
+ *                      .
+ * @return              The operation status.
+ * @retval RDY_OK       if the message was correctly posted.
+ * @retval RDY_RESET    if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation timed out.
  */
 msg_t chMBPost(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -90,21 +91,21 @@ msg_t chMBPost(Mailbox *mbp, msg_t msg, systime_t time) {
 }
 
 /**
- * @brief Posts a message into a mailbox.
+ * @brief   Posts a message into a mailbox.
  * @details The invoking thread waits until a empty slot in the mailbox becomes
  *          available or the specified time runs out.
  *
- * @param[in] mbp the pointer to an initialized Mailbox object
- * @param[in] msg the message to be posted on the mailbox
- * @param[in] time the number of ticks before the operation timeouts,
- *                 the following special values are allowed:
- *                 - @a TIME_IMMEDIATE immediate timeout.
- *                 - @a TIME_INFINITE no timeout.
- *                 .
- * @return The operation status.
- * @retval RDY_OK if the message was correctly posted.
- * @retval RDY_RESET if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT if the operation timed out.
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[in] msg       the message to be posted on the mailbox
+ * @param[in] time      the number of ticks before the operation timeouts,
+ *                      the following special values are allowed:
+ *                      - @a TIME_IMMEDIATE immediate timeout.
+ *                      - @a TIME_INFINITE no timeout.
+ *                      .
+ * @return              The operation status.
+ * @retval RDY_OK       if the message was correctly posted.
+ * @retval RDY_RESET    if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation timed out.
  */
 msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -123,21 +124,21 @@ msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
 }
 
 /**
- * @brief Posts an high priority message into a mailbox.
+ * @brief   Posts an high priority message into a mailbox.
  * @details The invoking thread waits until a empty slot in the mailbox becomes
  *          available or the specified time runs out.
  *
- * @param[in] mbp the pointer to an initialized Mailbox object
- * @param[in] msg the message to be posted on the mailbox
- * @param[in] time the number of ticks before the operation timeouts,
- *                 the following special values are allowed:
- *                 - @a TIME_IMMEDIATE immediate timeout.
- *                 - @a TIME_INFINITE no timeout.
- *                 .
- * @return The operation status.
- * @retval RDY_OK if the message was correctly posted.
- * @retval RDY_RESET if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT if the operation timed out.
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[in] msg       the message to be posted on the mailbox
+ * @param[in] time      the number of ticks before the operation timeouts,
+ *                      the following special values are allowed:
+ *                      - @a TIME_IMMEDIATE immediate timeout.
+ *                      - @a TIME_INFINITE no timeout.
+ *                      .
+ * @return              The operation status.
+ * @retval RDY_OK       if the message was correctly posted.
+ * @retval RDY_RESET    if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation timed out.
  */
 msg_t chMBPostAhead(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -149,21 +150,21 @@ msg_t chMBPostAhead(Mailbox *mbp, msg_t msg, systime_t time) {
 }
 
 /**
- * @brief Posts an high priority message into a mailbox.
+ * @brief   Posts an high priority message into a mailbox.
  * @details The invoking thread waits until a empty slot in the mailbox becomes
  *          available or the specified time runs out.
  *
- * @param[in] mbp the pointer to an initialized Mailbox object
- * @param[in] msg the message to be posted on the mailbox
- * @param[in] time the number of ticks before the operation timeouts,
- *                 the following special values are allowed:
- *                 - @a TIME_IMMEDIATE immediate timeout.
- *                 - @a TIME_INFINITE no timeout.
- *                 .
- * @return The operation status.
- * @retval RDY_OK if the message was correctly posted.
- * @retval RDY_RESET if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT if the operation timed out.
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[in] msg       the message to be posted on the mailbox
+ * @param[in] time      the number of ticks before the operation timeouts,
+ *                      the following special values are allowed:
+ *                      - @a TIME_IMMEDIATE immediate timeout.
+ *                      - @a TIME_INFINITE no timeout.
+ *                      .
+ * @return              The operation status.
+ * @retval RDY_OK       if the message was correctly posted.
+ * @retval RDY_RESET    if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation timed out.
  */
 msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -182,21 +183,21 @@ msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
 }
 
 /**
- * @brief Retrieves a message from a mailbox.
+ * @brief   Retrieves a message from a mailbox.
  * @details The invoking thread waits until a message is posted in the mailbox
  *          or the specified time runs out.
  *
- * @param[in] mbp the pointer to an initialized Mailbox object
- * @param[out] msgp pointer to a message variable for the received message
- * @param[in] time the number of ticks before the operation timeouts,
- *                 the following special values are allowed:
- *                 - @a TIME_IMMEDIATE immediate timeout.
- *                 - @a TIME_INFINITE no timeout.
- *                 .
- * @return The operation status.
- * @retval RDY_OK if a message was correctly fetched.
- * @retval RDY_RESET if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT if the operation timed out.
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[out] msgp     pointer to a message variable for the received message
+ * @param[in] time      the number of ticks before the operation timeouts,
+ *                      the following special values are allowed:
+ *                      - @a TIME_IMMEDIATE immediate timeout.
+ *                      - @a TIME_INFINITE no timeout.
+ *                      .
+ * @return              The operation status.
+ * @retval RDY_OK       if a message was correctly fetched.
+ * @retval RDY_RESET    if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation timed out.
  */
 msg_t chMBFetch(Mailbox *mbp, msg_t *msgp, systime_t time) {
   msg_t rdymsg;
@@ -208,21 +209,21 @@ msg_t chMBFetch(Mailbox *mbp, msg_t *msgp, systime_t time) {
 }
 
 /**
- * @brief Retrieves a message from a mailbox.
+ * @brief   Retrieves a message from a mailbox.
  * @details The invoking thread waits until a message is posted in the mailbox
  *          or the specified time runs out.
  *
- * @param[in] mbp the pointer to an initialized Mailbox object
- * @param[out] msgp pointer to a message variable for the received message
- * @param[in] time the number of ticks before the operation timeouts,
- *                 the following special values are allowed:
- *                 - @a TIME_IMMEDIATE immediate timeout.
- *                 - @a TIME_INFINITE no timeout.
- *                 .
- * @return The operation status.
- * @retval RDY_OK if a message was correctly fetched.
- * @retval RDY_RESET if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT if the operation timed out.
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[out] msgp     pointer to a message variable for the received message
+ * @param[in] time      the number of ticks before the operation timeouts,
+ *                      the following special values are allowed:
+ *                      - @a TIME_IMMEDIATE immediate timeout.
+ *                      - @a TIME_INFINITE no timeout.
+ *                      .
+ * @return              The operation status.
+ * @retval RDY_OK       if a message was correctly fetched.
+ * @retval RDY_RESET    if the mailbox was reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation timed out.
  */
 msg_t chMBFetchS(Mailbox *mbp, msg_t *msgp, systime_t time) {
   msg_t rdymsg;
-- 
cgit v1.2.3


From 157b6f9695e7f72f2d54b231c19cb4045710ed01 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sun, 21 Feb 2010 07:24:53 +0000
Subject: Updated license dates.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1646 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index aee514f84..3811fc5da 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -1,5 +1,5 @@
 /*
-    ChibiOS/RT - Copyright (C) 2006-2007 Giovanni Di Sirio.
+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 Giovanni Di Sirio.
 
     This file is part of ChibiOS/RT.
 
@@ -33,7 +33,7 @@
  *
  * @param[out] mbp      the pointer to the Mailbox structure to be initialized
  * @param[in] buf       the circular messages buffer
- * @param[in] n         the buffer size as number of @p msg_t
+ * @param[in] n         the buffer size as number of @p msg_t
  */
 void chMBInit(Mailbox *mbp, msg_t *buf, cnt_t n) {
 
-- 
cgit v1.2.3


From ad3d21e81592481539a56e93234f5bf1fa2c0504 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Tue, 16 Mar 2010 19:36:21 +0000
Subject: Documentation reorganization. Moved the description from kernel.dox
 into the source code for ease of editing and reference.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1746 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 3811fc5da..ce4ecae67 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -22,6 +22,30 @@
  * @brief   Mailboxes code.
  *
  * @addtogroup mailboxes
+ * @details Asynchronous messages.
+ *          <h2>Operation mode</h2>
+ *          A mailbox is an asynchronous communication mechanism.<br>
+ *          The following operations are possible on a mailbox:
+ *          - <b>Post</b>: Posts a message on the mailbox in FIFO order.
+ *          - <b>Post Ahead</b>: Posts a message on the mailbox with urgent
+ *            priority.
+ *          - <b>Fetch</b>: A message is fetched from the mailbox and removed
+ *            from the queue.
+ *          - <b>Reset</b>: The mailbox is emptied and all the stored messages
+ *            are lost.
+ *          .
+ *          A message is a variable of type msg_t that is guaranteed to have
+ *          the same size of and be compatible with (data) pointers (anyway an
+ *          explicit cast is needed).
+ *          If larger messages need to be exchanged then a pointer to a
+ *          structure can be posted in the mailbox but the posting side has
+ *          no predefined way to know when the message has been processed. A
+ *          possible approach is to allocate memory (from a memory pool as
+ *          example) from the posting side and free it on the fetching side.
+ *          Another approach is to set a "done" flag into the structure pointed
+ *          by the message.<br>
+ *          In order to use the mailboxes APIs the @p CH_USE_MAILBOXES option
+ *          must be enabled in @p chconf.h.
  * @{
  */
 
-- 
cgit v1.2.3


From 7ae3e3227ee895c3ed5ac3358411b07276c7838e Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Wed, 17 Mar 2010 16:24:43 +0000
Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1748
 35acf78f-673a-0410-8e92-d51de3d6d3f4

---
 os/kernel/src/chmboxes.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index ce4ecae67..717246b88 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -25,7 +25,7 @@
  * @details Asynchronous messages.
  *          <h2>Operation mode</h2>
  *          A mailbox is an asynchronous communication mechanism.<br>
- *          The following operations are possible on a mailbox:
+ *          Operations defined for mailboxes:
  *          - <b>Post</b>: Posts a message on the mailbox in FIFO order.
  *          - <b>Post Ahead</b>: Posts a message on the mailbox with urgent
  *            priority.
-- 
cgit v1.2.3


From 9ffea7e261ec4016d788abbbf7c4a6d3a78e0a04 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sat, 18 Sep 2010 06:48:56 +0000
Subject: Documentation improvements, renamed some event APIs.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@2179 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 44 +++++++++++++++++++++++---------------------
 1 file changed, 23 insertions(+), 21 deletions(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 717246b88..279778e48 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -43,17 +43,19 @@
  *          possible approach is to allocate memory (from a memory pool as
  *          example) from the posting side and free it on the fetching side.
  *          Another approach is to set a "done" flag into the structure pointed
- *          by the message.<br>
- *          In order to use the mailboxes APIs the @p CH_USE_MAILBOXES option
+ *          by the message.
+ * @pre     In order to use the mailboxes APIs the @p CH_USE_MAILBOXES option
  *          must be enabled in @p chconf.h.
  * @{
  */
 
 #include "ch.h"
 
-#if CH_USE_MAILBOXES
+#if CH_USE_MAILBOXES || defined(__DOXYGEN__)
 /**
  * @brief   Initializes a Mailbox object.
+ * @note    This function can be invoked before the kernel is initialized
+ *          because it just prepares a @p Mailbox structure.
  *
  * @param[out] mbp      the pointer to the Mailbox structure to be initialized
  * @param[in] buf       the circular messages buffer
@@ -101,9 +103,9 @@ void chMBReset(Mailbox *mbp) {
  *                      - @a TIME_INFINITE no timeout.
  *                      .
  * @return              The operation status.
- * @retval RDY_OK       if the message was correctly posted.
- * @retval RDY_RESET    if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT  if the operation timed out.
+ * @retval RDY_OK       if a message has been correctly posted.
+ * @retval RDY_RESET    if the mailbox has been reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation has timed out.
  */
 msg_t chMBPost(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -127,9 +129,9 @@ msg_t chMBPost(Mailbox *mbp, msg_t msg, systime_t time) {
  *                      - @a TIME_INFINITE no timeout.
  *                      .
  * @return              The operation status.
- * @retval RDY_OK       if the message was correctly posted.
- * @retval RDY_RESET    if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT  if the operation timed out.
+ * @retval RDY_OK       if a message has been correctly posted.
+ * @retval RDY_RESET    if the mailbox has been reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation has timed out.
  */
 msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -160,9 +162,9 @@ msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
  *                      - @a TIME_INFINITE no timeout.
  *                      .
  * @return              The operation status.
- * @retval RDY_OK       if the message was correctly posted.
- * @retval RDY_RESET    if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT  if the operation timed out.
+ * @retval RDY_OK       if a message has been correctly posted.
+ * @retval RDY_RESET    if the mailbox has been reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation has timed out.
  */
 msg_t chMBPostAhead(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -186,9 +188,9 @@ msg_t chMBPostAhead(Mailbox *mbp, msg_t msg, systime_t time) {
  *                      - @a TIME_INFINITE no timeout.
  *                      .
  * @return              The operation status.
- * @retval RDY_OK       if the message was correctly posted.
- * @retval RDY_RESET    if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT  if the operation timed out.
+ * @retval RDY_OK       if a message has been correctly posted.
+ * @retval RDY_RESET    if the mailbox has been reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation has timed out.
  */
 msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -219,9 +221,9 @@ msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
  *                      - @a TIME_INFINITE no timeout.
  *                      .
  * @return              The operation status.
- * @retval RDY_OK       if a message was correctly fetched.
- * @retval RDY_RESET    if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT  if the operation timed out.
+ * @retval RDY_OK       if a message has been correctly fetched.
+ * @retval RDY_RESET    if the mailbox has been reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation has timed out.
  */
 msg_t chMBFetch(Mailbox *mbp, msg_t *msgp, systime_t time) {
   msg_t rdymsg;
@@ -245,9 +247,9 @@ msg_t chMBFetch(Mailbox *mbp, msg_t *msgp, systime_t time) {
  *                      - @a TIME_INFINITE no timeout.
  *                      .
  * @return              The operation status.
- * @retval RDY_OK       if a message was correctly fetched.
- * @retval RDY_RESET    if the mailbox was reset while waiting.
- * @retval RDY_TIMEOUT  if the operation timed out.
+ * @retval RDY_OK       if a message has been correctly fetched.
+ * @retval RDY_RESET    if the mailbox has been reset while waiting.
+ * @retval RDY_TIMEOUT  if the operation has timed out.
  */
 msg_t chMBFetchS(Mailbox *mbp, msg_t *msgp, systime_t time) {
   msg_t rdymsg;
-- 
cgit v1.2.3


From 07351222e6d0b6b3dcd4f50ecb18bc09e7402d1c Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Tue, 21 Sep 2010 10:22:06 +0000
Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@2184
 35acf78f-673a-0410-8e92-d51de3d6d3f4

---
 os/kernel/src/chmboxes.c | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 279778e48..b2cef2470 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -54,12 +54,12 @@
 #if CH_USE_MAILBOXES || defined(__DOXYGEN__)
 /**
  * @brief   Initializes a Mailbox object.
- * @note    This function can be invoked before the kernel is initialized
- *          because it just prepares a @p Mailbox structure.
  *
  * @param[out] mbp      the pointer to the Mailbox structure to be initialized
  * @param[in] buf       the circular messages buffer
  * @param[in] n         the buffer size as number of @p msg_t
+ *
+ * @init
  */
 void chMBInit(Mailbox *mbp, msg_t *buf, cnt_t n) {
 
@@ -77,6 +77,8 @@ void chMBInit(Mailbox *mbp, msg_t *buf, cnt_t n) {
  *          the queued messages are lost.
  *
  * @param[in] mbp       the pointer to an initialized Mailbox object
+ *
+ * @api
  */
 void chMBReset(Mailbox *mbp) {
 
@@ -106,6 +108,8 @@ void chMBReset(Mailbox *mbp) {
  * @retval RDY_OK       if a message has been correctly posted.
  * @retval RDY_RESET    if the mailbox has been reset while waiting.
  * @retval RDY_TIMEOUT  if the operation has timed out.
+ *
+ * @api
  */
 msg_t chMBPost(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -132,6 +136,8 @@ msg_t chMBPost(Mailbox *mbp, msg_t msg, systime_t time) {
  * @retval RDY_OK       if a message has been correctly posted.
  * @retval RDY_RESET    if the mailbox has been reset while waiting.
  * @retval RDY_TIMEOUT  if the operation has timed out.
+ *
+ * @sclass
  */
 msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -165,6 +171,8 @@ msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
  * @retval RDY_OK       if a message has been correctly posted.
  * @retval RDY_RESET    if the mailbox has been reset while waiting.
  * @retval RDY_TIMEOUT  if the operation has timed out.
+ *
+ * @api
  */
 msg_t chMBPostAhead(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -191,6 +199,8 @@ msg_t chMBPostAhead(Mailbox *mbp, msg_t msg, systime_t time) {
  * @retval RDY_OK       if a message has been correctly posted.
  * @retval RDY_RESET    if the mailbox has been reset while waiting.
  * @retval RDY_TIMEOUT  if the operation has timed out.
+ *
+ * @sclass
  */
 msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
@@ -224,6 +234,8 @@ msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
  * @retval RDY_OK       if a message has been correctly fetched.
  * @retval RDY_RESET    if the mailbox has been reset while waiting.
  * @retval RDY_TIMEOUT  if the operation has timed out.
+ *
+ * @api
  */
 msg_t chMBFetch(Mailbox *mbp, msg_t *msgp, systime_t time) {
   msg_t rdymsg;
@@ -250,6 +262,8 @@ msg_t chMBFetch(Mailbox *mbp, msg_t *msgp, systime_t time) {
  * @retval RDY_OK       if a message has been correctly fetched.
  * @retval RDY_RESET    if the mailbox has been reset while waiting.
  * @retval RDY_TIMEOUT  if the operation has timed out.
+ *
+ * @sclass
  */
 msg_t chMBFetchS(Mailbox *mbp, msg_t *msgp, systime_t time) {
   msg_t rdymsg;
-- 
cgit v1.2.3


From 17f0815d52977bd1e3e9e662d2ffdccbaf77a6bd Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Mon, 21 Feb 2011 18:00:06 +0000
Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@2756
 35acf78f-673a-0410-8e92-d51de3d6d3f4

---
 os/kernel/src/chmboxes.c | 83 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index b2cef2470..e0b6ca014 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -155,6 +155,34 @@ msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
   return rdymsg;
 }
 
+/**
+ * @brief   Posts a message into a mailbox.
+ * @details This variant is non-blocking, the function returns a timeout
+ *          condition if the queue is full.
+ *
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[in] msg       the message to be posted on the mailbox
+ * @return              The operation status.
+ * @retval RDY_OK       if a message has been correctly posted.
+ * @retval RDY_TIMEOUT  if the mailbox is full and the message cannot be
+ *                      posted.
+ *
+ * @iclass
+ */
+msg_t chMBPostI(Mailbox *mbp, msg_t msg) {
+
+  chDbgCheck(mbp != NULL, "chMBPostI");
+
+  if (chSemGetCounterI(&mbp->mb_emptysem) <= 0)
+    return RDY_TIMEOUT;
+  chSemFastWaitI(&mbp->mb_emptysem);
+  *mbp->mb_wrptr++ = msg;
+  if (mbp->mb_wrptr >= mbp->mb_top)
+    mbp->mb_wrptr = mbp->mb_buffer;
+  chSemSignalI(&mbp->mb_fullsem);
+  return RDY_OK;
+}
+
 /**
  * @brief   Posts an high priority message into a mailbox.
  * @details The invoking thread waits until a empty slot in the mailbox becomes
@@ -218,6 +246,34 @@ msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
   return rdymsg;
 }
 
+/**
+ * @brief   Posts an high priority message into a mailbox.
+ * @details This variant is non-blocking, the function returns a timeout
+ *          condition if the queue is full.
+ *
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[in] msg       the message to be posted on the mailbox
+ * @return              The operation status.
+ * @retval RDY_OK       if a message has been correctly posted.
+ * @retval RDY_TIMEOUT  if the mailbox is full and the message cannot be
+ *                      posted.
+ *
+ * @iclass
+ */
+msg_t chMBPostAheadI(Mailbox *mbp, msg_t msg) {
+
+  chDbgCheck(mbp != NULL, "chMBPostAheadI");
+
+  if (chSemGetCounterI(&mbp->mb_emptysem) <= 0)
+    return RDY_TIMEOUT;
+  chSemFastWaitI(&mbp->mb_emptysem);
+  if (--mbp->mb_rdptr < mbp->mb_buffer)
+    mbp->mb_rdptr = mbp->mb_top - 1;
+  *mbp->mb_rdptr = msg;
+  chSemSignalI(&mbp->mb_fullsem);
+  return RDY_OK;
+}
+
 /**
  * @brief   Retrieves a message from a mailbox.
  * @details The invoking thread waits until a message is posted in the mailbox
@@ -280,6 +336,33 @@ msg_t chMBFetchS(Mailbox *mbp, msg_t *msgp, systime_t time) {
   }
   return rdymsg;
 }
+
+/**
+ * @brief   Retrieves a message from a mailbox.
+ * @details This variant is non-blocking, the function returns a timeout
+ *          condition if the queue is full.
+ *
+ * @param[in] mbp       the pointer to an initialized Mailbox object
+ * @param[out] msgp     pointer to a message variable for the received message
+ * @return              The operation status.
+ * @retval RDY_OK       if a message has been correctly fetched.
+ * @retval RDY_TIMEOUT  if the mailbox is empty and a message cannot be
+ *                      fetched.
+ *
+ * @iclass
+ */
+msg_t chMBFetchI(Mailbox *mbp, msg_t *msgp) {
+
+  chDbgCheck((mbp != NULL) && (msgp != NULL), "chMBFetchI");
+
+  if (chSemGetCounterI(&mbp->mb_fullsem) <= 0)
+    return RDY_TIMEOUT;
+  *msgp = *mbp->mb_rdptr++;
+  if (mbp->mb_rdptr >= mbp->mb_top)
+    mbp->mb_rdptr = mbp->mb_buffer;
+  chSemSignalI(&mbp->mb_emptysem);
+  return RDY_OK;
+}
 #endif /* CH_USE_MAILBOXES */
 
 /** @} */
-- 
cgit v1.2.3


From e7e79a6ccb4f3e320b2b8b7bad1b14d65218641d Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Fri, 18 Mar 2011 18:38:08 +0000
Subject: License updated.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@2827 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index e0b6ca014..af6ee5ea8 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -1,5 +1,6 @@
 /*
-    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 Giovanni Di Sirio.
+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,
+                 2011 Giovanni Di Sirio.
 
     This file is part of ChibiOS/RT.
 
-- 
cgit v1.2.3


From 43752ee8d132fc57028a9ff15156c5bfcd81c013 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Fri, 12 Aug 2011 11:10:19 +0000
Subject: Extended state check to all kernel I-class and s-class APIs,
 corrected some test cases where call protocol rules were not strictly
 observerd. No the whole test suite pass with the state checker enabled.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@3223 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index af6ee5ea8..bf5fdfe29 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -143,6 +143,7 @@ msg_t chMBPost(Mailbox *mbp, msg_t msg, systime_t time) {
 msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
 
+  chDbgCheckClassS();
   chDbgCheck(mbp != NULL, "chMBPostS");
 
   rdymsg = chSemWaitTimeoutS(&mbp->mb_emptysem, time);
@@ -172,6 +173,7 @@ msg_t chMBPostS(Mailbox *mbp, msg_t msg, systime_t time) {
  */
 msg_t chMBPostI(Mailbox *mbp, msg_t msg) {
 
+  chDbgCheckClassI();
   chDbgCheck(mbp != NULL, "chMBPostI");
 
   if (chSemGetCounterI(&mbp->mb_emptysem) <= 0)
@@ -234,6 +236,7 @@ msg_t chMBPostAhead(Mailbox *mbp, msg_t msg, systime_t time) {
 msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
   msg_t rdymsg;
 
+  chDbgCheckClassS();
   chDbgCheck(mbp != NULL, "chMBPostAheadS");
 
   rdymsg = chSemWaitTimeoutS(&mbp->mb_emptysem, time);
@@ -263,6 +266,7 @@ msg_t chMBPostAheadS(Mailbox *mbp, msg_t msg, systime_t time) {
  */
 msg_t chMBPostAheadI(Mailbox *mbp, msg_t msg) {
 
+  chDbgCheckClassI();
   chDbgCheck(mbp != NULL, "chMBPostAheadI");
 
   if (chSemGetCounterI(&mbp->mb_emptysem) <= 0)
@@ -325,6 +329,7 @@ msg_t chMBFetch(Mailbox *mbp, msg_t *msgp, systime_t time) {
 msg_t chMBFetchS(Mailbox *mbp, msg_t *msgp, systime_t time) {
   msg_t rdymsg;
 
+  chDbgCheckClassS();
   chDbgCheck((mbp != NULL) && (msgp != NULL), "chMBFetchS");
 
   rdymsg = chSemWaitTimeoutS(&mbp->mb_fullsem, time);
@@ -354,6 +359,7 @@ msg_t chMBFetchS(Mailbox *mbp, msg_t *msgp, systime_t time) {
  */
 msg_t chMBFetchI(Mailbox *mbp, msg_t *msgp) {
 
+  chDbgCheckClassI();
   chDbgCheck((mbp != NULL) && (msgp != NULL), "chMBFetchI");
 
   if (chSemGetCounterI(&mbp->mb_fullsem) <= 0)
-- 
cgit v1.2.3


From de5dcbba856524599a8f06d3a9bdbf1b01db44c2 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sat, 21 Jan 2012 14:29:42 +0000
Subject: License text updated with new year.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@3846 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index bf5fdfe29..86f88dce7 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -1,6 +1,6 @@
 /*
     ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,
-                 2011 Giovanni Di Sirio.
+                 2011,2012 Giovanni Di Sirio.
 
     This file is part of ChibiOS/RT.
 
-- 
cgit v1.2.3


From 52e98077ee867e31189c43ad592cf97f386cac93 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Thu, 15 Mar 2012 19:54:36 +0000
Subject: Fixed bug 3504450.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4039 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 1 +
 1 file changed, 1 insertion(+)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 86f88dce7..163f93f20 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -364,6 +364,7 @@ msg_t chMBFetchI(Mailbox *mbp, msg_t *msgp) {
 
   if (chSemGetCounterI(&mbp->mb_fullsem) <= 0)
     return RDY_TIMEOUT;
+  chSemFastWaitI(&mbp->mb_fullsem);
   *msgp = *mbp->mb_rdptr++;
   if (mbp->mb_rdptr >= mbp->mb_top)
     mbp->mb_rdptr = mbp->mb_buffer;
-- 
cgit v1.2.3


From 7d892ef699164466cd328bc59a6e7effd8109a85 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sun, 29 Jul 2012 07:28:09 +0000
Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4486
 35acf78f-673a-0410-8e92-d51de3d6d3f4

---
 os/kernel/src/chmboxes.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 163f93f20..a9eddb2e9 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -41,7 +41,7 @@
  *          If larger messages need to be exchanged then a pointer to a
  *          structure can be posted in the mailbox but the posting side has
  *          no predefined way to know when the message has been processed. A
- *          possible approach is to allocate memory (from a memory pool as
+ *          possible approach is to allocate memory (from a memory pool for
  *          example) from the posting side and free it on the fetching side.
  *          Another approach is to set a "done" flag into the structure pointed
  *          by the message.
@@ -346,7 +346,7 @@ msg_t chMBFetchS(Mailbox *mbp, msg_t *msgp, systime_t time) {
 /**
  * @brief   Retrieves a message from a mailbox.
  * @details This variant is non-blocking, the function returns a timeout
- *          condition if the queue is full.
+ *          condition if the queue is empty.
  *
  * @param[in] mbp       the pointer to an initialized Mailbox object
  * @param[out] msgp     pointer to a message variable for the received message
-- 
cgit v1.2.3


From 48e503d8d46b13a185503cb20b4396e5728417ed Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sun, 29 Jul 2012 07:29:54 +0000
Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4487
 35acf78f-673a-0410-8e92-d51de3d6d3f4

---
 os/kernel/src/chmboxes.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index a9eddb2e9..50ce22b7f 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -57,8 +57,8 @@
  * @brief   Initializes a Mailbox object.
  *
  * @param[out] mbp      the pointer to the Mailbox structure to be initialized
- * @param[in] buf       the circular messages buffer
- * @param[in] n         the buffer size as number of @p msg_t
+ * @param[in] buf       pointer to the messages buffer as an array of @p msg_t
+ * @param[in] n         size of the buffer as number of @p msg_t
  *
  * @init
  */
-- 
cgit v1.2.3


From 3d94ca6c47fd6ebbea0f23a86af0b273aa59a8e1 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sun, 29 Jul 2012 07:43:15 +0000
Subject: git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4488
 35acf78f-673a-0410-8e92-d51de3d6d3f4

---
 os/kernel/src/chmboxes.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 50ce22b7f..860e92db9 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -58,7 +58,7 @@
  *
  * @param[out] mbp      the pointer to the Mailbox structure to be initialized
  * @param[in] buf       pointer to the messages buffer as an array of @p msg_t
- * @param[in] n         size of the buffer as number of @p msg_t
+ * @param[in] n         number of elements in the buffer array
  *
  * @init
  */
-- 
cgit v1.2.3


From 184a71345c6a36a9a8664eda8fbcc3ea728267a8 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sat, 2 Feb 2013 10:58:09 +0000
Subject: Updated license years.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@5102 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/kernel/src/chmboxes.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'os/kernel/src/chmboxes.c')

diff --git a/os/kernel/src/chmboxes.c b/os/kernel/src/chmboxes.c
index 860e92db9..6f09a8d26 100644
--- a/os/kernel/src/chmboxes.c
+++ b/os/kernel/src/chmboxes.c
@@ -1,6 +1,6 @@
 /*
     ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,
-                 2011,2012 Giovanni Di Sirio.
+                 2011,2012,2013 Giovanni Di Sirio.
 
     This file is part of ChibiOS/RT.
 
-- 
cgit v1.2.3