1 /*
2 ** ###################################################################
3 **     Processors:          MIMX8ML8CVNKZ
4 **                          MIMX8ML8DVNLZ
5 **
6 **     Compilers:           GNU C Compiler
7 **                          IAR ANSI C/C++ Compiler for ARM
8 **                          Keil ARM C/C++ Compiler
9 **
10 **     Reference manual:    IMX8MPRM, Rev.D, 12/2020
11 **     Version:             rev. 5.0, 2021-03-01
12 **     Build:               b211028
13 **
14 **     Abstract:
15 **         Provides a system configuration function and a global variable that
16 **         contains the system frequency. It configures the device and initializes
17 **         the oscillator (PLL) that is part of the microcontroller device.
18 **
19 **     Copyright 2016 Freescale Semiconductor, Inc.
20 **     Copyright 2016-2021 NXP
21 **     All rights reserved.
22 **
23 **     SPDX-License-Identifier: BSD-3-Clause
24 **
25 **     http:                 www.nxp.com
26 **     mail:                 support@nxp.com
27 **
28 **     Revisions:
29 **     - rev. 1.0 (2019-10-11)
30 **         Initial version.
31 **     - rev. 2.0 (2020-02-21)
32 **         Rev.B Header.
33 **     - rev. 3.0 (2020-06-22)
34 **         Rev.C Header.
35 **     - rev. 4.0 (2020-11-16)
36 **         Rev.D Header.
37 **     - rev. 5.0 (2021-03-01)
38 **         Rev.D Header Final.
39 **
40 ** ###################################################################
41 */
42 
43 /*!
44  * @file MIMX8ML8_ca53
45  * @version 5.0
46  * @date 2021-03-01
47  * @brief Device specific configuration file for MIMX8ML8_ca53 (header file)
48  *
49  * Provides a system configuration function and a global variable that contains
50  * the system frequency. It configures the device and initializes the oscillator
51  * (PLL) that is part of the microcontroller device.
52  */
53 
54 #ifndef _SYSTEM_MIMX8ML8_ca53_H_
55 #define _SYSTEM_MIMX8ML8_ca53_H_                 /**< Symbol preventing repeated inclusion */
56 
57 #ifdef __cplusplus
58 extern "C" {
59 #endif
60 
61 #include <stdint.h>
62 
63 /* Define clock source values */
64 #define DEFAULT_SYSTEM_CLOCK   8000000U /* Default System clock value */
65 
66 /**
67  * @brief System clock frequency (core clock)
68  *
69  * The system clock frequency supplied to the SysTick timer and the processor
70  * core clock. This variable can be used by the user application to setup the
71  * SysTick timer or configure other parameters. It may also be used by debugger to
72  * query the frequency of the debug timer or configure the trace clock speed
73  * SystemCoreClock is initialized with a correct predefined value.
74  */
75 extern uint32_t SystemCoreClock;
76 
77 /**
78  * @brief Setup the microcontroller system.
79  *
80  * Typically this function configures the oscillator (PLL) that is part of the
81  * microcontroller device. For systems with variable clock speed it also updates
82  * the variable SystemCoreClock. SystemInit is called from startup_device file.
83  */
84 void SystemInit (void);
85 
86 /**
87  * @brief Updates the SystemCoreClock variable.
88  *
89  * It must be called whenever the core clock is changed during program
90  * execution. SystemCoreClockUpdate() evaluates the clock register settings and calculates
91  * the current core clock.
92  */
93 void SystemCoreClockUpdate (void);
94 
95 /**
96  * @brief SystemInit function hook.
97  *
98  * This weak function allows to call specific initialization code during the
99  * SystemInit() execution.This can be used when an application specific code needs
100  * to be called as close to the reset entry as possible (for example the Multicore
101  * Manager MCMGR_EarlyInit() function call).
102  * NOTE: No global r/w variables can be used in this hook function because the
103  * initialization of these variables happens after this function.
104  */
105 void SystemInitHook (void);
106 
107 #ifdef __cplusplus
108 }
109 #endif
110 
111 #endif  /* _SYSTEM_MIMX8ML8_ca53_H_ */
112