mbed official / mbed-rtos

Official mbed Real Time Operating System based on the RTX implementation of the CMSIS-RTOS API open standard.

Dependents:   denki-yohou_b TestY201 Network-RTOS NTPClient_HelloWorld ... more

Deprecated

This is the mbed 2 rtos library. mbed OS 5 integrates the mbed library with mbed-rtos. With this, we have provided thread safety for all mbed APIs. If you'd like to learn about using mbed OS 5, please see the docs.

rtos/Thread.cpp@118:6635230e06ba, 2016-07-25 (annotated)

Committer:
Kojto
Date:
Mon Jul 25 14:12:24 2016 +0100
Revision:
118:6635230e06ba
Parent:
115:11950e007d8a
Child:
119:19af2d39a542
RTOS rev118



Compatible with the mbed library v122



Changes:

- warnings about duplicated CM symbols fix

- init sequence update - allows init array to be run prior kernel start

- RTOS with OS_TIMERS=0 fix for thread id

- Thread ctor is deprecated, use start() method

- main stack fix for IAR (set via linker script)

- add TCB context pointer

- provide thread safety for toolchains (std lib locks)

- add MBED_RTOS_SINGLE_THREAD macro (sets TSKCNT to 1 and TIMERS to 0)

- nrf51, nucleo l423kc, nucleo f767zi, nucleo f446ze, efm32 support addition

- add OSObserver function

Who changed what in which revision?

