VSF Documented
arm_compiler.h
Go to the documentation of this file.
1/*****************************************************************************
2 * Copyright(C)2009-2022 by VSF Team *
3 * *
4 * Licensed under the Apache License, Version 2.0 (the "License"); *
5 * you may not use this file except in compliance with the License. *
6 * You may obtain a copy of the License at *
7 * *
8 * http://www.apache.org/licenses/LICENSE-2.0 *
9 * *
10 * Unless required by applicable law or agreed to in writing, software *
11 * distributed under the License is distributed on an "AS IS" BASIS, *
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. *
13 * See the License for the specific language governing permissions and *
14 * limitations under the License. *
15 * *
16 ****************************************************************************/
17
18#ifndef __USE_ARM_COMPILER_H_PART_1__
19#define __USE_ARM_COMPILER_H_PART_1__
20
21/*============================ INCLUDES ======================================*/
22
23#include "./arm_compiler_detect.h"
24
25#endif /* end of __USE_ARM_COMPILER_H_PART_1__ */
26
27/*========================== Multiple-Entry Start ============================*/
28
29#if defined(__IS_COMPILER_IAR__) && __IS_COMPILER_IAR__
30# include <intrinsics.h>
31#endif
32
33#ifndef __VSF_HEADER_ONLY_SHOW_COMPILER_INFO__
34# include "./type.h"
35#endif
36#include "../__common/__compiler.h"
37
38/*----------------------------------------------------------------------------*
39 * Overwrite MAX_CONSTRUCTOR_PRIORITY if necessary *
40 *----------------------------------------------------------------------------*/
41#if __IS_COMPILER_ARM_COMPILER_5__ \
42 || __IS_COMPILER_ARM_COMPILER_6__
43// TODO: what is the real MAX_CONSTRUCTOR_PRIORITY for arm-compiler 5/6?
44# ifndef MAX_CONSTRUCTOR_PRIORITY
45# define MAX_CONSTRUCTOR_PRIORITY 65535
46# endif
47#elif __IS_COMPILER_GCC__
48// TODO: as test, priority of 65535 is lower than 0, 65534 is the max priority
49# undef MAX_CONSTRUCTOR_PRIORITY
50# define MAX_CONSTRUCTOR_PRIORITY 65534
51#endif
52
53#ifndef VSF_UTILITIES_REQ___CMSIS_HEADER_FILE__FROM_USR
54#include "cmsis_compiler.h"
55#else
56#include VSF_UTILITIES_REQ___CMSIS_HEADER_FILE__FROM_USR
57#endif
58
59/*========================== Multiple-Entry End ==============================*/
60
61
62#ifndef __USE_ARM_COMPILER_H_PART_2__
63#define __USE_ARM_COMPILER_H_PART_2__
64
65#ifdef __cplusplus
66extern "C" {
67#endif
68
69/* ----------------- Start of section using anonymous unions -------------- */
70#if __IS_COMPILER_ARM_COMPILER_5__
71 //#pragma push
72 #pragma anon_unions
73#elif __IS_COMPILER_ARM_COMPILER_6__
74#elif __IS_COMPILER_IAR__
75 #pragma language=extended
76// in new iar, FILE must be derived from __FILE struct
77 #define __VSF_STDIO_INTERNAL_FILE_NAME __FILE
78#elif __IS_COMPILER_GCC__
79/* anonymous unions are enabled by default */
80 #if __GNUC__ <= 7
81 #define __COMPILER_HAS_NO_NEXTTOWARDF_IN_MATH__
82 #endif
83#elif __IS_COMPILER_LLVM__
84/* anonymous unions are enabled by default */
85#elif defined(__TMS470__)
86/* anonymous unions are enabled by default */
87#elif defined(__TASKING__)
88 #pragma warning 586
89#else
90 #warning Not supported compiler type
91#endif
92
93/*----------------------------------------------------------------------------*
94 * Warning Mitigation *
95 *----------------------------------------------------------------------------*/
96
97#if __IS_COMPILER_ARM_COMPILER_6__
98# pragma clang diagnostic ignored "-Wdollar-in-identifier-extension"
99#endif
100
101
102
103/*============================ MACROS ========================================*/
104
106#ifndef NOP
107 #define NOP() __asm__ __volatile__ ("nop");
108#endif
109
110
112#if __IS_COMPILER_IAR__
113# define LOW_LEVEL_INIT_RET_T int
114# define VSF_CAL_NO_INIT __no_init
115# define VSF_CAL_NO_RETURN __attribute__((noreturn))
116# define VSF_CAL_ROOT __root
117# define VSF_CAL_INLINE inline
118# define VSF_CAL_NO_INLINE __attribute__((noinline))
119# define VSF_CAL_ALWAYS_INLINE inline __attribute__((always_inline))
120# define VSF_CAL_WEAK(...) __weak
121# define VSF_CAL_RAMFUNC __ramfunc
122# define __asm__ __asm
123# define __VSF_CAL_ALIGN(__N) __attribute__((aligned (__N)))
124# define __VSF_CAL_AT_ADDR(__ADDR) @ __ADDR
125# define __VSF_CAL_SECTION(__SEC_STR) __attribute__((section (__SEC_STR)))
126# define VSF_CAL_SECTION_DECLARE(__SEC)
127# define VSF_CAL_SECTION_START(__SEC) __section_begin(#__SEC)
128# define VSF_CAL_SECTION_END(__SEC) __section_end(#__SEC)
129# define VSF_CAL_SECTION_SIZE(__SEC) __section_size(#__SEC)
130# define __VSF_CAL_WEAK_ALIAS(__ORIGIN, __ALIAS) \
131 _Pragma(__VSF_STR(weak __ORIGIN=__ALIAS))
132# define VSF_CAL_PACKED __attribute__((packed))
133# define VSF_CAL_UNALIGNED __packed
134# define VSF_CAL_TRANSPARENT_UNION __attribute__((transparent_union))
135# define __VSF_CAL_ALIGN_OF(...) __ALIGNOF__(__VA_ARGS__)
136
137# define __IAR_STARTUP_DATA_INIT __iar_data_init3
138
139# define __VSF_CAL_ISR(__VEC) void __VEC(void)
140
141#elif __IS_COMPILER_ARM_COMPILER_5__
142# define VSF_CAL_NO_INIT __attribute__( ( section( ".bss.noinit"),zero_init) )
143# define VSF_CAL_NO_RETURN __attribute__((noreturn))
144# define VSF_CAL_ROOT __attribute__((used))
145# define VSF_CAL_INLINE __inline
146# define VSF_CAL_NO_INLINE __attribute__((noinline))
147# define VSF_CAL_ALWAYS_INLINE __inline __attribute__((always_inline))
148# define VSF_CAL_WEAK(...) __attribute__((weak))
149# define VSF_CAL_RAMFUNC __attribute__((section (".textrw")))
150# define __asm__ __asm
151# define __VSF_CAL_ALIGN(__N) __attribute__((aligned (__N)))
152# define __VSF_CAL_AT_ADDR(__ADDR) __attribute__((at(__ADDR)))
153# define __VSF_CAL_SECTION(__SEC_STR) __attribute__((section (__SEC_STR)))
154# define __VSF_CAL_WEAK_ALIAS(__ORIGIN, __ALIAS) \
155 __attribute__((weakref(__VSF_STR(__ALIAS))))
156
157# define VSF_CAL_PACKED __attribute__((packed))
158# define VSF_CAL_UNALIGNED __packed
159# define VSF_CAL_TRANSPARENT_UNION __attribute__((transparent_union))
160# define __VSF_CAL_ALIGN_OF(...) __alignof__(__VA_ARGS__)
161
162# define __VSF_CAL_ISR(__VEC) void __VEC(void)
163
164#elif __IS_COMPILER_ARM_COMPILER_6__
165# define VSF_CAL_NO_INIT __attribute__( ( section( ".bss.noinit")) )
166# define VSF_CAL_NO_RETURN __attribute__((noreturn))
167# define VSF_CAL_ROOT __attribute__((used))
168# define VSF_CAL_INLINE __inline
169# define VSF_CAL_NO_INLINE __attribute__((noinline))
170# define VSF_CAL_ALWAYS_INLINE __inline __attribute__((always_inline))
171# define VSF_CAL_WEAK(...) __attribute__((weak))
172# define VSF_CAL_RAMFUNC __attribute__((section (".textrw")))
173# define __asm__ __asm
174# define __VSF_CAL_ALIGN(__N) __attribute__((aligned (__N)))
175# define __VSF_CAL_AT_ADDR(__ADDR) __attribute__((section (".ARM.__at_" #__ADDR)))
176# define __VSF_CAL_SECTION(__SEC_STR) __attribute__((section (__SEC_STR)))
177# define __VSF_CAL_WEAK_ALIAS(__ORIGIN, __ALIAS) \
178 __attribute__((weakref(__VSF_STR(__ALIAS))))
179
180# define VSF_CAL_PACKED __attribute__((packed))
181# define VSF_CAL_UNALIGNED __unaligned
182# define VSF_CAL_TRANSPARENT_UNION __attribute__((transparent_union))
183# define __VSF_CAL_ALIGN_OF(...) __alignof__(__VA_ARGS__)
184
185# define __VSF_CAL_ISR(__VEC) void __VEC(void)
186#endif
187
188/*----------------------------------------------------------------------------*
189 * Signal & Interrupt Definition *
190 *----------------------------------------------------------------------------*/
191
193#if __IS_COMPILER_IAR__
194# define ENABLE_GLOBAL_INTERRUPT() __enable_interrupt()
195#else
196# define ENABLE_GLOBAL_INTERRUPT() __enable_irq()
197#endif
198
200#if __IS_COMPILER_IAR__
201# define DISABLE_GLOBAL_INTERRUPT() ____disable_irq()
202
203static VSF_CAL_ALWAYS_INLINE uint32_t ____disable_irq(void)
204{
205 uint32_t wPRIMASK = __get_interrupt_state();
206 __disable_interrupt();
207 return wPRIMASK;
208}
209
210#elif __IS_COMPILER_ARM_COMPILER_5__
211# define DISABLE_GLOBAL_INTERRUPT() __disable_irq()
212#elif __IS_COMPILER_ARM_COMPILER_6__ && !defined(__CMSIS_ARMCC_V6_H)
213# define DISABLE_GLOBAL_INTERRUPT() __disable_irq()
214#elif __IS_COMPILER_GCC_
215# define DISABLE_GLOBAL_INTERRUPT() __disable_irq()
216#else /* for other compilers, using gcc assembly syntax to implement */
217
218# define DISABLE_GLOBAL_INTERRUPT() ____disable_irq()
219
220static VSF_CAL_ALWAYS_INLINE uint32_t ____disable_irq(void)
221{
222 uint32_t cpsr;
223
224 __asm__ __volatile__("mrs %[cpsr], primask\n"
225 "cpsid i\n"
226 : [cpsr] "=r"(cpsr));
227 return cpsr & 0x1;
228}
229#endif
230
231#if __IS_COMPILER_IAR__
232# define GET_GLOBAL_INTERRUPT_STATE() __get_interrupt_state()
233# define SET_GLOBAL_INTERRUPT_STATE(__STATE) __set_interrupt_state(__STATE)
234typedef __istate_t vsf_gint_state_t;
235#elif __IS_COMPILER_ARM_COMPILER_5__ || __IS_COMPILER_ARM_COMPILER_6__
236# define GET_GLOBAL_INTERRUPT_STATE() __get_PRIMASK()
237# define SET_GLOBAL_INTERRUPT_STATE(__STATE) __set_PRIMASK(__STATE)
238typedef uint32_t vsf_gint_state_t;
239#elif __IS_COMPILER_GCC__
240# define GET_GLOBAL_INTERRUPT_STATE() __get_PRIMASK()
241# define SET_GLOBAL_INTERRUPT_STATE(__STATE) __set_PRIMASK(__STATE)
242typedef uint32_t vsf_gint_state_t;
243#else
244typedef uint32_t vsf_gint_state_t;
245# define GET_GLOBAL_INTERRUPT_STATE() ____get_PRIMASK()
246
252VSF_CAL_ALWAYS_INLINE static inline uint32_t ____get_PRIMASK(void)
253{
254 unsigned int result;
255
256 __asm__ volatile ("MRS %0, primask" : "=r" (result) );
257 return(result);
258}
259
260# define SET_GLOBAL_INTERRUPT_STATE(__STATE) ____set_PRIMASK(__STATE)
261
267VSF_CAL_ALWAYS_INLINE static inline void ____set_PRIMASK(uint32_t priMask)
268{
269 __asm__ volatile ("MSR primask, %0" : : "r" (priMask) : "memory");
270}
271#endif
272
273/*----------------------------------------------------------------------------*
274 * Startup Source Code *
275 *----------------------------------------------------------------------------*/
276#if __IS_COMPILER_IAR__
277
278#ifndef __VECTOR_TABLE
279# define __VECTOR_TABLE __vector_table
280#endif
281#ifndef __VECTOR_TABLE_ATTRIBUTE
282# define __VECTOR_TABLE_ATTRIBUTE @".intvec"
283#endif
284#ifndef __PROGRAM_START
285# define __PROGRAM_START __iar_program_start
286#endif
287#ifndef __INITIAL_SP
288# define __INITIAL_SP CSTACK$$Limit
289#endif
290
291#elif __IS_COMPILER_ARM_COMPILER_6__ || __IS_COMPILER_ARM_COMPILER_5__
292
293#ifndef __VECTOR_TABLE
294# define __VECTOR_TABLE __Vectors
295#endif
296#ifndef __VECTOR_TABLE_ATTRIBUTE
297# define __VECTOR_TABLE_ATTRIBUTE ROOT SECTION("RESET")
298#endif
299#ifndef __PROGRAM_START
300# define __PROGRAM_START __main
301#endif
302#ifndef __INITIAL_SP
303# define __INITIAL_SP Image$$ARM_LIB_STACK$$ZI$$Limit
304#endif
305
306#else //__IS_COMPILER_GCC__ || __IS_COMPILER_LLVM__
307
308#ifndef __PROGRAM_START
309#define __PROGRAM_START __cmsis_start
310
311#endif
312
313#ifndef __INITIAL_SP
314#define __INITIAL_SP __StackTop
315#endif
316
317#ifndef __STACK_LIMIT
318#define __STACK_LIMIT __StackLimit
319#endif
320
321#ifndef __VECTOR_TABLE
322#define __VECTOR_TABLE __Vectors
323#endif
324
325#ifndef __VECTOR_TABLE_ATTRIBUTE
326#define __VECTOR_TABLE_ATTRIBUTE __attribute((used, section(".vectors")))
327#endif
328#endif
329
330/*============================ TYPES =========================================*/
331/*============================ PROTOTYPES ====================================*/
332
333#ifdef __cplusplus
334}
335#endif
336
337#endif /* end of __USE_ARM_COMPILER_H_PART_2__ */
338
339
340
__volatile__
#define __volatile__
Definition __compiler.h:56
vsf_gint_state_t
uint32_t vsf_gint_state_t
Definition arm_compiler.h:247
arm_compiler_detect.h
uint32_t
unsigned uint32_t
Definition stdint.h:9
Generated by doxygen 1.9.8