1 /*
2 ** ###################################################################
3 **     Processors:          LPC5536JBD100
4 **                          LPC5536JBD64
5 **                          LPC5536JHI48
6 **
7 **     Compilers:           GNU C Compiler
8 **                          IAR ANSI C/C++ Compiler for ARM
9 **                          Keil ARM C/C++ Compiler
10 **                          MCUXpresso Compiler
11 **
12 **     Reference manual:    LPC55S3x Reference Manual Rev. DraftG, 07/2021
13 **     Version:             rev. 1.1, 2021-08-04
14 **     Build:               b210806
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. 1.0 (2021-04-12)
32 **         Initial version based on RM DraftF
33 **     - rev. 1.1 (2021-08-04)
34 **         Initial version based on RM DraftG
35 **
36 ** ###################################################################
37 */
38 
39 /*!
40  * @file LPC5536
41  * @version 1.1
42  * @date 2021-08-04
43  * @brief Device specific configuration file for LPC5536 (header file)
44  *
45  * Provides a system configuration function and a global variable that contains
46  * the system frequency. It configures the device and initializes the oscillator
47  * (PLL) that is part of the microcontroller device.
48  */
49 
50 #ifndef _SYSTEM_LPC5536_H_
51 #define _SYSTEM_LPC5536_H_                       /**< Symbol preventing repeated inclusion */
52 
53 #ifdef __cplusplus
54 extern "C" {
55 #endif
56 
57 #include <stdint.h>
58 
59 #define DEFAULT_SYSTEM_CLOCK           12000000u           /* Default System clock value */
60 #define CLK_RTC_32K_CLK                   32768u           /* RTC oscillator 32 kHz output (32k_clk */
61 #define CLK_FRO_12MHZ                  12000000u           /* FRO 12 MHz (fro_12m) */
62 #define CLK_FRO_48MHZ                  48000000u           /* FRO 48 MHz (fro_48m) */
63 #define CLK_FRO_96MHZ                  96000000u           /* FRO 96 MHz (fro_96m) */
64 #define CLK_CLK_IN                     16000000u           /* Default CLK_IN pin clock */
65 
66 
67 /**
68  * @brief System clock frequency (core clock)
69  *
70  * The system clock frequency supplied to the SysTick timer and the processor
71  * core clock. This variable can be used by the user application to setup the
72  * SysTick timer or configure other parameters. It may also be used by debugger to
73  * query the frequency of the debug timer or configure the trace clock speed
74  * SystemCoreClock is initialized with a correct predefined value.
75  */
76 extern uint32_t SystemCoreClock;
77 
78 /**
79  * @brief Setup the microcontroller system.
80  *
81  * Typically this function configures the oscillator (PLL) that is part of the
82  * microcontroller device. For systems with variable clock speed it also updates
83  * the variable SystemCoreClock. SystemInit is called from startup_device file.
84  */
85 void SystemInit (void);
86 
87 /**
88  * @brief Updates the SystemCoreClock variable.
89  *
90  * It must be called whenever the core clock is changed during program
91  * execution. SystemCoreClockUpdate() evaluates the clock register settings and calculates
92  * the current core clock.
93  */
94 void SystemCoreClockUpdate (void);
95 
96 /**
97  * @brief SystemInit function hook.
98  *
99  * This weak function allows to call specific initialization code during the
100  * SystemInit() execution.This can be used when an application specific code needs
101  * to be called as close to the reset entry as possible (for example the Multicore
102  * Manager MCMGR_EarlyInit() function call).
103  * NOTE: No global r/w variables can be used in this hook function because the
104  * initialization of these variables happens after this function.
105  */
106 void SystemInitHook (void);
107 
108 #ifdef __cplusplus
109 }
110 #endif
111 
112 #endif  /* _SYSTEM_LPC5536_H_ */
113