mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_SAKURAIO_EVB_01/cmsis_armcc.h@170:e95d10626187, 2018-09-06 (annotated)

Committer:
AnnaBridge
Date:
Thu Sep 06 13:39:34 2018 +0100
Revision:
170:e95d10626187
Parent:
169:a7c7b631e539 
mbed library. Release version 163

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Anna Bridge 160:5571c4ff569f 1 /**************************************************************************//**
Anna Bridge 160:5571c4ff569f 2 * @file cmsis_armcc.h
Anna Bridge 169:a7c7b631e539 3 * @brief CMSIS compiler ARMCC (Arm Compiler 5) header file
Anna Bridge 169:a7c7b631e539 4 * @version V5.0.4
Anna Bridge 169:a7c7b631e539 5 * @date 10. January 2018
Anna Bridge 160:5571c4ff569f 6 ******************************************************************************/
Anna Bridge 160:5571c4ff569f 7 /*
Anna Bridge 169:a7c7b631e539 8 * Copyright (c) 2009-2018 Arm Limited. All rights reserved.
Anna Bridge 160:5571c4ff569f 9 *
Anna Bridge 160:5571c4ff569f 10 * SPDX-License-Identifier: Apache-2.0
Anna Bridge 160:5571c4ff569f 11 *
Anna Bridge 160:5571c4ff569f 12 * Licensed under the Apache License, Version 2.0 (the License); you may
Anna Bridge 160:5571c4ff569f 13 * not use this file except in compliance with the License.
Anna Bridge 160:5571c4ff569f 14 * You may obtain a copy of the License at
Anna Bridge 160:5571c4ff569f 15 *
Anna Bridge 160:5571c4ff569f 16 * www.apache.org/licenses/LICENSE-2.0
Anna Bridge 160:5571c4ff569f 17 *
Anna Bridge 160:5571c4ff569f 18 * Unless required by applicable law or agreed to in writing, software
Anna Bridge 160:5571c4ff569f 19 * distributed under the License is distributed on an AS IS BASIS, WITHOUT
Anna Bridge 160:5571c4ff569f 20 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Anna Bridge 160:5571c4ff569f 21 * See the License for the specific language governing permissions and
Anna Bridge 160:5571c4ff569f 22 * limitations under the License.
Anna Bridge 160:5571c4ff569f 23 */
Anna Bridge 160:5571c4ff569f 24
Anna Bridge 160:5571c4ff569f 25 #ifndef __CMSIS_ARMCC_H
Anna Bridge 160:5571c4ff569f 26 #define __CMSIS_ARMCC_H
Anna Bridge 160:5571c4ff569f 27
Anna Bridge 160:5571c4ff569f 28
Anna Bridge 160:5571c4ff569f 29 #if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 400677)
Anna Bridge 169:a7c7b631e539 30 #error "Please use Arm Compiler Toolchain V4.0.677 or later!"
Anna Bridge 160:5571c4ff569f 31 #endif
Anna Bridge 160:5571c4ff569f 32
Anna Bridge 160:5571c4ff569f 33 /* CMSIS compiler control architecture macros */
Anna Bridge 160:5571c4ff569f 34 #if ((defined (__TARGET_ARCH_6_M ) && (__TARGET_ARCH_6_M == 1)) || \
Anna Bridge 160:5571c4ff569f 35 (defined (__TARGET_ARCH_6S_M ) && (__TARGET_ARCH_6S_M == 1)) )
Anna Bridge 160:5571c4ff569f 36 #define __ARM_ARCH_6M__ 1
Anna Bridge 160:5571c4ff569f 37 #endif
Anna Bridge 160:5571c4ff569f 38
Anna Bridge 160:5571c4ff569f 39 #if (defined (__TARGET_ARCH_7_M ) && (__TARGET_ARCH_7_M == 1))
Anna Bridge 160:5571c4ff569f 40 #define __ARM_ARCH_7M__ 1
Anna Bridge 160:5571c4ff569f 41 #endif
Anna Bridge 160:5571c4ff569f 42
Anna Bridge 160:5571c4ff569f 43 #if (defined (__TARGET_ARCH_7E_M) && (__TARGET_ARCH_7E_M == 1))
Anna Bridge 160:5571c4ff569f 44 #define __ARM_ARCH_7EM__ 1
Anna Bridge 160:5571c4ff569f 45 #endif
Anna Bridge 160:5571c4ff569f 46
Anna Bridge 160:5571c4ff569f 47 /* __ARM_ARCH_8M_BASE__ not applicable */
Anna Bridge 160:5571c4ff569f 48 /* __ARM_ARCH_8M_MAIN__ not applicable */
Anna Bridge 160:5571c4ff569f 49
Anna Bridge 160:5571c4ff569f 50
Anna Bridge 160:5571c4ff569f 51 /* CMSIS compiler specific defines */
Anna Bridge 160:5571c4ff569f 52 #ifndef __ASM
Anna Bridge 160:5571c4ff569f 53 #define __ASM __asm
Anna Bridge 160:5571c4ff569f 54 #endif
Anna Bridge 160:5571c4ff569f 55 #ifndef __INLINE
Anna Bridge 160:5571c4ff569f 56 #define __INLINE __inline
Anna Bridge 160:5571c4ff569f 57 #endif
Anna Bridge 160:5571c4ff569f 58 #ifndef __STATIC_INLINE
Anna Bridge 160:5571c4ff569f 59 #define __STATIC_INLINE static __inline
Anna Bridge 160:5571c4ff569f 60 #endif
Anna Bridge 169:a7c7b631e539 61 #ifndef __STATIC_FORCEINLINE
Anna Bridge 169:a7c7b631e539 62 #define __STATIC_FORCEINLINE static __forceinline
Anna Bridge 169:a7c7b631e539 63 #endif
Anna Bridge 160:5571c4ff569f 64 #ifndef __NO_RETURN
Anna Bridge 160:5571c4ff569f 65 #define __NO_RETURN __declspec(noreturn)
Anna Bridge 160:5571c4ff569f 66 #endif
Anna Bridge 160:5571c4ff569f 67 #ifndef __USED
Anna Bridge 160:5571c4ff569f 68 #define __USED __attribute__((used))
Anna Bridge 160:5571c4ff569f 69 #endif
Anna Bridge 160:5571c4ff569f 70 #ifndef __WEAK
Anna Bridge 160:5571c4ff569f 71 #define __WEAK __attribute__((weak))
Anna Bridge 160:5571c4ff569f 72 #endif
Anna Bridge 160:5571c4ff569f 73 #ifndef __PACKED
Anna Bridge 160:5571c4ff569f 74 #define __PACKED __attribute__((packed))
Anna Bridge 160:5571c4ff569f 75 #endif
Anna Bridge 160:5571c4ff569f 76 #ifndef __PACKED_STRUCT
Anna Bridge 160:5571c4ff569f 77 #define __PACKED_STRUCT __packed struct
Anna Bridge 160:5571c4ff569f 78 #endif
Anna Bridge 160:5571c4ff569f 79 #ifndef __PACKED_UNION
Anna Bridge 160:5571c4ff569f 80 #define __PACKED_UNION __packed union
Anna Bridge 160:5571c4ff569f 81 #endif
Anna Bridge 160:5571c4ff569f 82 #ifndef __UNALIGNED_UINT32 /* deprecated */
Anna Bridge 160:5571c4ff569f 83 #define __UNALIGNED_UINT32(x) (*((__packed uint32_t *)(x)))
Anna Bridge 160:5571c4ff569f 84 #endif
Anna Bridge 160:5571c4ff569f 85 #ifndef __UNALIGNED_UINT16_WRITE
Anna Bridge 160:5571c4ff569f 86 #define __UNALIGNED_UINT16_WRITE(addr, val) ((*((__packed uint16_t *)(addr))) = (val))
Anna Bridge 160:5571c4ff569f 87 #endif
Anna Bridge 160:5571c4ff569f 88 #ifndef __UNALIGNED_UINT16_READ
Anna Bridge 160:5571c4ff569f 89 #define __UNALIGNED_UINT16_READ(addr) (*((const __packed uint16_t *)(addr)))
Anna Bridge 160:5571c4ff569f 90 #endif
Anna Bridge 160:5571c4ff569f 91 #ifndef __UNALIGNED_UINT32_WRITE
Anna Bridge 160:5571c4ff569f 92 #define __UNALIGNED_UINT32_WRITE(addr, val) ((*((__packed uint32_t *)(addr))) = (val))
Anna Bridge 160:5571c4ff569f 93 #endif
Anna Bridge 160:5571c4ff569f 94 #ifndef __UNALIGNED_UINT32_READ
Anna Bridge 160:5571c4ff569f 95 #define __UNALIGNED_UINT32_READ(addr) (*((const __packed uint32_t *)(addr)))
Anna Bridge 160:5571c4ff569f 96 #endif
Anna Bridge 160:5571c4ff569f 97 #ifndef __ALIGNED
Anna Bridge 160:5571c4ff569f 98 #define __ALIGNED(x) __attribute__((aligned(x)))
Anna Bridge 160:5571c4ff569f 99 #endif
Anna Bridge 160:5571c4ff569f 100 #ifndef __RESTRICT
Anna Bridge 160:5571c4ff569f 101 #define __RESTRICT __restrict
Anna Bridge 160:5571c4ff569f 102 #endif
Anna Bridge 160:5571c4ff569f 103
Anna Bridge 160:5571c4ff569f 104 /* ########################### Core Function Access ########################### */
Anna Bridge 160:5571c4ff569f 105 /** \ingroup CMSIS_Core_FunctionInterface
Anna Bridge 160:5571c4ff569f 106 \defgroup CMSIS_Core_RegAccFunctions CMSIS Core Register Access Functions
Anna Bridge 160:5571c4ff569f 107 @{
Anna Bridge 160:5571c4ff569f 108 */
Anna Bridge 160:5571c4ff569f 109
Anna Bridge 160:5571c4ff569f 110 /**
Anna Bridge 160:5571c4ff569f 111 \brief Enable IRQ Interrupts
Anna Bridge 160:5571c4ff569f 112 \details Enables IRQ interrupts by clearing the I-bit in the CPSR.
Anna Bridge 160:5571c4ff569f 113 Can only be executed in Privileged modes.
Anna Bridge 160:5571c4ff569f 114 */
Anna Bridge 160:5571c4ff569f 115 /* intrinsic void __enable_irq(); */
Anna Bridge 160:5571c4ff569f 116
Anna Bridge 160:5571c4ff569f 117
Anna Bridge 160:5571c4ff569f 118 /**
Anna Bridge 160:5571c4ff569f 119 \brief Disable IRQ Interrupts
Anna Bridge 160:5571c4ff569f 120 \details Disables IRQ interrupts by setting the I-bit in the CPSR.
Anna Bridge 160:5571c4ff569f 121 Can only be executed in Privileged modes.
Anna Bridge 160:5571c4ff569f 122 */
Anna Bridge 160:5571c4ff569f 123 /* intrinsic void __disable_irq(); */
Anna Bridge 160:5571c4ff569f 124
Anna Bridge 160:5571c4ff569f 125 /**
Anna Bridge 160:5571c4ff569f 126 \brief Get Control Register
Anna Bridge 160:5571c4ff569f 127 \details Returns the content of the Control Register.
Anna Bridge 160:5571c4ff569f 128 \return Control Register value
Anna Bridge 160:5571c4ff569f 129 */
Anna Bridge 160:5571c4ff569f 130 __STATIC_INLINE uint32_t __get_CONTROL(void)
Anna Bridge 160:5571c4ff569f 131 {
Anna Bridge 160:5571c4ff569f 132 register uint32_t __regControl __ASM("control");
Anna Bridge 160:5571c4ff569f 133 return(__regControl);
Anna Bridge 160:5571c4ff569f 134 }
Anna Bridge 160:5571c4ff569f 135
Anna Bridge 160:5571c4ff569f 136
Anna Bridge 160:5571c4ff569f 137 /**
Anna Bridge 160:5571c4ff569f 138 \brief Set Control Register
Anna Bridge 160:5571c4ff569f 139 \details Writes the given value to the Control Register.
Anna Bridge 160:5571c4ff569f 140 \param [in] control Control Register value to set
Anna Bridge 160:5571c4ff569f 141 */
Anna Bridge 160:5571c4ff569f 142 __STATIC_INLINE void __set_CONTROL(uint32_t control)
Anna Bridge 160:5571c4ff569f 143 {
Anna Bridge 160:5571c4ff569f 144 register uint32_t __regControl __ASM("control");
Anna Bridge 160:5571c4ff569f 145 __regControl = control;
Anna Bridge 160:5571c4ff569f 146 }
Anna Bridge 160:5571c4ff569f 147
Anna Bridge 160:5571c4ff569f 148
Anna Bridge 160:5571c4ff569f 149 /**
Anna Bridge 160:5571c4ff569f 150 \brief Get IPSR Register
Anna Bridge 160:5571c4ff569f 151 \details Returns the content of the IPSR Register.
Anna Bridge 160:5571c4ff569f 152 \return IPSR Register value
Anna Bridge 160:5571c4ff569f 153 */
Anna Bridge 160:5571c4ff569f 154 __STATIC_INLINE uint32_t __get_IPSR(void)
Anna Bridge 160:5571c4ff569f 155 {
Anna Bridge 160:5571c4ff569f 156 register uint32_t __regIPSR __ASM("ipsr");
Anna Bridge 160:5571c4ff569f 157 return(__regIPSR);
Anna Bridge 160:5571c4ff569f 158 }
Anna Bridge 160:5571c4ff569f 159
Anna Bridge 160:5571c4ff569f 160
Anna Bridge 160:5571c4ff569f 161 /**
Anna Bridge 160:5571c4ff569f 162 \brief Get APSR Register
Anna Bridge 160:5571c4ff569f 163 \details Returns the content of the APSR Register.
Anna Bridge 160:5571c4ff569f 164 \return APSR Register value
Anna Bridge 160:5571c4ff569f 165 */
Anna Bridge 160:5571c4ff569f 166 __STATIC_INLINE uint32_t __get_APSR(void)
Anna Bridge 160:5571c4ff569f 167 {
Anna Bridge 160:5571c4ff569f 168 register uint32_t __regAPSR __ASM("apsr");
Anna Bridge 160:5571c4ff569f 169 return(__regAPSR);
Anna Bridge 160:5571c4ff569f 170 }
Anna Bridge 160:5571c4ff569f 171
Anna Bridge 160:5571c4ff569f 172
Anna Bridge 160:5571c4ff569f 173 /**
Anna Bridge 160:5571c4ff569f 174 \brief Get xPSR Register
Anna Bridge 160:5571c4ff569f 175 \details Returns the content of the xPSR Register.
Anna Bridge 160:5571c4ff569f 176 \return xPSR Register value
Anna Bridge 160:5571c4ff569f 177 */
Anna Bridge 160:5571c4ff569f 178 __STATIC_INLINE uint32_t __get_xPSR(void)
Anna Bridge 160:5571c4ff569f 179 {
Anna Bridge 160:5571c4ff569f 180 register uint32_t __regXPSR __ASM("xpsr");
Anna Bridge 160:5571c4ff569f 181 return(__regXPSR);
Anna Bridge 160:5571c4ff569f 182 }
Anna Bridge 160:5571c4ff569f 183
Anna Bridge 160:5571c4ff569f 184
Anna Bridge 160:5571c4ff569f 185 /**
Anna Bridge 160:5571c4ff569f 186 \brief Get Process Stack Pointer
Anna Bridge 160:5571c4ff569f 187 \details Returns the current value of the Process Stack Pointer (PSP).
Anna Bridge 160:5571c4ff569f 188 \return PSP Register value
Anna Bridge 160:5571c4ff569f 189 */
Anna Bridge 160:5571c4ff569f 190 __STATIC_INLINE uint32_t __get_PSP(void)
Anna Bridge 160:5571c4ff569f 191 {
Anna Bridge 160:5571c4ff569f 192 register uint32_t __regProcessStackPointer __ASM("psp");
Anna Bridge 160:5571c4ff569f 193 return(__regProcessStackPointer);
Anna Bridge 160:5571c4ff569f 194 }
Anna Bridge 160:5571c4ff569f 195
Anna Bridge 160:5571c4ff569f 196
Anna Bridge 160:5571c4ff569f 197 /**
Anna Bridge 160:5571c4ff569f 198 \brief Set Process Stack Pointer
Anna Bridge 160:5571c4ff569f 199 \details Assigns the given value to the Process Stack Pointer (PSP).
Anna Bridge 160:5571c4ff569f 200 \param [in] topOfProcStack Process Stack Pointer value to set
Anna Bridge 160:5571c4ff569f 201 */
Anna Bridge 160:5571c4ff569f 202 __STATIC_INLINE void __set_PSP(uint32_t topOfProcStack)
Anna Bridge 160:5571c4ff569f 203 {
Anna Bridge 160:5571c4ff569f 204 register uint32_t __regProcessStackPointer __ASM("psp");
Anna Bridge 160:5571c4ff569f 205 __regProcessStackPointer = topOfProcStack;
Anna Bridge 160:5571c4ff569f 206 }
Anna Bridge 160:5571c4ff569f 207
Anna Bridge 160:5571c4ff569f 208
Anna Bridge 160:5571c4ff569f 209 /**
Anna Bridge 160:5571c4ff569f 210 \brief Get Main Stack Pointer
Anna Bridge 160:5571c4ff569f 211 \details Returns the current value of the Main Stack Pointer (MSP).
Anna Bridge 160:5571c4ff569f 212 \return MSP Register value
Anna Bridge 160:5571c4ff569f 213 */
Anna Bridge 160:5571c4ff569f 214 __STATIC_INLINE uint32_t __get_MSP(void)
Anna Bridge 160:5571c4ff569f 215 {
Anna Bridge 160:5571c4ff569f 216 register uint32_t __regMainStackPointer __ASM("msp");
Anna Bridge 160:5571c4ff569f 217 return(__regMainStackPointer);
Anna Bridge 160:5571c4ff569f 218 }
Anna Bridge 160:5571c4ff569f 219
Anna Bridge 160:5571c4ff569f 220
Anna Bridge 160:5571c4ff569f 221 /**
Anna Bridge 160:5571c4ff569f 222 \brief Set Main Stack Pointer
Anna Bridge 160:5571c4ff569f 223 \details Assigns the given value to the Main Stack Pointer (MSP).
Anna Bridge 160:5571c4ff569f 224 \param [in] topOfMainStack Main Stack Pointer value to set
Anna Bridge 160:5571c4ff569f 225 */
Anna Bridge 160:5571c4ff569f 226 __STATIC_INLINE void __set_MSP(uint32_t topOfMainStack)
Anna Bridge 160:5571c4ff569f 227 {
Anna Bridge 160:5571c4ff569f 228 register uint32_t __regMainStackPointer __ASM("msp");
Anna Bridge 160:5571c4ff569f 229 __regMainStackPointer = topOfMainStack;
Anna Bridge 160:5571c4ff569f 230 }
Anna Bridge 160:5571c4ff569f 231
Anna Bridge 160:5571c4ff569f 232
Anna Bridge 160:5571c4ff569f 233 /**
Anna Bridge 160:5571c4ff569f 234 \brief Get Priority Mask
Anna Bridge 160:5571c4ff569f 235 \details Returns the current state of the priority mask bit from the Priority Mask Register.
Anna Bridge 160:5571c4ff569f 236 \return Priority Mask value
Anna Bridge 160:5571c4ff569f 237 */
Anna Bridge 160:5571c4ff569f 238 __STATIC_INLINE uint32_t __get_PRIMASK(void)
Anna Bridge 160:5571c4ff569f 239 {
Anna Bridge 160:5571c4ff569f 240 register uint32_t __regPriMask __ASM("primask");
Anna Bridge 160:5571c4ff569f 241 return(__regPriMask);
Anna Bridge 160:5571c4ff569f 242 }
Anna Bridge 160:5571c4ff569f 243
Anna Bridge 160:5571c4ff569f 244
Anna Bridge 160:5571c4ff569f 245 /**
Anna Bridge 160:5571c4ff569f 246 \brief Set Priority Mask
Anna Bridge 160:5571c4ff569f 247 \details Assigns the given value to the Priority Mask Register.
Anna Bridge 160:5571c4ff569f 248 \param [in] priMask Priority Mask
Anna Bridge 160:5571c4ff569f 249 */
Anna Bridge 160:5571c4ff569f 250 __STATIC_INLINE void __set_PRIMASK(uint32_t priMask)
Anna Bridge 160:5571c4ff569f 251 {
Anna Bridge 160:5571c4ff569f 252 register uint32_t __regPriMask __ASM("primask");
Anna Bridge 160:5571c4ff569f 253 __regPriMask = (priMask);
Anna Bridge 160:5571c4ff569f 254 }
Anna Bridge 160:5571c4ff569f 255
Anna Bridge 160:5571c4ff569f 256
Anna Bridge 160:5571c4ff569f 257 #if ((defined (__ARM_ARCH_7M__ ) && (__ARM_ARCH_7M__ == 1)) || \
Anna Bridge 160:5571c4ff569f 258 (defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) )
Anna Bridge 160:5571c4ff569f 259
Anna Bridge 160:5571c4ff569f 260 /**
Anna Bridge 160:5571c4ff569f 261 \brief Enable FIQ
Anna Bridge 160:5571c4ff569f 262 \details Enables FIQ interrupts by clearing the F-bit in the CPSR.
Anna Bridge 160:5571c4ff569f 263 Can only be executed in Privileged modes.
Anna Bridge 160:5571c4ff569f 264 */
Anna Bridge 160:5571c4ff569f 265 #define __enable_fault_irq __enable_fiq
Anna Bridge 160:5571c4ff569f 266
Anna Bridge 160:5571c4ff569f 267
Anna Bridge 160:5571c4ff569f 268 /**
Anna Bridge 160:5571c4ff569f 269 \brief Disable FIQ
Anna Bridge 160:5571c4ff569f 270 \details Disables FIQ interrupts by setting the F-bit in the CPSR.
Anna Bridge 160:5571c4ff569f 271 Can only be executed in Privileged modes.
Anna Bridge 160:5571c4ff569f 272 */
Anna Bridge 160:5571c4ff569f 273 #define __disable_fault_irq __disable_fiq
Anna Bridge 160:5571c4ff569f 274
Anna Bridge 160:5571c4ff569f 275
Anna Bridge 160:5571c4ff569f 276 /**
Anna Bridge 160:5571c4ff569f 277 \brief Get Base Priority
Anna Bridge 160:5571c4ff569f 278 \details Returns the current value of the Base Priority register.
Anna Bridge 160:5571c4ff569f 279 \return Base Priority register value
Anna Bridge 160:5571c4ff569f 280 */
Anna Bridge 160:5571c4ff569f 281 __STATIC_INLINE uint32_t __get_BASEPRI(void)
Anna Bridge 160:5571c4ff569f 282 {
Anna Bridge 160:5571c4ff569f 283 register uint32_t __regBasePri __ASM("basepri");
Anna Bridge 160:5571c4ff569f 284 return(__regBasePri);
Anna Bridge 160:5571c4ff569f 285 }
Anna Bridge 160:5571c4ff569f 286
Anna Bridge 160:5571c4ff569f 287
Anna Bridge 160:5571c4ff569f 288 /**
Anna Bridge 160:5571c4ff569f 289 \brief Set Base Priority
Anna Bridge 160:5571c4ff569f 290 \details Assigns the given value to the Base Priority register.
Anna Bridge 160:5571c4ff569f 291 \param [in] basePri Base Priority value to set
Anna Bridge 160:5571c4ff569f 292 */
Anna Bridge 160:5571c4ff569f 293 __STATIC_INLINE void __set_BASEPRI(uint32_t basePri)
Anna Bridge 160:5571c4ff569f 294 {
Anna Bridge 160:5571c4ff569f 295 register uint32_t __regBasePri __ASM("basepri");
Anna Bridge 160:5571c4ff569f 296 __regBasePri = (basePri & 0xFFU);
Anna Bridge 160:5571c4ff569f 297 }
Anna Bridge 160:5571c4ff569f 298
Anna Bridge 160:5571c4ff569f 299
Anna Bridge 160:5571c4ff569f 300 /**
Anna Bridge 160:5571c4ff569f 301 \brief Set Base Priority with condition
Anna Bridge 160:5571c4ff569f 302 \details Assigns the given value to the Base Priority register only if BASEPRI masking is disabled,
Anna Bridge 160:5571c4ff569f 303 or the new value increases the BASEPRI priority level.
Anna Bridge 160:5571c4ff569f 304 \param [in] basePri Base Priority value to set
Anna Bridge 160:5571c4ff569f 305 */
Anna Bridge 160:5571c4ff569f 306 __STATIC_INLINE void __set_BASEPRI_MAX(uint32_t basePri)
Anna Bridge 160:5571c4ff569f 307 {
Anna Bridge 160:5571c4ff569f 308 register uint32_t __regBasePriMax __ASM("basepri_max");
Anna Bridge 160:5571c4ff569f 309 __regBasePriMax = (basePri & 0xFFU);
Anna Bridge 160:5571c4ff569f 310 }
Anna Bridge 160:5571c4ff569f 311
Anna Bridge 160:5571c4ff569f 312
Anna Bridge 160:5571c4ff569f 313 /**
Anna Bridge 160:5571c4ff569f 314 \brief Get Fault Mask
Anna Bridge 160:5571c4ff569f 315 \details Returns the current value of the Fault Mask register.
Anna Bridge 160:5571c4ff569f 316 \return Fault Mask register value
Anna Bridge 160:5571c4ff569f 317 */
Anna Bridge 160:5571c4ff569f 318 __STATIC_INLINE uint32_t __get_FAULTMASK(void)
Anna Bridge 160:5571c4ff569f 319 {
Anna Bridge 160:5571c4ff569f 320 register uint32_t __regFaultMask __ASM("faultmask");
Anna Bridge 160:5571c4ff569f 321 return(__regFaultMask);
Anna Bridge 160:5571c4ff569f 322 }
Anna Bridge 160:5571c4ff569f 323
Anna Bridge 160:5571c4ff569f 324
Anna Bridge 160:5571c4ff569f 325 /**
Anna Bridge 160:5571c4ff569f 326 \brief Set Fault Mask
Anna Bridge 160:5571c4ff569f 327 \details Assigns the given value to the Fault Mask register.
Anna Bridge 160:5571c4ff569f 328 \param [in] faultMask Fault Mask value to set
Anna Bridge 160:5571c4ff569f 329 */
Anna Bridge 160:5571c4ff569f 330 __STATIC_INLINE void __set_FAULTMASK(uint32_t faultMask)
Anna Bridge 160:5571c4ff569f 331 {
Anna Bridge 160:5571c4ff569f 332 register uint32_t __regFaultMask __ASM("faultmask");
Anna Bridge 160:5571c4ff569f 333 __regFaultMask = (faultMask & (uint32_t)1U);
Anna Bridge 160:5571c4ff569f 334 }
Anna Bridge 160:5571c4ff569f 335
Anna Bridge 160:5571c4ff569f 336 #endif /* ((defined (__ARM_ARCH_7M__ ) && (__ARM_ARCH_7M__ == 1)) || \
Anna Bridge 160:5571c4ff569f 337 (defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) ) */
Anna Bridge 160:5571c4ff569f 338
Anna Bridge 160:5571c4ff569f 339
Anna Bridge 160:5571c4ff569f 340 #if ((defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) )
Anna Bridge 160:5571c4ff569f 341
Anna Bridge 160:5571c4ff569f 342 /**
Anna Bridge 160:5571c4ff569f 343 \brief Get FPSCR
Anna Bridge 160:5571c4ff569f 344 \details Returns the current value of the Floating Point Status/Control register.
Anna Bridge 160:5571c4ff569f 345 \return Floating Point Status/Control register value
Anna Bridge 160:5571c4ff569f 346 */
Anna Bridge 160:5571c4ff569f 347 __STATIC_INLINE uint32_t __get_FPSCR(void)
Anna Bridge 160:5571c4ff569f 348 {
Anna Bridge 160:5571c4ff569f 349 #if ((defined (__FPU_PRESENT) && (__FPU_PRESENT == 1U)) && \
Anna Bridge 160:5571c4ff569f 350 (defined (__FPU_USED ) && (__FPU_USED == 1U)) )
Anna Bridge 160:5571c4ff569f 351 register uint32_t __regfpscr __ASM("fpscr");
Anna Bridge 160:5571c4ff569f 352 return(__regfpscr);
Anna Bridge 160:5571c4ff569f 353 #else
Anna Bridge 160:5571c4ff569f 354 return(0U);
Anna Bridge 160:5571c4ff569f 355 #endif
Anna Bridge 160:5571c4ff569f 356 }
Anna Bridge 160:5571c4ff569f 357
Anna Bridge 160:5571c4ff569f 358
Anna Bridge 160:5571c4ff569f 359 /**
Anna Bridge 160:5571c4ff569f 360 \brief Set FPSCR
Anna Bridge 160:5571c4ff569f 361 \details Assigns the given value to the Floating Point Status/Control register.
Anna Bridge 160:5571c4ff569f 362 \param [in] fpscr Floating Point Status/Control value to set
Anna Bridge 160:5571c4ff569f 363 */
Anna Bridge 160:5571c4ff569f 364 __STATIC_INLINE void __set_FPSCR(uint32_t fpscr)
Anna Bridge 160:5571c4ff569f 365 {
Anna Bridge 160:5571c4ff569f 366 #if ((defined (__FPU_PRESENT) && (__FPU_PRESENT == 1U)) && \
Anna Bridge 160:5571c4ff569f 367 (defined (__FPU_USED ) && (__FPU_USED == 1U)) )
Anna Bridge 160:5571c4ff569f 368 register uint32_t __regfpscr __ASM("fpscr");
Anna Bridge 160:5571c4ff569f 369 __regfpscr = (fpscr);
Anna Bridge 160:5571c4ff569f 370 #else
Anna Bridge 160:5571c4ff569f 371 (void)fpscr;
Anna Bridge 160:5571c4ff569f 372 #endif
Anna Bridge 160:5571c4ff569f 373 }
Anna Bridge 160:5571c4ff569f 374
Anna Bridge 160:5571c4ff569f 375 #endif /* ((defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) ) */
Anna Bridge 160:5571c4ff569f 376
Anna Bridge 160:5571c4ff569f 377
Anna Bridge 160:5571c4ff569f 378
Anna Bridge 160:5571c4ff569f 379 /*@} end of CMSIS_Core_RegAccFunctions */
Anna Bridge 160:5571c4ff569f 380
Anna Bridge 160:5571c4ff569f 381
Anna Bridge 160:5571c4ff569f 382 /* ########################## Core Instruction Access ######################### */
Anna Bridge 160:5571c4ff569f 383 /** \defgroup CMSIS_Core_InstructionInterface CMSIS Core Instruction Interface
Anna Bridge 160:5571c4ff569f 384 Access to dedicated instructions
Anna Bridge 160:5571c4ff569f 385 @{
Anna Bridge 160:5571c4ff569f 386 */
Anna Bridge 160:5571c4ff569f 387
Anna Bridge 160:5571c4ff569f 388 /**
Anna Bridge 160:5571c4ff569f 389 \brief No Operation
Anna Bridge 160:5571c4ff569f 390 \details No Operation does nothing. This instruction can be used for code alignment purposes.
Anna Bridge 160:5571c4ff569f 391 */
Anna Bridge 160:5571c4ff569f 392 #define __NOP __nop
Anna Bridge 160:5571c4ff569f 393
Anna Bridge 160:5571c4ff569f 394
Anna Bridge 160:5571c4ff569f 395 /**
Anna Bridge 160:5571c4ff569f 396 \brief Wait For Interrupt
Anna Bridge 160:5571c4ff569f 397 \details Wait For Interrupt is a hint instruction that suspends execution until one of a number of events occurs.
Anna Bridge 160:5571c4ff569f 398 */
Anna Bridge 160:5571c4ff569f 399 #define __WFI __wfi
Anna Bridge 160:5571c4ff569f 400
Anna Bridge 160:5571c4ff569f 401
Anna Bridge 160:5571c4ff569f 402 /**
Anna Bridge 160:5571c4ff569f 403 \brief Wait For Event
Anna Bridge 160:5571c4ff569f 404 \details Wait For Event is a hint instruction that permits the processor to enter
Anna Bridge 160:5571c4ff569f 405 a low-power state until one of a number of events occurs.
Anna Bridge 160:5571c4ff569f 406 */
Anna Bridge 160:5571c4ff569f 407 #define __WFE __wfe
Anna Bridge 160:5571c4ff569f 408
Anna Bridge 160:5571c4ff569f 409
Anna Bridge 160:5571c4ff569f 410 /**
Anna Bridge 160:5571c4ff569f 411 \brief Send Event
Anna Bridge 160:5571c4ff569f 412 \details Send Event is a hint instruction. It causes an event to be signaled to the CPU.
Anna Bridge 160:5571c4ff569f 413 */
Anna Bridge 160:5571c4ff569f 414 #define __SEV __sev
Anna Bridge 160:5571c4ff569f 415
Anna Bridge 160:5571c4ff569f 416
Anna Bridge 160:5571c4ff569f 417 /**
Anna Bridge 160:5571c4ff569f 418 \brief Instruction Synchronization Barrier
Anna Bridge 160:5571c4ff569f 419 \details Instruction Synchronization Barrier flushes the pipeline in the processor,
Anna Bridge 160:5571c4ff569f 420 so that all instructions following the ISB are fetched from cache or memory,
Anna Bridge 160:5571c4ff569f 421 after the instruction has been completed.
Anna Bridge 160:5571c4ff569f 422 */
Anna Bridge 160:5571c4ff569f 423 #define __ISB() do {\
Anna Bridge 160:5571c4ff569f 424 __schedule_barrier();\
Anna Bridge 160:5571c4ff569f 425 __isb(0xF);\
Anna Bridge 160:5571c4ff569f 426 __schedule_barrier();\
Anna Bridge 160:5571c4ff569f 427 } while (0U)
Anna Bridge 160:5571c4ff569f 428
Anna Bridge 160:5571c4ff569f 429 /**
Anna Bridge 160:5571c4ff569f 430 \brief Data Synchronization Barrier
Anna Bridge 160:5571c4ff569f 431 \details Acts as a special kind of Data Memory Barrier.
Anna Bridge 160:5571c4ff569f 432 It completes when all explicit memory accesses before this instruction complete.
Anna Bridge 160:5571c4ff569f 433 */
Anna Bridge 160:5571c4ff569f 434 #define __DSB() do {\
Anna Bridge 160:5571c4ff569f 435 __schedule_barrier();\
Anna Bridge 160:5571c4ff569f 436 __dsb(0xF);\
Anna Bridge 160:5571c4ff569f 437 __schedule_barrier();\
Anna Bridge 160:5571c4ff569f 438 } while (0U)
Anna Bridge 160:5571c4ff569f 439
Anna Bridge 160:5571c4ff569f 440 /**
Anna Bridge 160:5571c4ff569f 441 \brief Data Memory Barrier
Anna Bridge 160:5571c4ff569f 442 \details Ensures the apparent order of the explicit memory operations before
Anna Bridge 160:5571c4ff569f 443 and after the instruction, without ensuring their completion.
Anna Bridge 160:5571c4ff569f 444 */
Anna Bridge 160:5571c4ff569f 445 #define __DMB() do {\
Anna Bridge 160:5571c4ff569f 446 __schedule_barrier();\
Anna Bridge 160:5571c4ff569f 447 __dmb(0xF);\
Anna Bridge 160:5571c4ff569f 448 __schedule_barrier();\
Anna Bridge 160:5571c4ff569f 449 } while (0U)
Anna Bridge 160:5571c4ff569f 450
Anna Bridge 169:a7c7b631e539 451
Anna Bridge 160:5571c4ff569f 452 /**
Anna Bridge 160:5571c4ff569f 453 \brief Reverse byte order (32 bit)
Anna Bridge 169:a7c7b631e539 454 \details Reverses the byte order in unsigned integer value. For example, 0x12345678 becomes 0x78563412.
Anna Bridge 160:5571c4ff569f 455 \param [in] value Value to reverse
Anna Bridge 160:5571c4ff569f 456 \return Reversed value
Anna Bridge 160:5571c4ff569f 457 */
Anna Bridge 160:5571c4ff569f 458 #define __REV __rev
Anna Bridge 160:5571c4ff569f 459
Anna Bridge 160:5571c4ff569f 460
Anna Bridge 160:5571c4ff569f 461 /**
Anna Bridge 160:5571c4ff569f 462 \brief Reverse byte order (16 bit)
Anna Bridge 169:a7c7b631e539 463 \details Reverses the byte order within each halfword of a word. For example, 0x12345678 becomes 0x34127856.
Anna Bridge 160:5571c4ff569f 464 \param [in] value Value to reverse
Anna Bridge 160:5571c4ff569f 465 \return Reversed value
Anna Bridge 160:5571c4ff569f 466 */
Anna Bridge 160:5571c4ff569f 467 #ifndef __NO_EMBEDDED_ASM
Anna Bridge 169:a7c7b631e539 468 __attribute__((section(".rev16_text"))) __STATIC_INLINE __ASM uint32_t __REV16(uint32_t value)
Anna Bridge 160:5571c4ff569f 469 {
Anna Bridge 160:5571c4ff569f 470 rev16 r0, r0
Anna Bridge 160:5571c4ff569f 471 bx lr
Anna Bridge 160:5571c4ff569f 472 }
Anna Bridge 160:5571c4ff569f 473 #endif
Anna Bridge 160:5571c4ff569f 474
Anna Bridge 160:5571c4ff569f 475
Anna Bridge 160:5571c4ff569f 476 /**
Anna Bridge 169:a7c7b631e539 477 \brief Reverse byte order (16 bit)
Anna Bridge 169:a7c7b631e539 478 \details Reverses the byte order in a 16-bit value and returns the signed 16-bit result. For example, 0x0080 becomes 0x8000.
Anna Bridge 160:5571c4ff569f 479 \param [in] value Value to reverse
Anna Bridge 160:5571c4ff569f 480 \return Reversed value
Anna Bridge 160:5571c4ff569f 481 */
Anna Bridge 160:5571c4ff569f 482 #ifndef __NO_EMBEDDED_ASM
Anna Bridge 160:5571c4ff569f 483 __attribute__((section(".revsh_text"))) __STATIC_INLINE __ASM int16_t __REVSH(int16_t value)
Anna Bridge 160:5571c4ff569f 484 {
Anna Bridge 160:5571c4ff569f 485 revsh r0, r0
Anna Bridge 160:5571c4ff569f 486 bx lr
Anna Bridge 160:5571c4ff569f 487 }
Anna Bridge 160:5571c4ff569f 488 #endif
Anna Bridge 160:5571c4ff569f 489
Anna Bridge 160:5571c4ff569f 490
Anna Bridge 160:5571c4ff569f 491 /**
Anna Bridge 160:5571c4ff569f 492 \brief Rotate Right in unsigned value (32 bit)
Anna Bridge 160:5571c4ff569f 493 \details Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits.
Anna Bridge 160:5571c4ff569f 494 \param [in] op1 Value to rotate
Anna Bridge 160:5571c4ff569f 495 \param [in] op2 Number of Bits to rotate
Anna Bridge 160:5571c4ff569f 496 \return Rotated value
Anna Bridge 160:5571c4ff569f 497 */
Anna Bridge 160:5571c4ff569f 498 #define __ROR __ror
Anna Bridge 160:5571c4ff569f 499
Anna Bridge 160:5571c4ff569f 500
Anna Bridge 160:5571c4ff569f 501 /**
Anna Bridge 160:5571c4ff569f 502 \brief Breakpoint
Anna Bridge 160:5571c4ff569f 503 \details Causes the processor to enter Debug state.
Anna Bridge 160:5571c4ff569f 504 Debug tools can use this to investigate system state when the instruction at a particular address is reached.
Anna Bridge 160:5571c4ff569f 505 \param [in] value is ignored by the processor.
Anna Bridge 160:5571c4ff569f 506 If required, a debugger can use it to store additional information about the breakpoint.
Anna Bridge 160:5571c4ff569f 507 */
Anna Bridge 160:5571c4ff569f 508 #define __BKPT(value) __breakpoint(value)
Anna Bridge 160:5571c4ff569f 509
Anna Bridge 160:5571c4ff569f 510
Anna Bridge 160:5571c4ff569f 511 /**
Anna Bridge 160:5571c4ff569f 512 \brief Reverse bit order of value
Anna Bridge 160:5571c4ff569f 513 \details Reverses the bit order of the given value.
Anna Bridge 160:5571c4ff569f 514 \param [in] value Value to reverse
Anna Bridge 160:5571c4ff569f 515 \return Reversed value
Anna Bridge 160:5571c4ff569f 516 */
Anna Bridge 160:5571c4ff569f 517 #if ((defined (__ARM_ARCH_7M__ ) && (__ARM_ARCH_7M__ == 1)) || \
Anna Bridge 160:5571c4ff569f 518 (defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) )
Anna Bridge 160:5571c4ff569f 519 #define __RBIT __rbit
Anna Bridge 160:5571c4ff569f 520 #else
Anna Bridge 160:5571c4ff569f 521 __attribute__((always_inline)) __STATIC_INLINE uint32_t __RBIT(uint32_t value)
Anna Bridge 160:5571c4ff569f 522 {
Anna Bridge 160:5571c4ff569f 523 uint32_t result;
Anna Bridge 160:5571c4ff569f 524 uint32_t s = (4U /*sizeof(v)*/ * 8U) - 1U; /* extra shift needed at end */
Anna Bridge 160:5571c4ff569f 525
Anna Bridge 160:5571c4ff569f 526 result = value; /* r will be reversed bits of v; first get LSB of v */
Anna Bridge 160:5571c4ff569f 527 for (value >>= 1U; value != 0U; value >>= 1U)
Anna Bridge 160:5571c4ff569f 528 {
Anna Bridge 160:5571c4ff569f 529 result <<= 1U;
Anna Bridge 160:5571c4ff569f 530 result |= value & 1U;
Anna Bridge 160:5571c4ff569f 531 s--;
Anna Bridge 160:5571c4ff569f 532 }
Anna Bridge 160:5571c4ff569f 533 result <<= s; /* shift when v's highest bits are zero */
Anna Bridge 160:5571c4ff569f 534 return result;
Anna Bridge 160:5571c4ff569f 535 }
Anna Bridge 160:5571c4ff569f 536 #endif
Anna Bridge 160:5571c4ff569f 537
Anna Bridge 160:5571c4ff569f 538
Anna Bridge 160:5571c4ff569f 539 /**
Anna Bridge 160:5571c4ff569f 540 \brief Count leading zeros
Anna Bridge 160:5571c4ff569f 541 \details Counts the number of leading zeros of a data value.
Anna Bridge 160:5571c4ff569f 542 \param [in] value Value to count the leading zeros
Anna Bridge 160:5571c4ff569f 543 \return number of leading zeros in value
Anna Bridge 160:5571c4ff569f 544 */
Anna Bridge 160:5571c4ff569f 545 #define __CLZ __clz
Anna Bridge 160:5571c4ff569f 546
Anna Bridge 160:5571c4ff569f 547
Anna Bridge 160:5571c4ff569f 548 #if ((defined (__ARM_ARCH_7M__ ) && (__ARM_ARCH_7M__ == 1)) || \
Anna Bridge 160:5571c4ff569f 549 (defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) )
Anna Bridge 160:5571c4ff569f 550
Anna Bridge 160:5571c4ff569f 551 /**
Anna Bridge 160:5571c4ff569f 552 \brief LDR Exclusive (8 bit)
Anna Bridge 160:5571c4ff569f 553 \details Executes a exclusive LDR instruction for 8 bit value.
Anna Bridge 160:5571c4ff569f 554 \param [in] ptr Pointer to data
Anna Bridge 160:5571c4ff569f 555 \return value of type uint8_t at (*ptr)
Anna Bridge 160:5571c4ff569f 556 */
Anna Bridge 160:5571c4ff569f 557 #if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020)
Anna Bridge 160:5571c4ff569f 558 #define __LDREXB(ptr) ((uint8_t ) __ldrex(ptr))
Anna Bridge 160:5571c4ff569f 559 #else
Anna Bridge 160:5571c4ff569f 560 #define __LDREXB(ptr) _Pragma("push") _Pragma("diag_suppress 3731") ((uint8_t ) __ldrex(ptr)) _Pragma("pop")
Anna Bridge 160:5571c4ff569f 561 #endif
Anna Bridge 160:5571c4ff569f 562
Anna Bridge 160:5571c4ff569f 563
Anna Bridge 160:5571c4ff569f 564 /**
Anna Bridge 160:5571c4ff569f 565 \brief LDR Exclusive (16 bit)
Anna Bridge 160:5571c4ff569f 566 \details Executes a exclusive LDR instruction for 16 bit values.
Anna Bridge 160:5571c4ff569f 567 \param [in] ptr Pointer to data
Anna Bridge 160:5571c4ff569f 568 \return value of type uint16_t at (*ptr)
Anna Bridge 160:5571c4ff569f 569 */
Anna Bridge 160:5571c4ff569f 570 #if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020)
Anna Bridge 160:5571c4ff569f 571 #define __LDREXH(ptr) ((uint16_t) __ldrex(ptr))
Anna Bridge 160:5571c4ff569f 572 #else
Anna Bridge 160:5571c4ff569f 573 #define __LDREXH(ptr) _Pragma("push") _Pragma("diag_suppress 3731") ((uint16_t) __ldrex(ptr)) _Pragma("pop")
Anna Bridge 160:5571c4ff569f 574 #endif
Anna Bridge 160:5571c4ff569f 575
Anna Bridge 160:5571c4ff569f 576
Anna Bridge 160:5571c4ff569f 577 /**
Anna Bridge 160:5571c4ff569f 578 \brief LDR Exclusive (32 bit)
Anna Bridge 160:5571c4ff569f 579 \details Executes a exclusive LDR instruction for 32 bit values.
Anna Bridge 160:5571c4ff569f 580 \param [in] ptr Pointer to data
Anna Bridge 160:5571c4ff569f 581 \return value of type uint32_t at (*ptr)
Anna Bridge 160:5571c4ff569f 582 */
Anna Bridge 160:5571c4ff569f 583 #if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020)
Anna Bridge 160:5571c4ff569f 584 #define __LDREXW(ptr) ((uint32_t ) __ldrex(ptr))
Anna Bridge 160:5571c4ff569f 585 #else
Anna Bridge 160:5571c4ff569f 586 #define __LDREXW(ptr) _Pragma("push") _Pragma("diag_suppress 3731") ((uint32_t ) __ldrex(ptr)) _Pragma("pop")
Anna Bridge 160:5571c4ff569f 587 #endif
Anna Bridge 160:5571c4ff569f 588
Anna Bridge 160:5571c4ff569f 589
Anna Bridge 160:5571c4ff569f 590 /**
Anna Bridge 160:5571c4ff569f 591 \brief STR Exclusive (8 bit)
Anna Bridge 160:5571c4ff569f 592 \details Executes a exclusive STR instruction for 8 bit values.
Anna Bridge 160:5571c4ff569f 593 \param [in] value Value to store
Anna Bridge 160:5571c4ff569f 594 \param [in] ptr Pointer to location
Anna Bridge 160:5571c4ff569f 595 \return 0 Function succeeded
Anna Bridge 160:5571c4ff569f 596 \return 1 Function failed
Anna Bridge 160:5571c4ff569f 597 */
Anna Bridge 160:5571c4ff569f 598 #if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020)
Anna Bridge 160:5571c4ff569f 599 #define __STREXB(value, ptr) __strex(value, ptr)
Anna Bridge 160:5571c4ff569f 600 #else
Anna Bridge 160:5571c4ff569f 601 #define __STREXB(value, ptr) _Pragma("push") _Pragma("diag_suppress 3731") __strex(value, ptr) _Pragma("pop")
Anna Bridge 160:5571c4ff569f 602 #endif
Anna Bridge 160:5571c4ff569f 603
Anna Bridge 160:5571c4ff569f 604
Anna Bridge 160:5571c4ff569f 605 /**
Anna Bridge 160:5571c4ff569f 606 \brief STR Exclusive (16 bit)
Anna Bridge 160:5571c4ff569f 607 \details Executes a exclusive STR instruction for 16 bit values.
Anna Bridge 160:5571c4ff569f 608 \param [in] value Value to store
Anna Bridge 160:5571c4ff569f 609 \param [in] ptr Pointer to location
Anna Bridge 160:5571c4ff569f 610 \return 0 Function succeeded
Anna Bridge 160:5571c4ff569f 611 \return 1 Function failed
Anna Bridge 160:5571c4ff569f 612 */
Anna Bridge 160:5571c4ff569f 613 #if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020)
Anna Bridge 160:5571c4ff569f 614 #define __STREXH(value, ptr) __strex(value, ptr)
Anna Bridge 160:5571c4ff569f 615 #else
Anna Bridge 160:5571c4ff569f 616 #define __STREXH(value, ptr) _Pragma("push") _Pragma("diag_suppress 3731") __strex(value, ptr) _Pragma("pop")
Anna Bridge 160:5571c4ff569f 617 #endif
Anna Bridge 160:5571c4ff569f 618
Anna Bridge 160:5571c4ff569f 619
Anna Bridge 160:5571c4ff569f 620 /**
Anna Bridge 160:5571c4ff569f 621 \brief STR Exclusive (32 bit)
Anna Bridge 160:5571c4ff569f 622 \details Executes a exclusive STR instruction for 32 bit values.
Anna Bridge 160:5571c4ff569f 623 \param [in] value Value to store
Anna Bridge 160:5571c4ff569f 624 \param [in] ptr Pointer to location
Anna Bridge 160:5571c4ff569f 625 \return 0 Function succeeded
Anna Bridge 160:5571c4ff569f 626 \return 1 Function failed
Anna Bridge 160:5571c4ff569f 627 */
Anna Bridge 160:5571c4ff569f 628 #if defined(__ARMCC_VERSION) && (__ARMCC_VERSION < 5060020)
Anna Bridge 160:5571c4ff569f 629 #define __STREXW(value, ptr) __strex(value, ptr)
Anna Bridge 160:5571c4ff569f 630 #else
Anna Bridge 160:5571c4ff569f 631 #define __STREXW(value, ptr) _Pragma("push") _Pragma("diag_suppress 3731") __strex(value, ptr) _Pragma("pop")
Anna Bridge 160:5571c4ff569f 632 #endif
Anna Bridge 160:5571c4ff569f 633
Anna Bridge 160:5571c4ff569f 634
Anna Bridge 160:5571c4ff569f 635 /**
Anna Bridge 160:5571c4ff569f 636 \brief Remove the exclusive lock
Anna Bridge 160:5571c4ff569f 637 \details Removes the exclusive lock which is created by LDREX.
Anna Bridge 160:5571c4ff569f 638 */
Anna Bridge 160:5571c4ff569f 639 #define __CLREX __clrex
Anna Bridge 160:5571c4ff569f 640
Anna Bridge 160:5571c4ff569f 641
Anna Bridge 160:5571c4ff569f 642 /**
Anna Bridge 160:5571c4ff569f 643 \brief Signed Saturate
Anna Bridge 160:5571c4ff569f 644 \details Saturates a signed value.
Anna Bridge 160:5571c4ff569f 645 \param [in] value Value to be saturated
Anna Bridge 160:5571c4ff569f 646 \param [in] sat Bit position to saturate to (1..32)
Anna Bridge 160:5571c4ff569f 647 \return Saturated value
Anna Bridge 160:5571c4ff569f 648 */
Anna Bridge 160:5571c4ff569f 649 #define __SSAT __ssat
Anna Bridge 160:5571c4ff569f 650
Anna Bridge 160:5571c4ff569f 651
Anna Bridge 160:5571c4ff569f 652 /**
Anna Bridge 160:5571c4ff569f 653 \brief Unsigned Saturate
Anna Bridge 160:5571c4ff569f 654 \details Saturates an unsigned value.
Anna Bridge 160:5571c4ff569f 655 \param [in] value Value to be saturated
Anna Bridge 160:5571c4ff569f 656 \param [in] sat Bit position to saturate to (0..31)
Anna Bridge 160:5571c4ff569f 657 \return Saturated value
Anna Bridge 160:5571c4ff569f 658 */
Anna Bridge 160:5571c4ff569f 659 #define __USAT __usat
Anna Bridge 160:5571c4ff569f 660
Anna Bridge 160:5571c4ff569f 661
Anna Bridge 160:5571c4ff569f 662 /**
Anna Bridge 160:5571c4ff569f 663 \brief Rotate Right with Extend (32 bit)
Anna Bridge 160:5571c4ff569f 664 \details Moves each bit of a bitstring right by one bit.
Anna Bridge 160:5571c4ff569f 665 The carry input is shifted in at the left end of the bitstring.
Anna Bridge 160:5571c4ff569f 666 \param [in] value Value to rotate
Anna Bridge 160:5571c4ff569f 667 \return Rotated value
Anna Bridge 160:5571c4ff569f 668 */
Anna Bridge 160:5571c4ff569f 669 #ifndef __NO_EMBEDDED_ASM
Anna Bridge 160:5571c4ff569f 670 __attribute__((section(".rrx_text"))) __STATIC_INLINE __ASM uint32_t __RRX(uint32_t value)
Anna Bridge 160:5571c4ff569f 671 {
Anna Bridge 160:5571c4ff569f 672 rrx r0, r0
Anna Bridge 160:5571c4ff569f 673 bx lr
Anna Bridge 160:5571c4ff569f 674 }
Anna Bridge 160:5571c4ff569f 675 #endif
Anna Bridge 160:5571c4ff569f 676
Anna Bridge 160:5571c4ff569f 677
Anna Bridge 160:5571c4ff569f 678 /**
Anna Bridge 160:5571c4ff569f 679 \brief LDRT Unprivileged (8 bit)
Anna Bridge 160:5571c4ff569f 680 \details Executes a Unprivileged LDRT instruction for 8 bit value.
Anna Bridge 160:5571c4ff569f 681 \param [in] ptr Pointer to data
Anna Bridge 160:5571c4ff569f 682 \return value of type uint8_t at (*ptr)
Anna Bridge 160:5571c4ff569f 683 */
Anna Bridge 160:5571c4ff569f 684 #define __LDRBT(ptr) ((uint8_t ) __ldrt(ptr))
Anna Bridge 160:5571c4ff569f 685
Anna Bridge 160:5571c4ff569f 686
Anna Bridge 160:5571c4ff569f 687 /**
Anna Bridge 160:5571c4ff569f 688 \brief LDRT Unprivileged (16 bit)
Anna Bridge 160:5571c4ff569f 689 \details Executes a Unprivileged LDRT instruction for 16 bit values.
Anna Bridge 160:5571c4ff569f 690 \param [in] ptr Pointer to data
Anna Bridge 160:5571c4ff569f 691 \return value of type uint16_t at (*ptr)
Anna Bridge 160:5571c4ff569f 692 */
Anna Bridge 160:5571c4ff569f 693 #define __LDRHT(ptr) ((uint16_t) __ldrt(ptr))
Anna Bridge 160:5571c4ff569f 694
Anna Bridge 160:5571c4ff569f 695
Anna Bridge 160:5571c4ff569f 696 /**
Anna Bridge 160:5571c4ff569f 697 \brief LDRT Unprivileged (32 bit)
Anna Bridge 160:5571c4ff569f 698 \details Executes a Unprivileged LDRT instruction for 32 bit values.
Anna Bridge 160:5571c4ff569f 699 \param [in] ptr Pointer to data
Anna Bridge 160:5571c4ff569f 700 \return value of type uint32_t at (*ptr)
Anna Bridge 160:5571c4ff569f 701 */
Anna Bridge 160:5571c4ff569f 702 #define __LDRT(ptr) ((uint32_t ) __ldrt(ptr))
Anna Bridge 160:5571c4ff569f 703
Anna Bridge 160:5571c4ff569f 704
Anna Bridge 160:5571c4ff569f 705 /**
Anna Bridge 160:5571c4ff569f 706 \brief STRT Unprivileged (8 bit)
Anna Bridge 160:5571c4ff569f 707 \details Executes a Unprivileged STRT instruction for 8 bit values.
Anna Bridge 160:5571c4ff569f 708 \param [in] value Value to store
Anna Bridge 160:5571c4ff569f 709 \param [in] ptr Pointer to location
Anna Bridge 160:5571c4ff569f 710 */
Anna Bridge 160:5571c4ff569f 711 #define __STRBT(value, ptr) __strt(value, ptr)
Anna Bridge 160:5571c4ff569f 712
Anna Bridge 160:5571c4ff569f 713
Anna Bridge 160:5571c4ff569f 714 /**
Anna Bridge 160:5571c4ff569f 715 \brief STRT Unprivileged (16 bit)
Anna Bridge 160:5571c4ff569f 716 \details Executes a Unprivileged STRT instruction for 16 bit values.
Anna Bridge 160:5571c4ff569f 717 \param [in] value Value to store
Anna Bridge 160:5571c4ff569f 718 \param [in] ptr Pointer to location
Anna Bridge 160:5571c4ff569f 719 */
Anna Bridge 160:5571c4ff569f 720 #define __STRHT(value, ptr) __strt(value, ptr)
Anna Bridge 160:5571c4ff569f 721
Anna Bridge 160:5571c4ff569f 722
Anna Bridge 160:5571c4ff569f 723 /**
Anna Bridge 160:5571c4ff569f 724 \brief STRT Unprivileged (32 bit)
Anna Bridge 160:5571c4ff569f 725 \details Executes a Unprivileged STRT instruction for 32 bit values.
Anna Bridge 160:5571c4ff569f 726 \param [in] value Value to store
Anna Bridge 160:5571c4ff569f 727 \param [in] ptr Pointer to location
Anna Bridge 160:5571c4ff569f 728 */
Anna Bridge 160:5571c4ff569f 729 #define __STRT(value, ptr) __strt(value, ptr)
Anna Bridge 160:5571c4ff569f 730
Anna Bridge 160:5571c4ff569f 731 #else /* ((defined (__ARM_ARCH_7M__ ) && (__ARM_ARCH_7M__ == 1)) || \
Anna Bridge 160:5571c4ff569f 732 (defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) ) */
Anna Bridge 160:5571c4ff569f 733
Anna Bridge 160:5571c4ff569f 734 /**
Anna Bridge 160:5571c4ff569f 735 \brief Signed Saturate
Anna Bridge 160:5571c4ff569f 736 \details Saturates a signed value.
Anna Bridge 160:5571c4ff569f 737 \param [in] value Value to be saturated
Anna Bridge 160:5571c4ff569f 738 \param [in] sat Bit position to saturate to (1..32)
Anna Bridge 160:5571c4ff569f 739 \return Saturated value
Anna Bridge 160:5571c4ff569f 740 */
Anna Bridge 160:5571c4ff569f 741 __attribute__((always_inline)) __STATIC_INLINE int32_t __SSAT(int32_t val, uint32_t sat)
Anna Bridge 160:5571c4ff569f 742 {
Anna Bridge 169:a7c7b631e539 743 if ((sat >= 1U) && (sat <= 32U))
Anna Bridge 169:a7c7b631e539 744 {
Anna Bridge 160:5571c4ff569f 745 const int32_t max = (int32_t)((1U << (sat - 1U)) - 1U);
Anna Bridge 160:5571c4ff569f 746 const int32_t min = -1 - max ;
Anna Bridge 169:a7c7b631e539 747 if (val > max)
Anna Bridge 169:a7c7b631e539 748 {
Anna Bridge 160:5571c4ff569f 749 return max;
Anna Bridge 169:a7c7b631e539 750 }
Anna Bridge 169:a7c7b631e539 751 else if (val < min)
Anna Bridge 169:a7c7b631e539 752 {
Anna Bridge 160:5571c4ff569f 753 return min;
Anna Bridge 160:5571c4ff569f 754 }
Anna Bridge 160:5571c4ff569f 755 }
Anna Bridge 160:5571c4ff569f 756 return val;
Anna Bridge 160:5571c4ff569f 757 }
Anna Bridge 160:5571c4ff569f 758
Anna Bridge 160:5571c4ff569f 759 /**
Anna Bridge 160:5571c4ff569f 760 \brief Unsigned Saturate
Anna Bridge 160:5571c4ff569f 761 \details Saturates an unsigned value.
Anna Bridge 160:5571c4ff569f 762 \param [in] value Value to be saturated
Anna Bridge 160:5571c4ff569f 763 \param [in] sat Bit position to saturate to (0..31)
Anna Bridge 160:5571c4ff569f 764 \return Saturated value
Anna Bridge 160:5571c4ff569f 765 */
Anna Bridge 160:5571c4ff569f 766 __attribute__((always_inline)) __STATIC_INLINE uint32_t __USAT(int32_t val, uint32_t sat)
Anna Bridge 160:5571c4ff569f 767 {
Anna Bridge 169:a7c7b631e539 768 if (sat <= 31U)
Anna Bridge 169:a7c7b631e539 769 {
Anna Bridge 160:5571c4ff569f 770 const uint32_t max = ((1U << sat) - 1U);
Anna Bridge 169:a7c7b631e539 771 if (val > (int32_t)max)
Anna Bridge 169:a7c7b631e539 772 {
Anna Bridge 160:5571c4ff569f 773 return max;
Anna Bridge 169:a7c7b631e539 774 }
Anna Bridge 169:a7c7b631e539 775 else if (val < 0)
Anna Bridge 169:a7c7b631e539 776 {
Anna Bridge 160:5571c4ff569f 777 return 0U;
Anna Bridge 160:5571c4ff569f 778 }
Anna Bridge 160:5571c4ff569f 779 }
Anna Bridge 160:5571c4ff569f 780 return (uint32_t)val;
Anna Bridge 160:5571c4ff569f 781 }
Anna Bridge 160:5571c4ff569f 782
Anna Bridge 160:5571c4ff569f 783 #endif /* ((defined (__ARM_ARCH_7M__ ) && (__ARM_ARCH_7M__ == 1)) || \
Anna Bridge 160:5571c4ff569f 784 (defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) ) */
Anna Bridge 160:5571c4ff569f 785
Anna Bridge 160:5571c4ff569f 786 /*@}*/ /* end of group CMSIS_Core_InstructionInterface */
Anna Bridge 160:5571c4ff569f 787
Anna Bridge 160:5571c4ff569f 788
Anna Bridge 160:5571c4ff569f 789 /* ################### Compiler specific Intrinsics ########################### */
Anna Bridge 160:5571c4ff569f 790 /** \defgroup CMSIS_SIMD_intrinsics CMSIS SIMD Intrinsics
Anna Bridge 160:5571c4ff569f 791 Access to dedicated SIMD instructions
Anna Bridge 160:5571c4ff569f 792 @{
Anna Bridge 160:5571c4ff569f 793 */
Anna Bridge 160:5571c4ff569f 794
Anna Bridge 160:5571c4ff569f 795 #if ((defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) )
Anna Bridge 160:5571c4ff569f 796
Anna Bridge 160:5571c4ff569f 797 #define __SADD8 __sadd8
Anna Bridge 160:5571c4ff569f 798 #define __QADD8 __qadd8
Anna Bridge 160:5571c4ff569f 799 #define __SHADD8 __shadd8
Anna Bridge 160:5571c4ff569f 800 #define __UADD8 __uadd8
Anna Bridge 160:5571c4ff569f 801 #define __UQADD8 __uqadd8
Anna Bridge 160:5571c4ff569f 802 #define __UHADD8 __uhadd8
Anna Bridge 160:5571c4ff569f 803 #define __SSUB8 __ssub8
Anna Bridge 160:5571c4ff569f 804 #define __QSUB8 __qsub8
Anna Bridge 160:5571c4ff569f 805 #define __SHSUB8 __shsub8
Anna Bridge 160:5571c4ff569f 806 #define __USUB8 __usub8
Anna Bridge 160:5571c4ff569f 807 #define __UQSUB8 __uqsub8
Anna Bridge 160:5571c4ff569f 808 #define __UHSUB8 __uhsub8
Anna Bridge 160:5571c4ff569f 809 #define __SADD16 __sadd16
Anna Bridge 160:5571c4ff569f 810 #define __QADD16 __qadd16
Anna Bridge 160:5571c4ff569f 811 #define __SHADD16 __shadd16
Anna Bridge 160:5571c4ff569f 812 #define __UADD16 __uadd16
Anna Bridge 160:5571c4ff569f 813 #define __UQADD16 __uqadd16
Anna Bridge 160:5571c4ff569f 814 #define __UHADD16 __uhadd16
Anna Bridge 160:5571c4ff569f 815 #define __SSUB16 __ssub16
Anna Bridge 160:5571c4ff569f 816 #define __QSUB16 __qsub16
Anna Bridge 160:5571c4ff569f 817 #define __SHSUB16 __shsub16
Anna Bridge 160:5571c4ff569f 818 #define __USUB16 __usub16
Anna Bridge 160:5571c4ff569f 819 #define __UQSUB16 __uqsub16
Anna Bridge 160:5571c4ff569f 820 #define __UHSUB16 __uhsub16
Anna Bridge 160:5571c4ff569f 821 #define __SASX __sasx
Anna Bridge 160:5571c4ff569f 822 #define __QASX __qasx
Anna Bridge 160:5571c4ff569f 823 #define __SHASX __shasx
Anna Bridge 160:5571c4ff569f 824 #define __UASX __uasx
Anna Bridge 160:5571c4ff569f 825 #define __UQASX __uqasx
Anna Bridge 160:5571c4ff569f 826 #define __UHASX __uhasx
Anna Bridge 160:5571c4ff569f 827 #define __SSAX __ssax
Anna Bridge 160:5571c4ff569f 828 #define __QSAX __qsax
Anna Bridge 160:5571c4ff569f 829 #define __SHSAX __shsax
Anna Bridge 160:5571c4ff569f 830 #define __USAX __usax
Anna Bridge 160:5571c4ff569f 831 #define __UQSAX __uqsax
Anna Bridge 160:5571c4ff569f 832 #define __UHSAX __uhsax
Anna Bridge 160:5571c4ff569f 833 #define __USAD8 __usad8
Anna Bridge 160:5571c4ff569f 834 #define __USADA8 __usada8
Anna Bridge 160:5571c4ff569f 835 #define __SSAT16 __ssat16
Anna Bridge 160:5571c4ff569f 836 #define __USAT16 __usat16
Anna Bridge 160:5571c4ff569f 837 #define __UXTB16 __uxtb16
Anna Bridge 160:5571c4ff569f 838 #define __UXTAB16 __uxtab16
Anna Bridge 160:5571c4ff569f 839 #define __SXTB16 __sxtb16
Anna Bridge 160:5571c4ff569f 840 #define __SXTAB16 __sxtab16
Anna Bridge 160:5571c4ff569f 841 #define __SMUAD __smuad
Anna Bridge 160:5571c4ff569f 842 #define __SMUADX __smuadx
Anna Bridge 160:5571c4ff569f 843 #define __SMLAD __smlad
Anna Bridge 160:5571c4ff569f 844 #define __SMLADX __smladx
Anna Bridge 160:5571c4ff569f 845 #define __SMLALD __smlald
Anna Bridge 160:5571c4ff569f 846 #define __SMLALDX __smlaldx
Anna Bridge 160:5571c4ff569f 847 #define __SMUSD __smusd
Anna Bridge 160:5571c4ff569f 848 #define __SMUSDX __smusdx
Anna Bridge 160:5571c4ff569f 849 #define __SMLSD __smlsd
Anna Bridge 160:5571c4ff569f 850 #define __SMLSDX __smlsdx
Anna Bridge 160:5571c4ff569f 851 #define __SMLSLD __smlsld
Anna Bridge 160:5571c4ff569f 852 #define __SMLSLDX __smlsldx
Anna Bridge 160:5571c4ff569f 853 #define __SEL __sel
Anna Bridge 160:5571c4ff569f 854 #define __QADD __qadd
Anna Bridge 160:5571c4ff569f 855 #define __QSUB __qsub
Anna Bridge 160:5571c4ff569f 856
Anna Bridge 160:5571c4ff569f 857 #define __PKHBT(ARG1,ARG2,ARG3) ( ((((uint32_t)(ARG1)) ) & 0x0000FFFFUL) | \
Anna Bridge 160:5571c4ff569f 858 ((((uint32_t)(ARG2)) << (ARG3)) & 0xFFFF0000UL) )
Anna Bridge 160:5571c4ff569f 859
Anna Bridge 160:5571c4ff569f 860 #define __PKHTB(ARG1,ARG2,ARG3) ( ((((uint32_t)(ARG1)) ) & 0xFFFF0000UL) | \
Anna Bridge 160:5571c4ff569f 861 ((((uint32_t)(ARG2)) >> (ARG3)) & 0x0000FFFFUL) )
Anna Bridge 160:5571c4ff569f 862
Anna Bridge 160:5571c4ff569f 863 #define __SMMLA(ARG1,ARG2,ARG3) ( (int32_t)((((int64_t)(ARG1) * (ARG2)) + \
Anna Bridge 160:5571c4ff569f 864 ((int64_t)(ARG3) << 32U) ) >> 32U))
Anna Bridge 160:5571c4ff569f 865
Anna Bridge 160:5571c4ff569f 866 #endif /* ((defined (__ARM_ARCH_7EM__) && (__ARM_ARCH_7EM__ == 1)) ) */
Anna Bridge 160:5571c4ff569f 867 /*@} end of group CMSIS_SIMD_intrinsics */
Anna Bridge 160:5571c4ff569f 868
Anna Bridge 160:5571c4ff569f 869
Anna Bridge 160:5571c4ff569f 870 #endif /* __CMSIS_ARMCC_H */