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