Dave Lu / Mbed 2 deprecated FYDP

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   mbed

Fork of FYDP_Final2 by Dave Lu

mbed-rtos/rtx/rt_Mailbox.c@8:3d5a84b897be, 2015-03-25 (annotated)

Committer:
tntmarket
Date:
Wed Mar 25 11:44:05 2015 +0000
Revision:
8:3d5a84b897be
Parent:
mbed/mbed-rtos/rtx/rt_Mailbox.c@0:21019d94ad33 
lift folders

Who changed what in which revision?

UserRevisionLine numberNew contents of line
majik 0:21019d94ad33 1 /*----------------------------------------------------------------------------
majik 0:21019d94ad33 2 * RL-ARM - RTX
majik 0:21019d94ad33 3 *----------------------------------------------------------------------------
majik 0:21019d94ad33 4 * Name: RT_MAILBOX.C
majik 0:21019d94ad33 5 * Purpose: Implements waits and wake-ups for mailbox messages
majik 0:21019d94ad33 6 * Rev.: V4.60
majik 0:21019d94ad33 7 *----------------------------------------------------------------------------
majik 0:21019d94ad33 8 *
majik 0:21019d94ad33 9 * Copyright (c) 1999-2009 KEIL, 2009-2012 ARM Germany GmbH
majik 0:21019d94ad33 10 * All rights reserved.
majik 0:21019d94ad33 11 * Redistribution and use in source and binary forms, with or without
majik 0:21019d94ad33 12 * modification, are permitted provided that the following conditions are met:
majik 0:21019d94ad33 13 * - Redistributions of source code must retain the above copyright
majik 0:21019d94ad33 14 * notice, this list of conditions and the following disclaimer.
majik 0:21019d94ad33 15 * - Redistributions in binary form must reproduce the above copyright
majik 0:21019d94ad33 16 * notice, this list of conditions and the following disclaimer in the
majik 0:21019d94ad33 17 * documentation and/or other materials provided with the distribution.
majik 0:21019d94ad33 18 * - Neither the name of ARM nor the names of its contributors may be used
majik 0:21019d94ad33 19 * to endorse or promote products derived from this software without
majik 0:21019d94ad33 20 * specific prior written permission.
majik 0:21019d94ad33 21 *
majik 0:21019d94ad33 22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
majik 0:21019d94ad33 23 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
majik 0:21019d94ad33 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
majik 0:21019d94ad33 25 * ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE
majik 0:21019d94ad33 26 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
majik 0:21019d94ad33 27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
majik 0:21019d94ad33 28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
majik 0:21019d94ad33 29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
majik 0:21019d94ad33 30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
majik 0:21019d94ad33 31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
majik 0:21019d94ad33 32 * POSSIBILITY OF SUCH DAMAGE.
majik 0:21019d94ad33 33 *---------------------------------------------------------------------------*/
majik 0:21019d94ad33 34
majik 0:21019d94ad33 35 #include "rt_TypeDef.h"
majik 0:21019d94ad33 36 #include "RTX_Conf.h"
majik 0:21019d94ad33 37 #include "rt_System.h"
majik 0:21019d94ad33 38 #include "rt_List.h"
majik 0:21019d94ad33 39 #include "rt_Mailbox.h"
majik 0:21019d94ad33 40 #include "rt_MemBox.h"
majik 0:21019d94ad33 41 #include "rt_Task.h"
majik 0:21019d94ad33 42 #include "rt_HAL_CM.h"
majik 0:21019d94ad33 43
majik 0:21019d94ad33 44
majik 0:21019d94ad33 45 /*----------------------------------------------------------------------------
majik 0:21019d94ad33 46 * Functions
majik 0:21019d94ad33 47 *---------------------------------------------------------------------------*/
majik 0:21019d94ad33 48
majik 0:21019d94ad33 49
majik 0:21019d94ad33 50 /*--------------------------- rt_mbx_init -----------------------------------*/
majik 0:21019d94ad33 51
majik 0:21019d94ad33 52 void rt_mbx_init (OS_ID mailbox, U16 mbx_size) {
majik 0:21019d94ad33 53 /* Initialize a mailbox */
majik 0:21019d94ad33 54 P_MCB p_MCB = mailbox;
majik 0:21019d94ad33 55
majik 0:21019d94ad33 56 p_MCB->cb_type = MCB;
majik 0:21019d94ad33 57 p_MCB->state = 0;
majik 0:21019d94ad33 58 p_MCB->isr_st = 0;
majik 0:21019d94ad33 59 p_MCB->p_lnk = NULL;
majik 0:21019d94ad33 60 p_MCB->first = 0;
majik 0:21019d94ad33 61 p_MCB->last = 0;
majik 0:21019d94ad33 62 p_MCB->count = 0;
majik 0:21019d94ad33 63 p_MCB->size = (mbx_size + sizeof(void *) - sizeof(struct OS_MCB)) /
majik 0:21019d94ad33 64 (U32)sizeof (void *);
majik 0:21019d94ad33 65 }
majik 0:21019d94ad33 66
majik 0:21019d94ad33 67
majik 0:21019d94ad33 68 /*--------------------------- rt_mbx_send -----------------------------------*/
majik 0:21019d94ad33 69
majik 0:21019d94ad33 70 OS_RESULT rt_mbx_send (OS_ID mailbox, void *p_msg, U16 timeout) {
majik 0:21019d94ad33 71 /* Send message to a mailbox */
majik 0:21019d94ad33 72 P_MCB p_MCB = mailbox;
majik 0:21019d94ad33 73 P_TCB p_TCB;
majik 0:21019d94ad33 74
majik 0:21019d94ad33 75 if ((p_MCB->p_lnk != NULL) && (p_MCB->state == 1)) {
majik 0:21019d94ad33 76 /* A task is waiting for message */
majik 0:21019d94ad33 77 p_TCB = rt_get_first ((P_XCB)p_MCB);
majik 0:21019d94ad33 78 #ifdef __CMSIS_RTOS
majik 0:21019d94ad33 79 rt_ret_val2(p_TCB, 0x10/*osEventMessage*/, (U32)p_msg);
majik 0:21019d94ad33 80 #else
majik 0:21019d94ad33 81 *p_TCB->msg = p_msg;
majik 0:21019d94ad33 82 rt_ret_val (p_TCB, OS_R_MBX);
majik 0:21019d94ad33 83 #endif
majik 0:21019d94ad33 84 rt_rmv_dly (p_TCB);
majik 0:21019d94ad33 85 rt_dispatch (p_TCB);
majik 0:21019d94ad33 86 }
majik 0:21019d94ad33 87 else {
majik 0:21019d94ad33 88 /* Store message in mailbox queue */
majik 0:21019d94ad33 89 if (p_MCB->count == p_MCB->size) {
majik 0:21019d94ad33 90 /* No free message entry, wait for one. If message queue is full, */
majik 0:21019d94ad33 91 /* then no task is waiting for message. The 'p_MCB->p_lnk' list */
majik 0:21019d94ad33 92 /* pointer can now be reused for send message waits task list. */
majik 0:21019d94ad33 93 if (timeout == 0) {
majik 0:21019d94ad33 94 return (OS_R_TMO);
majik 0:21019d94ad33 95 }
majik 0:21019d94ad33 96 if (p_MCB->p_lnk != NULL) {
majik 0:21019d94ad33 97 rt_put_prio ((P_XCB)p_MCB, os_tsk.run);
majik 0:21019d94ad33 98 }
majik 0:21019d94ad33 99 else {
majik 0:21019d94ad33 100 p_MCB->p_lnk = os_tsk.run;
majik 0:21019d94ad33 101 os_tsk.run->p_lnk = NULL;
majik 0:21019d94ad33 102 os_tsk.run->p_rlnk = (P_TCB)p_MCB;
majik 0:21019d94ad33 103 /* Task is waiting to send a message */
majik 0:21019d94ad33 104 p_MCB->state = 2;
majik 0:21019d94ad33 105 }
majik 0:21019d94ad33 106 os_tsk.run->msg = p_msg;
majik 0:21019d94ad33 107 rt_block (timeout, WAIT_MBX);
majik 0:21019d94ad33 108 return (OS_R_TMO);
majik 0:21019d94ad33 109 }
majik 0:21019d94ad33 110 /* Yes, there is a free entry in a mailbox. */
majik 0:21019d94ad33 111 p_MCB->msg[p_MCB->first] = p_msg;
majik 0:21019d94ad33 112 rt_inc (&p_MCB->count);
majik 0:21019d94ad33 113 if (++p_MCB->first == p_MCB->size) {
majik 0:21019d94ad33 114 p_MCB->first = 0;
majik 0:21019d94ad33 115 }
majik 0:21019d94ad33 116 }
majik 0:21019d94ad33 117 return (OS_R_OK);
majik 0:21019d94ad33 118 }
majik 0:21019d94ad33 119
majik 0:21019d94ad33 120
majik 0:21019d94ad33 121 /*--------------------------- rt_mbx_wait -----------------------------------*/
majik 0:21019d94ad33 122
majik 0:21019d94ad33 123 OS_RESULT rt_mbx_wait (OS_ID mailbox, void **message, U16 timeout) {
majik 0:21019d94ad33 124 /* Receive a message; possibly wait for it */
majik 0:21019d94ad33 125 P_MCB p_MCB = mailbox;
majik 0:21019d94ad33 126 P_TCB p_TCB;
majik 0:21019d94ad33 127
majik 0:21019d94ad33 128 /* If a message is available in the fifo buffer */
majik 0:21019d94ad33 129 /* remove it from the fifo buffer and return. */
majik 0:21019d94ad33 130 if (p_MCB->count) {
majik 0:21019d94ad33 131 *message = p_MCB->msg[p_MCB->last];
majik 0:21019d94ad33 132 if (++p_MCB->last == p_MCB->size) {
majik 0:21019d94ad33 133 p_MCB->last = 0;
majik 0:21019d94ad33 134 }
majik 0:21019d94ad33 135 if ((p_MCB->p_lnk != NULL) && (p_MCB->state == 2)) {
majik 0:21019d94ad33 136 /* A task is waiting to send message */
majik 0:21019d94ad33 137 p_TCB = rt_get_first ((P_XCB)p_MCB);
majik 0:21019d94ad33 138 #ifdef __CMSIS_RTOS
majik 0:21019d94ad33 139 rt_ret_val(p_TCB, 0/*osOK*/);
majik 0:21019d94ad33 140 #else
majik 0:21019d94ad33 141 rt_ret_val(p_TCB, OS_R_OK);
majik 0:21019d94ad33 142 #endif
majik 0:21019d94ad33 143 p_MCB->msg[p_MCB->first] = p_TCB->msg;
majik 0:21019d94ad33 144 if (++p_MCB->first == p_MCB->size) {
majik 0:21019d94ad33 145 p_MCB->first = 0;
majik 0:21019d94ad33 146 }
majik 0:21019d94ad33 147 rt_rmv_dly (p_TCB);
majik 0:21019d94ad33 148 rt_dispatch (p_TCB);
majik 0:21019d94ad33 149 }
majik 0:21019d94ad33 150 else {
majik 0:21019d94ad33 151 rt_dec (&p_MCB->count);
majik 0:21019d94ad33 152 }
majik 0:21019d94ad33 153 return (OS_R_OK);
majik 0:21019d94ad33 154 }
majik 0:21019d94ad33 155 /* No message available: wait for one */
majik 0:21019d94ad33 156 if (timeout == 0) {
majik 0:21019d94ad33 157 return (OS_R_TMO);
majik 0:21019d94ad33 158 }
majik 0:21019d94ad33 159 if (p_MCB->p_lnk != NULL) {
majik 0:21019d94ad33 160 rt_put_prio ((P_XCB)p_MCB, os_tsk.run);
majik 0:21019d94ad33 161 }
majik 0:21019d94ad33 162 else {
majik 0:21019d94ad33 163 p_MCB->p_lnk = os_tsk.run;
majik 0:21019d94ad33 164 os_tsk.run->p_lnk = NULL;
majik 0:21019d94ad33 165 os_tsk.run->p_rlnk = (P_TCB)p_MCB;
majik 0:21019d94ad33 166 /* Task is waiting to receive a message */
majik 0:21019d94ad33 167 p_MCB->state = 1;
majik 0:21019d94ad33 168 }
majik 0:21019d94ad33 169 rt_block(timeout, WAIT_MBX);
majik 0:21019d94ad33 170 #ifndef __CMSIS_RTOS
majik 0:21019d94ad33 171 os_tsk.run->msg = message;
majik 0:21019d94ad33 172 #endif
majik 0:21019d94ad33 173 return (OS_R_TMO);
majik 0:21019d94ad33 174 }
majik 0:21019d94ad33 175
majik 0:21019d94ad33 176
majik 0:21019d94ad33 177 /*--------------------------- rt_mbx_check ----------------------------------*/
majik 0:21019d94ad33 178
majik 0:21019d94ad33 179 OS_RESULT rt_mbx_check (OS_ID mailbox) {
majik 0:21019d94ad33 180 /* Check for free space in a mailbox. Returns the number of messages */
majik 0:21019d94ad33 181 /* that can be stored to a mailbox. It returns 0 when mailbox is full. */
majik 0:21019d94ad33 182 P_MCB p_MCB = mailbox;
majik 0:21019d94ad33 183
majik 0:21019d94ad33 184 return (p_MCB->size - p_MCB->count);
majik 0:21019d94ad33 185 }
majik 0:21019d94ad33 186
majik 0:21019d94ad33 187
majik 0:21019d94ad33 188 /*--------------------------- isr_mbx_send ----------------------------------*/
majik 0:21019d94ad33 189
majik 0:21019d94ad33 190 void isr_mbx_send (OS_ID mailbox, void *p_msg) {
majik 0:21019d94ad33 191 /* Same function as "os_mbx_send", but to be called by ISRs. */
majik 0:21019d94ad33 192 P_MCB p_MCB = mailbox;
majik 0:21019d94ad33 193
majik 0:21019d94ad33 194 rt_psq_enq (p_MCB, (U32)p_msg);
majik 0:21019d94ad33 195 rt_psh_req ();
majik 0:21019d94ad33 196 }
majik 0:21019d94ad33 197
majik 0:21019d94ad33 198
majik 0:21019d94ad33 199 /*--------------------------- isr_mbx_receive -------------------------------*/
majik 0:21019d94ad33 200
majik 0:21019d94ad33 201 OS_RESULT isr_mbx_receive (OS_ID mailbox, void **message) {
majik 0:21019d94ad33 202 /* Receive a message in the interrupt function. The interrupt function */
majik 0:21019d94ad33 203 /* should not wait for a message since this would block the rtx os. */
majik 0:21019d94ad33 204 P_MCB p_MCB = mailbox;
majik 0:21019d94ad33 205
majik 0:21019d94ad33 206 if (p_MCB->count) {
majik 0:21019d94ad33 207 /* A message is available in the fifo buffer. */
majik 0:21019d94ad33 208 *message = p_MCB->msg[p_MCB->last];
majik 0:21019d94ad33 209 if (p_MCB->state == 2) {
majik 0:21019d94ad33 210 /* A task is locked waiting to send message */
majik 0:21019d94ad33 211 rt_psq_enq (p_MCB, 0);
majik 0:21019d94ad33 212 rt_psh_req ();
majik 0:21019d94ad33 213 }
majik 0:21019d94ad33 214 rt_dec (&p_MCB->count);
majik 0:21019d94ad33 215 if (++p_MCB->last == p_MCB->size) {
majik 0:21019d94ad33 216 p_MCB->last = 0;
majik 0:21019d94ad33 217 }
majik 0:21019d94ad33 218 return (OS_R_MBX);
majik 0:21019d94ad33 219 }
majik 0:21019d94ad33 220 return (OS_R_OK);
majik 0:21019d94ad33 221 }
majik 0:21019d94ad33 222
majik 0:21019d94ad33 223
majik 0:21019d94ad33 224 /*--------------------------- rt_mbx_psh ------------------------------------*/
majik 0:21019d94ad33 225
majik 0:21019d94ad33 226 void rt_mbx_psh (P_MCB p_CB, void *p_msg) {
majik 0:21019d94ad33 227 /* Store the message to the mailbox queue or pass it to task directly. */
majik 0:21019d94ad33 228 P_TCB p_TCB;
majik 0:21019d94ad33 229 void *mem;
majik 0:21019d94ad33 230
majik 0:21019d94ad33 231 if (p_CB->p_lnk != NULL) switch (p_CB->state) {
majik 0:21019d94ad33 232 #ifdef __CMSIS_RTOS
majik 0:21019d94ad33 233 case 3:
majik 0:21019d94ad33 234 /* Task is waiting to allocate memory, remove it from the waiting list */
majik 0:21019d94ad33 235 mem = rt_alloc_box(p_msg);
majik 0:21019d94ad33 236 if (mem == NULL) break;
majik 0:21019d94ad33 237 p_TCB = rt_get_first ((P_XCB)p_CB);
majik 0:21019d94ad33 238 rt_ret_val(p_TCB, (U32)mem);
majik 0:21019d94ad33 239 p_TCB->state = READY;
majik 0:21019d94ad33 240 rt_rmv_dly (p_TCB);
majik 0:21019d94ad33 241 rt_put_prio (&os_rdy, p_TCB);
majik 0:21019d94ad33 242 break;
majik 0:21019d94ad33 243 #endif
majik 0:21019d94ad33 244 case 2:
majik 0:21019d94ad33 245 /* Task is waiting to send a message, remove it from the waiting list */
majik 0:21019d94ad33 246 p_TCB = rt_get_first ((P_XCB)p_CB);
majik 0:21019d94ad33 247 #ifdef __CMSIS_RTOS
majik 0:21019d94ad33 248 rt_ret_val(p_TCB, 0/*osOK*/);
majik 0:21019d94ad33 249 #else
majik 0:21019d94ad33 250 rt_ret_val(p_TCB, OS_R_OK);
majik 0:21019d94ad33 251 #endif
majik 0:21019d94ad33 252 p_CB->msg[p_CB->first] = p_TCB->msg;
majik 0:21019d94ad33 253 rt_inc (&p_CB->count);
majik 0:21019d94ad33 254 if (++p_CB->first == p_CB->size) {
majik 0:21019d94ad33 255 p_CB->first = 0;
majik 0:21019d94ad33 256 }
majik 0:21019d94ad33 257 p_TCB->state = READY;
majik 0:21019d94ad33 258 rt_rmv_dly (p_TCB);
majik 0:21019d94ad33 259 rt_put_prio (&os_rdy, p_TCB);
majik 0:21019d94ad33 260 break;
majik 0:21019d94ad33 261 case 1:
majik 0:21019d94ad33 262 /* Task is waiting for a message, pass the message to the task directly */
majik 0:21019d94ad33 263 p_TCB = rt_get_first ((P_XCB)p_CB);
majik 0:21019d94ad33 264 #ifdef __CMSIS_RTOS
majik 0:21019d94ad33 265 rt_ret_val2(p_TCB, 0x10/*osEventMessage*/, (U32)p_msg);
majik 0:21019d94ad33 266 #else
majik 0:21019d94ad33 267 *p_TCB->msg = p_msg;
majik 0:21019d94ad33 268 rt_ret_val (p_TCB, OS_R_MBX);
majik 0:21019d94ad33 269 #endif
majik 0:21019d94ad33 270 p_TCB->state = READY;
majik 0:21019d94ad33 271 rt_rmv_dly (p_TCB);
majik 0:21019d94ad33 272 rt_put_prio (&os_rdy, p_TCB);
majik 0:21019d94ad33 273 break;
majik 0:21019d94ad33 274 } else {
majik 0:21019d94ad33 275 /* No task is waiting for a message, store it to the mailbox queue */
majik 0:21019d94ad33 276 if (p_CB->count < p_CB->size) {
majik 0:21019d94ad33 277 p_CB->msg[p_CB->first] = p_msg;
majik 0:21019d94ad33 278 rt_inc (&p_CB->count);
majik 0:21019d94ad33 279 if (++p_CB->first == p_CB->size) {
majik 0:21019d94ad33 280 p_CB->first = 0;
majik 0:21019d94ad33 281 }
majik 0:21019d94ad33 282 }
majik 0:21019d94ad33 283 else {
majik 0:21019d94ad33 284 os_error (OS_ERR_MBX_OVF);
majik 0:21019d94ad33 285 }
majik 0:21019d94ad33 286 }
majik 0:21019d94ad33 287 }
majik 0:21019d94ad33 288
majik 0:21019d94ad33 289 /*----------------------------------------------------------------------------
majik 0:21019d94ad33 290 * end of file
majik 0:21019d94ad33 291 *---------------------------------------------------------------------------*/
majik 0:21019d94ad33 292