1 /*
2 ** ###################################################################
3 **     Processors:          MIMXRT1015CAF4A
4 **                          MIMXRT1015DAF5A
5 **
6 **     Compilers:           Freescale C/C++ for Embedded ARM
7 **                          GNU C Compiler
8 **                          IAR ANSI C/C++ Compiler for ARM
9 **                          Keil ARM C/C++ Compiler
10 **                          MCUXpresso Compiler
11 **
12 **     Reference manual:    IMXRT1015RM Rev.1, 02/2021 | IMXRT102XSRM Rev.0
13 **     Version:             rev. 1.3, 2021-08-10
14 **     Build:               b210810
15 **
16 **     Abstract:
17 **         Provides a system configuration function and a global variable that
18 **         contains the system frequency. It configures the device and initializes
19 **         the oscillator (PLL) that is part of the microcontroller device.
20 **
21 **     Copyright 2016 Freescale Semiconductor, Inc.
22 **     Copyright 2016-2021 NXP
23 **     All rights reserved.
24 **
25 **     SPDX-License-Identifier: BSD-3-Clause
26 **
27 **     http:                 www.nxp.com
28 **     mail:                 support@nxp.com
29 **
30 **     Revisions:
31 **     - rev. 0.1 (2018-11-05)
32 **         Initial version.
33 **     - rev. 1.0 (2019-01-18)
34 **         Rev.0 Header GA
35 **     - rev. 1.1 (2019-02-20)
36 **         Update register SRC_SRSR's bitfield LOCKUP_SYSRESETREQ to LOCKUP.
37 **     - rev. 1.2 (2019-04-29)
38 **         Add SET/CLR/TOG register group to register CTRL, STAT, CHANNELCTRL, CH0STAT, CH0OPTS, CH1STAT, CH1OPTS, CH2STAT, CH2OPTS, CH3STAT, CH3OPTS of DCP module.
39 **     - rev. 1.3 (2021-08-10)
40 **         Update header files to align with IMXRT1015RM Rev.1.
41 **
42 ** ###################################################################
43 */
44 
45 /*!
46  * @file MIMXRT1015
47  * @version 1.3
48  * @date 2021-08-10
49  * @brief Device specific configuration file for MIMXRT1015 (header file)
50  *
51  * Provides a system configuration function and a global variable that contains
52  * the system frequency. It configures the device and initializes the oscillator
53  * (PLL) that is part of the microcontroller device.
54  */
55 
56 #ifndef _SYSTEM_MIMXRT1015_H_
57 #define _SYSTEM_MIMXRT1015_H_                    /**< Symbol preventing repeated inclusion */
58 
59 #ifdef __cplusplus
60 extern "C" {
61 #endif
62 
63 #include <stdint.h>
64 
65 
66 #ifndef DISABLE_WDOG
67   #define DISABLE_WDOG                 1
68 #endif
69 
70 /* Define clock source values */
71 
72 #define CPU_XTAL_CLK_HZ                24000000UL          /* Value of the external crystal or oscillator clock frequency in Hz */
73 
74 #define DEFAULT_SYSTEM_CLOCK           297000000UL         /* Default System clock value */
75 
76 
77 /**
78  * @brief System clock frequency (core clock)
79  *
80  * The system clock frequency supplied to the SysTick timer and the processor
81  * core clock. This variable can be used by the user application to setup the
82  * SysTick timer or configure other parameters. It may also be used by debugger to
83  * query the frequency of the debug timer or configure the trace clock speed
84  * SystemCoreClock is initialized with a correct predefined value.
85  */
86 extern uint32_t SystemCoreClock;
87 
88 /**
89  * @brief Setup the microcontroller system.
90  *
91  * Typically this function configures the oscillator (PLL) that is part of the
92  * microcontroller device. For systems with variable clock speed it also updates
93  * the variable SystemCoreClock. SystemInit is called from startup_device file.
94  */
95 void SystemInit (void);
96 
97 /**
98  * @brief Updates the SystemCoreClock variable.
99  *
100  * It must be called whenever the core clock is changed during program
101  * execution. SystemCoreClockUpdate() evaluates the clock register settings and calculates
102  * the current core clock.
103  */
104 void SystemCoreClockUpdate (void);
105 
106 /**
107  * @brief SystemInit function hook.
108  *
109  * This weak function allows to call specific initialization code during the
110  * SystemInit() execution.This can be used when an application specific code needs
111  * to be called as close to the reset entry as possible (for example the Multicore
112  * Manager MCMGR_EarlyInit() function call).
113  * NOTE: No global r/w variables can be used in this hook function because the
114  * initialization of these variables happens after this function.
115  */
116 void SystemInitHook (void);
117 
118 #ifdef __cplusplus
119 }
120 #endif
121 
122 #endif  /* _SYSTEM_MIMXRT1015_H_ */
123