ny davai
This commit is contained in:
846
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/cmsis_os.h
vendored
Normal file
846
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/cmsis_os.h
vendored
Normal file
@@ -0,0 +1,846 @@
|
||||
/*
|
||||
* Copyright (c) 2013-2019 ARM Limited. All rights reserved.
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the License); you may
|
||||
* not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an AS IS BASIS, WITHOUT
|
||||
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* ----------------------------------------------------------------------
|
||||
*
|
||||
* $Date: 10. January 2017
|
||||
* $Revision: V2.1.0
|
||||
*
|
||||
* Project: CMSIS-RTOS API
|
||||
* Title: cmsis_os.h FreeRTOS header file
|
||||
*
|
||||
* Version 0.02
|
||||
* Initial Proposal Phase
|
||||
* Version 0.03
|
||||
* osKernelStart added, optional feature: main started as thread
|
||||
* osSemaphores have standard behavior
|
||||
* osTimerCreate does not start the timer, added osTimerStart
|
||||
* osThreadPass is renamed to osThreadYield
|
||||
* Version 1.01
|
||||
* Support for C++ interface
|
||||
* - const attribute removed from the osXxxxDef_t typedefs
|
||||
* - const attribute added to the osXxxxDef macros
|
||||
* Added: osTimerDelete, osMutexDelete, osSemaphoreDelete
|
||||
* Added: osKernelInitialize
|
||||
* Version 1.02
|
||||
* Control functions for short timeouts in microsecond resolution:
|
||||
* Added: osKernelSysTick, osKernelSysTickFrequency, osKernelSysTickMicroSec
|
||||
* Removed: osSignalGet
|
||||
* Version 2.0.0
|
||||
* OS objects creation without macros (dynamic creation and resource allocation):
|
||||
* - added: osXxxxNew functions which replace osXxxxCreate
|
||||
* - added: osXxxxAttr_t structures
|
||||
* - deprecated: osXxxxCreate functions, osXxxxDef_t structures
|
||||
* - deprecated: osXxxxDef and osXxxx macros
|
||||
* osStatus codes simplified and renamed to osStatus_t
|
||||
* osEvent return structure deprecated
|
||||
* Kernel:
|
||||
* - added: osKernelInfo_t and osKernelGetInfo
|
||||
* - added: osKernelState_t and osKernelGetState (replaces osKernelRunning)
|
||||
* - added: osKernelLock, osKernelUnlock
|
||||
* - added: osKernelSuspend, osKernelResume
|
||||
* - added: osKernelGetTickCount, osKernelGetTickFreq
|
||||
* - renamed osKernelSysTick to osKernelGetSysTimerCount
|
||||
* - replaced osKernelSysTickFrequency with osKernelGetSysTimerFreq
|
||||
* - deprecated osKernelSysTickMicroSec
|
||||
* Thread:
|
||||
* - extended number of thread priorities
|
||||
* - renamed osPrioriry to osPrioriry_t
|
||||
* - replaced osThreadCreate with osThreadNew
|
||||
* - added: osThreadGetName
|
||||
* - added: osThreadState_t and osThreadGetState
|
||||
* - added: osThreadGetStackSize, osThreadGetStackSpace
|
||||
* - added: osThreadSuspend, osThreadResume
|
||||
* - added: osThreadJoin, osThreadDetach, osThreadExit
|
||||
* - added: osThreadGetCount, osThreadEnumerate
|
||||
* - added: Thread Flags (moved from Signals)
|
||||
* Signals:
|
||||
* - renamed osSignals to osThreadFlags (moved to Thread Flags)
|
||||
* - changed return value of Set/Clear/Wait functions
|
||||
* - Clear function limited to current running thread
|
||||
* - extended Wait function (options)
|
||||
* - added: osThreadFlagsGet
|
||||
* Event Flags:
|
||||
* - added new independent object for handling Event Flags
|
||||
* Delay and Wait functions:
|
||||
* - added: osDelayUntil
|
||||
* - deprecated: osWait
|
||||
* Timer:
|
||||
* - replaced osTimerCreate with osTimerNew
|
||||
* - added: osTimerGetName, osTimerIsRunning
|
||||
* Mutex:
|
||||
* - extended: attributes (Recursive, Priority Inherit, Robust)
|
||||
* - replaced osMutexCreate with osMutexNew
|
||||
* - renamed osMutexWait to osMutexAcquire
|
||||
* - added: osMutexGetName, osMutexGetOwner
|
||||
* Semaphore:
|
||||
* - extended: maximum and initial token count
|
||||
* - replaced osSemaphoreCreate with osSemaphoreNew
|
||||
* - renamed osSemaphoreWait to osSemaphoreAcquire (changed return value)
|
||||
* - added: osSemaphoreGetName, osSemaphoreGetCount
|
||||
* Memory Pool:
|
||||
* - using osMemoryPool prefix instead of osPool
|
||||
* - replaced osPoolCreate with osMemoryPoolNew
|
||||
* - extended osMemoryPoolAlloc (timeout)
|
||||
* - added: osMemoryPoolGetName
|
||||
* - added: osMemoryPoolGetCapacity, osMemoryPoolGetBlockSize
|
||||
* - added: osMemoryPoolGetCount, osMemoryPoolGetSpace
|
||||
* - added: osMemoryPoolDelete
|
||||
* - deprecated: osPoolCAlloc
|
||||
* Message Queue:
|
||||
* - extended: fixed size message instead of a single 32-bit value
|
||||
* - using osMessageQueue prefix instead of osMessage
|
||||
* - replaced osMessageCreate with osMessageQueueNew
|
||||
* - updated: osMessageQueuePut, osMessageQueueGet
|
||||
* - added: osMessageQueueGetName
|
||||
* - added: osMessageQueueGetCapacity, osMessageQueueGetMsgSize
|
||||
* - added: osMessageQueueGetCount, osMessageQueueGetSpace
|
||||
* - added: osMessageQueueReset, osMessageQueueDelete
|
||||
* Mail Queue:
|
||||
* - deprecated (superseded by extended Message Queue functionality)
|
||||
* Version 2.1.0
|
||||
* Support for critical and uncritical sections (nesting safe):
|
||||
* - updated: osKernelLock, osKernelUnlock
|
||||
* - added: osKernelRestoreLock
|
||||
* Updated Thread and Event Flags:
|
||||
* - changed flags parameter and return type from int32_t to uint32_t
|
||||
*---------------------------------------------------------------------------*/
|
||||
|
||||
#ifndef CMSIS_OS_H_
|
||||
#define CMSIS_OS_H_
|
||||
|
||||
#include "FreeRTOS.h"
|
||||
#include "task.h"
|
||||
|
||||
#define RTOS_ID_n ((tskKERNEL_VERSION_MAJOR << 16) | (tskKERNEL_VERSION_MINOR))
|
||||
#define RTOS_ID_s ("FreeRTOS " tskKERNEL_VERSION_NUMBER)
|
||||
|
||||
#define osCMSIS 0x20001U ///< API version (main[31:16].sub[15:0])
|
||||
|
||||
#define osCMSIS_FreeRTOS RTOS_ID_n ///< RTOS identification and version (main[31:16].sub[15:0])
|
||||
|
||||
#define osKernelSystemId RTOS_ID_s ///< RTOS identification string
|
||||
|
||||
#define osFeature_MainThread 0 ///< main thread 1=main can be thread, 0=not available
|
||||
#define osFeature_Signals 24U ///< maximum number of Signal Flags available per thread
|
||||
#define osFeature_Semaphore 65535U ///< maximum count for \ref osSemaphoreCreate function
|
||||
#define osFeature_Wait 0 ///< osWait function: 1=available, 0=not available
|
||||
#define osFeature_SysTick 1 ///< osKernelSysTick functions: 1=available, 0=not available
|
||||
#define osFeature_Pool 0 ///< Memory Pools: 1=available, 0=not available
|
||||
#define osFeature_MessageQ 1 ///< Message Queues: 1=available, 0=not available
|
||||
#define osFeature_MailQ 0 ///< Mail Queues: 1=available, 0=not available
|
||||
|
||||
#if defined(__CC_ARM)
|
||||
#define os_InRegs __value_in_regs
|
||||
#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050)
|
||||
#define os_InRegs __attribute__((value_in_regs))
|
||||
#else
|
||||
#define os_InRegs
|
||||
#endif
|
||||
|
||||
#include "cmsis_os2.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C"
|
||||
{
|
||||
#endif
|
||||
|
||||
|
||||
// ==== Enumerations, structures, defines ====
|
||||
|
||||
/// Priority values.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef enum {
|
||||
osPriorityIdle = -3, ///< Priority: idle (lowest)
|
||||
osPriorityLow = -2, ///< Priority: low
|
||||
osPriorityBelowNormal = -1, ///< Priority: below normal
|
||||
osPriorityNormal = 0, ///< Priority: normal (default)
|
||||
osPriorityAboveNormal = +1, ///< Priority: above normal
|
||||
osPriorityHigh = +2, ///< Priority: high
|
||||
osPriorityRealtime = +3, ///< Priority: realtime (highest)
|
||||
osPriorityError = 0x84, ///< System cannot determine priority or illegal priority.
|
||||
osPriorityReserved = 0x7FFFFFFF ///< Prevents enum down-size compiler optimization.
|
||||
} osPriority;
|
||||
#else
|
||||
#define osPriority osPriority_t
|
||||
#endif
|
||||
|
||||
/// Entry point of a thread.
|
||||
typedef void (*os_pthread) (void const *argument);
|
||||
|
||||
/// Entry point of a timer call back function.
|
||||
typedef void (*os_ptimer) (void const *argument);
|
||||
|
||||
/// Timer type.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef enum {
|
||||
osTimerOnce = 0, ///< One-shot timer.
|
||||
osTimerPeriodic = 1 ///< Repeating timer.
|
||||
} os_timer_type;
|
||||
#else
|
||||
#define os_timer_type osTimerType_t
|
||||
#endif
|
||||
|
||||
/// Timeout value.
|
||||
#define osWaitForever 0xFFFFFFFFU ///< Wait forever timeout value.
|
||||
|
||||
/// Status code values returned by CMSIS-RTOS functions.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef enum {
|
||||
osOK = 0, ///< Function completed; no error or event occurred.
|
||||
osEventSignal = 0x08, ///< Function completed; signal event occurred.
|
||||
osEventMessage = 0x10, ///< Function completed; message event occurred.
|
||||
osEventMail = 0x20, ///< Function completed; mail event occurred.
|
||||
osEventTimeout = 0x40, ///< Function completed; timeout occurred.
|
||||
osErrorParameter = 0x80, ///< Parameter error: a mandatory parameter was missing or specified an incorrect object.
|
||||
osErrorResource = 0x81, ///< Resource not available: a specified resource was not available.
|
||||
osErrorTimeoutResource = 0xC1, ///< Resource not available within given time: a specified resource was not available within the timeout period.
|
||||
osErrorISR = 0x82, ///< Not allowed in ISR context: the function cannot be called from interrupt service routines.
|
||||
osErrorISRRecursive = 0x83, ///< Function called multiple times from ISR with same object.
|
||||
osErrorPriority = 0x84, ///< System cannot determine priority or thread has illegal priority.
|
||||
osErrorNoMemory = 0x85, ///< System is out of memory: it was impossible to allocate or reserve memory for the operation.
|
||||
osErrorValue = 0x86, ///< Value of a parameter is out of range.
|
||||
osErrorOS = 0xFF, ///< Unspecified RTOS error: run-time error but no other error message fits.
|
||||
osStatusReserved = 0x7FFFFFFF ///< Prevents enum down-size compiler optimization.
|
||||
} osStatus;
|
||||
#else
|
||||
typedef int32_t osStatus;
|
||||
#define osEventSignal (0x08)
|
||||
#define osEventMessage (0x10)
|
||||
#define osEventMail (0x20)
|
||||
#define osEventTimeout (0x40)
|
||||
#define osErrorOS osError
|
||||
#define osErrorTimeoutResource osErrorTimeout
|
||||
#define osErrorISRRecursive (-126)
|
||||
#define osErrorValue (-127)
|
||||
#define osErrorPriority (-128)
|
||||
#endif
|
||||
|
||||
|
||||
// >>> the following data type definitions may be adapted towards a specific RTOS
|
||||
|
||||
/// Thread ID identifies the thread.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef void *osThreadId;
|
||||
#else
|
||||
#define osThreadId osThreadId_t
|
||||
#endif
|
||||
|
||||
/// Timer ID identifies the timer.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef void *osTimerId;
|
||||
#else
|
||||
#define osTimerId osTimerId_t
|
||||
#endif
|
||||
|
||||
/// Mutex ID identifies the mutex.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef void *osMutexId;
|
||||
#else
|
||||
#define osMutexId osMutexId_t
|
||||
#endif
|
||||
|
||||
/// Semaphore ID identifies the semaphore.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef void *osSemaphoreId;
|
||||
#else
|
||||
#define osSemaphoreId osSemaphoreId_t
|
||||
#endif
|
||||
|
||||
/// Pool ID identifies the memory pool.
|
||||
typedef void *osPoolId;
|
||||
|
||||
/// Message ID identifies the message queue.
|
||||
typedef void *osMessageQId;
|
||||
|
||||
/// Mail ID identifies the mail queue.
|
||||
typedef void *osMailQId;
|
||||
|
||||
|
||||
/// Thread Definition structure contains startup information of a thread.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef struct os_thread_def {
|
||||
os_pthread pthread; ///< start address of thread function
|
||||
osPriority tpriority; ///< initial thread priority
|
||||
uint32_t instances; ///< maximum number of instances of that thread function
|
||||
uint32_t stacksize; ///< stack size requirements in bytes; 0 is default stack size
|
||||
} osThreadDef_t;
|
||||
#else
|
||||
typedef struct os_thread_def {
|
||||
os_pthread pthread; ///< start address of thread function
|
||||
osThreadAttr_t attr; ///< thread attributes
|
||||
} osThreadDef_t;
|
||||
#endif
|
||||
|
||||
/// Timer Definition structure contains timer parameters.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef struct os_timer_def {
|
||||
os_ptimer ptimer; ///< start address of a timer function
|
||||
} osTimerDef_t;
|
||||
#else
|
||||
typedef struct os_timer_def {
|
||||
os_ptimer ptimer; ///< start address of a timer function
|
||||
osTimerAttr_t attr; ///< timer attributes
|
||||
} osTimerDef_t;
|
||||
#endif
|
||||
|
||||
/// Mutex Definition structure contains setup information for a mutex.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef struct os_mutex_def {
|
||||
uint32_t dummy; ///< dummy value
|
||||
} osMutexDef_t;
|
||||
#else
|
||||
#define osMutexDef_t osMutexAttr_t
|
||||
#endif
|
||||
|
||||
/// Semaphore Definition structure contains setup information for a semaphore.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef struct os_semaphore_def {
|
||||
uint32_t dummy; ///< dummy value
|
||||
} osSemaphoreDef_t;
|
||||
#else
|
||||
#define osSemaphoreDef_t osSemaphoreAttr_t
|
||||
#endif
|
||||
|
||||
/// Definition structure for memory block allocation.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef struct os_pool_def {
|
||||
uint32_t pool_sz; ///< number of items (elements) in the pool
|
||||
uint32_t item_sz; ///< size of an item
|
||||
void *pool; ///< pointer to memory for pool
|
||||
} osPoolDef_t;
|
||||
#else
|
||||
typedef struct os_pool_def {
|
||||
uint32_t pool_sz; ///< number of items (elements) in the pool
|
||||
uint32_t item_sz; ///< size of an item
|
||||
osMemoryPoolAttr_t attr; ///< memory pool attributes
|
||||
} osPoolDef_t;
|
||||
#endif
|
||||
|
||||
/// Definition structure for message queue.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef struct os_messageQ_def {
|
||||
uint32_t queue_sz; ///< number of elements in the queue
|
||||
void *pool; ///< memory array for messages
|
||||
} osMessageQDef_t;
|
||||
#else
|
||||
typedef struct os_messageQ_def {
|
||||
uint32_t queue_sz; ///< number of elements in the queue
|
||||
osMessageQueueAttr_t attr; ///< message queue attributes
|
||||
} osMessageQDef_t;
|
||||
#endif
|
||||
|
||||
/// Definition structure for mail queue.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
typedef struct os_mailQ_def {
|
||||
uint32_t queue_sz; ///< number of elements in the queue
|
||||
uint32_t item_sz; ///< size of an item
|
||||
void *pool; ///< memory array for mail
|
||||
} osMailQDef_t;
|
||||
#else
|
||||
typedef struct os_mailQ_def {
|
||||
uint32_t queue_sz; ///< number of elements in the queue
|
||||
uint32_t item_sz; ///< size of an item
|
||||
void *mail; ///< pointer to mail
|
||||
osMemoryPoolAttr_t mp_attr; ///< memory pool attributes
|
||||
osMessageQueueAttr_t mq_attr; ///< message queue attributes
|
||||
} osMailQDef_t;
|
||||
#endif
|
||||
|
||||
|
||||
/// Event structure contains detailed information about an event.
|
||||
typedef struct {
|
||||
osStatus status; ///< status code: event or error information
|
||||
union {
|
||||
uint32_t v; ///< message as 32-bit value
|
||||
void *p; ///< message or mail as void pointer
|
||||
int32_t signals; ///< signal flags
|
||||
} value; ///< event value
|
||||
union {
|
||||
osMailQId mail_id; ///< mail id obtained by \ref osMailCreate
|
||||
osMessageQId message_id; ///< message id obtained by \ref osMessageCreate
|
||||
} def; ///< event definition
|
||||
} osEvent;
|
||||
|
||||
|
||||
// ==== Kernel Management Functions ====
|
||||
|
||||
/// Initialize the RTOS Kernel for creating objects.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osKernelInitialize (void);
|
||||
#endif
|
||||
|
||||
/// Start the RTOS Kernel scheduler.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osKernelStart (void);
|
||||
#endif
|
||||
|
||||
/// Check if the RTOS kernel is already started.
|
||||
/// \return 0 RTOS is not started, 1 RTOS is started.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
int32_t osKernelRunning(void);
|
||||
#endif
|
||||
|
||||
#if (defined(osFeature_SysTick) && (osFeature_SysTick != 0)) // System Timer available
|
||||
|
||||
/// Get the RTOS kernel system timer counter.
|
||||
/// \return RTOS kernel system timer as 32-bit value
|
||||
#if (osCMSIS < 0x20000U)
|
||||
uint32_t osKernelSysTick (void);
|
||||
#else
|
||||
#define osKernelSysTick osKernelGetSysTimerCount
|
||||
#endif
|
||||
|
||||
/// The RTOS kernel system timer frequency in Hz.
|
||||
/// \note Reflects the system timer setting and is typically defined in a configuration file.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
#define osKernelSysTickFrequency 100000000
|
||||
#endif
|
||||
|
||||
/// Convert a microseconds value to a RTOS kernel system timer value.
|
||||
/// \param microsec time value in microseconds.
|
||||
/// \return time value normalized to the \ref osKernelSysTickFrequency
|
||||
#if (osCMSIS < 0x20000U)
|
||||
#define osKernelSysTickMicroSec(microsec) (((uint64_t)microsec * (osKernelSysTickFrequency)) / 1000000)
|
||||
#else
|
||||
#define osKernelSysTickMicroSec(microsec) (((uint64_t)microsec * osKernelGetSysTimerFreq()) / 1000000)
|
||||
#endif
|
||||
|
||||
#endif // System Timer available
|
||||
|
||||
|
||||
// ==== Thread Management Functions ====
|
||||
|
||||
/// Create a Thread Definition with function, priority, and stack requirements.
|
||||
/// \param name name of the thread function.
|
||||
/// \param priority initial priority of the thread function.
|
||||
/// \param instances number of possible thread instances.
|
||||
/// \param stacksz stack size (in bytes) requirements for the thread function.
|
||||
#if defined (osObjectsExternal) // object is external
|
||||
#define osThreadDef(name, priority, instances, stacksz) \
|
||||
extern const osThreadDef_t os_thread_def_##name
|
||||
#else // define the object
|
||||
#define osThreadDef(name, priority, instances, stacksz) \
|
||||
static uint64_t os_thread_stack##name[(stacksz)?(((stacksz+7)/8)):1]; \
|
||||
static StaticTask_t os_thread_cb_##name; \
|
||||
const osThreadDef_t os_thread_def_##name = \
|
||||
{ (name), \
|
||||
{ NULL, osThreadDetached, \
|
||||
(instances == 1) ? (&os_thread_cb_##name) : NULL,\
|
||||
(instances == 1) ? sizeof(StaticTask_t) : 0U, \
|
||||
((stacksz) && (instances == 1)) ? (&os_thread_stack##name) : NULL, \
|
||||
8*((stacksz+7)/8), \
|
||||
(priority), 0U, 0U } }
|
||||
#endif
|
||||
|
||||
/// Access a Thread definition.
|
||||
/// \param name name of the thread definition object.
|
||||
#define osThread(name) \
|
||||
&os_thread_def_##name
|
||||
|
||||
/// Create a thread and add it to Active Threads and set it to state READY.
|
||||
/// \param[in] thread_def thread definition referenced with \ref osThread.
|
||||
/// \param[in] argument pointer that is passed to the thread function as start argument.
|
||||
/// \return thread ID for reference by other functions or NULL in case of error.
|
||||
osThreadId osThreadCreate (const osThreadDef_t *thread_def, void *argument);
|
||||
|
||||
/// Return the thread ID of the current running thread.
|
||||
/// \return thread ID for reference by other functions or NULL in case of error.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osThreadId osThreadGetId (void);
|
||||
#endif
|
||||
|
||||
/// Change priority of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadCreate or \ref osThreadGetId.
|
||||
/// \param[in] priority new priority value for the thread function.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osThreadSetPriority (osThreadId thread_id, osPriority priority);
|
||||
#endif
|
||||
|
||||
/// Get current priority of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadCreate or \ref osThreadGetId.
|
||||
/// \return current priority value of the specified thread.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osPriority osThreadGetPriority (osThreadId thread_id);
|
||||
#endif
|
||||
|
||||
/// Pass control to next thread that is in state \b READY.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osThreadYield (void);
|
||||
#endif
|
||||
|
||||
/// Terminate execution of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadCreate or \ref osThreadGetId.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osThreadTerminate (osThreadId thread_id);
|
||||
#endif
|
||||
|
||||
|
||||
// ==== Signal Management ====
|
||||
|
||||
/// Set the specified Signal Flags of an active thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadCreate or \ref osThreadGetId.
|
||||
/// \param[in] signals specifies the signal flags of the thread that should be set.
|
||||
/// \return previous signal flags of the specified thread or 0x80000000 in case of incorrect parameters.
|
||||
int32_t osSignalSet (osThreadId thread_id, int32_t signals);
|
||||
|
||||
/// Clear the specified Signal Flags of an active thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadCreate or \ref osThreadGetId.
|
||||
/// \param[in] signals specifies the signal flags of the thread that shall be cleared.
|
||||
/// \return previous signal flags of the specified thread or 0x80000000 in case of incorrect parameters or call from ISR.
|
||||
int32_t osSignalClear (osThreadId thread_id, int32_t signals);
|
||||
|
||||
/// Wait for one or more Signal Flags to become signaled for the current \b RUNNING thread.
|
||||
/// \param[in] signals wait until all specified signal flags set or 0 for any single signal flag.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return event flag information or error code.
|
||||
os_InRegs osEvent osSignalWait (int32_t signals, uint32_t millisec);
|
||||
|
||||
|
||||
// ==== Generic Wait Functions ====
|
||||
|
||||
/// Wait for Timeout (Time Delay).
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue "time delay" value
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osDelay (uint32_t millisec);
|
||||
#endif
|
||||
|
||||
#if (defined (osFeature_Wait) && (osFeature_Wait != 0)) // Generic Wait available
|
||||
|
||||
/// Wait for Signal, Message, Mail, or Timeout.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out
|
||||
/// \return event that contains signal, message, or mail information or error code.
|
||||
os_InRegs osEvent osWait (uint32_t millisec);
|
||||
|
||||
#endif // Generic Wait available
|
||||
|
||||
|
||||
// ==== Timer Management Functions ====
|
||||
|
||||
/// Define a Timer object.
|
||||
/// \param name name of the timer object.
|
||||
/// \param function name of the timer call back function.
|
||||
#if defined (osObjectsExternal) // object is external
|
||||
#define osTimerDef(name, function) \
|
||||
extern const osTimerDef_t os_timer_def_##name
|
||||
#else // define the object
|
||||
#define osTimerDef(name, function) \
|
||||
static StaticTimer_t os_timer_cb_##name; \
|
||||
const osTimerDef_t os_timer_def_##name = \
|
||||
{ (function), { NULL, 0U, (&os_timer_cb_##name), sizeof(StaticTimer_t) } }
|
||||
#endif
|
||||
|
||||
/// Access a Timer definition.
|
||||
/// \param name name of the timer object.
|
||||
#define osTimer(name) \
|
||||
&os_timer_def_##name
|
||||
|
||||
/// Create and Initialize a timer.
|
||||
/// \param[in] timer_def timer object referenced with \ref osTimer.
|
||||
/// \param[in] type osTimerOnce for one-shot or osTimerPeriodic for periodic behavior.
|
||||
/// \param[in] argument argument to the timer call back function.
|
||||
/// \return timer ID for reference by other functions or NULL in case of error.
|
||||
osTimerId osTimerCreate (const osTimerDef_t *timer_def, os_timer_type type, void *argument);
|
||||
|
||||
/// Start or restart a timer.
|
||||
/// \param[in] timer_id timer ID obtained by \ref osTimerCreate.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue "time delay" value of the timer.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osTimerStart (osTimerId timer_id, uint32_t millisec);
|
||||
#endif
|
||||
|
||||
/// Stop a timer.
|
||||
/// \param[in] timer_id timer ID obtained by \ref osTimerCreate.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osTimerStop (osTimerId timer_id);
|
||||
#endif
|
||||
|
||||
/// Delete a timer.
|
||||
/// \param[in] timer_id timer ID obtained by \ref osTimerCreate.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osTimerDelete (osTimerId timer_id);
|
||||
#endif
|
||||
|
||||
|
||||
// ==== Mutex Management Functions ====
|
||||
|
||||
/// Define a Mutex.
|
||||
/// \param name name of the mutex object.
|
||||
#if defined (osObjectsExternal) // object is external
|
||||
#define osMutexDef(name) \
|
||||
extern const osMutexDef_t os_mutex_def_##name
|
||||
#else // define the object
|
||||
#define osMutexDef(name) \
|
||||
static StaticSemaphore_t os_mutex_cb_##name; \
|
||||
const osMutexDef_t os_mutex_def_##name = \
|
||||
{ NULL, osMutexRecursive | osMutexPrioInherit, (&os_mutex_cb_##name), sizeof(StaticSemaphore_t) }
|
||||
#endif
|
||||
|
||||
/// Access a Mutex definition.
|
||||
/// \param name name of the mutex object.
|
||||
#define osMutex(name) \
|
||||
&os_mutex_def_##name
|
||||
|
||||
/// Create and Initialize a Mutex object.
|
||||
/// \param[in] mutex_def mutex definition referenced with \ref osMutex.
|
||||
/// \return mutex ID for reference by other functions or NULL in case of error.
|
||||
osMutexId osMutexCreate (const osMutexDef_t *mutex_def);
|
||||
|
||||
/// Wait until a Mutex becomes available.
|
||||
/// \param[in] mutex_id mutex ID obtained by \ref osMutexCreate.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osMutexWait (osMutexId mutex_id, uint32_t millisec);
|
||||
#else
|
||||
#define osMutexWait osMutexAcquire
|
||||
#endif
|
||||
|
||||
/// Release a Mutex that was obtained by \ref osMutexWait.
|
||||
/// \param[in] mutex_id mutex ID obtained by \ref osMutexCreate.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osMutexRelease (osMutexId mutex_id);
|
||||
#endif
|
||||
|
||||
/// Delete a Mutex object.
|
||||
/// \param[in] mutex_id mutex ID obtained by \ref osMutexCreate.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osMutexDelete (osMutexId mutex_id);
|
||||
#endif
|
||||
|
||||
|
||||
// ==== Semaphore Management Functions ====
|
||||
|
||||
#if (defined (osFeature_Semaphore) && (osFeature_Semaphore != 0U)) // Semaphore available
|
||||
|
||||
/// Define a Semaphore object.
|
||||
/// \param name name of the semaphore object.
|
||||
#if defined (osObjectsExternal) // object is external
|
||||
#define osSemaphoreDef(name) \
|
||||
extern const osSemaphoreDef_t os_semaphore_def_##name
|
||||
#else // define the object
|
||||
#define osSemaphoreDef(name) \
|
||||
static StaticSemaphore_t os_semaphore_cb_##name; \
|
||||
const osSemaphoreDef_t os_semaphore_def_##name = \
|
||||
{ NULL, 0U, (&os_semaphore_cb_##name), sizeof(StaticSemaphore_t) }
|
||||
#endif
|
||||
|
||||
/// Access a Semaphore definition.
|
||||
/// \param name name of the semaphore object.
|
||||
#define osSemaphore(name) \
|
||||
&os_semaphore_def_##name
|
||||
|
||||
/// Create and Initialize a Semaphore object.
|
||||
/// \param[in] semaphore_def semaphore definition referenced with \ref osSemaphore.
|
||||
/// \param[in] count maximum and initial number of available tokens.
|
||||
/// \return semaphore ID for reference by other functions or NULL in case of error.
|
||||
osSemaphoreId osSemaphoreCreate (const osSemaphoreDef_t *semaphore_def, int32_t count);
|
||||
|
||||
/// Wait until a Semaphore token becomes available.
|
||||
/// \param[in] semaphore_id semaphore object referenced with \ref osSemaphoreCreate.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return number of available tokens, or -1 in case of incorrect parameters.
|
||||
int32_t osSemaphoreWait (osSemaphoreId semaphore_id, uint32_t millisec);
|
||||
|
||||
/// Release a Semaphore token.
|
||||
/// \param[in] semaphore_id semaphore object referenced with \ref osSemaphoreCreate.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osSemaphoreRelease (osSemaphoreId semaphore_id);
|
||||
#endif
|
||||
|
||||
/// Delete a Semaphore object.
|
||||
/// \param[in] semaphore_id semaphore object referenced with \ref osSemaphoreCreate.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
#if (osCMSIS < 0x20000U)
|
||||
osStatus osSemaphoreDelete (osSemaphoreId semaphore_id);
|
||||
#endif
|
||||
|
||||
#endif // Semaphore available
|
||||
|
||||
|
||||
// ==== Memory Pool Management Functions ====
|
||||
|
||||
#if (defined(osFeature_Pool) && (osFeature_Pool != 0)) // Memory Pool available
|
||||
|
||||
/// \brief Define a Memory Pool.
|
||||
/// \param name name of the memory pool.
|
||||
/// \param no maximum number of blocks (objects) in the memory pool.
|
||||
/// \param type data type of a single block (object).
|
||||
#if defined (osObjectsExternal) // object is external
|
||||
#define osPoolDef(name, no, type) \
|
||||
extern const osPoolDef_t os_pool_def_##name
|
||||
#else // define the object
|
||||
#define osPoolDef(name, no, type) \
|
||||
const osPoolDef_t os_pool_def_##name = \
|
||||
{ (no), sizeof(type), {NULL} }
|
||||
#endif
|
||||
|
||||
/// \brief Access a Memory Pool definition.
|
||||
/// \param name name of the memory pool
|
||||
#define osPool(name) \
|
||||
&os_pool_def_##name
|
||||
|
||||
/// Create and Initialize a Memory Pool object.
|
||||
/// \param[in] pool_def memory pool definition referenced with \ref osPool.
|
||||
/// \return memory pool ID for reference by other functions or NULL in case of error.
|
||||
osPoolId osPoolCreate (const osPoolDef_t *pool_def);
|
||||
|
||||
/// Allocate a memory block from a Memory Pool.
|
||||
/// \param[in] pool_id memory pool ID obtain referenced with \ref osPoolCreate.
|
||||
/// \return address of the allocated memory block or NULL in case of no memory available.
|
||||
void *osPoolAlloc (osPoolId pool_id);
|
||||
|
||||
/// Allocate a memory block from a Memory Pool and set memory block to zero.
|
||||
/// \param[in] pool_id memory pool ID obtain referenced with \ref osPoolCreate.
|
||||
/// \return address of the allocated memory block or NULL in case of no memory available.
|
||||
void *osPoolCAlloc (osPoolId pool_id);
|
||||
|
||||
/// Return an allocated memory block back to a Memory Pool.
|
||||
/// \param[in] pool_id memory pool ID obtain referenced with \ref osPoolCreate.
|
||||
/// \param[in] block address of the allocated memory block to be returned to the memory pool.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus osPoolFree (osPoolId pool_id, void *block);
|
||||
|
||||
#endif // Memory Pool available
|
||||
|
||||
|
||||
// ==== Message Queue Management Functions ====
|
||||
|
||||
#if (defined(osFeature_MessageQ) && (osFeature_MessageQ != 0)) // Message Queue available
|
||||
|
||||
/// \brief Create a Message Queue Definition.
|
||||
/// \param name name of the queue.
|
||||
/// \param queue_sz maximum number of messages in the queue.
|
||||
/// \param type data type of a single message element (for debugger).
|
||||
#if defined (osObjectsExternal) // object is external
|
||||
#define osMessageQDef(name, queue_sz, type) \
|
||||
extern const osMessageQDef_t os_messageQ_def_##name
|
||||
#else // define the object
|
||||
#define osMessageQDef(name, queue_sz, type) \
|
||||
static StaticQueue_t os_mq_cb_##name; \
|
||||
static uint32_t os_mq_data_##name[(queue_sz) * sizeof(type)]; \
|
||||
const osMessageQDef_t os_messageQ_def_##name = \
|
||||
{ (queue_sz), \
|
||||
{ NULL, 0U, (&os_mq_cb_##name), sizeof(StaticQueue_t), \
|
||||
(&os_mq_data_##name), sizeof(os_mq_data_##name) } }
|
||||
#endif
|
||||
|
||||
/// \brief Access a Message Queue Definition.
|
||||
/// \param name name of the queue
|
||||
#define osMessageQ(name) \
|
||||
&os_messageQ_def_##name
|
||||
|
||||
/// Create and Initialize a Message Queue object.
|
||||
/// \param[in] queue_def message queue definition referenced with \ref osMessageQ.
|
||||
/// \param[in] thread_id thread ID (obtained by \ref osThreadCreate or \ref osThreadGetId) or NULL.
|
||||
/// \return message queue ID for reference by other functions or NULL in case of error.
|
||||
osMessageQId osMessageCreate (const osMessageQDef_t *queue_def, osThreadId thread_id);
|
||||
|
||||
/// Put a Message to a Queue.
|
||||
/// \param[in] queue_id message queue ID obtained with \ref osMessageCreate.
|
||||
/// \param[in] info message information.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus osMessagePut (osMessageQId queue_id, uint32_t info, uint32_t millisec);
|
||||
|
||||
/// Get a Message from a Queue or timeout if Queue is empty.
|
||||
/// \param[in] queue_id message queue ID obtained with \ref osMessageCreate.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return event information that includes status code.
|
||||
os_InRegs osEvent osMessageGet (osMessageQId queue_id, uint32_t millisec);
|
||||
|
||||
#endif // Message Queue available
|
||||
|
||||
|
||||
// ==== Mail Queue Management Functions ====
|
||||
|
||||
#if (defined(osFeature_MailQ) && (osFeature_MailQ != 0)) // Mail Queue available
|
||||
|
||||
/// \brief Create a Mail Queue Definition.
|
||||
/// \param name name of the queue.
|
||||
/// \param queue_sz maximum number of mails in the queue.
|
||||
/// \param type data type of a single mail element.
|
||||
#if defined (osObjectsExternal) // object is external
|
||||
#define osMailQDef(name, queue_sz, type) \
|
||||
extern const osMailQDef_t os_mailQ_def_##name
|
||||
#else // define the object
|
||||
#define osMailQDef(name, queue_sz, type) \
|
||||
const osMailQDef_t os_mailQ_def_##name = \
|
||||
{ (queue_sz), sizeof(type), NULL }
|
||||
#endif
|
||||
|
||||
/// \brief Access a Mail Queue Definition.
|
||||
/// \param name name of the queue
|
||||
#define osMailQ(name) \
|
||||
&os_mailQ_def_##name
|
||||
|
||||
/// Create and Initialize a Mail Queue object.
|
||||
/// \param[in] queue_def mail queue definition referenced with \ref osMailQ.
|
||||
/// \param[in] thread_id thread ID (obtained by \ref osThreadCreate or \ref osThreadGetId) or NULL.
|
||||
/// \return mail queue ID for reference by other functions or NULL in case of error.
|
||||
osMailQId osMailCreate (const osMailQDef_t *queue_def, osThreadId thread_id);
|
||||
|
||||
/// Allocate a memory block for mail from a mail memory pool.
|
||||
/// \param[in] queue_id mail queue ID obtained with \ref osMailCreate.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out
|
||||
/// \return pointer to memory block that can be filled with mail or NULL in case of error.
|
||||
void *osMailAlloc (osMailQId queue_id, uint32_t millisec);
|
||||
|
||||
/// Allocate a memory block for mail from a mail memory pool and set memory block to zero.
|
||||
/// \param[in] queue_id mail queue ID obtained with \ref osMailCreate.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out
|
||||
/// \return pointer to memory block that can be filled with mail or NULL in case of error.
|
||||
void *osMailCAlloc (osMailQId queue_id, uint32_t millisec);
|
||||
|
||||
/// Put a Mail into a Queue.
|
||||
/// \param[in] queue_id mail queue ID obtained with \ref osMailCreate.
|
||||
/// \param[in] mail pointer to memory with mail to put into a queue.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus osMailPut (osMailQId queue_id, const void *mail);
|
||||
|
||||
/// Get a Mail from a Queue or timeout if Queue is empty.
|
||||
/// \param[in] queue_id mail queue ID obtained with \ref osMailCreate.
|
||||
/// \param[in] millisec \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return event information that includes status code.
|
||||
os_InRegs osEvent osMailGet (osMailQId queue_id, uint32_t millisec);
|
||||
|
||||
/// Free a memory block by returning it to a mail memory pool.
|
||||
/// \param[in] queue_id mail queue ID obtained with \ref osMailCreate.
|
||||
/// \param[in] mail pointer to memory block that was obtained with \ref osMailGet.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus osMailFree (osMailQId queue_id, void *mail);
|
||||
|
||||
#endif // Mail Queue available
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif // CMSIS_OS_H_
|
||||
2482
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/cmsis_os2.c
vendored
Normal file
2482
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/cmsis_os2.c
vendored
Normal file
@@ -0,0 +1,2482 @@
|
||||
/* --------------------------------------------------------------------------
|
||||
* Copyright (c) 2013-2020 Arm Limited. All rights reserved.
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the License); you may
|
||||
* not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an AS IS BASIS, WITHOUT
|
||||
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* Name: cmsis_os2.c
|
||||
* Purpose: CMSIS RTOS2 wrapper for FreeRTOS
|
||||
*
|
||||
*---------------------------------------------------------------------------*/
|
||||
|
||||
#include <string.h>
|
||||
|
||||
#include "cmsis_os2.h" // ::CMSIS:RTOS2
|
||||
#include "cmsis_compiler.h" // Compiler agnostic definitions
|
||||
|
||||
#include "FreeRTOS.h" // ARM.FreeRTOS::RTOS:Core
|
||||
#include "task.h" // ARM.FreeRTOS::RTOS:Core
|
||||
#include "event_groups.h" // ARM.FreeRTOS::RTOS:Event Groups
|
||||
#include "semphr.h" // ARM.FreeRTOS::RTOS:Core
|
||||
|
||||
#include "freertos_mpool.h" // osMemoryPool definitions
|
||||
#include "freertos_os2.h" // Configuration check and setup
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
#ifndef __ARM_ARCH_6M__
|
||||
#define __ARM_ARCH_6M__ 0
|
||||
#endif
|
||||
#ifndef __ARM_ARCH_7M__
|
||||
#define __ARM_ARCH_7M__ 0
|
||||
#endif
|
||||
#ifndef __ARM_ARCH_7EM__
|
||||
#define __ARM_ARCH_7EM__ 0
|
||||
#endif
|
||||
#ifndef __ARM_ARCH_8M_MAIN__
|
||||
#define __ARM_ARCH_8M_MAIN__ 0
|
||||
#endif
|
||||
#ifndef __ARM_ARCH_7A__
|
||||
#define __ARM_ARCH_7A__ 0
|
||||
#endif
|
||||
|
||||
#if ((__ARM_ARCH_7M__ == 1U) || \
|
||||
(__ARM_ARCH_7EM__ == 1U) || \
|
||||
(__ARM_ARCH_8M_MAIN__ == 1U))
|
||||
#define IS_IRQ_MASKED() ((__get_PRIMASK() != 0U) || (__get_BASEPRI() != 0U))
|
||||
#elif (__ARM_ARCH_6M__ == 1U)
|
||||
#define IS_IRQ_MASKED() (__get_PRIMASK() != 0U)
|
||||
#elif (__ARM_ARCH_7A__ == 1U)
|
||||
/* CPSR mask bits */
|
||||
#define CPSR_MASKBIT_I 0x80U
|
||||
|
||||
#define IS_IRQ_MASKED() ((__get_CPSR() & CPSR_MASKBIT_I) != 0U)
|
||||
#else
|
||||
#define IS_IRQ_MASKED() (__get_PRIMASK() != 0U)
|
||||
#endif
|
||||
|
||||
#if (__ARM_ARCH_7A__ == 1U)
|
||||
/* CPSR mode bitmasks */
|
||||
#define CPSR_MODE_USER 0x10U
|
||||
#define CPSR_MODE_SYSTEM 0x1FU
|
||||
|
||||
#define IS_IRQ_MODE() ((__get_mode() != CPSR_MODE_USER) && (__get_mode() != CPSR_MODE_SYSTEM))
|
||||
#else
|
||||
#define IS_IRQ_MODE() (__get_IPSR() != 0U)
|
||||
#endif
|
||||
|
||||
#define IS_IRQ() IS_IRQ_MODE()
|
||||
|
||||
#define SVCall_IRQ_NBR (IRQn_Type) -5 /* SVCall_IRQ_NBR added as SV_Call handler name is not the same for CM0 and for all other CMx */
|
||||
|
||||
/* Limits */
|
||||
#define MAX_BITS_TASK_NOTIFY 31U
|
||||
#define MAX_BITS_EVENT_GROUPS 24U
|
||||
|
||||
#define THREAD_FLAGS_INVALID_BITS (~((1UL << MAX_BITS_TASK_NOTIFY) - 1U))
|
||||
#define EVENT_FLAGS_INVALID_BITS (~((1UL << MAX_BITS_EVENT_GROUPS) - 1U))
|
||||
|
||||
/* Kernel version and identification string definition (major.minor.rev: mmnnnrrrr dec) */
|
||||
#define KERNEL_VERSION (((uint32_t)tskKERNEL_VERSION_MAJOR * 10000000UL) | \
|
||||
((uint32_t)tskKERNEL_VERSION_MINOR * 10000UL) | \
|
||||
((uint32_t)tskKERNEL_VERSION_BUILD * 1UL))
|
||||
|
||||
#define KERNEL_ID ("FreeRTOS " tskKERNEL_VERSION_NUMBER)
|
||||
|
||||
/* Timer callback information structure definition */
|
||||
typedef struct {
|
||||
osTimerFunc_t func;
|
||||
void *arg;
|
||||
} TimerCallback_t;
|
||||
|
||||
/* Kernel initialization state */
|
||||
static osKernelState_t KernelState = osKernelInactive;
|
||||
|
||||
/*
|
||||
Heap region definition used by heap_5 variant
|
||||
|
||||
Define configAPPLICATION_ALLOCATED_HEAP as nonzero value in FreeRTOSConfig.h if
|
||||
heap regions are already defined and vPortDefineHeapRegions is called in application.
|
||||
|
||||
Otherwise vPortDefineHeapRegions will be called by osKernelInitialize using
|
||||
definition configHEAP_5_REGIONS as parameter. Overriding configHEAP_5_REGIONS
|
||||
is possible by defining it globally or in FreeRTOSConfig.h.
|
||||
*/
|
||||
#if defined(USE_FreeRTOS_HEAP_5)
|
||||
#if (configAPPLICATION_ALLOCATED_HEAP == 0)
|
||||
/*
|
||||
FreeRTOS heap is not defined by the application.
|
||||
Single region of size configTOTAL_HEAP_SIZE (defined in FreeRTOSConfig.h)
|
||||
is provided by default. Define configHEAP_5_REGIONS to provide custom
|
||||
HeapRegion_t array.
|
||||
*/
|
||||
#define HEAP_5_REGION_SETUP 1
|
||||
|
||||
#ifndef configHEAP_5_REGIONS
|
||||
#define configHEAP_5_REGIONS xHeapRegions
|
||||
|
||||
static uint8_t ucHeap[configTOTAL_HEAP_SIZE];
|
||||
|
||||
static HeapRegion_t xHeapRegions[] = {
|
||||
{ ucHeap, configTOTAL_HEAP_SIZE },
|
||||
{ NULL, 0 }
|
||||
};
|
||||
#else
|
||||
/* Global definition is provided to override default heap array */
|
||||
extern HeapRegion_t configHEAP_5_REGIONS[];
|
||||
#endif
|
||||
#else
|
||||
/*
|
||||
The application already defined the array used for the FreeRTOS heap and
|
||||
called vPortDefineHeapRegions to initialize heap.
|
||||
*/
|
||||
#define HEAP_5_REGION_SETUP 0
|
||||
#endif /* configAPPLICATION_ALLOCATED_HEAP */
|
||||
#endif /* USE_FreeRTOS_HEAP_5 */
|
||||
|
||||
#if defined(SysTick)
|
||||
#undef SysTick_Handler
|
||||
|
||||
/* CMSIS SysTick interrupt handler prototype */
|
||||
extern void SysTick_Handler (void);
|
||||
/* FreeRTOS tick timer interrupt handler prototype */
|
||||
extern void xPortSysTickHandler (void);
|
||||
|
||||
/*
|
||||
SysTick handler implementation that also clears overflow flag.
|
||||
*/
|
||||
#if (USE_CUSTOM_SYSTICK_HANDLER_IMPLEMENTATION == 0)
|
||||
void SysTick_Handler (void) {
|
||||
/* Clear overflow flag */
|
||||
SysTick->CTRL;
|
||||
|
||||
if (xTaskGetSchedulerState() != taskSCHEDULER_NOT_STARTED) {
|
||||
/* Call tick handler */
|
||||
xPortSysTickHandler();
|
||||
}
|
||||
}
|
||||
#endif
|
||||
#endif /* SysTick */
|
||||
|
||||
/*
|
||||
Setup SVC to reset value.
|
||||
*/
|
||||
__STATIC_INLINE void SVC_Setup (void) {
|
||||
#if (__ARM_ARCH_7A__ == 0U)
|
||||
/* Service Call interrupt might be configured before kernel start */
|
||||
/* and when its priority is lower or equal to BASEPRI, svc intruction */
|
||||
/* causes a Hard Fault. */
|
||||
NVIC_SetPriority (SVCall_IRQ_NBR, 0U);
|
||||
#endif
|
||||
}
|
||||
|
||||
/*
|
||||
Function macro used to retrieve semaphore count from ISR
|
||||
*/
|
||||
#ifndef uxSemaphoreGetCountFromISR
|
||||
#define uxSemaphoreGetCountFromISR( xSemaphore ) uxQueueMessagesWaitingFromISR( ( QueueHandle_t ) ( xSemaphore ) )
|
||||
#endif
|
||||
|
||||
/* Get OS Tick count value */
|
||||
static uint32_t OS_Tick_GetCount (void);
|
||||
/* Get OS Tick overflow status */
|
||||
static uint32_t OS_Tick_GetOverflow (void);
|
||||
/* Get OS Tick interval */
|
||||
static uint32_t OS_Tick_GetInterval (void);
|
||||
/*---------------------------------------------------------------------------*/
|
||||
|
||||
osStatus_t osKernelInitialize (void) {
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else {
|
||||
if (KernelState == osKernelInactive) {
|
||||
#if defined(USE_TRACE_EVENT_RECORDER)
|
||||
EvrFreeRTOSSetup(0U);
|
||||
#endif
|
||||
#if defined(USE_FreeRTOS_HEAP_5) && (HEAP_5_REGION_SETUP == 1)
|
||||
vPortDefineHeapRegions (configHEAP_5_REGIONS);
|
||||
#endif
|
||||
KernelState = osKernelReady;
|
||||
stat = osOK;
|
||||
} else {
|
||||
stat = osError;
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osStatus_t osKernelGetInfo (osVersion_t *version, char *id_buf, uint32_t id_size) {
|
||||
|
||||
if (version != NULL) {
|
||||
/* Version encoding is major.minor.rev: mmnnnrrrr dec */
|
||||
version->api = KERNEL_VERSION;
|
||||
version->kernel = KERNEL_VERSION;
|
||||
}
|
||||
|
||||
if ((id_buf != NULL) && (id_size != 0U)) {
|
||||
if (id_size > sizeof(KERNEL_ID)) {
|
||||
id_size = sizeof(KERNEL_ID);
|
||||
}
|
||||
memcpy(id_buf, KERNEL_ID, id_size);
|
||||
}
|
||||
|
||||
return (osOK);
|
||||
}
|
||||
|
||||
osKernelState_t osKernelGetState (void) {
|
||||
osKernelState_t state;
|
||||
|
||||
switch (xTaskGetSchedulerState()) {
|
||||
case taskSCHEDULER_RUNNING:
|
||||
state = osKernelRunning;
|
||||
break;
|
||||
|
||||
case taskSCHEDULER_SUSPENDED:
|
||||
state = osKernelLocked;
|
||||
break;
|
||||
|
||||
case taskSCHEDULER_NOT_STARTED:
|
||||
default:
|
||||
if (KernelState == osKernelReady) {
|
||||
state = osKernelReady;
|
||||
} else {
|
||||
state = osKernelInactive;
|
||||
}
|
||||
break;
|
||||
}
|
||||
|
||||
return (state);
|
||||
}
|
||||
|
||||
osStatus_t osKernelStart (void) {
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else {
|
||||
if (KernelState == osKernelReady) {
|
||||
/* Ensure SVC priority is at the reset value */
|
||||
SVC_Setup();
|
||||
/* Change state to enable IRQ masking check */
|
||||
KernelState = osKernelRunning;
|
||||
/* Start the kernel scheduler */
|
||||
vTaskStartScheduler();
|
||||
stat = osOK;
|
||||
} else {
|
||||
stat = osError;
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
int32_t osKernelLock (void) {
|
||||
int32_t lock;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
lock = (int32_t)osErrorISR;
|
||||
}
|
||||
else {
|
||||
switch (xTaskGetSchedulerState()) {
|
||||
case taskSCHEDULER_SUSPENDED:
|
||||
lock = 1;
|
||||
break;
|
||||
|
||||
case taskSCHEDULER_RUNNING:
|
||||
vTaskSuspendAll();
|
||||
lock = 0;
|
||||
break;
|
||||
|
||||
case taskSCHEDULER_NOT_STARTED:
|
||||
default:
|
||||
lock = (int32_t)osError;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return (lock);
|
||||
}
|
||||
|
||||
int32_t osKernelUnlock (void) {
|
||||
int32_t lock;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
lock = (int32_t)osErrorISR;
|
||||
}
|
||||
else {
|
||||
switch (xTaskGetSchedulerState()) {
|
||||
case taskSCHEDULER_SUSPENDED:
|
||||
lock = 1;
|
||||
|
||||
if (xTaskResumeAll() != pdTRUE) {
|
||||
if (xTaskGetSchedulerState() == taskSCHEDULER_SUSPENDED) {
|
||||
lock = (int32_t)osError;
|
||||
}
|
||||
}
|
||||
break;
|
||||
|
||||
case taskSCHEDULER_RUNNING:
|
||||
lock = 0;
|
||||
break;
|
||||
|
||||
case taskSCHEDULER_NOT_STARTED:
|
||||
default:
|
||||
lock = (int32_t)osError;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return (lock);
|
||||
}
|
||||
|
||||
int32_t osKernelRestoreLock (int32_t lock) {
|
||||
|
||||
if (IS_IRQ()) {
|
||||
lock = (int32_t)osErrorISR;
|
||||
}
|
||||
else {
|
||||
switch (xTaskGetSchedulerState()) {
|
||||
case taskSCHEDULER_SUSPENDED:
|
||||
case taskSCHEDULER_RUNNING:
|
||||
if (lock == 1) {
|
||||
vTaskSuspendAll();
|
||||
}
|
||||
else {
|
||||
if (lock != 0) {
|
||||
lock = (int32_t)osError;
|
||||
}
|
||||
else {
|
||||
if (xTaskResumeAll() != pdTRUE) {
|
||||
if (xTaskGetSchedulerState() != taskSCHEDULER_RUNNING) {
|
||||
lock = (int32_t)osError;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
break;
|
||||
|
||||
case taskSCHEDULER_NOT_STARTED:
|
||||
default:
|
||||
lock = (int32_t)osError;
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return (lock);
|
||||
}
|
||||
|
||||
uint32_t osKernelGetTickCount (void) {
|
||||
TickType_t ticks;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
ticks = xTaskGetTickCountFromISR();
|
||||
} else {
|
||||
ticks = xTaskGetTickCount();
|
||||
}
|
||||
|
||||
return (ticks);
|
||||
}
|
||||
|
||||
uint32_t osKernelGetTickFreq (void) {
|
||||
return (configTICK_RATE_HZ);
|
||||
}
|
||||
|
||||
/* Get OS Tick count value */
|
||||
static uint32_t OS_Tick_GetCount (void) {
|
||||
uint32_t load = SysTick->LOAD;
|
||||
return (load - SysTick->VAL);
|
||||
}
|
||||
|
||||
/* Get OS Tick overflow status */
|
||||
static uint32_t OS_Tick_GetOverflow (void) {
|
||||
return ((SysTick->CTRL >> 16) & 1U);
|
||||
}
|
||||
|
||||
/* Get OS Tick interval */
|
||||
static uint32_t OS_Tick_GetInterval (void) {
|
||||
return (SysTick->LOAD + 1U);
|
||||
}
|
||||
|
||||
uint32_t osKernelGetSysTimerCount (void) {
|
||||
uint32_t irqmask = IS_IRQ_MASKED();
|
||||
TickType_t ticks;
|
||||
uint32_t val;
|
||||
|
||||
__disable_irq();
|
||||
|
||||
ticks = xTaskGetTickCount();
|
||||
val = OS_Tick_GetCount();
|
||||
|
||||
if (OS_Tick_GetOverflow() != 0U) {
|
||||
val = OS_Tick_GetCount();
|
||||
ticks++;
|
||||
}
|
||||
val += ticks * OS_Tick_GetInterval();
|
||||
|
||||
if (irqmask == 0U) {
|
||||
__enable_irq();
|
||||
}
|
||||
|
||||
return (val);
|
||||
}
|
||||
|
||||
uint32_t osKernelGetSysTimerFreq (void) {
|
||||
return (configCPU_CLOCK_HZ);
|
||||
}
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
|
||||
osThreadId_t osThreadNew (osThreadFunc_t func, void *argument, const osThreadAttr_t *attr) {
|
||||
const char *name;
|
||||
uint32_t stack;
|
||||
TaskHandle_t hTask;
|
||||
UBaseType_t prio;
|
||||
int32_t mem;
|
||||
|
||||
hTask = NULL;
|
||||
|
||||
if (!IS_IRQ() && (func != NULL)) {
|
||||
stack = configMINIMAL_STACK_SIZE;
|
||||
prio = (UBaseType_t)osPriorityNormal;
|
||||
|
||||
name = NULL;
|
||||
mem = -1;
|
||||
|
||||
if (attr != NULL) {
|
||||
if (attr->name != NULL) {
|
||||
name = attr->name;
|
||||
}
|
||||
if (attr->priority != osPriorityNone) {
|
||||
prio = (UBaseType_t)attr->priority;
|
||||
}
|
||||
|
||||
if ((prio < osPriorityIdle) || (prio > osPriorityISR) || ((attr->attr_bits & osThreadJoinable) == osThreadJoinable)) {
|
||||
return (NULL);
|
||||
}
|
||||
|
||||
if (attr->stack_size > 0U) {
|
||||
/* In FreeRTOS stack is not in bytes, but in sizeof(StackType_t) which is 4 on ARM ports. */
|
||||
/* Stack size should be therefore 4 byte aligned in order to avoid division caused side effects */
|
||||
stack = attr->stack_size / sizeof(StackType_t);
|
||||
}
|
||||
|
||||
if ((attr->cb_mem != NULL) && (attr->cb_size >= sizeof(StaticTask_t)) &&
|
||||
(attr->stack_mem != NULL) && (attr->stack_size > 0U)) {
|
||||
mem = 1;
|
||||
}
|
||||
else {
|
||||
if ((attr->cb_mem == NULL) && (attr->cb_size == 0U) && (attr->stack_mem == NULL)) {
|
||||
mem = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
mem = 0;
|
||||
}
|
||||
|
||||
if (mem == 1) {
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
hTask = xTaskCreateStatic ((TaskFunction_t)func, name, stack, argument, prio, (StackType_t *)attr->stack_mem,
|
||||
(StaticTask_t *)attr->cb_mem);
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
if (mem == 0) {
|
||||
#if (configSUPPORT_DYNAMIC_ALLOCATION == 1)
|
||||
if (xTaskCreate ((TaskFunction_t)func, name, (uint16_t)stack, argument, prio, &hTask) != pdPASS) {
|
||||
hTask = NULL;
|
||||
}
|
||||
#endif
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return ((osThreadId_t)hTask);
|
||||
}
|
||||
|
||||
const char *osThreadGetName (osThreadId_t thread_id) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
const char *name;
|
||||
|
||||
if (IS_IRQ() || (hTask == NULL)) {
|
||||
name = NULL;
|
||||
} else {
|
||||
name = pcTaskGetName (hTask);
|
||||
}
|
||||
|
||||
return (name);
|
||||
}
|
||||
|
||||
osThreadId_t osThreadGetId (void) {
|
||||
osThreadId_t id;
|
||||
|
||||
id = (osThreadId_t)xTaskGetCurrentTaskHandle();
|
||||
|
||||
return (id);
|
||||
}
|
||||
|
||||
osThreadState_t osThreadGetState (osThreadId_t thread_id) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
osThreadState_t state;
|
||||
|
||||
if (IS_IRQ() || (hTask == NULL)) {
|
||||
state = osThreadError;
|
||||
}
|
||||
else {
|
||||
switch (eTaskGetState (hTask)) {
|
||||
case eRunning: state = osThreadRunning; break;
|
||||
case eReady: state = osThreadReady; break;
|
||||
case eBlocked:
|
||||
case eSuspended: state = osThreadBlocked; break;
|
||||
case eDeleted: state = osThreadTerminated; break;
|
||||
case eInvalid:
|
||||
default: state = osThreadError; break;
|
||||
}
|
||||
}
|
||||
|
||||
return (state);
|
||||
}
|
||||
|
||||
uint32_t osThreadGetStackSpace (osThreadId_t thread_id) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
uint32_t sz;
|
||||
|
||||
if (IS_IRQ() || (hTask == NULL)) {
|
||||
sz = 0U;
|
||||
} else {
|
||||
sz = (uint32_t)(uxTaskGetStackHighWaterMark(hTask) * sizeof(StackType_t));
|
||||
}
|
||||
|
||||
return (sz);
|
||||
}
|
||||
|
||||
osStatus_t osThreadSetPriority (osThreadId_t thread_id, osPriority_t priority) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if ((hTask == NULL) || (priority < osPriorityIdle) || (priority > osPriorityISR)) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
stat = osOK;
|
||||
vTaskPrioritySet (hTask, (UBaseType_t)priority);
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osPriority_t osThreadGetPriority (osThreadId_t thread_id) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
osPriority_t prio;
|
||||
|
||||
if (IS_IRQ() || (hTask == NULL)) {
|
||||
prio = osPriorityError;
|
||||
} else {
|
||||
prio = (osPriority_t)((int32_t)uxTaskPriorityGet (hTask));
|
||||
}
|
||||
|
||||
return (prio);
|
||||
}
|
||||
|
||||
osStatus_t osThreadYield (void) {
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
} else {
|
||||
stat = osOK;
|
||||
taskYIELD();
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
#if (configUSE_OS2_THREAD_SUSPEND_RESUME == 1)
|
||||
osStatus_t osThreadSuspend (osThreadId_t thread_id) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hTask == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
stat = osOK;
|
||||
vTaskSuspend (hTask);
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osStatus_t osThreadResume (osThreadId_t thread_id) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hTask == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
stat = osOK;
|
||||
vTaskResume (hTask);
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
#endif /* (configUSE_OS2_THREAD_SUSPEND_RESUME == 1) */
|
||||
|
||||
__NO_RETURN void osThreadExit (void) {
|
||||
#ifndef USE_FreeRTOS_HEAP_1
|
||||
vTaskDelete (NULL);
|
||||
#endif
|
||||
for (;;);
|
||||
}
|
||||
|
||||
osStatus_t osThreadTerminate (osThreadId_t thread_id) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
osStatus_t stat;
|
||||
#ifndef USE_FreeRTOS_HEAP_1
|
||||
eTaskState tstate;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hTask == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
tstate = eTaskGetState (hTask);
|
||||
|
||||
if (tstate != eDeleted) {
|
||||
stat = osOK;
|
||||
vTaskDelete (hTask);
|
||||
} else {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
#else
|
||||
stat = osError;
|
||||
#endif
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
uint32_t osThreadGetCount (void) {
|
||||
uint32_t count;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
count = 0U;
|
||||
} else {
|
||||
count = uxTaskGetNumberOfTasks();
|
||||
}
|
||||
|
||||
return (count);
|
||||
}
|
||||
|
||||
#if (configUSE_OS2_THREAD_ENUMERATE == 1)
|
||||
uint32_t osThreadEnumerate (osThreadId_t *thread_array, uint32_t array_items) {
|
||||
uint32_t i, count;
|
||||
TaskStatus_t *task;
|
||||
|
||||
if (IS_IRQ() || (thread_array == NULL) || (array_items == 0U)) {
|
||||
count = 0U;
|
||||
} else {
|
||||
vTaskSuspendAll();
|
||||
|
||||
count = uxTaskGetNumberOfTasks();
|
||||
task = pvPortMalloc (count * sizeof(TaskStatus_t));
|
||||
|
||||
if (task != NULL) {
|
||||
count = uxTaskGetSystemState (task, count, NULL);
|
||||
|
||||
for (i = 0U; (i < count) && (i < array_items); i++) {
|
||||
thread_array[i] = (osThreadId_t)task[i].xHandle;
|
||||
}
|
||||
count = i;
|
||||
}
|
||||
(void)xTaskResumeAll();
|
||||
|
||||
vPortFree (task);
|
||||
}
|
||||
|
||||
return (count);
|
||||
}
|
||||
#endif /* (configUSE_OS2_THREAD_ENUMERATE == 1) */
|
||||
|
||||
#if (configUSE_OS2_THREAD_FLAGS == 1)
|
||||
uint32_t osThreadFlagsSet (osThreadId_t thread_id, uint32_t flags) {
|
||||
TaskHandle_t hTask = (TaskHandle_t)thread_id;
|
||||
uint32_t rflags;
|
||||
BaseType_t yield;
|
||||
|
||||
if ((hTask == NULL) || ((flags & THREAD_FLAGS_INVALID_BITS) != 0U)) {
|
||||
rflags = (uint32_t)osErrorParameter;
|
||||
}
|
||||
else {
|
||||
rflags = (uint32_t)osError;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
yield = pdFALSE;
|
||||
|
||||
(void)xTaskNotifyFromISR (hTask, flags, eSetBits, &yield);
|
||||
(void)xTaskNotifyAndQueryFromISR (hTask, 0, eNoAction, &rflags, NULL);
|
||||
|
||||
portYIELD_FROM_ISR (yield);
|
||||
}
|
||||
else {
|
||||
(void)xTaskNotify (hTask, flags, eSetBits);
|
||||
(void)xTaskNotifyAndQuery (hTask, 0, eNoAction, &rflags);
|
||||
}
|
||||
}
|
||||
/* Return flags after setting */
|
||||
return (rflags);
|
||||
}
|
||||
|
||||
uint32_t osThreadFlagsClear (uint32_t flags) {
|
||||
TaskHandle_t hTask;
|
||||
uint32_t rflags, cflags;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
rflags = (uint32_t)osErrorISR;
|
||||
}
|
||||
else if ((flags & THREAD_FLAGS_INVALID_BITS) != 0U) {
|
||||
rflags = (uint32_t)osErrorParameter;
|
||||
}
|
||||
else {
|
||||
hTask = xTaskGetCurrentTaskHandle();
|
||||
|
||||
if (xTaskNotifyAndQuery (hTask, 0, eNoAction, &cflags) == pdPASS) {
|
||||
rflags = cflags;
|
||||
cflags &= ~flags;
|
||||
|
||||
if (xTaskNotify (hTask, cflags, eSetValueWithOverwrite) != pdPASS) {
|
||||
rflags = (uint32_t)osError;
|
||||
}
|
||||
}
|
||||
else {
|
||||
rflags = (uint32_t)osError;
|
||||
}
|
||||
}
|
||||
|
||||
/* Return flags before clearing */
|
||||
return (rflags);
|
||||
}
|
||||
|
||||
uint32_t osThreadFlagsGet (void) {
|
||||
TaskHandle_t hTask;
|
||||
uint32_t rflags;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
rflags = (uint32_t)osErrorISR;
|
||||
}
|
||||
else {
|
||||
hTask = xTaskGetCurrentTaskHandle();
|
||||
|
||||
if (xTaskNotifyAndQuery (hTask, 0, eNoAction, &rflags) != pdPASS) {
|
||||
rflags = (uint32_t)osError;
|
||||
}
|
||||
}
|
||||
|
||||
return (rflags);
|
||||
}
|
||||
|
||||
uint32_t osThreadFlagsWait (uint32_t flags, uint32_t options, uint32_t timeout) {
|
||||
uint32_t rflags, nval;
|
||||
uint32_t clear;
|
||||
TickType_t t0, td, tout;
|
||||
BaseType_t rval;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
rflags = (uint32_t)osErrorISR;
|
||||
}
|
||||
else if ((flags & THREAD_FLAGS_INVALID_BITS) != 0U) {
|
||||
rflags = (uint32_t)osErrorParameter;
|
||||
}
|
||||
else {
|
||||
if ((options & osFlagsNoClear) == osFlagsNoClear) {
|
||||
clear = 0U;
|
||||
} else {
|
||||
clear = flags;
|
||||
}
|
||||
|
||||
rflags = 0U;
|
||||
tout = timeout;
|
||||
|
||||
t0 = xTaskGetTickCount();
|
||||
do {
|
||||
rval = xTaskNotifyWait (0, clear, &nval, tout);
|
||||
|
||||
if (rval == pdPASS) {
|
||||
rflags &= flags;
|
||||
rflags |= nval;
|
||||
|
||||
if ((options & osFlagsWaitAll) == osFlagsWaitAll) {
|
||||
if ((flags & rflags) == flags) {
|
||||
break;
|
||||
} else {
|
||||
if (timeout == 0U) {
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
if ((flags & rflags) != 0) {
|
||||
break;
|
||||
} else {
|
||||
if (timeout == 0U) {
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/* Update timeout */
|
||||
td = xTaskGetTickCount() - t0;
|
||||
|
||||
if (td > tout) {
|
||||
tout = 0;
|
||||
} else {
|
||||
tout -= td;
|
||||
}
|
||||
}
|
||||
else {
|
||||
if (timeout == 0) {
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
} else {
|
||||
rflags = (uint32_t)osErrorTimeout;
|
||||
}
|
||||
}
|
||||
}
|
||||
while (rval != pdFAIL);
|
||||
}
|
||||
|
||||
/* Return flags before clearing */
|
||||
return (rflags);
|
||||
}
|
||||
#endif /* (configUSE_OS2_THREAD_FLAGS == 1) */
|
||||
|
||||
osStatus_t osDelay (uint32_t ticks) {
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else {
|
||||
stat = osOK;
|
||||
|
||||
if (ticks != 0U) {
|
||||
vTaskDelay(ticks);
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osStatus_t osDelayUntil (uint32_t ticks) {
|
||||
TickType_t tcnt, delay;
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else {
|
||||
stat = osOK;
|
||||
tcnt = xTaskGetTickCount();
|
||||
|
||||
/* Determine remaining number of ticks to delay */
|
||||
delay = (TickType_t)ticks - tcnt;
|
||||
|
||||
/* Check if target tick has not expired */
|
||||
if((delay != 0U) && (0 == (delay >> (8 * sizeof(TickType_t) - 1)))) {
|
||||
vTaskDelayUntil (&tcnt, delay);
|
||||
}
|
||||
else
|
||||
{
|
||||
/* No delay or already expired */
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
#if (configUSE_OS2_TIMER == 1)
|
||||
|
||||
static void TimerCallback (TimerHandle_t hTimer) {
|
||||
TimerCallback_t *callb;
|
||||
|
||||
callb = (TimerCallback_t *)pvTimerGetTimerID (hTimer);
|
||||
|
||||
if (callb != NULL) {
|
||||
callb->func (callb->arg);
|
||||
}
|
||||
}
|
||||
|
||||
osTimerId_t osTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr) {
|
||||
const char *name;
|
||||
TimerHandle_t hTimer;
|
||||
TimerCallback_t *callb;
|
||||
UBaseType_t reload;
|
||||
int32_t mem;
|
||||
|
||||
hTimer = NULL;
|
||||
|
||||
if (!IS_IRQ() && (func != NULL)) {
|
||||
/* Allocate memory to store callback function and argument */
|
||||
callb = pvPortMalloc (sizeof(TimerCallback_t));
|
||||
|
||||
if (callb != NULL) {
|
||||
callb->func = func;
|
||||
callb->arg = argument;
|
||||
|
||||
if (type == osTimerOnce) {
|
||||
reload = pdFALSE;
|
||||
} else {
|
||||
reload = pdTRUE;
|
||||
}
|
||||
|
||||
mem = -1;
|
||||
name = NULL;
|
||||
|
||||
if (attr != NULL) {
|
||||
if (attr->name != NULL) {
|
||||
name = attr->name;
|
||||
}
|
||||
|
||||
if ((attr->cb_mem != NULL) && (attr->cb_size >= sizeof(StaticTimer_t))) {
|
||||
mem = 1;
|
||||
}
|
||||
else {
|
||||
if ((attr->cb_mem == NULL) && (attr->cb_size == 0U)) {
|
||||
mem = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
mem = 0;
|
||||
}
|
||||
|
||||
if (mem == 1) {
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
hTimer = xTimerCreateStatic (name, 1, reload, callb, TimerCallback, (StaticTimer_t *)attr->cb_mem);
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
if (mem == 0) {
|
||||
#if (configSUPPORT_DYNAMIC_ALLOCATION == 1)
|
||||
hTimer = xTimerCreate (name, 1, reload, callb, TimerCallback);
|
||||
#endif
|
||||
}
|
||||
}
|
||||
|
||||
if ((hTimer == NULL) && (callb != NULL)) {
|
||||
vPortFree (callb);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return ((osTimerId_t)hTimer);
|
||||
}
|
||||
|
||||
const char *osTimerGetName (osTimerId_t timer_id) {
|
||||
TimerHandle_t hTimer = (TimerHandle_t)timer_id;
|
||||
const char *p;
|
||||
|
||||
if (IS_IRQ() || (hTimer == NULL)) {
|
||||
p = NULL;
|
||||
} else {
|
||||
p = pcTimerGetName (hTimer);
|
||||
}
|
||||
|
||||
return (p);
|
||||
}
|
||||
|
||||
osStatus_t osTimerStart (osTimerId_t timer_id, uint32_t ticks) {
|
||||
TimerHandle_t hTimer = (TimerHandle_t)timer_id;
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hTimer == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
if (xTimerChangePeriod (hTimer, ticks, 0) == pdPASS) {
|
||||
stat = osOK;
|
||||
} else {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osStatus_t osTimerStop (osTimerId_t timer_id) {
|
||||
TimerHandle_t hTimer = (TimerHandle_t)timer_id;
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hTimer == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
if (xTimerIsTimerActive (hTimer) == pdFALSE) {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
else {
|
||||
if (xTimerStop (hTimer, 0) == pdPASS) {
|
||||
stat = osOK;
|
||||
} else {
|
||||
stat = osError;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
uint32_t osTimerIsRunning (osTimerId_t timer_id) {
|
||||
TimerHandle_t hTimer = (TimerHandle_t)timer_id;
|
||||
uint32_t running;
|
||||
|
||||
if (IS_IRQ() || (hTimer == NULL)) {
|
||||
running = 0U;
|
||||
} else {
|
||||
running = (uint32_t)xTimerIsTimerActive (hTimer);
|
||||
}
|
||||
|
||||
return (running);
|
||||
}
|
||||
|
||||
osStatus_t osTimerDelete (osTimerId_t timer_id) {
|
||||
TimerHandle_t hTimer = (TimerHandle_t)timer_id;
|
||||
osStatus_t stat;
|
||||
#ifndef USE_FreeRTOS_HEAP_1
|
||||
TimerCallback_t *callb;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hTimer == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
callb = (TimerCallback_t *)pvTimerGetTimerID (hTimer);
|
||||
|
||||
if (xTimerDelete (hTimer, 0) == pdPASS) {
|
||||
vPortFree (callb);
|
||||
stat = osOK;
|
||||
} else {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
#else
|
||||
stat = osError;
|
||||
#endif
|
||||
|
||||
return (stat);
|
||||
}
|
||||
#endif /* (configUSE_OS2_TIMER == 1) */
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
|
||||
osEventFlagsId_t osEventFlagsNew (const osEventFlagsAttr_t *attr) {
|
||||
EventGroupHandle_t hEventGroup;
|
||||
int32_t mem;
|
||||
|
||||
hEventGroup = NULL;
|
||||
|
||||
if (!IS_IRQ()) {
|
||||
mem = -1;
|
||||
|
||||
if (attr != NULL) {
|
||||
if ((attr->cb_mem != NULL) && (attr->cb_size >= sizeof(StaticEventGroup_t))) {
|
||||
mem = 1;
|
||||
}
|
||||
else {
|
||||
if ((attr->cb_mem == NULL) && (attr->cb_size == 0U)) {
|
||||
mem = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
mem = 0;
|
||||
}
|
||||
|
||||
if (mem == 1) {
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
hEventGroup = xEventGroupCreateStatic (attr->cb_mem);
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
if (mem == 0) {
|
||||
#if (configSUPPORT_DYNAMIC_ALLOCATION == 1)
|
||||
hEventGroup = xEventGroupCreate();
|
||||
#endif
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return ((osEventFlagsId_t)hEventGroup);
|
||||
}
|
||||
|
||||
uint32_t osEventFlagsSet (osEventFlagsId_t ef_id, uint32_t flags) {
|
||||
EventGroupHandle_t hEventGroup = (EventGroupHandle_t)ef_id;
|
||||
uint32_t rflags;
|
||||
BaseType_t yield;
|
||||
|
||||
if ((hEventGroup == NULL) || ((flags & EVENT_FLAGS_INVALID_BITS) != 0U)) {
|
||||
rflags = (uint32_t)osErrorParameter;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
#if (configUSE_OS2_EVENTFLAGS_FROM_ISR == 0)
|
||||
(void)yield;
|
||||
/* Enable timers and xTimerPendFunctionCall function to support osEventFlagsSet from ISR */
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
#else
|
||||
yield = pdFALSE;
|
||||
|
||||
if (xEventGroupSetBitsFromISR (hEventGroup, (EventBits_t)flags, &yield) == pdFAIL) {
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
} else {
|
||||
rflags = flags;
|
||||
portYIELD_FROM_ISR (yield);
|
||||
}
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
rflags = xEventGroupSetBits (hEventGroup, (EventBits_t)flags);
|
||||
}
|
||||
|
||||
return (rflags);
|
||||
}
|
||||
|
||||
uint32_t osEventFlagsClear (osEventFlagsId_t ef_id, uint32_t flags) {
|
||||
EventGroupHandle_t hEventGroup = (EventGroupHandle_t)ef_id;
|
||||
uint32_t rflags;
|
||||
|
||||
if ((hEventGroup == NULL) || ((flags & EVENT_FLAGS_INVALID_BITS) != 0U)) {
|
||||
rflags = (uint32_t)osErrorParameter;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
#if (configUSE_OS2_EVENTFLAGS_FROM_ISR == 0)
|
||||
/* Enable timers and xTimerPendFunctionCall function to support osEventFlagsSet from ISR */
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
#else
|
||||
rflags = xEventGroupGetBitsFromISR (hEventGroup);
|
||||
|
||||
if (xEventGroupClearBitsFromISR (hEventGroup, (EventBits_t)flags) == pdFAIL) {
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
}
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
rflags = xEventGroupClearBits (hEventGroup, (EventBits_t)flags);
|
||||
}
|
||||
|
||||
return (rflags);
|
||||
}
|
||||
|
||||
uint32_t osEventFlagsGet (osEventFlagsId_t ef_id) {
|
||||
EventGroupHandle_t hEventGroup = (EventGroupHandle_t)ef_id;
|
||||
uint32_t rflags;
|
||||
|
||||
if (ef_id == NULL) {
|
||||
rflags = 0U;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
rflags = xEventGroupGetBitsFromISR (hEventGroup);
|
||||
}
|
||||
else {
|
||||
rflags = xEventGroupGetBits (hEventGroup);
|
||||
}
|
||||
|
||||
return (rflags);
|
||||
}
|
||||
|
||||
uint32_t osEventFlagsWait (osEventFlagsId_t ef_id, uint32_t flags, uint32_t options, uint32_t timeout) {
|
||||
EventGroupHandle_t hEventGroup = (EventGroupHandle_t)ef_id;
|
||||
BaseType_t wait_all;
|
||||
BaseType_t exit_clr;
|
||||
uint32_t rflags;
|
||||
|
||||
if ((hEventGroup == NULL) || ((flags & EVENT_FLAGS_INVALID_BITS) != 0U)) {
|
||||
rflags = (uint32_t)osErrorParameter;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
rflags = (uint32_t)osErrorISR;
|
||||
}
|
||||
else {
|
||||
if (options & osFlagsWaitAll) {
|
||||
wait_all = pdTRUE;
|
||||
} else {
|
||||
wait_all = pdFAIL;
|
||||
}
|
||||
|
||||
if (options & osFlagsNoClear) {
|
||||
exit_clr = pdFAIL;
|
||||
} else {
|
||||
exit_clr = pdTRUE;
|
||||
}
|
||||
|
||||
rflags = xEventGroupWaitBits (hEventGroup, (EventBits_t)flags, exit_clr, wait_all, (TickType_t)timeout);
|
||||
|
||||
if (options & osFlagsWaitAll) {
|
||||
if ((flags & rflags) != flags) {
|
||||
if (timeout > 0U) {
|
||||
rflags = (uint32_t)osErrorTimeout;
|
||||
} else {
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
if ((flags & rflags) == 0U) {
|
||||
if (timeout > 0U) {
|
||||
rflags = (uint32_t)osErrorTimeout;
|
||||
} else {
|
||||
rflags = (uint32_t)osErrorResource;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (rflags);
|
||||
}
|
||||
|
||||
osStatus_t osEventFlagsDelete (osEventFlagsId_t ef_id) {
|
||||
EventGroupHandle_t hEventGroup = (EventGroupHandle_t)ef_id;
|
||||
osStatus_t stat;
|
||||
|
||||
#ifndef USE_FreeRTOS_HEAP_1
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hEventGroup == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
stat = osOK;
|
||||
vEventGroupDelete (hEventGroup);
|
||||
}
|
||||
#else
|
||||
stat = osError;
|
||||
#endif
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
#if (configUSE_OS2_MUTEX == 1)
|
||||
|
||||
osMutexId_t osMutexNew (const osMutexAttr_t *attr) {
|
||||
SemaphoreHandle_t hMutex;
|
||||
uint32_t type;
|
||||
uint32_t rmtx;
|
||||
int32_t mem;
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
const char *name;
|
||||
#endif
|
||||
|
||||
hMutex = NULL;
|
||||
|
||||
if (!IS_IRQ()) {
|
||||
if (attr != NULL) {
|
||||
type = attr->attr_bits;
|
||||
} else {
|
||||
type = 0U;
|
||||
}
|
||||
|
||||
if ((type & osMutexRecursive) == osMutexRecursive) {
|
||||
rmtx = 1U;
|
||||
} else {
|
||||
rmtx = 0U;
|
||||
}
|
||||
|
||||
if ((type & osMutexRobust) != osMutexRobust) {
|
||||
mem = -1;
|
||||
|
||||
if (attr != NULL) {
|
||||
if ((attr->cb_mem != NULL) && (attr->cb_size >= sizeof(StaticSemaphore_t))) {
|
||||
mem = 1;
|
||||
}
|
||||
else {
|
||||
if ((attr->cb_mem == NULL) && (attr->cb_size == 0U)) {
|
||||
mem = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
mem = 0;
|
||||
}
|
||||
|
||||
if (mem == 1) {
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
if (rmtx != 0U) {
|
||||
#if (configUSE_RECURSIVE_MUTEXES == 1)
|
||||
hMutex = xSemaphoreCreateRecursiveMutexStatic (attr->cb_mem);
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
hMutex = xSemaphoreCreateMutexStatic (attr->cb_mem);
|
||||
}
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
if (mem == 0) {
|
||||
#if (configSUPPORT_DYNAMIC_ALLOCATION == 1)
|
||||
if (rmtx != 0U) {
|
||||
#if (configUSE_RECURSIVE_MUTEXES == 1)
|
||||
hMutex = xSemaphoreCreateRecursiveMutex ();
|
||||
#endif
|
||||
} else {
|
||||
hMutex = xSemaphoreCreateMutex ();
|
||||
}
|
||||
#endif
|
||||
}
|
||||
}
|
||||
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
if (hMutex != NULL) {
|
||||
if (attr != NULL) {
|
||||
name = attr->name;
|
||||
} else {
|
||||
name = NULL;
|
||||
}
|
||||
vQueueAddToRegistry (hMutex, name);
|
||||
}
|
||||
#endif
|
||||
|
||||
if ((hMutex != NULL) && (rmtx != 0U)) {
|
||||
hMutex = (SemaphoreHandle_t)((uint32_t)hMutex | 1U);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return ((osMutexId_t)hMutex);
|
||||
}
|
||||
|
||||
osStatus_t osMutexAcquire (osMutexId_t mutex_id, uint32_t timeout) {
|
||||
SemaphoreHandle_t hMutex;
|
||||
osStatus_t stat;
|
||||
uint32_t rmtx;
|
||||
|
||||
hMutex = (SemaphoreHandle_t)((uint32_t)mutex_id & ~1U);
|
||||
|
||||
rmtx = (uint32_t)mutex_id & 1U;
|
||||
|
||||
stat = osOK;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hMutex == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
if (rmtx != 0U) {
|
||||
#if (configUSE_RECURSIVE_MUTEXES == 1)
|
||||
if (xSemaphoreTakeRecursive (hMutex, timeout) != pdPASS) {
|
||||
if (timeout != 0U) {
|
||||
stat = osErrorTimeout;
|
||||
} else {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
if (xSemaphoreTake (hMutex, timeout) != pdPASS) {
|
||||
if (timeout != 0U) {
|
||||
stat = osErrorTimeout;
|
||||
} else {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osStatus_t osMutexRelease (osMutexId_t mutex_id) {
|
||||
SemaphoreHandle_t hMutex;
|
||||
osStatus_t stat;
|
||||
uint32_t rmtx;
|
||||
|
||||
hMutex = (SemaphoreHandle_t)((uint32_t)mutex_id & ~1U);
|
||||
|
||||
rmtx = (uint32_t)mutex_id & 1U;
|
||||
|
||||
stat = osOK;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hMutex == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
if (rmtx != 0U) {
|
||||
#if (configUSE_RECURSIVE_MUTEXES == 1)
|
||||
if (xSemaphoreGiveRecursive (hMutex) != pdPASS) {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
if (xSemaphoreGive (hMutex) != pdPASS) {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osThreadId_t osMutexGetOwner (osMutexId_t mutex_id) {
|
||||
SemaphoreHandle_t hMutex;
|
||||
osThreadId_t owner;
|
||||
|
||||
hMutex = (SemaphoreHandle_t)((uint32_t)mutex_id & ~1U);
|
||||
|
||||
if (IS_IRQ() || (hMutex == NULL)) {
|
||||
owner = NULL;
|
||||
} else {
|
||||
owner = (osThreadId_t)xSemaphoreGetMutexHolder (hMutex);
|
||||
}
|
||||
|
||||
return (owner);
|
||||
}
|
||||
|
||||
osStatus_t osMutexDelete (osMutexId_t mutex_id) {
|
||||
osStatus_t stat;
|
||||
#ifndef USE_FreeRTOS_HEAP_1
|
||||
SemaphoreHandle_t hMutex;
|
||||
|
||||
hMutex = (SemaphoreHandle_t)((uint32_t)mutex_id & ~1U);
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hMutex == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
vQueueUnregisterQueue (hMutex);
|
||||
#endif
|
||||
stat = osOK;
|
||||
vSemaphoreDelete (hMutex);
|
||||
}
|
||||
#else
|
||||
stat = osError;
|
||||
#endif
|
||||
|
||||
return (stat);
|
||||
}
|
||||
#endif /* (configUSE_OS2_MUTEX == 1) */
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
|
||||
osSemaphoreId_t osSemaphoreNew (uint32_t max_count, uint32_t initial_count, const osSemaphoreAttr_t *attr) {
|
||||
SemaphoreHandle_t hSemaphore;
|
||||
int32_t mem;
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
const char *name;
|
||||
#endif
|
||||
|
||||
hSemaphore = NULL;
|
||||
|
||||
if (!IS_IRQ() && (max_count > 0U) && (initial_count <= max_count)) {
|
||||
mem = -1;
|
||||
|
||||
if (attr != NULL) {
|
||||
if ((attr->cb_mem != NULL) && (attr->cb_size >= sizeof(StaticSemaphore_t))) {
|
||||
mem = 1;
|
||||
}
|
||||
else {
|
||||
if ((attr->cb_mem == NULL) && (attr->cb_size == 0U)) {
|
||||
mem = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
mem = 0;
|
||||
}
|
||||
|
||||
if (mem != -1) {
|
||||
if (max_count == 1U) {
|
||||
if (mem == 1) {
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
hSemaphore = xSemaphoreCreateBinaryStatic ((StaticSemaphore_t *)attr->cb_mem);
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
#if (configSUPPORT_DYNAMIC_ALLOCATION == 1)
|
||||
hSemaphore = xSemaphoreCreateBinary();
|
||||
#endif
|
||||
}
|
||||
|
||||
if ((hSemaphore != NULL) && (initial_count != 0U)) {
|
||||
if (xSemaphoreGive (hSemaphore) != pdPASS) {
|
||||
vSemaphoreDelete (hSemaphore);
|
||||
hSemaphore = NULL;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
if (mem == 1) {
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
hSemaphore = xSemaphoreCreateCountingStatic (max_count, initial_count, (StaticSemaphore_t *)attr->cb_mem);
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
#if (configSUPPORT_DYNAMIC_ALLOCATION == 1)
|
||||
hSemaphore = xSemaphoreCreateCounting (max_count, initial_count);
|
||||
#endif
|
||||
}
|
||||
}
|
||||
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
if (hSemaphore != NULL) {
|
||||
if (attr != NULL) {
|
||||
name = attr->name;
|
||||
} else {
|
||||
name = NULL;
|
||||
}
|
||||
vQueueAddToRegistry (hSemaphore, name);
|
||||
}
|
||||
#endif
|
||||
}
|
||||
}
|
||||
|
||||
return ((osSemaphoreId_t)hSemaphore);
|
||||
}
|
||||
|
||||
osStatus_t osSemaphoreAcquire (osSemaphoreId_t semaphore_id, uint32_t timeout) {
|
||||
SemaphoreHandle_t hSemaphore = (SemaphoreHandle_t)semaphore_id;
|
||||
osStatus_t stat;
|
||||
BaseType_t yield;
|
||||
|
||||
stat = osOK;
|
||||
|
||||
if (hSemaphore == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
if (timeout != 0U) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
yield = pdFALSE;
|
||||
|
||||
if (xSemaphoreTakeFromISR (hSemaphore, &yield) != pdPASS) {
|
||||
stat = osErrorResource;
|
||||
} else {
|
||||
portYIELD_FROM_ISR (yield);
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
if (xSemaphoreTake (hSemaphore, (TickType_t)timeout) != pdPASS) {
|
||||
if (timeout != 0U) {
|
||||
stat = osErrorTimeout;
|
||||
} else {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osStatus_t osSemaphoreRelease (osSemaphoreId_t semaphore_id) {
|
||||
SemaphoreHandle_t hSemaphore = (SemaphoreHandle_t)semaphore_id;
|
||||
osStatus_t stat;
|
||||
BaseType_t yield;
|
||||
|
||||
stat = osOK;
|
||||
|
||||
if (hSemaphore == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
yield = pdFALSE;
|
||||
|
||||
if (xSemaphoreGiveFromISR (hSemaphore, &yield) != pdTRUE) {
|
||||
stat = osErrorResource;
|
||||
} else {
|
||||
portYIELD_FROM_ISR (yield);
|
||||
}
|
||||
}
|
||||
else {
|
||||
if (xSemaphoreGive (hSemaphore) != pdPASS) {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
uint32_t osSemaphoreGetCount (osSemaphoreId_t semaphore_id) {
|
||||
SemaphoreHandle_t hSemaphore = (SemaphoreHandle_t)semaphore_id;
|
||||
uint32_t count;
|
||||
|
||||
if (hSemaphore == NULL) {
|
||||
count = 0U;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
count = uxQueueMessagesWaitingFromISR (hSemaphore);
|
||||
} else {
|
||||
count = (uint32_t)uxSemaphoreGetCount (hSemaphore);
|
||||
}
|
||||
|
||||
return (count);
|
||||
}
|
||||
|
||||
osStatus_t osSemaphoreDelete (osSemaphoreId_t semaphore_id) {
|
||||
SemaphoreHandle_t hSemaphore = (SemaphoreHandle_t)semaphore_id;
|
||||
osStatus_t stat;
|
||||
|
||||
#ifndef USE_FreeRTOS_HEAP_1
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hSemaphore == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
vQueueUnregisterQueue (hSemaphore);
|
||||
#endif
|
||||
|
||||
stat = osOK;
|
||||
vSemaphoreDelete (hSemaphore);
|
||||
}
|
||||
#else
|
||||
stat = osError;
|
||||
#endif
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
|
||||
osMessageQueueId_t osMessageQueueNew (uint32_t msg_count, uint32_t msg_size, const osMessageQueueAttr_t *attr) {
|
||||
QueueHandle_t hQueue;
|
||||
int32_t mem;
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
const char *name;
|
||||
#endif
|
||||
|
||||
hQueue = NULL;
|
||||
|
||||
if (!IS_IRQ() && (msg_count > 0U) && (msg_size > 0U)) {
|
||||
mem = -1;
|
||||
|
||||
if (attr != NULL) {
|
||||
if ((attr->cb_mem != NULL) && (attr->cb_size >= sizeof(StaticQueue_t)) &&
|
||||
(attr->mq_mem != NULL) && (attr->mq_size >= (msg_count * msg_size))) {
|
||||
mem = 1;
|
||||
}
|
||||
else {
|
||||
if ((attr->cb_mem == NULL) && (attr->cb_size == 0U) &&
|
||||
(attr->mq_mem == NULL) && (attr->mq_size == 0U)) {
|
||||
mem = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
mem = 0;
|
||||
}
|
||||
|
||||
if (mem == 1) {
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
hQueue = xQueueCreateStatic (msg_count, msg_size, attr->mq_mem, attr->cb_mem);
|
||||
#endif
|
||||
}
|
||||
else {
|
||||
if (mem == 0) {
|
||||
#if (configSUPPORT_DYNAMIC_ALLOCATION == 1)
|
||||
hQueue = xQueueCreate (msg_count, msg_size);
|
||||
#endif
|
||||
}
|
||||
}
|
||||
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
if (hQueue != NULL) {
|
||||
if (attr != NULL) {
|
||||
name = attr->name;
|
||||
} else {
|
||||
name = NULL;
|
||||
}
|
||||
vQueueAddToRegistry (hQueue, name);
|
||||
}
|
||||
#endif
|
||||
|
||||
}
|
||||
|
||||
return ((osMessageQueueId_t)hQueue);
|
||||
}
|
||||
|
||||
osStatus_t osMessageQueuePut (osMessageQueueId_t mq_id, const void *msg_ptr, uint8_t msg_prio, uint32_t timeout) {
|
||||
QueueHandle_t hQueue = (QueueHandle_t)mq_id;
|
||||
osStatus_t stat;
|
||||
BaseType_t yield;
|
||||
|
||||
(void)msg_prio; /* Message priority is ignored */
|
||||
|
||||
stat = osOK;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
if ((hQueue == NULL) || (msg_ptr == NULL) || (timeout != 0U)) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
yield = pdFALSE;
|
||||
|
||||
if (xQueueSendToBackFromISR (hQueue, msg_ptr, &yield) != pdTRUE) {
|
||||
stat = osErrorResource;
|
||||
} else {
|
||||
portYIELD_FROM_ISR (yield);
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
if ((hQueue == NULL) || (msg_ptr == NULL)) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
if (xQueueSendToBack (hQueue, msg_ptr, (TickType_t)timeout) != pdPASS) {
|
||||
if (timeout != 0U) {
|
||||
stat = osErrorTimeout;
|
||||
} else {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osStatus_t osMessageQueueGet (osMessageQueueId_t mq_id, void *msg_ptr, uint8_t *msg_prio, uint32_t timeout) {
|
||||
QueueHandle_t hQueue = (QueueHandle_t)mq_id;
|
||||
osStatus_t stat;
|
||||
BaseType_t yield;
|
||||
|
||||
(void)msg_prio; /* Message priority is ignored */
|
||||
|
||||
stat = osOK;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
if ((hQueue == NULL) || (msg_ptr == NULL) || (timeout != 0U)) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
yield = pdFALSE;
|
||||
|
||||
if (xQueueReceiveFromISR (hQueue, msg_ptr, &yield) != pdPASS) {
|
||||
stat = osErrorResource;
|
||||
} else {
|
||||
portYIELD_FROM_ISR (yield);
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
if ((hQueue == NULL) || (msg_ptr == NULL)) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
if (xQueueReceive (hQueue, msg_ptr, (TickType_t)timeout) != pdPASS) {
|
||||
if (timeout != 0U) {
|
||||
stat = osErrorTimeout;
|
||||
} else {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
uint32_t osMessageQueueGetCapacity (osMessageQueueId_t mq_id) {
|
||||
StaticQueue_t *mq = (StaticQueue_t *)mq_id;
|
||||
uint32_t capacity;
|
||||
|
||||
if (mq == NULL) {
|
||||
capacity = 0U;
|
||||
} else {
|
||||
/* capacity = pxQueue->uxLength */
|
||||
capacity = mq->uxDummy4[1];
|
||||
}
|
||||
|
||||
return (capacity);
|
||||
}
|
||||
|
||||
uint32_t osMessageQueueGetMsgSize (osMessageQueueId_t mq_id) {
|
||||
StaticQueue_t *mq = (StaticQueue_t *)mq_id;
|
||||
uint32_t size;
|
||||
|
||||
if (mq == NULL) {
|
||||
size = 0U;
|
||||
} else {
|
||||
/* size = pxQueue->uxItemSize */
|
||||
size = mq->uxDummy4[2];
|
||||
}
|
||||
|
||||
return (size);
|
||||
}
|
||||
|
||||
uint32_t osMessageQueueGetCount (osMessageQueueId_t mq_id) {
|
||||
QueueHandle_t hQueue = (QueueHandle_t)mq_id;
|
||||
UBaseType_t count;
|
||||
|
||||
if (hQueue == NULL) {
|
||||
count = 0U;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
count = uxQueueMessagesWaitingFromISR (hQueue);
|
||||
}
|
||||
else {
|
||||
count = uxQueueMessagesWaiting (hQueue);
|
||||
}
|
||||
|
||||
return ((uint32_t)count);
|
||||
}
|
||||
|
||||
uint32_t osMessageQueueGetSpace (osMessageQueueId_t mq_id) {
|
||||
StaticQueue_t *mq = (StaticQueue_t *)mq_id;
|
||||
uint32_t space;
|
||||
uint32_t isrm;
|
||||
|
||||
if (mq == NULL) {
|
||||
space = 0U;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
isrm = taskENTER_CRITICAL_FROM_ISR();
|
||||
|
||||
/* space = pxQueue->uxLength - pxQueue->uxMessagesWaiting; */
|
||||
space = mq->uxDummy4[1] - mq->uxDummy4[0];
|
||||
|
||||
taskEXIT_CRITICAL_FROM_ISR(isrm);
|
||||
}
|
||||
else {
|
||||
space = (uint32_t)uxQueueSpacesAvailable ((QueueHandle_t)mq);
|
||||
}
|
||||
|
||||
return (space);
|
||||
}
|
||||
|
||||
osStatus_t osMessageQueueReset (osMessageQueueId_t mq_id) {
|
||||
QueueHandle_t hQueue = (QueueHandle_t)mq_id;
|
||||
osStatus_t stat;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hQueue == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
stat = osOK;
|
||||
(void)xQueueReset (hQueue);
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
osStatus_t osMessageQueueDelete (osMessageQueueId_t mq_id) {
|
||||
QueueHandle_t hQueue = (QueueHandle_t)mq_id;
|
||||
osStatus_t stat;
|
||||
|
||||
#ifndef USE_FreeRTOS_HEAP_1
|
||||
if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else if (hQueue == NULL) {
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
#if (configQUEUE_REGISTRY_SIZE > 0)
|
||||
vQueueUnregisterQueue (hQueue);
|
||||
#endif
|
||||
|
||||
stat = osOK;
|
||||
vQueueDelete (hQueue);
|
||||
}
|
||||
#else
|
||||
stat = osError;
|
||||
#endif
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
#ifdef FREERTOS_MPOOL_H_
|
||||
|
||||
/* Static memory pool functions */
|
||||
static void FreeBlock (MemPool_t *mp, void *block);
|
||||
static void *AllocBlock (MemPool_t *mp);
|
||||
static void *CreateBlock (MemPool_t *mp);
|
||||
|
||||
osMemoryPoolId_t osMemoryPoolNew (uint32_t block_count, uint32_t block_size, const osMemoryPoolAttr_t *attr) {
|
||||
MemPool_t *mp;
|
||||
const char *name;
|
||||
int32_t mem_cb, mem_mp;
|
||||
uint32_t sz;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
mp = NULL;
|
||||
}
|
||||
else if ((block_count == 0U) || (block_size == 0U)) {
|
||||
mp = NULL;
|
||||
}
|
||||
else {
|
||||
mp = NULL;
|
||||
sz = MEMPOOL_ARR_SIZE (block_count, block_size);
|
||||
|
||||
name = NULL;
|
||||
mem_cb = -1;
|
||||
mem_mp = -1;
|
||||
|
||||
if (attr != NULL) {
|
||||
if (attr->name != NULL) {
|
||||
name = attr->name;
|
||||
}
|
||||
|
||||
if ((attr->cb_mem != NULL) && (attr->cb_size >= sizeof(MemPool_t))) {
|
||||
/* Static control block is provided */
|
||||
mem_cb = 1;
|
||||
}
|
||||
else if ((attr->cb_mem == NULL) && (attr->cb_size == 0U)) {
|
||||
/* Allocate control block memory on heap */
|
||||
mem_cb = 0;
|
||||
}
|
||||
|
||||
if ((attr->mp_mem == NULL) && (attr->mp_size == 0U)) {
|
||||
/* Allocate memory array on heap */
|
||||
mem_mp = 0;
|
||||
}
|
||||
else {
|
||||
if (attr->mp_mem != NULL) {
|
||||
/* Check if array is 4-byte aligned */
|
||||
if (((uint32_t)attr->mp_mem & 3U) == 0U) {
|
||||
/* Check if array big enough */
|
||||
if (attr->mp_size >= sz) {
|
||||
/* Static memory pool array is provided */
|
||||
mem_mp = 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
/* Attributes not provided, allocate memory on heap */
|
||||
mem_cb = 0;
|
||||
mem_mp = 0;
|
||||
}
|
||||
|
||||
if (mem_cb == 0) {
|
||||
mp = pvPortMalloc (sizeof(MemPool_t));
|
||||
} else {
|
||||
mp = attr->cb_mem;
|
||||
}
|
||||
|
||||
if (mp != NULL) {
|
||||
/* Create a semaphore (max count == initial count == block_count) */
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
mp->sem = xSemaphoreCreateCountingStatic (block_count, block_count, &mp->mem_sem);
|
||||
#elif (configSUPPORT_DYNAMIC_ALLOCATION == 1)
|
||||
mp->sem = xSemaphoreCreateCounting (block_count, block_count);
|
||||
#else
|
||||
mp->sem == NULL;
|
||||
#endif
|
||||
|
||||
if (mp->sem != NULL) {
|
||||
/* Setup memory array */
|
||||
if (mem_mp == 0) {
|
||||
mp->mem_arr = pvPortMalloc (sz);
|
||||
} else {
|
||||
mp->mem_arr = attr->mp_mem;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if ((mp != NULL) && (mp->mem_arr != NULL)) {
|
||||
/* Memory pool can be created */
|
||||
mp->head = NULL;
|
||||
mp->mem_sz = sz;
|
||||
mp->name = name;
|
||||
mp->bl_sz = block_size;
|
||||
mp->bl_cnt = block_count;
|
||||
mp->n = 0U;
|
||||
|
||||
/* Set heap allocated memory flags */
|
||||
mp->status = MPOOL_STATUS;
|
||||
|
||||
if (mem_cb == 0) {
|
||||
/* Control block on heap */
|
||||
mp->status |= 1U;
|
||||
}
|
||||
if (mem_mp == 0) {
|
||||
/* Memory array on heap */
|
||||
mp->status |= 2U;
|
||||
}
|
||||
}
|
||||
else {
|
||||
/* Memory pool cannot be created, release allocated resources */
|
||||
if ((mem_cb == 0) && (mp != NULL)) {
|
||||
/* Free control block memory */
|
||||
vPortFree (mp);
|
||||
}
|
||||
mp = NULL;
|
||||
}
|
||||
}
|
||||
|
||||
return (mp);
|
||||
}
|
||||
|
||||
const char *osMemoryPoolGetName (osMemoryPoolId_t mp_id) {
|
||||
MemPool_t *mp = (osMemoryPoolId_t)mp_id;
|
||||
const char *p;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
p = NULL;
|
||||
}
|
||||
else if (mp_id == NULL) {
|
||||
p = NULL;
|
||||
}
|
||||
else {
|
||||
p = mp->name;
|
||||
}
|
||||
|
||||
return (p);
|
||||
}
|
||||
|
||||
void *osMemoryPoolAlloc (osMemoryPoolId_t mp_id, uint32_t timeout) {
|
||||
MemPool_t *mp;
|
||||
void *block;
|
||||
uint32_t isrm;
|
||||
|
||||
if (mp_id == NULL) {
|
||||
/* Invalid input parameters */
|
||||
block = NULL;
|
||||
}
|
||||
else {
|
||||
block = NULL;
|
||||
|
||||
mp = (MemPool_t *)mp_id;
|
||||
|
||||
if ((mp->status & MPOOL_STATUS) == MPOOL_STATUS) {
|
||||
if (IS_IRQ()) {
|
||||
if (timeout == 0U) {
|
||||
if (xSemaphoreTakeFromISR (mp->sem, NULL) == pdTRUE) {
|
||||
if ((mp->status & MPOOL_STATUS) == MPOOL_STATUS) {
|
||||
isrm = taskENTER_CRITICAL_FROM_ISR();
|
||||
|
||||
/* Get a block from the free-list */
|
||||
block = AllocBlock(mp);
|
||||
|
||||
if (block == NULL) {
|
||||
/* List of free blocks is empty, 'create' new block */
|
||||
block = CreateBlock(mp);
|
||||
}
|
||||
|
||||
taskEXIT_CRITICAL_FROM_ISR(isrm);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
else {
|
||||
if (xSemaphoreTake (mp->sem, (TickType_t)timeout) == pdTRUE) {
|
||||
if ((mp->status & MPOOL_STATUS) == MPOOL_STATUS) {
|
||||
taskENTER_CRITICAL();
|
||||
|
||||
/* Get a block from the free-list */
|
||||
block = AllocBlock(mp);
|
||||
|
||||
if (block == NULL) {
|
||||
/* List of free blocks is empty, 'create' new block */
|
||||
block = CreateBlock(mp);
|
||||
}
|
||||
|
||||
taskEXIT_CRITICAL();
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (block);
|
||||
}
|
||||
|
||||
osStatus_t osMemoryPoolFree (osMemoryPoolId_t mp_id, void *block) {
|
||||
MemPool_t *mp;
|
||||
osStatus_t stat;
|
||||
uint32_t isrm;
|
||||
BaseType_t yield;
|
||||
|
||||
if ((mp_id == NULL) || (block == NULL)) {
|
||||
/* Invalid input parameters */
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
mp = (MemPool_t *)mp_id;
|
||||
|
||||
if ((mp->status & MPOOL_STATUS) != MPOOL_STATUS) {
|
||||
/* Invalid object status */
|
||||
stat = osErrorResource;
|
||||
}
|
||||
else if ((block < (void *)&mp->mem_arr[0]) || (block > (void*)&mp->mem_arr[mp->mem_sz-1])) {
|
||||
/* Block pointer outside of memory array area */
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else {
|
||||
stat = osOK;
|
||||
|
||||
if (IS_IRQ()) {
|
||||
if (uxSemaphoreGetCountFromISR (mp->sem) == mp->bl_cnt) {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
else {
|
||||
isrm = taskENTER_CRITICAL_FROM_ISR();
|
||||
|
||||
/* Add block to the list of free blocks */
|
||||
FreeBlock(mp, block);
|
||||
|
||||
taskEXIT_CRITICAL_FROM_ISR(isrm);
|
||||
|
||||
yield = pdFALSE;
|
||||
xSemaphoreGiveFromISR (mp->sem, &yield);
|
||||
portYIELD_FROM_ISR (yield);
|
||||
}
|
||||
}
|
||||
else {
|
||||
if (uxSemaphoreGetCount (mp->sem) == mp->bl_cnt) {
|
||||
stat = osErrorResource;
|
||||
}
|
||||
else {
|
||||
taskENTER_CRITICAL();
|
||||
|
||||
/* Add block to the list of free blocks */
|
||||
FreeBlock(mp, block);
|
||||
|
||||
taskEXIT_CRITICAL();
|
||||
|
||||
xSemaphoreGive (mp->sem);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
uint32_t osMemoryPoolGetCapacity (osMemoryPoolId_t mp_id) {
|
||||
MemPool_t *mp;
|
||||
uint32_t n;
|
||||
|
||||
if (mp_id == NULL) {
|
||||
/* Invalid input parameters */
|
||||
n = 0U;
|
||||
}
|
||||
else {
|
||||
mp = (MemPool_t *)mp_id;
|
||||
|
||||
if ((mp->status & MPOOL_STATUS) != MPOOL_STATUS) {
|
||||
/* Invalid object status */
|
||||
n = 0U;
|
||||
}
|
||||
else {
|
||||
n = mp->bl_cnt;
|
||||
}
|
||||
}
|
||||
|
||||
/* Return maximum number of memory blocks */
|
||||
return (n);
|
||||
}
|
||||
|
||||
uint32_t osMemoryPoolGetBlockSize (osMemoryPoolId_t mp_id) {
|
||||
MemPool_t *mp;
|
||||
uint32_t sz;
|
||||
|
||||
if (mp_id == NULL) {
|
||||
/* Invalid input parameters */
|
||||
sz = 0U;
|
||||
}
|
||||
else {
|
||||
mp = (MemPool_t *)mp_id;
|
||||
|
||||
if ((mp->status & MPOOL_STATUS) != MPOOL_STATUS) {
|
||||
/* Invalid object status */
|
||||
sz = 0U;
|
||||
}
|
||||
else {
|
||||
sz = mp->bl_sz;
|
||||
}
|
||||
}
|
||||
|
||||
/* Return memory block size in bytes */
|
||||
return (sz);
|
||||
}
|
||||
|
||||
uint32_t osMemoryPoolGetCount (osMemoryPoolId_t mp_id) {
|
||||
MemPool_t *mp;
|
||||
uint32_t n;
|
||||
|
||||
if (mp_id == NULL) {
|
||||
/* Invalid input parameters */
|
||||
n = 0U;
|
||||
}
|
||||
else {
|
||||
mp = (MemPool_t *)mp_id;
|
||||
|
||||
if ((mp->status & MPOOL_STATUS) != MPOOL_STATUS) {
|
||||
/* Invalid object status */
|
||||
n = 0U;
|
||||
}
|
||||
else {
|
||||
if (IS_IRQ()) {
|
||||
n = uxSemaphoreGetCountFromISR (mp->sem);
|
||||
} else {
|
||||
n = uxSemaphoreGetCount (mp->sem);
|
||||
}
|
||||
|
||||
n = mp->bl_cnt - n;
|
||||
}
|
||||
}
|
||||
|
||||
/* Return number of memory blocks used */
|
||||
return (n);
|
||||
}
|
||||
|
||||
uint32_t osMemoryPoolGetSpace (osMemoryPoolId_t mp_id) {
|
||||
MemPool_t *mp;
|
||||
uint32_t n;
|
||||
|
||||
if (mp_id == NULL) {
|
||||
/* Invalid input parameters */
|
||||
n = 0U;
|
||||
}
|
||||
else {
|
||||
mp = (MemPool_t *)mp_id;
|
||||
|
||||
if ((mp->status & MPOOL_STATUS) != MPOOL_STATUS) {
|
||||
/* Invalid object status */
|
||||
n = 0U;
|
||||
}
|
||||
else {
|
||||
if (IS_IRQ()) {
|
||||
n = uxSemaphoreGetCountFromISR (mp->sem);
|
||||
} else {
|
||||
n = uxSemaphoreGetCount (mp->sem);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/* Return number of memory blocks available */
|
||||
return (n);
|
||||
}
|
||||
|
||||
osStatus_t osMemoryPoolDelete (osMemoryPoolId_t mp_id) {
|
||||
MemPool_t *mp;
|
||||
osStatus_t stat;
|
||||
|
||||
if (mp_id == NULL) {
|
||||
/* Invalid input parameters */
|
||||
stat = osErrorParameter;
|
||||
}
|
||||
else if (IS_IRQ()) {
|
||||
stat = osErrorISR;
|
||||
}
|
||||
else {
|
||||
mp = (MemPool_t *)mp_id;
|
||||
|
||||
taskENTER_CRITICAL();
|
||||
|
||||
/* Invalidate control block status */
|
||||
mp->status = mp->status & 3U;
|
||||
|
||||
/* Wake-up tasks waiting for pool semaphore */
|
||||
while (xSemaphoreGive (mp->sem) == pdTRUE);
|
||||
|
||||
mp->head = NULL;
|
||||
mp->bl_sz = 0U;
|
||||
mp->bl_cnt = 0U;
|
||||
|
||||
if ((mp->status & 2U) != 0U) {
|
||||
/* Memory pool array allocated on heap */
|
||||
vPortFree (mp->mem_arr);
|
||||
}
|
||||
if ((mp->status & 1U) != 0U) {
|
||||
/* Memory pool control block allocated on heap */
|
||||
vPortFree (mp);
|
||||
}
|
||||
|
||||
taskEXIT_CRITICAL();
|
||||
|
||||
stat = osOK;
|
||||
}
|
||||
|
||||
return (stat);
|
||||
}
|
||||
|
||||
/*
|
||||
Create new block given according to the current block index.
|
||||
*/
|
||||
static void *CreateBlock (MemPool_t *mp) {
|
||||
MemPoolBlock_t *p = NULL;
|
||||
|
||||
if (mp->n < mp->bl_cnt) {
|
||||
/* Unallocated blocks exist, set pointer to new block */
|
||||
p = (void *)(mp->mem_arr + (mp->bl_sz * mp->n));
|
||||
|
||||
/* Increment block index */
|
||||
mp->n += 1U;
|
||||
}
|
||||
|
||||
return (p);
|
||||
}
|
||||
|
||||
/*
|
||||
Allocate a block by reading the list of free blocks.
|
||||
*/
|
||||
static void *AllocBlock (MemPool_t *mp) {
|
||||
MemPoolBlock_t *p = NULL;
|
||||
|
||||
if (mp->head != NULL) {
|
||||
/* List of free block exists, get head block */
|
||||
p = mp->head;
|
||||
|
||||
/* Head block is now next on the list */
|
||||
mp->head = p->next;
|
||||
}
|
||||
|
||||
return (p);
|
||||
}
|
||||
|
||||
/*
|
||||
Free block by putting it to the list of free blocks.
|
||||
*/
|
||||
static void FreeBlock (MemPool_t *mp, void *block) {
|
||||
MemPoolBlock_t *p = block;
|
||||
|
||||
/* Store current head into block memory space */
|
||||
p->next = mp->head;
|
||||
|
||||
/* Store current block as new head */
|
||||
mp->head = p;
|
||||
}
|
||||
#endif /* FREERTOS_MPOOL_H_ */
|
||||
/*---------------------------------------------------------------------------*/
|
||||
|
||||
/* Callback function prototypes */
|
||||
extern void vApplicationIdleHook (void);
|
||||
extern void vApplicationTickHook (void);
|
||||
extern void vApplicationMallocFailedHook (void);
|
||||
extern void vApplicationDaemonTaskStartupHook (void);
|
||||
extern void vApplicationStackOverflowHook (TaskHandle_t xTask, signed char *pcTaskName);
|
||||
|
||||
/**
|
||||
Dummy implementation of the callback function vApplicationIdleHook().
|
||||
*/
|
||||
#if (configUSE_IDLE_HOOK == 1)
|
||||
__WEAK void vApplicationIdleHook (void){}
|
||||
#endif
|
||||
|
||||
/**
|
||||
Dummy implementation of the callback function vApplicationTickHook().
|
||||
*/
|
||||
#if (configUSE_TICK_HOOK == 1)
|
||||
__WEAK void vApplicationTickHook (void){}
|
||||
#endif
|
||||
|
||||
/**
|
||||
Dummy implementation of the callback function vApplicationMallocFailedHook().
|
||||
*/
|
||||
#if (configUSE_MALLOC_FAILED_HOOK == 1)
|
||||
__WEAK void vApplicationMallocFailedHook (void){}
|
||||
#endif
|
||||
|
||||
/**
|
||||
Dummy implementation of the callback function vApplicationDaemonTaskStartupHook().
|
||||
*/
|
||||
#if (configUSE_DAEMON_TASK_STARTUP_HOOK == 1)
|
||||
__WEAK void vApplicationDaemonTaskStartupHook (void){}
|
||||
#endif
|
||||
|
||||
/**
|
||||
Dummy implementation of the callback function vApplicationStackOverflowHook().
|
||||
*/
|
||||
#if (configCHECK_FOR_STACK_OVERFLOW > 0)
|
||||
__WEAK void vApplicationStackOverflowHook (TaskHandle_t xTask, signed char *pcTaskName) {
|
||||
(void)xTask;
|
||||
(void)pcTaskName;
|
||||
configASSERT(0);
|
||||
}
|
||||
#endif
|
||||
|
||||
/*---------------------------------------------------------------------------*/
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
/* External Idle and Timer task static memory allocation functions */
|
||||
extern void vApplicationGetIdleTaskMemory (StaticTask_t **ppxIdleTaskTCBBuffer, StackType_t **ppxIdleTaskStackBuffer, uint32_t *pulIdleTaskStackSize);
|
||||
extern void vApplicationGetTimerTaskMemory (StaticTask_t **ppxTimerTaskTCBBuffer, StackType_t **ppxTimerTaskStackBuffer, uint32_t *pulTimerTaskStackSize);
|
||||
|
||||
/*
|
||||
vApplicationGetIdleTaskMemory gets called when configSUPPORT_STATIC_ALLOCATION
|
||||
equals to 1 and is required for static memory allocation support.
|
||||
*/
|
||||
__WEAK void vApplicationGetIdleTaskMemory (StaticTask_t **ppxIdleTaskTCBBuffer, StackType_t **ppxIdleTaskStackBuffer, uint32_t *pulIdleTaskStackSize) {
|
||||
/* Idle task control block and stack */
|
||||
static StaticTask_t Idle_TCB;
|
||||
static StackType_t Idle_Stack[configMINIMAL_STACK_SIZE];
|
||||
|
||||
*ppxIdleTaskTCBBuffer = &Idle_TCB;
|
||||
*ppxIdleTaskStackBuffer = &Idle_Stack[0];
|
||||
*pulIdleTaskStackSize = (uint32_t)configMINIMAL_STACK_SIZE;
|
||||
}
|
||||
|
||||
/*
|
||||
vApplicationGetTimerTaskMemory gets called when configSUPPORT_STATIC_ALLOCATION
|
||||
equals to 1 and is required for static memory allocation support.
|
||||
*/
|
||||
__WEAK void vApplicationGetTimerTaskMemory (StaticTask_t **ppxTimerTaskTCBBuffer, StackType_t **ppxTimerTaskStackBuffer, uint32_t *pulTimerTaskStackSize) {
|
||||
/* Timer task control block and stack */
|
||||
static StaticTask_t Timer_TCB;
|
||||
static StackType_t Timer_Stack[configTIMER_TASK_STACK_DEPTH];
|
||||
|
||||
*ppxTimerTaskTCBBuffer = &Timer_TCB;
|
||||
*ppxTimerTaskStackBuffer = &Timer_Stack[0];
|
||||
*pulTimerTaskStackSize = (uint32_t)configTIMER_TASK_STACK_DEPTH;
|
||||
}
|
||||
#endif
|
||||
734
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/cmsis_os2.h
vendored
Normal file
734
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/cmsis_os2.h
vendored
Normal file
@@ -0,0 +1,734 @@
|
||||
/* --------------------------------------------------------------------------
|
||||
* Portions Copyright © 2017 STMicroelectronics International N.V. All rights reserved.
|
||||
* Portions Copyright (c) 2013-2017 ARM Limited. All rights reserved.
|
||||
* --------------------------------------------------------------------------
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the License); you may
|
||||
* not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an AS IS BASIS, WITHOUT
|
||||
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* Name: cmsis_os2.h
|
||||
* Purpose: CMSIS RTOS2 wrapper for FreeRTOS
|
||||
*
|
||||
*---------------------------------------------------------------------------*/
|
||||
|
||||
#ifndef CMSIS_OS2_H_
|
||||
#define CMSIS_OS2_H_
|
||||
|
||||
#ifndef __NO_RETURN
|
||||
#if defined(__CC_ARM)
|
||||
#define __NO_RETURN __declspec(noreturn)
|
||||
#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050)
|
||||
#define __NO_RETURN __attribute__((__noreturn__))
|
||||
#elif defined(__GNUC__)
|
||||
#define __NO_RETURN __attribute__((__noreturn__))
|
||||
#elif defined(__ICCARM__)
|
||||
#define __NO_RETURN __noreturn
|
||||
#else
|
||||
#define __NO_RETURN
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#include <stdint.h>
|
||||
#include <stddef.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C"
|
||||
{
|
||||
#endif
|
||||
|
||||
|
||||
// ==== Enumerations, structures, defines ====
|
||||
|
||||
/// Version information.
|
||||
typedef struct {
|
||||
uint32_t api; ///< API version (major.minor.rev: mmnnnrrrr dec).
|
||||
uint32_t kernel; ///< Kernel version (major.minor.rev: mmnnnrrrr dec).
|
||||
} osVersion_t;
|
||||
|
||||
/// Kernel state.
|
||||
typedef enum {
|
||||
osKernelInactive = 0, ///< Inactive.
|
||||
osKernelReady = 1, ///< Ready.
|
||||
osKernelRunning = 2, ///< Running.
|
||||
osKernelLocked = 3, ///< Locked.
|
||||
osKernelSuspended = 4, ///< Suspended.
|
||||
osKernelError = -1, ///< Error.
|
||||
osKernelReserved = 0x7FFFFFFFU ///< Prevents enum down-size compiler optimization.
|
||||
} osKernelState_t;
|
||||
|
||||
/// Thread state.
|
||||
typedef enum {
|
||||
osThreadInactive = 0, ///< Inactive.
|
||||
osThreadReady = 1, ///< Ready.
|
||||
osThreadRunning = 2, ///< Running.
|
||||
osThreadBlocked = 3, ///< Blocked.
|
||||
osThreadTerminated = 4, ///< Terminated.
|
||||
osThreadError = -1, ///< Error.
|
||||
osThreadReserved = 0x7FFFFFFF ///< Prevents enum down-size compiler optimization.
|
||||
} osThreadState_t;
|
||||
|
||||
/// Priority values.
|
||||
typedef enum {
|
||||
osPriorityNone = 0, ///< No priority (not initialized).
|
||||
osPriorityIdle = 1, ///< Reserved for Idle thread.
|
||||
osPriorityLow = 8, ///< Priority: low
|
||||
osPriorityLow1 = 8+1, ///< Priority: low + 1
|
||||
osPriorityLow2 = 8+2, ///< Priority: low + 2
|
||||
osPriorityLow3 = 8+3, ///< Priority: low + 3
|
||||
osPriorityLow4 = 8+4, ///< Priority: low + 4
|
||||
osPriorityLow5 = 8+5, ///< Priority: low + 5
|
||||
osPriorityLow6 = 8+6, ///< Priority: low + 6
|
||||
osPriorityLow7 = 8+7, ///< Priority: low + 7
|
||||
osPriorityBelowNormal = 16, ///< Priority: below normal
|
||||
osPriorityBelowNormal1 = 16+1, ///< Priority: below normal + 1
|
||||
osPriorityBelowNormal2 = 16+2, ///< Priority: below normal + 2
|
||||
osPriorityBelowNormal3 = 16+3, ///< Priority: below normal + 3
|
||||
osPriorityBelowNormal4 = 16+4, ///< Priority: below normal + 4
|
||||
osPriorityBelowNormal5 = 16+5, ///< Priority: below normal + 5
|
||||
osPriorityBelowNormal6 = 16+6, ///< Priority: below normal + 6
|
||||
osPriorityBelowNormal7 = 16+7, ///< Priority: below normal + 7
|
||||
osPriorityNormal = 24, ///< Priority: normal
|
||||
osPriorityNormal1 = 24+1, ///< Priority: normal + 1
|
||||
osPriorityNormal2 = 24+2, ///< Priority: normal + 2
|
||||
osPriorityNormal3 = 24+3, ///< Priority: normal + 3
|
||||
osPriorityNormal4 = 24+4, ///< Priority: normal + 4
|
||||
osPriorityNormal5 = 24+5, ///< Priority: normal + 5
|
||||
osPriorityNormal6 = 24+6, ///< Priority: normal + 6
|
||||
osPriorityNormal7 = 24+7, ///< Priority: normal + 7
|
||||
osPriorityAboveNormal = 32, ///< Priority: above normal
|
||||
osPriorityAboveNormal1 = 32+1, ///< Priority: above normal + 1
|
||||
osPriorityAboveNormal2 = 32+2, ///< Priority: above normal + 2
|
||||
osPriorityAboveNormal3 = 32+3, ///< Priority: above normal + 3
|
||||
osPriorityAboveNormal4 = 32+4, ///< Priority: above normal + 4
|
||||
osPriorityAboveNormal5 = 32+5, ///< Priority: above normal + 5
|
||||
osPriorityAboveNormal6 = 32+6, ///< Priority: above normal + 6
|
||||
osPriorityAboveNormal7 = 32+7, ///< Priority: above normal + 7
|
||||
osPriorityHigh = 40, ///< Priority: high
|
||||
osPriorityHigh1 = 40+1, ///< Priority: high + 1
|
||||
osPriorityHigh2 = 40+2, ///< Priority: high + 2
|
||||
osPriorityHigh3 = 40+3, ///< Priority: high + 3
|
||||
osPriorityHigh4 = 40+4, ///< Priority: high + 4
|
||||
osPriorityHigh5 = 40+5, ///< Priority: high + 5
|
||||
osPriorityHigh6 = 40+6, ///< Priority: high + 6
|
||||
osPriorityHigh7 = 40+7, ///< Priority: high + 7
|
||||
osPriorityRealtime = 48, ///< Priority: realtime
|
||||
osPriorityRealtime1 = 48+1, ///< Priority: realtime + 1
|
||||
osPriorityRealtime2 = 48+2, ///< Priority: realtime + 2
|
||||
osPriorityRealtime3 = 48+3, ///< Priority: realtime + 3
|
||||
osPriorityRealtime4 = 48+4, ///< Priority: realtime + 4
|
||||
osPriorityRealtime5 = 48+5, ///< Priority: realtime + 5
|
||||
osPriorityRealtime6 = 48+6, ///< Priority: realtime + 6
|
||||
osPriorityRealtime7 = 48+7, ///< Priority: realtime + 7
|
||||
osPriorityISR = 56, ///< Reserved for ISR deferred thread.
|
||||
osPriorityError = -1, ///< System cannot determine priority or illegal priority.
|
||||
osPriorityReserved = 0x7FFFFFFF ///< Prevents enum down-size compiler optimization.
|
||||
} osPriority_t;
|
||||
|
||||
/// Entry point of a thread.
|
||||
typedef void (*osThreadFunc_t) (void *argument);
|
||||
|
||||
/// Timer callback function.
|
||||
typedef void (*osTimerFunc_t) (void *argument);
|
||||
|
||||
/// Timer type.
|
||||
typedef enum {
|
||||
osTimerOnce = 0, ///< One-shot timer.
|
||||
osTimerPeriodic = 1 ///< Repeating timer.
|
||||
} osTimerType_t;
|
||||
|
||||
// Timeout value.
|
||||
#define osWaitForever 0xFFFFFFFFU ///< Wait forever timeout value.
|
||||
|
||||
// Flags options (\ref osThreadFlagsWait and \ref osEventFlagsWait).
|
||||
#define osFlagsWaitAny 0x00000000U ///< Wait for any flag (default).
|
||||
#define osFlagsWaitAll 0x00000001U ///< Wait for all flags.
|
||||
#define osFlagsNoClear 0x00000002U ///< Do not clear flags which have been specified to wait for.
|
||||
|
||||
// Flags errors (returned by osThreadFlagsXxxx and osEventFlagsXxxx).
|
||||
#define osFlagsError 0x80000000U ///< Error indicator.
|
||||
#define osFlagsErrorUnknown 0xFFFFFFFFU ///< osError (-1).
|
||||
#define osFlagsErrorTimeout 0xFFFFFFFEU ///< osErrorTimeout (-2).
|
||||
#define osFlagsErrorResource 0xFFFFFFFDU ///< osErrorResource (-3).
|
||||
#define osFlagsErrorParameter 0xFFFFFFFCU ///< osErrorParameter (-4).
|
||||
#define osFlagsErrorISR 0xFFFFFFFAU ///< osErrorISR (-6).
|
||||
|
||||
// Thread attributes (attr_bits in \ref osThreadAttr_t).
|
||||
#define osThreadDetached 0x00000000U ///< Thread created in detached mode (default)
|
||||
#define osThreadJoinable 0x00000001U ///< Thread created in joinable mode
|
||||
|
||||
// Mutex attributes (attr_bits in \ref osMutexAttr_t).
|
||||
#define osMutexRecursive 0x00000001U ///< Recursive mutex.
|
||||
#define osMutexPrioInherit 0x00000002U ///< Priority inherit protocol.
|
||||
#define osMutexRobust 0x00000008U ///< Robust mutex.
|
||||
|
||||
/// Status code values returned by CMSIS-RTOS functions.
|
||||
typedef enum {
|
||||
osOK = 0, ///< Operation completed successfully.
|
||||
osError = -1, ///< Unspecified RTOS error: run-time error but no other error message fits.
|
||||
osErrorTimeout = -2, ///< Operation not completed within the timeout period.
|
||||
osErrorResource = -3, ///< Resource not available.
|
||||
osErrorParameter = -4, ///< Parameter error.
|
||||
osErrorNoMemory = -5, ///< System is out of memory: it was impossible to allocate or reserve memory for the operation.
|
||||
osErrorISR = -6, ///< Not allowed in ISR context: the function cannot be called from interrupt service routines.
|
||||
osStatusReserved = 0x7FFFFFFF ///< Prevents enum down-size compiler optimization.
|
||||
} osStatus_t;
|
||||
|
||||
|
||||
/// \details Thread ID identifies the thread.
|
||||
typedef void *osThreadId_t;
|
||||
|
||||
/// \details Timer ID identifies the timer.
|
||||
typedef void *osTimerId_t;
|
||||
|
||||
/// \details Event Flags ID identifies the event flags.
|
||||
typedef void *osEventFlagsId_t;
|
||||
|
||||
/// \details Mutex ID identifies the mutex.
|
||||
typedef void *osMutexId_t;
|
||||
|
||||
/// \details Semaphore ID identifies the semaphore.
|
||||
typedef void *osSemaphoreId_t;
|
||||
|
||||
/// \details Memory Pool ID identifies the memory pool.
|
||||
typedef void *osMemoryPoolId_t;
|
||||
|
||||
/// \details Message Queue ID identifies the message queue.
|
||||
typedef void *osMessageQueueId_t;
|
||||
|
||||
|
||||
#ifndef TZ_MODULEID_T
|
||||
#define TZ_MODULEID_T
|
||||
/// \details Data type that identifies secure software modules called by a process.
|
||||
typedef uint32_t TZ_ModuleId_t;
|
||||
#endif
|
||||
|
||||
|
||||
/// Attributes structure for thread.
|
||||
typedef struct {
|
||||
const char *name; ///< name of the thread
|
||||
uint32_t attr_bits; ///< attribute bits
|
||||
void *cb_mem; ///< memory for control block
|
||||
uint32_t cb_size; ///< size of provided memory for control block
|
||||
void *stack_mem; ///< memory for stack
|
||||
uint32_t stack_size; ///< size of stack
|
||||
osPriority_t priority; ///< initial thread priority (default: osPriorityNormal)
|
||||
TZ_ModuleId_t tz_module; ///< TrustZone module identifier
|
||||
uint32_t reserved; ///< reserved (must be 0)
|
||||
} osThreadAttr_t;
|
||||
|
||||
/// Attributes structure for timer.
|
||||
typedef struct {
|
||||
const char *name; ///< name of the timer
|
||||
uint32_t attr_bits; ///< attribute bits
|
||||
void *cb_mem; ///< memory for control block
|
||||
uint32_t cb_size; ///< size of provided memory for control block
|
||||
} osTimerAttr_t;
|
||||
|
||||
/// Attributes structure for event flags.
|
||||
typedef struct {
|
||||
const char *name; ///< name of the event flags
|
||||
uint32_t attr_bits; ///< attribute bits
|
||||
void *cb_mem; ///< memory for control block
|
||||
uint32_t cb_size; ///< size of provided memory for control block
|
||||
} osEventFlagsAttr_t;
|
||||
|
||||
/// Attributes structure for mutex.
|
||||
typedef struct {
|
||||
const char *name; ///< name of the mutex
|
||||
uint32_t attr_bits; ///< attribute bits
|
||||
void *cb_mem; ///< memory for control block
|
||||
uint32_t cb_size; ///< size of provided memory for control block
|
||||
} osMutexAttr_t;
|
||||
|
||||
/// Attributes structure for semaphore.
|
||||
typedef struct {
|
||||
const char *name; ///< name of the semaphore
|
||||
uint32_t attr_bits; ///< attribute bits
|
||||
void *cb_mem; ///< memory for control block
|
||||
uint32_t cb_size; ///< size of provided memory for control block
|
||||
} osSemaphoreAttr_t;
|
||||
|
||||
/// Attributes structure for memory pool.
|
||||
typedef struct {
|
||||
const char *name; ///< name of the memory pool
|
||||
uint32_t attr_bits; ///< attribute bits
|
||||
void *cb_mem; ///< memory for control block
|
||||
uint32_t cb_size; ///< size of provided memory for control block
|
||||
void *mp_mem; ///< memory for data storage
|
||||
uint32_t mp_size; ///< size of provided memory for data storage
|
||||
} osMemoryPoolAttr_t;
|
||||
|
||||
/// Attributes structure for message queue.
|
||||
typedef struct {
|
||||
const char *name; ///< name of the message queue
|
||||
uint32_t attr_bits; ///< attribute bits
|
||||
void *cb_mem; ///< memory for control block
|
||||
uint32_t cb_size; ///< size of provided memory for control block
|
||||
void *mq_mem; ///< memory for data storage
|
||||
uint32_t mq_size; ///< size of provided memory for data storage
|
||||
} osMessageQueueAttr_t;
|
||||
|
||||
|
||||
// ==== Kernel Management Functions ====
|
||||
|
||||
/// Initialize the RTOS Kernel.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osKernelInitialize (void);
|
||||
|
||||
/// Get RTOS Kernel Information.
|
||||
/// \param[out] version pointer to buffer for retrieving version information.
|
||||
/// \param[out] id_buf pointer to buffer for retrieving kernel identification string.
|
||||
/// \param[in] id_size size of buffer for kernel identification string.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osKernelGetInfo (osVersion_t *version, char *id_buf, uint32_t id_size);
|
||||
|
||||
/// Get the current RTOS Kernel state.
|
||||
/// \return current RTOS Kernel state.
|
||||
osKernelState_t osKernelGetState (void);
|
||||
|
||||
/// Start the RTOS Kernel scheduler.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osKernelStart (void);
|
||||
|
||||
/// Lock the RTOS Kernel scheduler.
|
||||
/// \return previous lock state (1 - locked, 0 - not locked, error code if negative).
|
||||
int32_t osKernelLock (void);
|
||||
|
||||
/// Unlock the RTOS Kernel scheduler.
|
||||
/// \return previous lock state (1 - locked, 0 - not locked, error code if negative).
|
||||
int32_t osKernelUnlock (void);
|
||||
|
||||
/// Restore the RTOS Kernel scheduler lock state.
|
||||
/// \param[in] lock lock state obtained by \ref osKernelLock or \ref osKernelUnlock.
|
||||
/// \return new lock state (1 - locked, 0 - not locked, error code if negative).
|
||||
int32_t osKernelRestoreLock (int32_t lock);
|
||||
|
||||
/// Suspend the RTOS Kernel scheduler.
|
||||
/// \return time in ticks, for how long the system can sleep or power-down.
|
||||
uint32_t osKernelSuspend (void);
|
||||
|
||||
/// Resume the RTOS Kernel scheduler.
|
||||
/// \param[in] sleep_ticks time in ticks for how long the system was in sleep or power-down mode.
|
||||
void osKernelResume (uint32_t sleep_ticks);
|
||||
|
||||
/// Get the RTOS kernel tick count.
|
||||
/// \return RTOS kernel current tick count.
|
||||
uint32_t osKernelGetTickCount (void);
|
||||
|
||||
/// Get the RTOS kernel tick frequency.
|
||||
/// \return frequency of the kernel tick in hertz, i.e. kernel ticks per second.
|
||||
uint32_t osKernelGetTickFreq (void);
|
||||
|
||||
/// Get the RTOS kernel system timer count.
|
||||
/// \return RTOS kernel current system timer count as 32-bit value.
|
||||
uint32_t osKernelGetSysTimerCount (void);
|
||||
|
||||
/// Get the RTOS kernel system timer frequency.
|
||||
/// \return frequency of the system timer in hertz, i.e. timer ticks per second.
|
||||
uint32_t osKernelGetSysTimerFreq (void);
|
||||
|
||||
|
||||
// ==== Thread Management Functions ====
|
||||
|
||||
/// Create a thread and add it to Active Threads.
|
||||
/// \param[in] func thread function.
|
||||
/// \param[in] argument pointer that is passed to the thread function as start argument.
|
||||
/// \param[in] attr thread attributes; NULL: default values.
|
||||
/// \return thread ID for reference by other functions or NULL in case of error.
|
||||
osThreadId_t osThreadNew (osThreadFunc_t func, void *argument, const osThreadAttr_t *attr);
|
||||
|
||||
/// Get name of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return name as NULL terminated string.
|
||||
const char *osThreadGetName (osThreadId_t thread_id);
|
||||
|
||||
/// Return the thread ID of the current running thread.
|
||||
/// \return thread ID for reference by other functions or NULL in case of error.
|
||||
osThreadId_t osThreadGetId (void);
|
||||
|
||||
/// Get current thread state of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return current thread state of the specified thread.
|
||||
osThreadState_t osThreadGetState (osThreadId_t thread_id);
|
||||
|
||||
/// Get stack size of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return stack size in bytes.
|
||||
uint32_t osThreadGetStackSize (osThreadId_t thread_id);
|
||||
|
||||
/// Get available stack space of a thread based on stack watermark recording during execution.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return remaining stack space in bytes.
|
||||
uint32_t osThreadGetStackSpace (osThreadId_t thread_id);
|
||||
|
||||
/// Change priority of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \param[in] priority new priority value for the thread function.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osThreadSetPriority (osThreadId_t thread_id, osPriority_t priority);
|
||||
|
||||
/// Get current priority of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return current priority value of the specified thread.
|
||||
osPriority_t osThreadGetPriority (osThreadId_t thread_id);
|
||||
|
||||
/// Pass control to next thread that is in state \b READY.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osThreadYield (void);
|
||||
|
||||
/// Suspend execution of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osThreadSuspend (osThreadId_t thread_id);
|
||||
|
||||
/// Resume execution of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osThreadResume (osThreadId_t thread_id);
|
||||
|
||||
/// Detach a thread (thread storage can be reclaimed when thread terminates).
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osThreadDetach (osThreadId_t thread_id);
|
||||
|
||||
/// Wait for specified thread to terminate.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osThreadJoin (osThreadId_t thread_id);
|
||||
|
||||
/// Terminate execution of current running thread.
|
||||
__NO_RETURN void osThreadExit (void);
|
||||
|
||||
/// Terminate execution of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osThreadTerminate (osThreadId_t thread_id);
|
||||
|
||||
/// Get number of active threads.
|
||||
/// \return number of active threads.
|
||||
uint32_t osThreadGetCount (void);
|
||||
|
||||
/// Enumerate active threads.
|
||||
/// \param[out] thread_array pointer to array for retrieving thread IDs.
|
||||
/// \param[in] array_items maximum number of items in array for retrieving thread IDs.
|
||||
/// \return number of enumerated threads.
|
||||
uint32_t osThreadEnumerate (osThreadId_t *thread_array, uint32_t array_items);
|
||||
|
||||
|
||||
// ==== Thread Flags Functions ====
|
||||
|
||||
/// Set the specified Thread Flags of a thread.
|
||||
/// \param[in] thread_id thread ID obtained by \ref osThreadNew or \ref osThreadGetId.
|
||||
/// \param[in] flags specifies the flags of the thread that shall be set.
|
||||
/// \return thread flags after setting or error code if highest bit set.
|
||||
uint32_t osThreadFlagsSet (osThreadId_t thread_id, uint32_t flags);
|
||||
|
||||
/// Clear the specified Thread Flags of current running thread.
|
||||
/// \param[in] flags specifies the flags of the thread that shall be cleared.
|
||||
/// \return thread flags before clearing or error code if highest bit set.
|
||||
uint32_t osThreadFlagsClear (uint32_t flags);
|
||||
|
||||
/// Get the current Thread Flags of current running thread.
|
||||
/// \return current thread flags.
|
||||
uint32_t osThreadFlagsGet (void);
|
||||
|
||||
/// Wait for one or more Thread Flags of the current running thread to become signaled.
|
||||
/// \param[in] flags specifies the flags to wait for.
|
||||
/// \param[in] options specifies flags options (osFlagsXxxx).
|
||||
/// \param[in] timeout \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return thread flags before clearing or error code if highest bit set.
|
||||
uint32_t osThreadFlagsWait (uint32_t flags, uint32_t options, uint32_t timeout);
|
||||
|
||||
|
||||
// ==== Generic Wait Functions ====
|
||||
|
||||
/// Wait for Timeout (Time Delay).
|
||||
/// \param[in] ticks \ref CMSIS_RTOS_TimeOutValue "time ticks" value
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osDelay (uint32_t ticks);
|
||||
|
||||
/// Wait until specified time.
|
||||
/// \param[in] ticks absolute time in ticks
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osDelayUntil (uint32_t ticks);
|
||||
|
||||
|
||||
// ==== Timer Management Functions ====
|
||||
|
||||
/// Create and Initialize a timer.
|
||||
/// \param[in] func function pointer to callback function.
|
||||
/// \param[in] type \ref osTimerOnce for one-shot or \ref osTimerPeriodic for periodic behavior.
|
||||
/// \param[in] argument argument to the timer callback function.
|
||||
/// \param[in] attr timer attributes; NULL: default values.
|
||||
/// \return timer ID for reference by other functions or NULL in case of error.
|
||||
osTimerId_t osTimerNew (osTimerFunc_t func, osTimerType_t type, void *argument, const osTimerAttr_t *attr);
|
||||
|
||||
/// Get name of a timer.
|
||||
/// \param[in] timer_id timer ID obtained by \ref osTimerNew.
|
||||
/// \return name as NULL terminated string.
|
||||
const char *osTimerGetName (osTimerId_t timer_id);
|
||||
|
||||
/// Start or restart a timer.
|
||||
/// \param[in] timer_id timer ID obtained by \ref osTimerNew.
|
||||
/// \param[in] ticks \ref CMSIS_RTOS_TimeOutValue "time ticks" value of the timer.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osTimerStart (osTimerId_t timer_id, uint32_t ticks);
|
||||
|
||||
/// Stop a timer.
|
||||
/// \param[in] timer_id timer ID obtained by \ref osTimerNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osTimerStop (osTimerId_t timer_id);
|
||||
|
||||
/// Check if a timer is running.
|
||||
/// \param[in] timer_id timer ID obtained by \ref osTimerNew.
|
||||
/// \return 0 not running, 1 running.
|
||||
uint32_t osTimerIsRunning (osTimerId_t timer_id);
|
||||
|
||||
/// Delete a timer.
|
||||
/// \param[in] timer_id timer ID obtained by \ref osTimerNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osTimerDelete (osTimerId_t timer_id);
|
||||
|
||||
|
||||
// ==== Event Flags Management Functions ====
|
||||
|
||||
/// Create and Initialize an Event Flags object.
|
||||
/// \param[in] attr event flags attributes; NULL: default values.
|
||||
/// \return event flags ID for reference by other functions or NULL in case of error.
|
||||
osEventFlagsId_t osEventFlagsNew (const osEventFlagsAttr_t *attr);
|
||||
|
||||
/// Get name of an Event Flags object.
|
||||
/// \param[in] ef_id event flags ID obtained by \ref osEventFlagsNew.
|
||||
/// \return name as NULL terminated string.
|
||||
const char *osEventFlagsGetName (osEventFlagsId_t ef_id);
|
||||
|
||||
/// Set the specified Event Flags.
|
||||
/// \param[in] ef_id event flags ID obtained by \ref osEventFlagsNew.
|
||||
/// \param[in] flags specifies the flags that shall be set.
|
||||
/// \return event flags after setting or error code if highest bit set.
|
||||
uint32_t osEventFlagsSet (osEventFlagsId_t ef_id, uint32_t flags);
|
||||
|
||||
/// Clear the specified Event Flags.
|
||||
/// \param[in] ef_id event flags ID obtained by \ref osEventFlagsNew.
|
||||
/// \param[in] flags specifies the flags that shall be cleared.
|
||||
/// \return event flags before clearing or error code if highest bit set.
|
||||
uint32_t osEventFlagsClear (osEventFlagsId_t ef_id, uint32_t flags);
|
||||
|
||||
/// Get the current Event Flags.
|
||||
/// \param[in] ef_id event flags ID obtained by \ref osEventFlagsNew.
|
||||
/// \return current event flags.
|
||||
uint32_t osEventFlagsGet (osEventFlagsId_t ef_id);
|
||||
|
||||
/// Wait for one or more Event Flags to become signaled.
|
||||
/// \param[in] ef_id event flags ID obtained by \ref osEventFlagsNew.
|
||||
/// \param[in] flags specifies the flags to wait for.
|
||||
/// \param[in] options specifies flags options (osFlagsXxxx).
|
||||
/// \param[in] timeout \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return event flags before clearing or error code if highest bit set.
|
||||
uint32_t osEventFlagsWait (osEventFlagsId_t ef_id, uint32_t flags, uint32_t options, uint32_t timeout);
|
||||
|
||||
/// Delete an Event Flags object.
|
||||
/// \param[in] ef_id event flags ID obtained by \ref osEventFlagsNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osEventFlagsDelete (osEventFlagsId_t ef_id);
|
||||
|
||||
|
||||
// ==== Mutex Management Functions ====
|
||||
|
||||
/// Create and Initialize a Mutex object.
|
||||
/// \param[in] attr mutex attributes; NULL: default values.
|
||||
/// \return mutex ID for reference by other functions or NULL in case of error.
|
||||
osMutexId_t osMutexNew (const osMutexAttr_t *attr);
|
||||
|
||||
/// Get name of a Mutex object.
|
||||
/// \param[in] mutex_id mutex ID obtained by \ref osMutexNew.
|
||||
/// \return name as NULL terminated string.
|
||||
const char *osMutexGetName (osMutexId_t mutex_id);
|
||||
|
||||
/// Acquire a Mutex or timeout if it is locked.
|
||||
/// \param[in] mutex_id mutex ID obtained by \ref osMutexNew.
|
||||
/// \param[in] timeout \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMutexAcquire (osMutexId_t mutex_id, uint32_t timeout);
|
||||
|
||||
/// Release a Mutex that was acquired by \ref osMutexAcquire.
|
||||
/// \param[in] mutex_id mutex ID obtained by \ref osMutexNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMutexRelease (osMutexId_t mutex_id);
|
||||
|
||||
/// Get Thread which owns a Mutex object.
|
||||
/// \param[in] mutex_id mutex ID obtained by \ref osMutexNew.
|
||||
/// \return thread ID of owner thread or NULL when mutex was not acquired.
|
||||
osThreadId_t osMutexGetOwner (osMutexId_t mutex_id);
|
||||
|
||||
/// Delete a Mutex object.
|
||||
/// \param[in] mutex_id mutex ID obtained by \ref osMutexNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMutexDelete (osMutexId_t mutex_id);
|
||||
|
||||
|
||||
// ==== Semaphore Management Functions ====
|
||||
|
||||
/// Create and Initialize a Semaphore object.
|
||||
/// \param[in] max_count maximum number of available tokens.
|
||||
/// \param[in] initial_count initial number of available tokens.
|
||||
/// \param[in] attr semaphore attributes; NULL: default values.
|
||||
/// \return semaphore ID for reference by other functions or NULL in case of error.
|
||||
osSemaphoreId_t osSemaphoreNew (uint32_t max_count, uint32_t initial_count, const osSemaphoreAttr_t *attr);
|
||||
|
||||
/// Get name of a Semaphore object.
|
||||
/// \param[in] semaphore_id semaphore ID obtained by \ref osSemaphoreNew.
|
||||
/// \return name as NULL terminated string.
|
||||
const char *osSemaphoreGetName (osSemaphoreId_t semaphore_id);
|
||||
|
||||
/// Acquire a Semaphore token or timeout if no tokens are available.
|
||||
/// \param[in] semaphore_id semaphore ID obtained by \ref osSemaphoreNew.
|
||||
/// \param[in] timeout \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osSemaphoreAcquire (osSemaphoreId_t semaphore_id, uint32_t timeout);
|
||||
|
||||
/// Release a Semaphore token up to the initial maximum count.
|
||||
/// \param[in] semaphore_id semaphore ID obtained by \ref osSemaphoreNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osSemaphoreRelease (osSemaphoreId_t semaphore_id);
|
||||
|
||||
/// Get current Semaphore token count.
|
||||
/// \param[in] semaphore_id semaphore ID obtained by \ref osSemaphoreNew.
|
||||
/// \return number of tokens available.
|
||||
uint32_t osSemaphoreGetCount (osSemaphoreId_t semaphore_id);
|
||||
|
||||
/// Delete a Semaphore object.
|
||||
/// \param[in] semaphore_id semaphore ID obtained by \ref osSemaphoreNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osSemaphoreDelete (osSemaphoreId_t semaphore_id);
|
||||
|
||||
|
||||
// ==== Memory Pool Management Functions ====
|
||||
|
||||
/// Create and Initialize a Memory Pool object.
|
||||
/// \param[in] block_count maximum number of memory blocks in memory pool.
|
||||
/// \param[in] block_size memory block size in bytes.
|
||||
/// \param[in] attr memory pool attributes; NULL: default values.
|
||||
/// \return memory pool ID for reference by other functions or NULL in case of error.
|
||||
osMemoryPoolId_t osMemoryPoolNew (uint32_t block_count, uint32_t block_size, const osMemoryPoolAttr_t *attr);
|
||||
|
||||
/// Get name of a Memory Pool object.
|
||||
/// \param[in] mp_id memory pool ID obtained by \ref osMemoryPoolNew.
|
||||
/// \return name as NULL terminated string.
|
||||
const char *osMemoryPoolGetName (osMemoryPoolId_t mp_id);
|
||||
|
||||
/// Allocate a memory block from a Memory Pool.
|
||||
/// \param[in] mp_id memory pool ID obtained by \ref osMemoryPoolNew.
|
||||
/// \param[in] timeout \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return address of the allocated memory block or NULL in case of no memory is available.
|
||||
void *osMemoryPoolAlloc (osMemoryPoolId_t mp_id, uint32_t timeout);
|
||||
|
||||
/// Return an allocated memory block back to a Memory Pool.
|
||||
/// \param[in] mp_id memory pool ID obtained by \ref osMemoryPoolNew.
|
||||
/// \param[in] block address of the allocated memory block to be returned to the memory pool.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMemoryPoolFree (osMemoryPoolId_t mp_id, void *block);
|
||||
|
||||
/// Get maximum number of memory blocks in a Memory Pool.
|
||||
/// \param[in] mp_id memory pool ID obtained by \ref osMemoryPoolNew.
|
||||
/// \return maximum number of memory blocks.
|
||||
uint32_t osMemoryPoolGetCapacity (osMemoryPoolId_t mp_id);
|
||||
|
||||
/// Get memory block size in a Memory Pool.
|
||||
/// \param[in] mp_id memory pool ID obtained by \ref osMemoryPoolNew.
|
||||
/// \return memory block size in bytes.
|
||||
uint32_t osMemoryPoolGetBlockSize (osMemoryPoolId_t mp_id);
|
||||
|
||||
/// Get number of memory blocks used in a Memory Pool.
|
||||
/// \param[in] mp_id memory pool ID obtained by \ref osMemoryPoolNew.
|
||||
/// \return number of memory blocks used.
|
||||
uint32_t osMemoryPoolGetCount (osMemoryPoolId_t mp_id);
|
||||
|
||||
/// Get number of memory blocks available in a Memory Pool.
|
||||
/// \param[in] mp_id memory pool ID obtained by \ref osMemoryPoolNew.
|
||||
/// \return number of memory blocks available.
|
||||
uint32_t osMemoryPoolGetSpace (osMemoryPoolId_t mp_id);
|
||||
|
||||
/// Delete a Memory Pool object.
|
||||
/// \param[in] mp_id memory pool ID obtained by \ref osMemoryPoolNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMemoryPoolDelete (osMemoryPoolId_t mp_id);
|
||||
|
||||
|
||||
// ==== Message Queue Management Functions ====
|
||||
|
||||
/// Create and Initialize a Message Queue object.
|
||||
/// \param[in] msg_count maximum number of messages in queue.
|
||||
/// \param[in] msg_size maximum message size in bytes.
|
||||
/// \param[in] attr message queue attributes; NULL: default values.
|
||||
/// \return message queue ID for reference by other functions or NULL in case of error.
|
||||
osMessageQueueId_t osMessageQueueNew (uint32_t msg_count, uint32_t msg_size, const osMessageQueueAttr_t *attr);
|
||||
|
||||
/// Get name of a Message Queue object.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \return name as NULL terminated string.
|
||||
const char *osMessageQueueGetName (osMessageQueueId_t mq_id);
|
||||
|
||||
/// Put a Message into a Queue or timeout if Queue is full.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \param[in] msg_ptr pointer to buffer with message to put into a queue.
|
||||
/// \param[in] msg_prio message priority.
|
||||
/// \param[in] timeout \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMessageQueuePut (osMessageQueueId_t mq_id, const void *msg_ptr, uint8_t msg_prio, uint32_t timeout);
|
||||
|
||||
/// Get a Message from a Queue or timeout if Queue is empty.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \param[out] msg_ptr pointer to buffer for message to get from a queue.
|
||||
/// \param[out] msg_prio pointer to buffer for message priority or NULL.
|
||||
/// \param[in] timeout \ref CMSIS_RTOS_TimeOutValue or 0 in case of no time-out.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMessageQueueGet (osMessageQueueId_t mq_id, void *msg_ptr, uint8_t *msg_prio, uint32_t timeout);
|
||||
|
||||
/// Get maximum number of messages in a Message Queue.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \return maximum number of messages.
|
||||
uint32_t osMessageQueueGetCapacity (osMessageQueueId_t mq_id);
|
||||
|
||||
/// Get maximum message size in a Memory Pool.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \return maximum message size in bytes.
|
||||
uint32_t osMessageQueueGetMsgSize (osMessageQueueId_t mq_id);
|
||||
|
||||
/// Get number of queued messages in a Message Queue.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \return number of queued messages.
|
||||
uint32_t osMessageQueueGetCount (osMessageQueueId_t mq_id);
|
||||
|
||||
/// Get number of available slots for messages in a Message Queue.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \return number of available slots for messages.
|
||||
uint32_t osMessageQueueGetSpace (osMessageQueueId_t mq_id);
|
||||
|
||||
/// Reset a Message Queue to initial empty state.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMessageQueueReset (osMessageQueueId_t mq_id);
|
||||
|
||||
/// Delete a Message Queue object.
|
||||
/// \param[in] mq_id message queue ID obtained by \ref osMessageQueueNew.
|
||||
/// \return status code that indicates the execution status of the function.
|
||||
osStatus_t osMessageQueueDelete (osMessageQueueId_t mq_id);
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif // CMSIS_OS2_H_
|
||||
63
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/freertos_mpool.h
vendored
Normal file
63
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/freertos_mpool.h
vendored
Normal file
@@ -0,0 +1,63 @@
|
||||
/* --------------------------------------------------------------------------
|
||||
* Copyright (c) 2013-2020 Arm Limited. All rights reserved.
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the License); you may
|
||||
* not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an AS IS BASIS, WITHOUT
|
||||
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* Name: freertos_mpool.h
|
||||
* Purpose: CMSIS RTOS2 wrapper for FreeRTOS
|
||||
*
|
||||
*---------------------------------------------------------------------------*/
|
||||
|
||||
#ifndef FREERTOS_MPOOL_H_
|
||||
#define FREERTOS_MPOOL_H_
|
||||
|
||||
#include <stdint.h>
|
||||
#include "FreeRTOS.h"
|
||||
#include "semphr.h"
|
||||
|
||||
/* Memory Pool implementation definitions */
|
||||
#define MPOOL_STATUS 0x5EED0000U
|
||||
|
||||
/* Memory Block header */
|
||||
typedef struct {
|
||||
void *next; /* Pointer to next block */
|
||||
} MemPoolBlock_t;
|
||||
|
||||
/* Memory Pool control block */
|
||||
typedef struct MemPoolDef_t {
|
||||
MemPoolBlock_t *head; /* Pointer to head block */
|
||||
SemaphoreHandle_t sem; /* Pool semaphore handle */
|
||||
uint8_t *mem_arr; /* Pool memory array */
|
||||
uint32_t mem_sz; /* Pool memory array size */
|
||||
const char *name; /* Pointer to name string */
|
||||
uint32_t bl_sz; /* Size of a single block */
|
||||
uint32_t bl_cnt; /* Number of blocks */
|
||||
uint32_t n; /* Block allocation index */
|
||||
volatile uint32_t status; /* Object status flags */
|
||||
#if (configSUPPORT_STATIC_ALLOCATION == 1)
|
||||
StaticSemaphore_t mem_sem; /* Semaphore object memory */
|
||||
#endif
|
||||
} MemPool_t;
|
||||
|
||||
/* No need to hide static object type, just align to coding style */
|
||||
#define StaticMemPool_t MemPool_t
|
||||
|
||||
/* Define memory pool control block size */
|
||||
#define MEMPOOL_CB_SIZE (sizeof(StaticMemPool_t))
|
||||
|
||||
/* Define size of the byte array required to create count of blocks of given size */
|
||||
#define MEMPOOL_ARR_SIZE(bl_count, bl_size) (((((bl_size) + (4 - 1)) / 4) * 4)*(bl_count))
|
||||
|
||||
#endif /* FREERTOS_MPOOL_H_ */
|
||||
310
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/freertos_os2.h
vendored
Normal file
310
Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2/freertos_os2.h
vendored
Normal file
@@ -0,0 +1,310 @@
|
||||
/* --------------------------------------------------------------------------
|
||||
* Copyright (c) 2013-2020 Arm Limited. All rights reserved.
|
||||
*
|
||||
* SPDX-License-Identifier: Apache-2.0
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the License); you may
|
||||
* not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an AS IS BASIS, WITHOUT
|
||||
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* Name: freertos_os2.h
|
||||
* Purpose: CMSIS RTOS2 wrapper for FreeRTOS
|
||||
*
|
||||
*---------------------------------------------------------------------------*/
|
||||
|
||||
#ifndef FREERTOS_OS2_H_
|
||||
#define FREERTOS_OS2_H_
|
||||
|
||||
#include <string.h>
|
||||
#include <stdint.h>
|
||||
|
||||
#include "FreeRTOS.h" // ARM.FreeRTOS::RTOS:Core
|
||||
|
||||
#include CMSIS_device_header
|
||||
|
||||
/*
|
||||
CMSIS-RTOS2 FreeRTOS image size optimization definitions.
|
||||
|
||||
Note: Definitions configUSE_OS2 can be used to optimize FreeRTOS image size when
|
||||
certain functionality is not required when using CMSIS-RTOS2 API.
|
||||
In general optimization decisions are left to the tool chain but in cases
|
||||
when coding style prevents it to optimize the code following optional
|
||||
definitions can be used.
|
||||
*/
|
||||
|
||||
/*
|
||||
Option to exclude CMSIS-RTOS2 functions osThreadSuspend and osThreadResume from
|
||||
the application image.
|
||||
*/
|
||||
#ifndef configUSE_OS2_THREAD_SUSPEND_RESUME
|
||||
#define configUSE_OS2_THREAD_SUSPEND_RESUME 1
|
||||
#endif
|
||||
|
||||
/*
|
||||
Option to exclude CMSIS-RTOS2 function osThreadEnumerate from the application image.
|
||||
*/
|
||||
#ifndef configUSE_OS2_THREAD_ENUMERATE
|
||||
#define configUSE_OS2_THREAD_ENUMERATE 1
|
||||
#endif
|
||||
|
||||
/*
|
||||
Option to disable CMSIS-RTOS2 function osEventFlagsSet and osEventFlagsClear
|
||||
operation from ISR.
|
||||
*/
|
||||
#ifndef configUSE_OS2_EVENTFLAGS_FROM_ISR
|
||||
#define configUSE_OS2_EVENTFLAGS_FROM_ISR 1
|
||||
#endif
|
||||
|
||||
/*
|
||||
Option to exclude CMSIS-RTOS2 Thread Flags API functions from the application image.
|
||||
*/
|
||||
#ifndef configUSE_OS2_THREAD_FLAGS
|
||||
#define configUSE_OS2_THREAD_FLAGS configUSE_TASK_NOTIFICATIONS
|
||||
#endif
|
||||
|
||||
/*
|
||||
Option to exclude CMSIS-RTOS2 Timer API functions from the application image.
|
||||
*/
|
||||
#ifndef configUSE_OS2_TIMER
|
||||
#define configUSE_OS2_TIMER configUSE_TIMERS
|
||||
#endif
|
||||
|
||||
/*
|
||||
Option to exclude CMSIS-RTOS2 Mutex API functions from the application image.
|
||||
*/
|
||||
#ifndef configUSE_OS2_MUTEX
|
||||
#define configUSE_OS2_MUTEX configUSE_MUTEXES
|
||||
#endif
|
||||
|
||||
|
||||
/*
|
||||
CMSIS-RTOS2 FreeRTOS configuration check (FreeRTOSConfig.h).
|
||||
|
||||
Note: CMSIS-RTOS API requires functions included by using following definitions.
|
||||
In case if certain API function is not used compiler will optimize it away.
|
||||
*/
|
||||
#if (INCLUDE_xSemaphoreGetMutexHolder == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osMutexGetOwner uses FreeRTOS function xSemaphoreGetMutexHolder. In case if
|
||||
osMutexGetOwner is not used in the application image, compiler will optimize it away.
|
||||
Set #define INCLUDE_xSemaphoreGetMutexHolder 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_xSemaphoreGetMutexHolder must equal 1 to implement Mutex Management API."
|
||||
#endif
|
||||
#if (INCLUDE_vTaskDelay == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osDelay uses FreeRTOS function vTaskDelay. In case if
|
||||
osDelay is not used in the application image, compiler will optimize it away.
|
||||
Set #define INCLUDE_vTaskDelay 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_vTaskDelay must equal 1 to implement Generic Wait Functions API."
|
||||
#endif
|
||||
#if (INCLUDE_vTaskDelayUntil == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osDelayUntil uses FreeRTOS function vTaskDelayUntil. In case if
|
||||
osDelayUntil is not used in the application image, compiler will optimize it away.
|
||||
Set #define INCLUDE_vTaskDelayUntil 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_vTaskDelayUntil must equal 1 to implement Generic Wait Functions API."
|
||||
#endif
|
||||
#if (INCLUDE_vTaskDelete == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osThreadTerminate and osThreadExit uses FreeRTOS function
|
||||
vTaskDelete. In case if they are not used in the application image, compiler
|
||||
will optimize them away.
|
||||
Set #define INCLUDE_vTaskDelete 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_vTaskDelete must equal 1 to implement Thread Management API."
|
||||
#endif
|
||||
#if (INCLUDE_xTaskGetCurrentTaskHandle == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 API uses FreeRTOS function xTaskGetCurrentTaskHandle to implement
|
||||
functions osThreadGetId, osThreadFlagsClear and osThreadFlagsGet. In case if these
|
||||
functions are not used in the application image, compiler will optimize them away.
|
||||
Set #define INCLUDE_xTaskGetCurrentTaskHandle 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_xTaskGetCurrentTaskHandle must equal 1 to implement Thread Management API."
|
||||
#endif
|
||||
#if (INCLUDE_xTaskGetSchedulerState == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 API uses FreeRTOS function xTaskGetSchedulerState to implement Kernel
|
||||
tick handling and therefore it is vital that xTaskGetSchedulerState is included into
|
||||
the application image.
|
||||
Set #define INCLUDE_xTaskGetSchedulerState 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_xTaskGetSchedulerState must equal 1 to implement Kernel Information and Control API."
|
||||
#endif
|
||||
#if (INCLUDE_uxTaskGetStackHighWaterMark == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osThreadGetStackSpace uses FreeRTOS function uxTaskGetStackHighWaterMark.
|
||||
In case if osThreadGetStackSpace is not used in the application image, compiler will
|
||||
optimize it away.
|
||||
Set #define INCLUDE_uxTaskGetStackHighWaterMark 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_uxTaskGetStackHighWaterMark must equal 1 to implement Thread Management API."
|
||||
#endif
|
||||
#if (INCLUDE_uxTaskPriorityGet == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osThreadGetPriority uses FreeRTOS function uxTaskPriorityGet. In case if
|
||||
osThreadGetPriority is not used in the application image, compiler will optimize it away.
|
||||
Set #define INCLUDE_uxTaskPriorityGet 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_uxTaskPriorityGet must equal 1 to implement Thread Management API."
|
||||
#endif
|
||||
#if (INCLUDE_vTaskPrioritySet == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osThreadSetPriority uses FreeRTOS function vTaskPrioritySet. In case if
|
||||
osThreadSetPriority is not used in the application image, compiler will optimize it away.
|
||||
Set #define INCLUDE_vTaskPrioritySet 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_vTaskPrioritySet must equal 1 to implement Thread Management API."
|
||||
#endif
|
||||
#if (INCLUDE_eTaskGetState == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 API uses FreeRTOS function vTaskDelayUntil to implement functions osThreadGetState
|
||||
and osThreadTerminate. In case if these functions are not used in the application image,
|
||||
compiler will optimize them away.
|
||||
Set #define INCLUDE_eTaskGetState 1 to fix this error.
|
||||
*/
|
||||
#error "Definition INCLUDE_eTaskGetState must equal 1 to implement Thread Management API."
|
||||
#endif
|
||||
#if (INCLUDE_vTaskSuspend == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 API uses FreeRTOS functions vTaskSuspend and vTaskResume to implement
|
||||
functions osThreadSuspend and osThreadResume. In case if these functions are not
|
||||
used in the application image, compiler will optimize them away.
|
||||
Set #define INCLUDE_vTaskSuspend 1 to fix this error.
|
||||
|
||||
Alternatively, if the application does not use osThreadSuspend and
|
||||
osThreadResume they can be excluded from the image code by setting:
|
||||
#define configUSE_OS2_THREAD_SUSPEND_RESUME 0 (in FreeRTOSConfig.h)
|
||||
*/
|
||||
#if (configUSE_OS2_THREAD_SUSPEND_RESUME == 1)
|
||||
#error "Definition INCLUDE_vTaskSuspend must equal 1 to implement Kernel Information and Control API."
|
||||
#endif
|
||||
#endif
|
||||
#if (INCLUDE_xTimerPendFunctionCall == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osEventFlagsSet and osEventFlagsClear, when called from
|
||||
the ISR, call FreeRTOS functions xEventGroupSetBitsFromISR and
|
||||
xEventGroupClearBitsFromISR which are only enabled if timers are operational and
|
||||
xTimerPendFunctionCall in enabled.
|
||||
Set #define INCLUDE_xTimerPendFunctionCall 1 and #define configUSE_TIMERS 1
|
||||
to fix this error.
|
||||
|
||||
Alternatively, if the application does not use osEventFlagsSet and osEventFlagsClear
|
||||
from the ISR their operation from ISR can be restricted by setting:
|
||||
#define configUSE_OS2_EVENTFLAGS_FROM_ISR 0 (in FreeRTOSConfig.h)
|
||||
*/
|
||||
#if (configUSE_OS2_EVENTFLAGS_FROM_ISR == 1)
|
||||
#error "Definition INCLUDE_xTimerPendFunctionCall must equal 1 to implement Event Flags API."
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#if (configUSE_TIMERS == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 Timer Management API functions use FreeRTOS timer functions to implement
|
||||
timer management. In case if these functions are not used in the application image,
|
||||
compiler will optimize them away.
|
||||
Set #define configUSE_TIMERS 1 to fix this error.
|
||||
|
||||
Alternatively, if the application does not use timer functions they can be
|
||||
excluded from the image code by setting:
|
||||
#define configUSE_OS2_TIMER 0 (in FreeRTOSConfig.h)
|
||||
*/
|
||||
#if (configUSE_OS2_TIMER == 1)
|
||||
#error "Definition configUSE_TIMERS must equal 1 to implement Timer Management API."
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#if (configUSE_MUTEXES == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 Mutex Management API functions use FreeRTOS mutex functions to implement
|
||||
mutex management. In case if these functions are not used in the application image,
|
||||
compiler will optimize them away.
|
||||
Set #define configUSE_MUTEXES 1 to fix this error.
|
||||
|
||||
Alternatively, if the application does not use mutex functions they can be
|
||||
excluded from the image code by setting:
|
||||
#define configUSE_OS2_MUTEX 0 (in FreeRTOSConfig.h)
|
||||
*/
|
||||
#if (configUSE_OS2_MUTEX == 1)
|
||||
#error "Definition configUSE_MUTEXES must equal 1 to implement Mutex Management API."
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#if (configUSE_COUNTING_SEMAPHORES == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 Memory Pool functions use FreeRTOS function xSemaphoreCreateCounting
|
||||
to implement memory pools. In case if these functions are not used in the application image,
|
||||
compiler will optimize them away.
|
||||
Set #define configUSE_COUNTING_SEMAPHORES 1 to fix this error.
|
||||
*/
|
||||
#error "Definition configUSE_COUNTING_SEMAPHORES must equal 1 to implement Memory Pool API."
|
||||
#endif
|
||||
#if (configUSE_TASK_NOTIFICATIONS == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 Thread Flags API functions use FreeRTOS Task Notification functions to implement
|
||||
thread flag management. In case if these functions are not used in the application image,
|
||||
compiler will optimize them away.
|
||||
Set #define configUSE_TASK_NOTIFICATIONS 1 to fix this error.
|
||||
|
||||
Alternatively, if the application does not use thread flags functions they can be
|
||||
excluded from the image code by setting:
|
||||
#define configUSE_OS2_THREAD_FLAGS 0 (in FreeRTOSConfig.h)
|
||||
*/
|
||||
#if (configUSE_OS2_THREAD_FLAGS == 1)
|
||||
#error "Definition configUSE_TASK_NOTIFICATIONS must equal 1 to implement Thread Flags API."
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#if (configUSE_TRACE_FACILITY == 0)
|
||||
/*
|
||||
CMSIS-RTOS2 function osThreadEnumerate requires FreeRTOS function uxTaskGetSystemState
|
||||
which is only enabled if configUSE_TRACE_FACILITY == 1.
|
||||
Set #define configUSE_TRACE_FACILITY 1 to fix this error.
|
||||
|
||||
Alternatively, if the application does not use osThreadEnumerate it can be
|
||||
excluded from the image code by setting:
|
||||
#define configUSE_OS2_THREAD_ENUMERATE 0 (in FreeRTOSConfig.h)
|
||||
*/
|
||||
#if (configUSE_OS2_THREAD_ENUMERATE == 1)
|
||||
#error "Definition configUSE_TRACE_FACILITY must equal 1 to implement osThreadEnumerate."
|
||||
#endif
|
||||
#endif
|
||||
|
||||
#if (configUSE_16_BIT_TICKS == 1)
|
||||
/*
|
||||
CMSIS-RTOS2 wrapper for FreeRTOS relies on 32-bit tick timer which is also optimal on
|
||||
a 32-bit CPU architectures.
|
||||
Set #define configUSE_16_BIT_TICKS 0 to fix this error.
|
||||
*/
|
||||
#error "Definition configUSE_16_BIT_TICKS must be zero to implement CMSIS-RTOS2 API."
|
||||
#endif
|
||||
|
||||
#if (configMAX_PRIORITIES != 56)
|
||||
/*
|
||||
CMSIS-RTOS2 defines 56 different priorities (see osPriority_t) and portable CMSIS-RTOS2
|
||||
implementation should implement the same number of priorities.
|
||||
Set #define configMAX_PRIORITIES 56 to fix this error.
|
||||
*/
|
||||
#error "Definition configMAX_PRIORITIES must equal 56 to implement Thread Management API."
|
||||
#endif
|
||||
#if (configUSE_PORT_OPTIMISED_TASK_SELECTION != 0)
|
||||
/*
|
||||
CMSIS-RTOS2 requires handling of 56 different priorities (see osPriority_t) while FreeRTOS port
|
||||
optimised selection for Cortex core only handles 32 different priorities.
|
||||
Set #define configUSE_PORT_OPTIMISED_TASK_SELECTION 0 to fix this error.
|
||||
*/
|
||||
#error "Definition configUSE_PORT_OPTIMISED_TASK_SELECTION must be zero to implement Thread Management API."
|
||||
#endif
|
||||
|
||||
#endif /* FREERTOS_OS2_H_ */
|
||||
Reference in New Issue
Block a user