mbed official / mbed-dev

mbed library sources. Supersedes mbed-src.

Dependents:   Nucleo_Hello_Encoder BLE_iBeaconScan AM1805_DEMO DISCO-F429ZI_ExportTemplate1 ... more

cmsis/TARGET_CORTEX_M/cmsis_armcc.h@187:0387e8f68319, 2018-09-06 (annotated)

Committer:
AnnaBridge
Date:
Thu Sep 06 13:40:20 2018 +0100
Revision:
187:0387e8f68319
Parent:
186:707f6e361f3e
Child:
188:bcfe06ba3d64
mbed-dev library. Release version 163

Who changed what in which revision?

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