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