Freeman Oldman / NUCLEO_STM32F401RE_CC3000_ILI9341

The code from https://github.com/vpcola/Nucleo

mbed-rtos/rtx/rt_Mailbox.c@0:5464d5e415e5, 2014-10-08 (annotated)

Committer:
sinrab
Date:
Wed Oct 08 11:00:24 2014 +0000
Revision:
0:5464d5e415e5
The code from https://github.com/vpcola/Nucleo

Who changed what in which revision?

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