]> git.sur5r.net Git - freertos/blob - FreeRTOS/Source/portable/RVDS/ARM_CM0/portmacro.h
Cortex M0 GCC/IAR/Keil ports -- tickless support.
[freertos] / FreeRTOS / Source / portable / RVDS / ARM_CM0 / portmacro.h
1 /*\r
2  * FreeRTOS Kernel V10.2.1\r
3  * Copyright (C) 2019 Amazon.com, Inc. or its affiliates.  All Rights Reserved.\r
4  *\r
5  * Permission is hereby granted, free of charge, to any person obtaining a copy of\r
6  * this software and associated documentation files (the "Software"), to deal in\r
7  * the Software without restriction, including without limitation the rights to\r
8  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\r
9  * the Software, and to permit persons to whom the Software is furnished to do so,\r
10  * subject to the following conditions:\r
11  *\r
12  * The above copyright notice and this permission notice shall be included in all\r
13  * copies or substantial portions of the Software.\r
14  *\r
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\r
17  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\r
18  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\r
19  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\r
20  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\r
21  *\r
22  * http://www.FreeRTOS.org\r
23  * http://aws.amazon.com/freertos\r
24  *\r
25  * 1 tab == 4 spaces!\r
26  */\r
27 \r
28 \r
29 #ifndef PORTMACRO_H\r
30 #define PORTMACRO_H\r
31 \r
32 #ifdef __cplusplus\r
33 extern "C" {\r
34 #endif\r
35 \r
36 /*-----------------------------------------------------------\r
37  * Port specific definitions.\r
38  *\r
39  * The settings in this file configure FreeRTOS correctly for the\r
40  * given hardware and compiler.\r
41  *\r
42  * These settings should not be altered.\r
43  *-----------------------------------------------------------\r
44  */\r
45 \r
46 /* Type definitions. */\r
47 #define portCHAR                char\r
48 #define portFLOAT               float\r
49 #define portDOUBLE              double\r
50 #define portLONG                long\r
51 #define portSHORT               short\r
52 #define portSTACK_TYPE  uint32_t\r
53 #define portBASE_TYPE   long\r
54 \r
55 typedef portSTACK_TYPE StackType_t;\r
56 typedef long BaseType_t;\r
57 typedef unsigned long UBaseType_t;\r
58 \r
59 #if( configUSE_16_BIT_TICKS == 1 )\r
60         typedef uint16_t TickType_t;\r
61         #define portMAX_DELAY ( TickType_t ) 0xffff\r
62 #else\r
63         typedef uint32_t TickType_t;\r
64         #define portMAX_DELAY ( TickType_t ) 0xffffffffUL\r
65 \r
66         /* 32-bit tick type on a 32-bit architecture, so reads of the tick count do\r
67         not need to be guarded with a critical section. */\r
68         #define portTICK_TYPE_IS_ATOMIC 1\r
69 #endif\r
70 /*-----------------------------------------------------------*/\r
71 \r
72 /* Architecture specifics. */\r
73 #define portSTACK_GROWTH                        ( -1 )\r
74 #define portTICK_PERIOD_MS                      ( ( TickType_t ) 1000 / configTICK_RATE_HZ )\r
75 #define portBYTE_ALIGNMENT                      8\r
76 /*-----------------------------------------------------------*/\r
77 \r
78 \r
79 /* Scheduler utilities. */\r
80 extern void vPortYield( void );\r
81 #define portNVIC_INT_CTRL_REG           ( * ( ( volatile uint32_t * ) 0xe000ed04 ) )\r
82 #define portNVIC_PENDSVSET_BIT          ( 1UL << 28UL )\r
83 #define portYIELD()                                     vPortYield()\r
84 #define portEND_SWITCHING_ISR( xSwitchRequired ) if( xSwitchRequired ) portNVIC_INT_CTRL_REG = portNVIC_PENDSVSET_BIT\r
85 #define portYIELD_FROM_ISR( x ) portEND_SWITCHING_ISR( x )\r
86 /*-----------------------------------------------------------*/\r
87 \r
88 /* Critical section management. */\r
89 extern void vPortEnterCritical( void );\r
90 extern void vPortExitCritical( void );\r
91 extern uint32_t ulSetInterruptMaskFromISR( void );\r
92 extern void vClearInterruptMaskFromISR( uint32_t ulMask );\r
93 \r
94 #define portSET_INTERRUPT_MASK_FROM_ISR()               ulSetInterruptMaskFromISR()\r
95 #define portCLEAR_INTERRUPT_MASK_FROM_ISR(x)    vClearInterruptMaskFromISR( x )\r
96 #define portDISABLE_INTERRUPTS()                                __disable_irq()\r
97 #define portENABLE_INTERRUPTS()                                 __enable_irq()\r
98 #define portENTER_CRITICAL()                                    vPortEnterCritical()\r
99 #define portEXIT_CRITICAL()                                             vPortExitCritical()\r
100 \r
101 /*-----------------------------------------------------------*/\r
102 \r
103 /* Tickless idle/low power functionality. */\r
104 #ifndef portSUPPRESS_TICKS_AND_SLEEP\r
105         extern void vPortSuppressTicksAndSleep( TickType_t xExpectedIdleTime );\r
106         #define portSUPPRESS_TICKS_AND_SLEEP( xExpectedIdleTime ) vPortSuppressTicksAndSleep( xExpectedIdleTime )\r
107 #endif\r
108 /*-----------------------------------------------------------*/\r
109 \r
110 /* Task function macros as described on the FreeRTOS.org WEB site. */\r
111 #define portTASK_FUNCTION_PROTO( vFunction, pvParameters ) void vFunction( void *pvParameters )\r
112 #define portTASK_FUNCTION( vFunction, pvParameters ) void vFunction( void *pvParameters )\r
113 \r
114 #define portNOP()\r
115 \r
116 #ifdef __cplusplus\r
117 }\r
118 #endif\r
119 \r
120 #endif /* PORTMACRO_H */\r
121 \r