UserRevisionLine numberNew contents of line
emilmont 8:88a1a9c26ae3 1 /* mbed Microcontroller Library
emilmont 8:88a1a9c26ae3 2 * Copyright (c) 2006-2012 ARM Limited
emilmont 8:88a1a9c26ae3 3 *
emilmont 8:88a1a9c26ae3 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
emilmont 8:88a1a9c26ae3 5 * of this software and associated documentation files (the "Software"), to deal
emilmont 8:88a1a9c26ae3 6 * in the Software without restriction, including without limitation the rights
emilmont 8:88a1a9c26ae3 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
emilmont 8:88a1a9c26ae3 8 * copies of the Software, and to permit persons to whom the Software is
emilmont 8:88a1a9c26ae3 9 * furnished to do so, subject to the following conditions:
emilmont 8:88a1a9c26ae3 10 *
emilmont 8:88a1a9c26ae3 11 * The above copyright notice and this permission notice shall be included in
emilmont 8:88a1a9c26ae3 12 * all copies or substantial portions of the Software.
emilmont 8:88a1a9c26ae3 13 *
emilmont 8:88a1a9c26ae3 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
emilmont 8:88a1a9c26ae3 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
emilmont 8:88a1a9c26ae3 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
emilmont 8:88a1a9c26ae3 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
emilmont 8:88a1a9c26ae3 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
emilmont 8:88a1a9c26ae3 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
emilmont 8:88a1a9c26ae3 20 * SOFTWARE.
emilmont 8:88a1a9c26ae3 21 */
emilmont 8:88a1a9c26ae3 22 #include "Thread.h"
emilmont 8:88a1a9c26ae3 23
Kojto 118:6635230e06ba 24 #include "mbed.h"
mbed_official 107:bdd541595fc5 25 #include "rtos_idle.h"
emilmont 8:88a1a9c26ae3 26
mbed_official 112:53ace74b190c 27 // rt_tid2ptcb is an internal function which we exposed to get TCB for thread id
mbed_official 112:53ace74b190c 28 #undef NULL //Workaround for conflicting macros in rt_TypeDef.h and stdio.h
mbed_official 112:53ace74b190c 29 #include "rt_TypeDef.h"
mbed_official 112:53ace74b190c 30
mbed_official 112:53ace74b190c 31 extern "C" P_TCB rt_tid2ptcb(osThreadId thread_id);
mbed_official 112:53ace74b190c 32
emilmont 8:88a1a9c26ae3 33 namespace rtos {
emilmont 8:88a1a9c26ae3 34
Kojto 118:6635230e06ba 35 void Thread::constructor(osPriority priority,
Kojto 118:6635230e06ba 36 uint32_t stack_size, unsigned char *stack_pointer) {
Kojto 118:6635230e06ba 37 _tid = 0;
Kojto 118:6635230e06ba 38 _dynamic_stack = (stack_pointer == NULL);
Kojto 118:6635230e06ba 39
mbed_official 115:11950e007d8a 40 #if defined(__MBED_CMSIS_RTOS_CA9) || defined(__MBED_CMSIS_RTOS_CM)
emilmont 8:88a1a9c26ae3 41 _thread_def.tpriority = priority;
emilmont 8:88a1a9c26ae3 42 _thread_def.stacksize = stack_size;
Kojto 118:6635230e06ba 43 _thread_def.stack_pointer = (uint32_t*)stack_pointer;
Kojto 118:6635230e06ba 44 #endif
Kojto 118:6635230e06ba 45 }
Kojto 118:6635230e06ba 46
Kojto 118:6635230e06ba 47 void Thread::constructor(Callback<void()> task,
Kojto 118:6635230e06ba 48 osPriority priority, uint32_t stack_size, unsigned char *stack_pointer) {
Kojto 118:6635230e06ba 49 constructor(priority, stack_size, stack_pointer);
Kojto 118:6635230e06ba 50
Kojto 118:6635230e06ba 51 switch (start(task)) {
Kojto 118:6635230e06ba 52 case osErrorResource:
Kojto 118:6635230e06ba 53 error("OS ran out of threads!\n");
Kojto 118:6635230e06ba 54 break;
Kojto 118:6635230e06ba 55 case osErrorParameter:
Kojto 118:6635230e06ba 56 error("Thread already running!\n");
Kojto 118:6635230e06ba 57 break;
Kojto 118:6635230e06ba 58 case osErrorNoMemory:
Kojto 118:6635230e06ba 59 error("Error allocating the stack memory\n");
Kojto 118:6635230e06ba 60 default:
Kojto 118:6635230e06ba 61 break;
Kojto 118:6635230e06ba 62 }
Kojto 118:6635230e06ba 63 }
Kojto 118:6635230e06ba 64
Kojto 118:6635230e06ba 65 osStatus Thread::start(Callback<void()> task) {
Kojto 118:6635230e06ba 66 if (_tid != 0) {
Kojto 118:6635230e06ba 67 return osErrorParameter;
Kojto 118:6635230e06ba 68 }
Kojto 118:6635230e06ba 69
Kojto 118:6635230e06ba 70 #if defined(__MBED_CMSIS_RTOS_CA9) || defined(__MBED_CMSIS_RTOS_CM)
Kojto 118:6635230e06ba 71 _thread_def.pthread = (void (*)(const void *))Callback<void()>::thunk;
Kojto 118:6635230e06ba 72 if (_thread_def.stack_pointer == NULL) {
Kojto 118:6635230e06ba 73 _thread_def.stack_pointer = new uint32_t[_thread_def.stacksize/sizeof(uint32_t)];
emilmont 8:88a1a9c26ae3 74 if (_thread_def.stack_pointer == NULL)
Kojto 118:6635230e06ba 75 return osErrorNoMemory;
emilmont 8:88a1a9c26ae3 76 }
Kojto 118:6635230e06ba 77
mbed_official 84:143955ffb790 78 //Fill the stack with a magic word for maximum usage checking
Kojto 118:6635230e06ba 79 for (uint32_t i = 0; i < (_thread_def.stacksize / sizeof(uint32_t)); i++) {
mbed_official 84:143955ffb790 80 _thread_def.stack_pointer[i] = 0xE25A2EA5;
mbed_official 84:143955ffb790 81 }
emilmont 8:88a1a9c26ae3 82 #endif
Kojto 118:6635230e06ba 83 _task = task;
Kojto 118:6635230e06ba 84 _tid = osThreadCreate(&_thread_def, &_task);
Kojto 118:6635230e06ba 85 if (_tid == NULL) {
Kojto 118:6635230e06ba 86 if (_dynamic_stack) delete[] (_thread_def.stack_pointer);
Kojto 118:6635230e06ba 87 return osErrorResource;
Kojto 118:6635230e06ba 88 }
Kojto 118:6635230e06ba 89 return osOK;
emilmont 8:88a1a9c26ae3 90 }
emilmont 8:88a1a9c26ae3 91
emilmont 8:88a1a9c26ae3 92 osStatus Thread::terminate() {
emilmont 8:88a1a9c26ae3 93 return osThreadTerminate(_tid);
emilmont 8:88a1a9c26ae3 94 }
emilmont 8:88a1a9c26ae3 95
Kojto 118:6635230e06ba 96 osStatus Thread::join() {
Kojto 118:6635230e06ba 97 while (true) {
Kojto 118:6635230e06ba 98 uint8_t state = get_state();
Kojto 118:6635230e06ba 99 if (state == Thread::Inactive || state == osErrorParameter) {
Kojto 118:6635230e06ba 100 return osOK;
Kojto 118:6635230e06ba 101 }
Kojto 118:6635230e06ba 102
Kojto 118:6635230e06ba 103 osStatus status = yield();
Kojto 118:6635230e06ba 104 if (status != osOK) {
Kojto 118:6635230e06ba 105 return status;
Kojto 118:6635230e06ba 106 }
Kojto 118:6635230e06ba 107 }
Kojto 118:6635230e06ba 108 }
Kojto 118:6635230e06ba 109
emilmont 8:88a1a9c26ae3 110 osStatus Thread::set_priority(osPriority priority) {
emilmont 8:88a1a9c26ae3 111 return osThreadSetPriority(_tid, priority);
emilmont 8:88a1a9c26ae3 112 }
emilmont 8:88a1a9c26ae3 113
emilmont 8:88a1a9c26ae3 114 osPriority Thread::get_priority() {
emilmont 8:88a1a9c26ae3 115 return osThreadGetPriority(_tid);
emilmont 8:88a1a9c26ae3 116 }
emilmont 8:88a1a9c26ae3 117
emilmont 8:88a1a9c26ae3 118 int32_t Thread::signal_set(int32_t signals) {
emilmont 8:88a1a9c26ae3 119 return osSignalSet(_tid, signals);
emilmont 8:88a1a9c26ae3 120 }
emilmont 8:88a1a9c26ae3 121
mbed_official 76:85a52b7ef44b 122 int32_t Thread::signal_clr(int32_t signals) {
mbed_official 76:85a52b7ef44b 123 return osSignalClear(_tid, signals);
mbed_official 76:85a52b7ef44b 124 }
mbed_official 76:85a52b7ef44b 125
emilmont 8:88a1a9c26ae3 126 Thread::State Thread::get_state() {
mbed_official 112:53ace74b190c 127 #if !defined(__MBED_CMSIS_RTOS_CA9) && !defined(__MBED_CMSIS_RTOS_CM)
mbed_official 112:53ace74b190c 128 #ifdef CMSIS_OS_RTX
emilmont 8:88a1a9c26ae3 129 return ((State)_thread_def.tcb.state);
mbed_official 112:53ace74b190c 130 #endif
mbed_official 48:e9a2c7cb57a4 131 #else
mbed_official 48:e9a2c7cb57a4 132 uint8_t status;
mbed_official 48:e9a2c7cb57a4 133 status = osThreadGetState(_tid);
mbed_official 48:e9a2c7cb57a4 134 return ((State)status);
mbed_official 48:e9a2c7cb57a4 135 #endif
emilmont 8:88a1a9c26ae3 136 }
emilmont 8:88a1a9c26ae3 137
mbed_official 84:143955ffb790 138 uint32_t Thread::stack_size() {
mbed_official 84:143955ffb790 139 #ifndef __MBED_CMSIS_RTOS_CA9
mbed_official 112:53ace74b190c 140 #if defined(CMSIS_OS_RTX) && !defined(__MBED_CMSIS_RTOS_CM)
mbed_official 84:143955ffb790 141 return _thread_def.tcb.priv_stack;
mbed_official 84:143955ffb790 142 #else
mbed_official 112:53ace74b190c 143 P_TCB tcb = rt_tid2ptcb(_tid);
mbed_official 112:53ace74b190c 144 return tcb->priv_stack;
mbed_official 112:53ace74b190c 145 #endif
mbed_official 112:53ace74b190c 146 #else
mbed_official 84:143955ffb790 147 return 0;
mbed_official 84:143955ffb790 148 #endif
mbed_official 84:143955ffb790 149 }
mbed_official 84:143955ffb790 150
mbed_official 84:143955ffb790 151 uint32_t Thread::free_stack() {
mbed_official 84:143955ffb790 152 #ifndef __MBED_CMSIS_RTOS_CA9
mbed_official 112:53ace74b190c 153 #if defined(CMSIS_OS_RTX) && !defined(__MBED_CMSIS_RTOS_CM)
mbed_official 84:143955ffb790 154 uint32_t bottom = (uint32_t)_thread_def.tcb.stack;
mbed_official 84:143955ffb790 155 return _thread_def.tcb.tsk_stack - bottom;
mbed_official 84:143955ffb790 156 #else
mbed_official 112:53ace74b190c 157 P_TCB tcb = rt_tid2ptcb(_tid);
mbed_official 112:53ace74b190c 158 uint32_t bottom = (uint32_t)tcb->stack;
mbed_official 112:53ace74b190c 159 return tcb->tsk_stack - bottom;
mbed_official 112:53ace74b190c 160 #endif
mbed_official 112:53ace74b190c 161 #else
mbed_official 84:143955ffb790 162 return 0;
mbed_official 84:143955ffb790 163 #endif
mbed_official 84:143955ffb790 164 }
mbed_official 84:143955ffb790 165
mbed_official 84:143955ffb790 166 uint32_t Thread::used_stack() {
mbed_official 84:143955ffb790 167 #ifndef __MBED_CMSIS_RTOS_CA9
mbed_official 112:53ace74b190c 168 #if defined(CMSIS_OS_RTX) && !defined(__MBED_CMSIS_RTOS_CM)
mbed_official 84:143955ffb790 169 uint32_t top = (uint32_t)_thread_def.tcb.stack + _thread_def.tcb.priv_stack;
mbed_official 84:143955ffb790 170 return top - _thread_def.tcb.tsk_stack;
mbed_official 84:143955ffb790 171 #else
mbed_official 112:53ace74b190c 172 P_TCB tcb = rt_tid2ptcb(_tid);
mbed_official 112:53ace74b190c 173 uint32_t top = (uint32_t)tcb->stack + tcb->priv_stack;
mbed_official 112:53ace74b190c 174 return top - tcb->tsk_stack;
mbed_official 112:53ace74b190c 175 #endif
mbed_official 112:53ace74b190c 176 #else
mbed_official 84:143955ffb790 177 return 0;
mbed_official 84:143955ffb790 178 #endif
mbed_official 84:143955ffb790 179 }
mbed_official 84:143955ffb790 180
mbed_official 84:143955ffb790 181 uint32_t Thread::max_stack() {
mbed_official 84:143955ffb790 182 #ifndef __MBED_CMSIS_RTOS_CA9
mbed_official 112:53ace74b190c 183 #if defined(CMSIS_OS_RTX) && !defined(__MBED_CMSIS_RTOS_CM)
mbed_official 84:143955ffb790 184 uint32_t high_mark = 0;
mbed_official 84:143955ffb790 185 while (_thread_def.tcb.stack[high_mark] == 0xE25A2EA5)
mbed_official 84:143955ffb790 186 high_mark++;
mbed_official 84:143955ffb790 187 return _thread_def.tcb.priv_stack - (high_mark * 4);
mbed_official 84:143955ffb790 188 #else
mbed_official 112:53ace74b190c 189 P_TCB tcb = rt_tid2ptcb(_tid);
mbed_official 112:53ace74b190c 190 uint32_t high_mark = 0;
mbed_official 112:53ace74b190c 191 while (tcb->stack[high_mark] == 0xE25A2EA5)
mbed_official 112:53ace74b190c 192 high_mark++;
mbed_official 112:53ace74b190c 193 return tcb->priv_stack - (high_mark * 4);
mbed_official 112:53ace74b190c 194 #endif
mbed_official 112:53ace74b190c 195 #else
mbed_official 84:143955ffb790 196 return 0;
mbed_official 84:143955ffb790 197 #endif
mbed_official 84:143955ffb790 198 }
mbed_official 84:143955ffb790 199
emilmont 8:88a1a9c26ae3 200 osEvent Thread::signal_wait(int32_t signals, uint32_t millisec) {
emilmont 8:88a1a9c26ae3 201 return osSignalWait(signals, millisec);
emilmont 8:88a1a9c26ae3 202 }
emilmont 8:88a1a9c26ae3 203
emilmont 8:88a1a9c26ae3 204 osStatus Thread::wait(uint32_t millisec) {
emilmont 8:88a1a9c26ae3 205 return osDelay(millisec);
emilmont 8:88a1a9c26ae3 206 }
emilmont 8:88a1a9c26ae3 207
emilmont 8:88a1a9c26ae3 208 osStatus Thread::yield() {
emilmont 8:88a1a9c26ae3 209 return osThreadYield();
emilmont 8:88a1a9c26ae3 210 }
emilmont 8:88a1a9c26ae3 211
emilmont 8:88a1a9c26ae3 212 osThreadId Thread::gettid() {
emilmont 8:88a1a9c26ae3 213 return osThreadGetId();
emilmont 8:88a1a9c26ae3 214 }
emilmont 8:88a1a9c26ae3 215
mbed_official 107:bdd541595fc5 216 void Thread::attach_idle_hook(void (*fptr)(void)) {
mbed_official 107:bdd541595fc5 217 rtos_attach_idle_hook(fptr);
mbed_official 107:bdd541595fc5 218 }
mbed_official 107:bdd541595fc5 219
emilmont 8:88a1a9c26ae3 220 Thread::~Thread() {
emilmont 8:88a1a9c26ae3 221 terminate();
mbed_official 112:53ace74b190c 222 #ifdef __MBED_CMSIS_RTOS_CM
emilmont 8:88a1a9c26ae3 223 if (_dynamic_stack) {
emilmont 8:88a1a9c26ae3 224 delete[] (_thread_def.stack_pointer);
emilmont 8:88a1a9c26ae3 225 }
mbed_official 112:53ace74b190c 226 #endif
emilmont 8:88a1a9c26ae3 227 }
emilmont 8:88a1a9c26ae3 228
emilmont 8:88a1a9c26ae3 229 }