src/common/fsl_common.h

   1 /*
   2  * The Clear BSD License
   3  * Copyright (c) 2015-2016, Freescale Semiconductor, Inc.
   4  * Copyright 2016-2017 NXP
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without modification,
   8  * are permitted (subject to the limitations in the disclaimer below) provided
   9  *  that the following conditions are met:
  10  *
  11  * o Redistributions of source code must retain the above copyright notice, this list
  12  *   of conditions and the following disclaimer.
  13  *
  14  * o Redistributions in binary form must reproduce the above copyright notice, this
  15  *   list of conditions and the following disclaimer in the documentation and/or
  16  *   other materials provided with the distribution.
  17  *
  18  * o Neither the name of the copyright holder nor the names of its
  19  *   contributors may be used to endorse or promote products derived from this
  20  *   software without specific prior written permission.
  21  *
  22  * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY THIS LICENSE.
  23  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  25  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  26  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
  27  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  28  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  29  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
  30  * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  31  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  32  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  33  */
  34
  35 #ifndef _FSL_COMMON_H_
  36 #define _FSL_COMMON_H_
  37
  38 #include <assert.h>
  39 #include <stdbool.h>
  40 #include <stdint.h>
  41 #include <string.h>
  42 #include <stdlib.h>
  43
  44 #if defined(__ICCARM__)
  45 #include <stddef.h>
  46 #endif
  47
  48 #include "fsl_device_registers.h"
  49
  50 /*!
  51  * @addtogroup ksdk_common
  52  * @{
  53  */
  54
  55 /*******************************************************************************
  56  * Definitions
  57  ******************************************************************************/
  58
  59 /*! @brief Construct a status code value from a group and code number. */
  60 #define MAKE_STATUS(group, code) ((((group)*100) + (code)))
  61
  62 /*! @brief Construct the version number for drivers. */
  63 #define MAKE_VERSION(major, minor, bugfix) (((major) << 16) | ((minor) << 8) | (bugfix))
  64
  65 /*! @name Driver version */
  66 /*@{*/
  67 /*! @brief common driver version 2.0.0. */
  68 #define FSL_COMMON_DRIVER_VERSION (MAKE_VERSION(2, 0, 0))
  69 /*@}*/
  70
  71 /* Debug console type definition. */
  72 #define DEBUG_CONSOLE_DEVICE_TYPE_NONE          0U      /*!< No debug console.             */
  73 #define DEBUG_CONSOLE_DEVICE_TYPE_UART          1U      /*!< Debug console base on UART.   */
  74 #define DEBUG_CONSOLE_DEVICE_TYPE_LPUART        2U      /*!< Debug console base on LPUART. */
  75 #define DEBUG_CONSOLE_DEVICE_TYPE_LPSCI         3U      /*!< Debug console base on LPSCI.  */
  76 #define DEBUG_CONSOLE_DEVICE_TYPE_USBCDC        4U      /*!< Debug console base on USBCDC. */
  77 #define DEBUG_CONSOLE_DEVICE_TYPE_FLEXCOMM      5U      /*!< Debug console base on USBCDC. */
  78 #define DEBUG_CONSOLE_DEVICE_TYPE_IUART         6U      /*!< Debug console base on i.MX UART. */
  79 #define DEBUG_CONSOLE_DEVICE_TYPE_VUSART        7U      /*!< Debug console base on LPC_USART. */
  80 #define DEBUG_CONSOLE_DEVICE_TYPE_MINI_USART    8U      /*!< Debug console base on LPC_USART. */
  81 #define DEBUG_CONSOLE_DEVICE_TYPE_SWO           9U      /*!< Debug console base on SWO. */
  82
  83 /*! @brief Status group numbers. */
  84 enum _status_groups
  85 {
  86     kStatusGroup_Generic = 0,                 /*!< Group number for generic status codes. */
  87     kStatusGroup_FLASH = 1,                   /*!< Group number for FLASH status codes. */
  88     kStatusGroup_LPSPI = 4,                   /*!< Group number for LPSPI status codes. */
  89     kStatusGroup_FLEXIO_SPI = 5,              /*!< Group number for FLEXIO SPI status codes. */
  90     kStatusGroup_DSPI = 6,                    /*!< Group number for DSPI status codes. */
  91     kStatusGroup_FLEXIO_UART = 7,             /*!< Group number for FLEXIO UART status codes. */
  92     kStatusGroup_FLEXIO_I2C = 8,              /*!< Group number for FLEXIO I2C status codes. */
  93     kStatusGroup_LPI2C = 9,                   /*!< Group number for LPI2C status codes. */
  94     kStatusGroup_UART = 10,                   /*!< Group number for UART status codes. */
  95     kStatusGroup_I2C = 11,                    /*!< Group number for UART status codes. */
  96     kStatusGroup_LPSCI = 12,                  /*!< Group number for LPSCI status codes. */
  97     kStatusGroup_LPUART = 13,                 /*!< Group number for LPUART status codes. */
  98     kStatusGroup_SPI = 14,                    /*!< Group number for SPI status code.*/
  99     kStatusGroup_XRDC = 15,                   /*!< Group number for XRDC status code.*/
 100     kStatusGroup_SEMA42 = 16,                 /*!< Group number for SEMA42 status code.*/
 101     kStatusGroup_SDHC = 17,                   /*!< Group number for SDHC status code */
 102     kStatusGroup_SDMMC = 18,                  /*!< Group number for SDMMC status code */
 103     kStatusGroup_SAI = 19,                    /*!< Group number for SAI status code */
 104     kStatusGroup_MCG = 20,                    /*!< Group number for MCG status codes. */
 105     kStatusGroup_SCG = 21,                    /*!< Group number for SCG status codes. */
 106     kStatusGroup_SDSPI = 22,                  /*!< Group number for SDSPI status codes. */
 107     kStatusGroup_FLEXIO_I2S = 23,             /*!< Group number for FLEXIO I2S status codes */
 108     kStatusGroup_FLEXIO_MCULCD = 24,          /*!< Group number for FLEXIO LCD status codes */
 109     kStatusGroup_FLASHIAP = 25,               /*!< Group number for FLASHIAP status codes */
 110     kStatusGroup_FLEXCOMM_I2C = 26,           /*!< Group number for FLEXCOMM I2C status codes */
 111     kStatusGroup_I2S = 27,                    /*!< Group number for I2S status codes */
 112     kStatusGroup_IUART = 28,                  /*!< Group number for IUART status codes */
 113     kStatusGroup_CSI = 29,                    /*!< Group number for CSI status codes */
 114     kStatusGroup_MIPI_DSI = 30,               /*!< Group number for MIPI DSI status codes */
 115     kStatusGroup_SDRAMC = 35,                 /*!< Group number for SDRAMC status codes. */
 116     kStatusGroup_POWER = 39,                  /*!< Group number for POWER status codes. */
 117     kStatusGroup_ENET = 40,                   /*!< Group number for ENET status codes. */
 118     kStatusGroup_PHY = 41,                    /*!< Group number for PHY status codes. */
 119     kStatusGroup_TRGMUX = 42,                 /*!< Group number for TRGMUX status codes. */
 120     kStatusGroup_SMARTCARD = 43,              /*!< Group number for SMARTCARD status codes. */
 121     kStatusGroup_LMEM = 44,                   /*!< Group number for LMEM status codes. */
 122     kStatusGroup_QSPI = 45,                   /*!< Group number for QSPI status codes. */
 123     kStatusGroup_DMA = 50,                    /*!< Group number for DMA status codes. */
 124     kStatusGroup_EDMA = 51,                   /*!< Group number for EDMA status codes. */
 125     kStatusGroup_DMAMGR = 52,                 /*!< Group number for DMAMGR status codes. */
 126     kStatusGroup_FLEXCAN = 53,                /*!< Group number for FlexCAN status codes. */
 127     kStatusGroup_LTC = 54,                    /*!< Group number for LTC status codes. */
 128     kStatusGroup_FLEXIO_CAMERA = 55,          /*!< Group number for FLEXIO CAMERA status codes. */
 129     kStatusGroup_LPC_SPI = 56,                /*!< Group number for LPC_SPI status codes. */
 130     kStatusGroup_LPC_USART = 57,              /*!< Group number for LPC_USART status codes. */
 131     kStatusGroup_DMIC = 58,                   /*!< Group number for DMIC status codes. */
 132     kStatusGroup_SDIF = 59,                   /*!< Group number for SDIF status codes.*/
 133     kStatusGroup_SPIFI = 60,                  /*!< Group number for SPIFI status codes. */
 134     kStatusGroup_OTP = 61,                    /*!< Group number for OTP status codes. */
 135     kStatusGroup_MCAN = 62,                   /*!< Group number for MCAN status codes. */
 136     kStatusGroup_CAAM = 63,                   /*!< Group number for CAAM status codes. */
 137     kStatusGroup_ECSPI = 64,                  /*!< Group number for ECSPI status codes. */
 138     kStatusGroup_USDHC = 65,                  /*!< Group number for USDHC status codes.*/
 139     kStatusGroup_LPC_I2C = 66,                /*!< Group number for LPC_I2C status codes.*/
 140     kStatusGroup_DCP = 67,                    /*!< Group number for DCP status codes.*/
 141     kStatusGroup_MSCAN = 68,                  /*!< Group number for MSCAN status codes.*/
 142     kStatusGroup_ESAI = 69,                   /*!< Group number for ESAI status codes. */
 143     kStatusGroup_FLEXSPI = 70,                /*!< Group number for FLEXSPI status codes. */
 144     kStatusGroup_MMDC = 71,                   /*!< Group number for MMDC status codes. */
 145     kStatusGroup_MICFIL = 72,                 /*!< Group number for MIC status codes. */
 146     kStatusGroup_SDMA = 73,                   /*!< Group number for SDMA status codes. */
 147     kStatusGroup_ICS = 74,                    /*!< Group number for ICS status codes. */
 148     kStatusGroup_SPDIF = 75,                  /*!< Group number for SPDIF status codes. */
 149     kStatusGroup_LPC_MINISPI = 76,            /*!< Group number for LPC_MINISPI status codes. */
 150     kStatusGroup_NOTIFIER = 98,               /*!< Group number for NOTIFIER status codes. */
 151     kStatusGroup_DebugConsole = 99,           /*!< Group number for debug console status codes. */
 152     kStatusGroup_SEMC = 100,                   /*!< Group number for SEMC status codes. */
 153     kStatusGroup_ApplicationRangeStart = 101, /*!< Starting number for application groups. */
 154 };
 155
 156 /*! @brief Generic status return codes. */
 157 enum _generic_status
 158 {
 159     kStatus_Success = MAKE_STATUS(kStatusGroup_Generic, 0),
 160     kStatus_Fail = MAKE_STATUS(kStatusGroup_Generic, 1),
 161     kStatus_ReadOnly = MAKE_STATUS(kStatusGroup_Generic, 2),
 162     kStatus_OutOfRange = MAKE_STATUS(kStatusGroup_Generic, 3),
 163     kStatus_InvalidArgument = MAKE_STATUS(kStatusGroup_Generic, 4),
 164     kStatus_Timeout = MAKE_STATUS(kStatusGroup_Generic, 5),
 165     kStatus_NoTransferInProgress = MAKE_STATUS(kStatusGroup_Generic, 6),
 166 };
 167
 168 /*! @brief Type used for all status and error return values. */
 169 typedef int32_t status_t;
 170
 171 /*
 172  * Chip level peripheral reset API, for MCUs that implement peripheral reset control external to a peripheral
 173  */
 174 #if ((defined(FSL_FEATURE_SOC_SYSCON_COUNT) && (FSL_FEATURE_SOC_SYSCON_COUNT > 0)) || \
 175      (defined(FSL_FEATURE_SOC_ASYNC_SYSCON_COUNT) && (FSL_FEATURE_SOC_ASYNC_SYSCON_COUNT > 0)))
 176 #include "fsl_reset.h"
 177 #endif
 178
 179 /*
 180  * Macro guard for whether to use default weak IRQ implementation in drivers
 181  */
 182 #ifndef FSL_DRIVER_TRANSFER_DOUBLE_WEAK_IRQ
 183 #define FSL_DRIVER_TRANSFER_DOUBLE_WEAK_IRQ 1
 184 #endif
 185
 186 /*! @name Min/max macros */
 187 /* @{ */
 188 #if !defined(MIN)
 189 #define MIN(a, b) ((a) < (b) ? (a) : (b))
 190 #endif
 191
 192 #if !defined(MAX)
 193 #define MAX(a, b) ((a) > (b) ? (a) : (b))
 194 #endif
 195 /* @} */
 196
 197 /*! @brief Computes the number of elements in an array. */
 198 #if !defined(ARRAY_SIZE)
 199 #define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
 200 #endif
 201
 202 /*! @name UINT16_MAX/UINT32_MAX value */
 203 /* @{ */
 204 #if !defined(UINT16_MAX)
 205 #define UINT16_MAX ((uint16_t)-1)
 206 #endif
 207
 208 #if !defined(UINT32_MAX)
 209 #define UINT32_MAX ((uint32_t)-1)
 210 #endif
 211 /* @} */
 212
 213 /*! @name Timer utilities */
 214 /* @{ */
 215 /*! Macro to convert a microsecond period to raw count value */
 216 #define USEC_TO_COUNT(us, clockFreqInHz) (uint64_t)((uint64_t)us * clockFreqInHz / 1000000U)
 217 /*! Macro to convert a raw count value to microsecond */
 218 #define COUNT_TO_USEC(count, clockFreqInHz) (uint64_t)((uint64_t)count * 1000000U / clockFreqInHz)
 219
 220 /*! Macro to convert a millisecond period to raw count value */
 221 #define MSEC_TO_COUNT(ms, clockFreqInHz) (uint64_t)((uint64_t)ms * clockFreqInHz / 1000U)
 222 /*! Macro to convert a raw count value to millisecond */
 223 #define COUNT_TO_MSEC(count, clockFreqInHz) (uint64_t)((uint64_t)count * 1000U / clockFreqInHz)
 224 /* @} */
 225
 226 /*! @name Alignment variable definition macros */
 227 /* @{ */
 228 #if (defined(__ICCARM__))
 229 /**
 230  * Workaround to disable MISRA C message suppress warnings for IAR compiler.
 231  * http://supp.iar.com/Support/?note=24725
 232  */
 233 _Pragma("diag_suppress=Pm120")
 234 #define SDK_PRAGMA(x) _Pragma(#x)
 235     _Pragma("diag_error=Pm120")
 236 /*! Macro to define a variable with alignbytes alignment */
 237 #define SDK_ALIGN(var, alignbytes) SDK_PRAGMA(data_alignment = alignbytes) var
 238 /*! Macro to define a variable with L1 d-cache line size alignment */
 239 #if defined(FSL_FEATURE_L1DCACHE_LINESIZE_BYTE)
 240 #define SDK_L1DCACHE_ALIGN(var) SDK_PRAGMA(data_alignment = FSL_FEATURE_L1DCACHE_LINESIZE_BYTE) var
 241 #endif
 242 /*! Macro to define a variable with L2 cache line size alignment */
 243 #if defined(FSL_FEATURE_L2CACHE_LINESIZE_BYTE)
 244 #define SDK_L2CACHE_ALIGN(var) SDK_PRAGMA(data_alignment = FSL_FEATURE_L2CACHE_LINESIZE_BYTE) var
 245 #endif
 246 #elif defined(__ARMCC_VERSION)
 247 /*! Macro to define a variable with alignbytes alignment */
 248 #define SDK_ALIGN(var, alignbytes) __align(alignbytes) var
 249 /*! Macro to define a variable with L1 d-cache line size alignment */
 250 #if defined(FSL_FEATURE_L1DCACHE_LINESIZE_BYTE)
 251 #define SDK_L1DCACHE_ALIGN(var) __align(FSL_FEATURE_L1DCACHE_LINESIZE_BYTE) var
 252 #endif
 253 /*! Macro to define a variable with L2 cache line size alignment */
 254 #if defined(FSL_FEATURE_L2CACHE_LINESIZE_BYTE)
 255 #define SDK_L2CACHE_ALIGN(var) __align(FSL_FEATURE_L2CACHE_LINESIZE_BYTE) var
 256 #endif
 257 #elif defined(__GNUC__)
 258 /*! Macro to define a variable with alignbytes alignment */
 259 #define SDK_ALIGN(var, alignbytes) var __attribute__((aligned(alignbytes)))
 260 /*! Macro to define a variable with L1 d-cache line size alignment */
 261 #if defined(FSL_FEATURE_L1DCACHE_LINESIZE_BYTE)
 262 #define SDK_L1DCACHE_ALIGN(var) var __attribute__((aligned(FSL_FEATURE_L1DCACHE_LINESIZE_BYTE)))
 263 #endif
 264 /*! Macro to define a variable with L2 cache line size alignment */
 265 #if defined(FSL_FEATURE_L2CACHE_LINESIZE_BYTE)
 266 #define SDK_L2CACHE_ALIGN(var) var __attribute__((aligned(FSL_FEATURE_L2CACHE_LINESIZE_BYTE)))
 267 #endif
 268 #else
 269 #error Toolchain not supported
 270 #define SDK_ALIGN(var, alignbytes) var
 271 #if defined(FSL_FEATURE_L1DCACHE_LINESIZE_BYTE)
 272 #define SDK_L1DCACHE_ALIGN(var) var
 273 #endif
 274 #if defined(FSL_FEATURE_L2CACHE_LINESIZE_BYTE)
 275 #define SDK_L2CACHE_ALIGN(var) var
 276 #endif
 277 #endif
 278
 279 /*! Macro to change a value to a given size aligned value */
 280 #define SDK_SIZEALIGN(var, alignbytes) \
 281     ((unsigned int)((var) + ((alignbytes)-1)) & (unsigned int)(~(unsigned int)((alignbytes)-1)))
 282 /* @} */
 283
 284 /*! @name Non-cacheable region definition macros */
 285 /* For initialized non-zero non-cacheable variables, please using "AT_NONCACHEABLE_SECTION_INIT(var) ={xx};" or
 286  * "AT_NONCACHEABLE_SECTION_ALIGN_INIT(var) ={xx};" in your projects to define them, for zero-inited non-cacheable variables,
 287  * please using "AT_NONCACHEABLE_SECTION(var);" or "AT_NONCACHEABLE_SECTION_ALIGN(var);" to define them, these zero-inited variables
 288  * will be initialized to zero in system startup.
 289  */
 290 /* @{ */
 291 #if (defined(__ICCARM__))
 292 #if defined(FSL_FEATURE_L1ICACHE_LINESIZE_BYTE)
 293 #define AT_NONCACHEABLE_SECTION(var) var @"NonCacheable"
 294 #define AT_NONCACHEABLE_SECTION_ALIGN(var, alignbytes) SDK_PRAGMA(data_alignment = alignbytes) var @"NonCacheable"
 295 #define AT_NONCACHEABLE_SECTION_INIT(var) var @"NonCacheable.init"
 296 #define AT_NONCACHEABLE_SECTION_ALIGN_INIT(var, alignbytes) SDK_PRAGMA(data_alignment = alignbytes) var @"NonCacheable.init"
 297 #else
 298 #define AT_NONCACHEABLE_SECTION(var) var
 299 #define AT_NONCACHEABLE_SECTION_ALIGN(var, alignbytes) SDK_PRAGMA(data_alignment = alignbytes) var
 300 #define AT_NONCACHEABLE_SECTION_INIT(var) var
 301 #define AT_NONCACHEABLE_SECTION_ALIGN_INIT(var, alignbytes) SDK_PRAGMA(data_alignment = alignbytes) var
 302 #endif
 303 #elif(defined(__ARMCC_VERSION))
 304 #if defined(FSL_FEATURE_L1ICACHE_LINESIZE_BYTE)
 305 #define AT_NONCACHEABLE_SECTION(var) __attribute__((section("NonCacheable"), zero_init)) var
 306 #define AT_NONCACHEABLE_SECTION_ALIGN(var, alignbytes) \
 307     __attribute__((section("NonCacheable"), zero_init)) __align(alignbytes) var
 308 #define AT_NONCACHEABLE_SECTION_INIT(var) __attribute__((section("NonCacheable.init"))) var
 309 #define AT_NONCACHEABLE_SECTION_ALIGN_INIT(var, alignbytes) \
 310     __attribute__((section("NonCacheable.init"))) __align(alignbytes) var
 311 #else
 312 #define AT_NONCACHEABLE_SECTION(var) var
 313 #define AT_NONCACHEABLE_SECTION_ALIGN(var, alignbytes) __align(alignbytes) var
 314 #define AT_NONCACHEABLE_SECTION_INIT(var) var
 315 #define AT_NONCACHEABLE_SECTION_ALIGN_INIT(var, alignbytes) __align(alignbytes) var
 316 #endif
 317 #elif(defined(__GNUC__))
 318 /* For GCC, when the non-cacheable section is required, please define "__STARTUP_INITIALIZE_NONCACHEDATA"
 319  * in your projects to make sure the non-cacheable section variables will be initialized in system startup.
 320  */
 321 #if defined(FSL_FEATURE_L1ICACHE_LINESIZE_BYTE)
 322 #define AT_NONCACHEABLE_SECTION_INIT(var) __attribute__((section("NonCacheable.init"))) var
 323 #define AT_NONCACHEABLE_SECTION_ALIGN_INIT(var, alignbytes) \
 324     __attribute__((section("NonCacheable.init"))) var __attribute__((aligned(alignbytes)))
 325 #define AT_NONCACHEABLE_SECTION(var) __attribute__((section("NonCacheable,\"aw\",%nobits @"))) var
 326 #define AT_NONCACHEABLE_SECTION_ALIGN(var, alignbytes) \
 327     __attribute__((section("NonCacheable,\"aw\",%nobits @"))) var __attribute__((aligned(alignbytes)))
 328 #else
 329 #define AT_NONCACHEABLE_SECTION(var) var
 330 #define AT_NONCACHEABLE_SECTION_ALIGN(var, alignbytes) var __attribute__((aligned(alignbytes)))
 331 #define AT_NONCACHEABLE_SECTION_INIT(var) var
 332 #define AT_NONCACHEABLE_SECTION_ALIGN_INIT(var, alignbytes) var __attribute__((aligned(alignbytes)))
 333 #endif
 334 #else
 335 #error Toolchain not supported.
 336 #define AT_NONCACHEABLE_SECTION(var) var
 337 #define AT_NONCACHEABLE_SECTION_ALIGN(var, alignbytes) var
 338 #define AT_NONCACHEABLE_SECTION_INIT(var) var
 339 #define AT_NONCACHEABLE_SECTION_ALIGN_INIT(var, alignbytes) var
 340 #endif
 341 /* @} */
 342
 343 /*! @name Time sensitive region */
 344 /* @{ */
 345 #if defined(FSL_SDK_DRIVER_QUICK_ACCESS_ENABLE) && FSL_SDK_DRIVER_QUICK_ACCESS_ENABLE
 346 #if (defined(__ICCARM__))
 347 #define AT_QUICKACCESS_SECTION_CODE(func) func @"CodeQuickAccess"
 348 #define AT_QUICKACCESS_SECTION_DATA(func) func @"DataQuickAccess"
 349 #elif(defined(__ARMCC_VERSION))
 350 #define AT_QUICKACCESS_SECTION_CODE(func) __attribute__((section("CodeQuickAccess"))) func
 351 #define AT_QUICKACCESS_SECTION_DATA(func) __attribute__((section("DataQuickAccess"))) func
 352 #elif(defined(__GNUC__))
 353 #define AT_QUICKACCESS_SECTION_CODE(func) __attribute__((section("CodeQuickAccess"))) func
 354 #define AT_QUICKACCESS_SECTION_DATA(func) __attribute__((section("DataQuickAccess"))) func
 355 #else
 356 #error Toolchain not supported.
 357 #endif /* defined(__ICCARM__) */
 358 #else
 359 #if (defined(__ICCARM__))
 360 #define AT_QUICKACCESS_SECTION_CODE(func) func
 361 #define AT_QUICKACCESS_SECTION_DATA(func) func
 362 #elif(defined(__ARMCC_VERSION))
 363 #define AT_QUICKACCESS_SECTION_CODE(func) func
 364 #define AT_QUICKACCESS_SECTION_DATA(func) func
 365 #elif(defined(__GNUC__))
 366 #define AT_QUICKACCESS_SECTION_CODE(func) func
 367 #define AT_QUICKACCESS_SECTION_DATA(func) func
 368 #else
 369 #error Toolchain not supported.
 370 #endif
 371 #endif /* __FSL_SDK_DRIVER_QUICK_ACCESS_ENABLE */
 372 /* @} */
 373
 374 /*******************************************************************************
 375  * API
 376  ******************************************************************************/
 377
 378 #if defined(__cplusplus)
 379         extern "C"
 380 {
 381 #endif
 382
 383     /*!
 384      * @brief Enable specific interrupt.
 385      *
 386      * Enable LEVEL1 interrupt. For some devices, there might be multiple interrupt
 387      * levels. For example, there are NVIC and intmux. Here the interrupts connected
 388      * to NVIC are the LEVEL1 interrupts, because they are routed to the core directly.
 389      * The interrupts connected to intmux are the LEVEL2 interrupts, they are routed
 390      * to NVIC first then routed to core.
 391      *
 392      * This function only enables the LEVEL1 interrupts. The number of LEVEL1 interrupts
 393      * is indicated by the feature macro FSL_FEATURE_NUMBER_OF_LEVEL1_INT_VECTORS.
 394      *
 395      * @param interrupt The IRQ number.
 396      * @retval kStatus_Success Interrupt enabled successfully
 397      * @retval kStatus_Fail Failed to enable the interrupt
 398      */
 399     static inline status_t EnableIRQ(IRQn_Type interrupt)
 400     {
 401         if (NotAvail_IRQn == interrupt)
 402         {
 403             return kStatus_Fail;
 404         }
 405
 406 #if defined(FSL_FEATURE_NUMBER_OF_LEVEL1_INT_VECTORS) && (FSL_FEATURE_NUMBER_OF_LEVEL1_INT_VECTORS > 0)
 407         if (interrupt >= FSL_FEATURE_NUMBER_OF_LEVEL1_INT_VECTORS)
 408         {
 409             return kStatus_Fail;
 410         }
 411 #endif
 412
 413 #if defined(__GIC_PRIO_BITS)
 414         GIC_EnableIRQ(interrupt);
 415 #else
 416         NVIC_EnableIRQ(interrupt);
 417 #endif
 418         return kStatus_Success;
 419     }
 420
 421     /*!
 422      * @brief Disable specific interrupt.
 423      *
 424      * Disable LEVEL1 interrupt. For some devices, there might be multiple interrupt
 425      * levels. For example, there are NVIC and intmux. Here the interrupts connected
 426      * to NVIC are the LEVEL1 interrupts, because they are routed to the core directly.
 427      * The interrupts connected to intmux are the LEVEL2 interrupts, they are routed
 428      * to NVIC first then routed to core.
 429      *
 430      * This function only disables the LEVEL1 interrupts. The number of LEVEL1 interrupts
 431      * is indicated by the feature macro FSL_FEATURE_NUMBER_OF_LEVEL1_INT_VECTORS.
 432      *
 433      * @param interrupt The IRQ number.
 434      * @retval kStatus_Success Interrupt disabled successfully
 435      * @retval kStatus_Fail Failed to disable the interrupt
 436      */
 437     static inline status_t DisableIRQ(IRQn_Type interrupt)
 438     {
 439         if (NotAvail_IRQn == interrupt)
 440         {
 441             return kStatus_Fail;
 442         }
 443
 444 #if defined(FSL_FEATURE_NUMBER_OF_LEVEL1_INT_VECTORS) && (FSL_FEATURE_NUMBER_OF_LEVEL1_INT_VECTORS > 0)
 445         if (interrupt >= FSL_FEATURE_NUMBER_OF_LEVEL1_INT_VECTORS)
 446         {
 447             return kStatus_Fail;
 448         }
 449 #endif
 450
 451 #if defined(__GIC_PRIO_BITS)
 452         GIC_DisableIRQ(interrupt);
 453 #else
 454     NVIC_DisableIRQ(interrupt);
 455 #endif
 456         return kStatus_Success;
 457     }
 458
 459     /*!
 460      * @brief Disable the global IRQ
 461      *
 462      * Disable the global interrupt and return the current primask register. User is required to provided the primask
 463      * register for the EnableGlobalIRQ().
 464      *
 465      * @return Current primask value.
 466      */
 467     static inline uint32_t DisableGlobalIRQ(void)
 468     {
 469 #if defined(CPSR_I_Msk)
 470         uint32_t cpsr = __get_CPSR() & CPSR_I_Msk;
 471
 472         __disable_irq();
 473
 474         return cpsr;
 475 #else
 476     uint32_t regPrimask = __get_PRIMASK();
 477
 478     __disable_irq();
 479
 480     return regPrimask;
 481 #endif
 482     }
 483
 484     /*!
 485      * @brief Enaable the global IRQ
 486      *
 487      * Set the primask register with the provided primask value but not just enable the primask. The idea is for the
 488      * convinience of integration of RTOS. some RTOS get its own management mechanism of primask. User is required to
 489      * use the EnableGlobalIRQ() and DisableGlobalIRQ() in pair.
 490      *
 491      * @param primask value of primask register to be restored. The primask value is supposed to be provided by the
 492      * DisableGlobalIRQ().
 493      */
 494     static inline void EnableGlobalIRQ(uint32_t primask)
 495     {
 496 #if defined(CPSR_I_Msk)
 497         __set_CPSR((__get_CPSR() & ~CPSR_I_Msk) | primask);
 498 #else
 499     __set_PRIMASK(primask);
 500 #endif
 501     }
 502
 503 #if defined(ENABLE_RAM_VECTOR_TABLE)
 504     /*!
 505      * @brief install IRQ handler
 506      *
 507      * @param irq IRQ number
 508      * @param irqHandler IRQ handler address
 509      * @return The old IRQ handler address
 510      */
 511     uint32_t InstallIRQHandler(IRQn_Type irq, uint32_t irqHandler);
 512 #endif /* ENABLE_RAM_VECTOR_TABLE. */
 513
 514 #if (defined(FSL_FEATURE_SOC_SYSCON_COUNT) && (FSL_FEATURE_SOC_SYSCON_COUNT > 0))
 515     /*!
 516      * @brief Enable specific interrupt for wake-up from deep-sleep mode.
 517      *
 518      * Enable the interrupt for wake-up from deep sleep mode.
 519      * Some interrupts are typically used in sleep mode only and will not occur during
 520      * deep-sleep mode because relevant clocks are stopped. However, it is possible to enable
 521      * those clocks (significantly increasing power consumption in the reduced power mode),
 522      * making these wake-ups possible.
 523      *
 524      * @note This function also enables the interrupt in the NVIC (EnableIRQ() is called internally).
 525      *
 526      * @param interrupt The IRQ number.
 527      */
 528     void EnableDeepSleepIRQ(IRQn_Type interrupt);
 529
 530     /*!
 531      * @brief Disable specific interrupt for wake-up from deep-sleep mode.
 532      *
 533      * Disable the interrupt for wake-up from deep sleep mode.
 534      * Some interrupts are typically used in sleep mode only and will not occur during
 535      * deep-sleep mode because relevant clocks are stopped. However, it is possible to enable
 536      * those clocks (significantly increasing power consumption in the reduced power mode),
 537      * making these wake-ups possible.
 538      *
 539      * @note This function also disables the interrupt in the NVIC (DisableIRQ() is called internally).
 540      *
 541      * @param interrupt The IRQ number.
 542      */
 543     void DisableDeepSleepIRQ(IRQn_Type interrupt);
 544 #endif /* FSL_FEATURE_SOC_SYSCON_COUNT */
 545
 546     /*!
 547      * @brief Allocate memory with given alignment and aligned size.
 548      *
 549      * This is provided to support the dynamically allocated memory
 550      * used in cache-able region.
 551      * @param size The length required to malloc.
 552      * @param alignbytes The alignment size.
 553      * @retval The allocated memory.
 554      */
 555     void *SDK_Malloc(size_t size, size_t alignbytes);
 556
 557     /*!
 558      * @brief Free memory.
 559      *
 560      * @param ptr The memory to be release.
 561      */
 562     void SDK_Free(void *ptr);
 563
 564 #if defined(__cplusplus)
 565 }
 566 #endif
 567
 568 /*! @} */
 569
 570 #endif /* _FSL_COMMON_H_ */