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