📄 rtos.h
字号:
/*********************************************************************
* SEGGER MICROCONTROLLER GmbH & Co KG *
* Solutions for real time microcontroller applications *
**********************************************************************
* *
* (c) 1995 - 2008 SEGGER Microcontroller GmbH & Co KG *
* *
* www.segger.com Support: support@segger.com *
* *
**********************************************************************
* *
* embOS * Real time operating system for microcontrollers *
* *
* *
* Please note: *
* *
* Knowledge of this file may under no circumstances *
* be used to write a similar product or a real-time *
* operating system for in-house use. *
* *
* Thank you for your fairness ! *
* *
**********************************************************************
* *
* embOS version: 3.60d *
* *
**********************************************************************
----------------------------------------------------------------------
File : RTOS.h
Purpose : Include file for the OS,
to be included in every C-module accessing OS-routines
-------- END-OF-HEADER ---------------------------------------------
*/
#ifndef RTOS_H_INCLUDED /* Avoid multiple inclusion */
#define RTOS_H_INCLUDED
/*********************************************************************
*
* Chip specifics for Cortex M3 cores and IAR compiler
*
**********************************************************************
*/
#include <string.h> // required for memset() etc.
#include <intrinsics.h> // required for __disable_interrupt() etc.
/*********************************************************************
*
* Configuration
*/
#define OS_PORT_REVISION (0) // Port specific revision
#define OS_PTR_OP_IS_ATOMIC (1)
#define OS_GetTime() (OS_Time)
#define OS_GetTime32() (OS_Time)
#define OS_I32 int
#define OS_SIZEOF_INT (4) // Size of integer in bytes
#define OS_BIG_ENDIAN (1 - __LITTLE_ENDIAN__)
#define OS_SUPPORT_SYSSTACK_INFO (1) // Option to supply more info to viewer
#define OS_SUPPORT_INTSTACK_INFO (0) // Not used
#define OS_SUPPORT_OS_ALLOC (1) // Define whether OS_Alloc is supported
#define OS_STACKFILL_CHAR (0xcd) // To be compatible with IAR stack check plugin
#define OS_SP_ADJUST (0)
#define OS_EnterIntStack() // No special stack switching required
#define OS_LeaveIntStack() // No special stack switching required
/***** Core specific configuration *********************************/
#define OS_SWITCH_FROM_INT_MODIFIES_STACK (0)
#define OS_INTERRUPTS_ARE_NESTABLE_ON_ENTRY (1)
#define OS_SCHEDULER_ACTIVATED_BY_EXCEPTION (1)
#define OS_SUPPORT_INT_PRIORITY (0) // Variable interrupt priorities for OS not supported by now
/***** End of configuration settings *******************************/
#define OS_DI() OS_DisableInt()
#define OS_EI() OS_EnableInt()
#define OS_IPL_EI_DEFAULT 0
#define OS_IPL_DI_DEFAULT 128
/****** Core specific implementation ********************************/
#define OS_CPU "IAR CM3"
/*********************************************************************
*
* Port specific (non OS generic) functions
*/
#ifdef __cplusplus
extern "C" {
#endif
typedef void OS_ISR_HANDLER(void);
OS_ISR_HANDLER* OS_ARM_InstallISRHandler (int ISRIndex, OS_ISR_HANDLER* pFunc);
void OS_ARM_EnableISR (int ISRIndex);
void OS_ARM_DisableISR (int ISRIndex);
int OS_ARM_ISRSetPrio (int ISRIndex, int Prio);
void OS_ARM_AssignISRSource (int ISRIndex, int Source);
void OS_ARM_EnableISRSource (int SourceIndex);
void OS_ARM_DisableISRSource (int SourceIndex);
void OS_StartTask(void);
void OS_DisableInt(void);
void OS_EnableInt(void);
#if (__VER__ >= 441)
void OS_InitSysLocks(void);
#endif
#define OS_INIT_SYS_LOCKS() OS_InitSysLocks()
#define OS_IDLE() // Overrides call of OS_Idle()
#define OS_EI_ON_LEAVE() OS_EI() // Required for CPUs with do not restore DI-flag by RETI.
/***** Declare functions used in the interrupt vector table in ROM */
void __program_start(void); // Program entry
void OS_Exception(void); // In RTOS_CM3.asm OS library
void OS_COM_IsrHandler(void); // In RTOSInit
void OS_Systick(void); // In RTOSInit
#ifdef __cplusplus
}
#endif
/*********************************************************************
*
* Check configuration
*
**********************************************************************
This is required in order to automatically create the correct identifiers
in order to be able to autoamitcally remap the identifiers.
*/
#define OS_CPU_PREFIX "v7"
#if __LITTLE_ENDIAN__==1
#define OS_ENDIAN_PREFIX "L"
#else
#define OS_ENDIAN_PREFIX "B"
#endif
#define OS_MODEL OS_CPU_PREFIX OS_ENDIAN_PREFIX
#ifndef __CPU_MODE__
#error "__CPU_MODE__ not defined. OSCHIP has to be modified !"
#endif
/****** End of chip / compiler specific part ************************/
/*********************************************************************
*
* Generic portion of the OS starts here
*
**********************************************************************
This file (original name OS_RAW.h) is part of RTOS.h, the include
file for the OS.
*/
#if (!defined(OS_LIBMODE_XR) && !defined(OS_LIBMODE_R) && \
!defined(OS_LIBMODE_S) && !defined(OS_LIBMODE_SP) && \
!defined(OS_LIBMODE_D) && !defined(OS_LIBMODE_DP) && \
!defined(OS_LIBMODE_DT))
#include "OS_Config.h"
#endif
#define OS_VERSION_GENERIC (36004) /* Generic version 3.60d */
#ifndef OS_PORT_REVISION
#define OS_PORT_REVISION 0
#endif
#define OS_VERSION OS_VERSION_GENERIC + (OS_PORT_REVISION * 25)
/*********************************************************************
*
* Defines for library types
*
**********************************************************************
*/
/* If library type is not selected yet (on project level,
for example), then select DP by default
*/
#if (!defined(OS_LIBMODE_XR) && !defined(OS_LIBMODE_R) && \
!defined(OS_LIBMODE_S) && !defined(OS_LIBMODE_SP) && \
!defined(OS_LIBMODE_D) && !defined(OS_LIBMODE_DP) && \
!defined(OS_LIBMODE_DT))
#define OS_LIBMODE_DP
#endif
#if defined(OS_LIBMODE_XR) // Extremely small release - without Round robin support
#define OS_CHECKSTACK 0
#define OS_DEBUG 0
#define OS_PROFILE 0
#define OS_SUPPORT_TICKSTEP 0
#define OS_TRACE 0
#define OS_RR_SUPPORTED 0
#define OS_TRACKNAME 0
#define OS_SUPPORT_SAVE_RESTORE_HOOK 0
#define OS_CreateTask OS_CreateTask_XR
#define OS_CreateTaskEx OS_CreateTaskEx_XR
#define OS_LIBMODE "XR"
#elif defined(OS_LIBMODE_R) // Release build
#define OS_CHECKSTACK 0
#define OS_DEBUG 0
#define OS_PROFILE 0
#define OS_SUPPORT_TICKSTEP 0
#define OS_TRACE 0
#define OS_CreateTask OS_CreateTask_R
#define OS_CreateTaskEx OS_CreateTaskEx_R
#define OS_LIBMODE "R"
#elif defined(OS_LIBMODE_S) // Release build with stack check
#define OS_CHECKSTACK 1
#define OS_DEBUG 0
#define OS_PROFILE 0
#define OS_SUPPORT_TICKSTEP 0
#define OS_TRACE 0
#define OS_CreateTask OS_CreateTask_S
#define OS_CreateTaskEx OS_CreateTaskEx_S
#define OS_LIBMODE "S"
#elif defined(OS_LIBMODE_SP) // Release build with stack check and profiling
#define OS_CHECKSTACK 1
#define OS_DEBUG 0
#define OS_PROFILE 1
#define OS_SUPPORT_TICKSTEP 1
#define OS_TRACE 0
#define OS_CreateTask OS_CreateTask_SP
#define OS_CreateTaskEx OS_CreateTaskEx_SP
#define OS_LIBMODE "SP"
#elif defined(OS_LIBMODE_D) // Debug build
#define OS_CHECKSTACK 1
#define OS_DEBUG 1
#define OS_PROFILE 0
#define OS_SUPPORT_TICKSTEP 1
#define OS_TRACE 0
#define OS_CreateTask OS_CreateTask_D
#define OS_CreateTaskEx OS_CreateTaskEx_D
#define OS_LIBMODE "D"
#elif defined(OS_LIBMODE_DP) // Debug build with profiling
#define OS_CHECKSTACK 1
#define OS_PROFILE 1
#define OS_DEBUG 1
#define OS_SUPPORT_TICKSTEP 1
#define OS_TRACE 0
#define OS_CreateTask OS_CreateTask_DP
#define OS_CreateTaskEx OS_CreateTaskEx_DP
#define OS_LIBMODE "DP"
#elif defined(OS_LIBMODE_DT) // Debug build with profiling and trace
#define OS_CHECKSTACK 1
#define OS_DEBUG 1
#define OS_PROFILE 1
#define OS_SUPPORT_TICKSTEP 1
#define OS_TRACE 1
#define OS_CreateTask OS_CreateTask_DT
#define OS_CreateTaskEx OS_CreateTaskEx_DT
#define OS_LIBMODE "DT"
#else
#error Please define library type used !
#endif
/*********************************************************************
*
* OS compile time switches
*
**********************************************************************
These compile time switches can be modified when recompiling
the library. Usually, the values are in OSCHIP.H, which is then
merged with OS_RAW.H to form RTOS.H.
If the values are not defined in OSCHIP.H, the default values
below are used.
*/
/* Make it possible to place const data in RAM via
define and therefore via command line. This is required
for some smaller CPUs in small memory models
It is defined to be "const" by default, but can be defined to nothing
by simply adding a -DOS_CONST_DATA on the commandline
*/
#ifndef OS_CONST_DATA
#define OS_CONST_DATA const /* Default */
#else
#undef OS_CONST_DATA
#define OS_CONST_DATA /* define blank */
#endif
#ifndef OS_INTERWORK
#define OS_INTERWORK
#endif
#ifndef OS_SCHEDULER_ACTIVATED_BY_EXCEPTION
#define OS_SCHEDULER_ACTIVATED_BY_EXCEPTION (0)
#endif
#ifndef OS_STACK_ADR
#define OS_STACK_ADR OS_U32
#endif
#ifndef OS_MODEL
#define OS_MODEL ""
#endif
#ifndef OS_MEMSET
#define OS_MEMSET(a,v,s) memset(a,v,s)
#endif
#ifndef OS_MEMCPY
#define OS_MEMCPY(dest,src,cnt) memcpy(dest,src,cnt)
#endif
#ifndef OS_STRLEN
#define OS_STRLEN(s) strlen(s)
#endif
#ifndef OS_DUMMY_STATEMENT
#define OS_DUMMY_STATEMENT()
#endif
#ifndef OS_USEPARA
#define OS_USEPARA(para) para=para
#endif
#ifndef OS_SUPPORT_TICKSTEP
#define OS_SUPPORT_TICKSTEP 0
#endif
#ifndef OS_TRACKNAME
#define OS_TRACKNAME (1)
#endif
#ifndef OS_TRACE
#define OS_TRACE (0)
#endif
#ifndef OS_SUPPORT_SAVE_RESTORE_HOOK
#define OS_SUPPORT_SAVE_RESTORE_HOOK (1)
#endif
#ifndef OS_RR_SUPPORTED
#define OS_RR_SUPPORTED (1)
#endif
#ifndef OS_STACK_AT_BOTTOM
#define OS_STACK_AT_BOTTOM (0)
#endif
/* Settings for NON-ANSI compiler syntax
The default behaviour complies with IAR.
*/
#ifndef OS_COMPILER_LOCATION_LEFT
#define OS_COMPILER_LOCATION_LEFT 1 /* (req. for IAR) */
#endif
#ifndef OS_COMPILER_STORAGE_MODIFIER_LEFT
#define OS_COMPILER_STORAGE_MODIFIER_LEFT 1 /* default for all except KEIL */
#endif
#define OS_LINK_MAILBOXES (OS_DEBUG)
#ifndef OS_CHECK
#define OS_CHECK 0
#endif
#ifndef OS_ALIGN_PTR
#define OS_ALIGN_PTR (1)
#endif
#ifndef OS_ALIGN_INT
#define OS_ALIGN_INT (1)
#endif
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -