mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_KW24D/TOOLCHAIN_ARM_STD/system_MKW24D5.h@171:3a7713b1edbc, 2018-11-08 (annotated)

Committer:
AnnaBridge
Date:
Thu Nov 08 11:45:42 2018 +0000
Revision:
171:3a7713b1edbc
mbed library. Release version 164

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 171:3a7713b1edbc 1 /*
AnnaBridge 171:3a7713b1edbc 2 ** ###################################################################
AnnaBridge 171:3a7713b1edbc 3 ** Processor: MKW24D512VHA5
AnnaBridge 171:3a7713b1edbc 4 ** Compilers: Keil ARM C/C++ Compiler
AnnaBridge 171:3a7713b1edbc 5 ** Freescale C/C++ for Embedded ARM
AnnaBridge 171:3a7713b1edbc 6 ** GNU C Compiler
AnnaBridge 171:3a7713b1edbc 7 ** IAR ANSI C/C++ Compiler for ARM
AnnaBridge 171:3a7713b1edbc 8 **
AnnaBridge 171:3a7713b1edbc 9 ** Reference manual: MKW2xDRM Rev.2 July 2014
AnnaBridge 171:3a7713b1edbc 10 ** Version: rev. 2.0, 2014-11-26
AnnaBridge 171:3a7713b1edbc 11 ** Build: b160512
AnnaBridge 171:3a7713b1edbc 12 **
AnnaBridge 171:3a7713b1edbc 13 ** Abstract:
AnnaBridge 171:3a7713b1edbc 14 ** Provides a system configuration function and a global variable that
AnnaBridge 171:3a7713b1edbc 15 ** contains the system frequency. It configures the device and initializes
AnnaBridge 171:3a7713b1edbc 16 ** the oscillator (PLL) that is part of the microcontroller device.
AnnaBridge 171:3a7713b1edbc 17 **
AnnaBridge 171:3a7713b1edbc 18 ** Copyright (c) 2016 Freescale Semiconductor, Inc.
AnnaBridge 171:3a7713b1edbc 19 ** All rights reserved.
AnnaBridge 171:3a7713b1edbc 20 **
AnnaBridge 171:3a7713b1edbc 21 ** Redistribution and use in source and binary forms, with or without modification,
AnnaBridge 171:3a7713b1edbc 22 ** are permitted provided that the following conditions are met:
AnnaBridge 171:3a7713b1edbc 23 **
AnnaBridge 171:3a7713b1edbc 24 ** o Redistributions of source code must retain the above copyright notice, this list
AnnaBridge 171:3a7713b1edbc 25 ** of conditions and the following disclaimer.
AnnaBridge 171:3a7713b1edbc 26 **
AnnaBridge 171:3a7713b1edbc 27 ** o Redistributions in binary form must reproduce the above copyright notice, this
AnnaBridge 171:3a7713b1edbc 28 ** list of conditions and the following disclaimer in the documentation and/or
AnnaBridge 171:3a7713b1edbc 29 ** other materials provided with the distribution.
AnnaBridge 171:3a7713b1edbc 30 **
AnnaBridge 171:3a7713b1edbc 31 ** o Neither the name of Freescale Semiconductor, Inc. nor the names of its
AnnaBridge 171:3a7713b1edbc 32 ** contributors may be used to endorse or promote products derived from this
AnnaBridge 171:3a7713b1edbc 33 ** software without specific prior written permission.
AnnaBridge 171:3a7713b1edbc 34 **
AnnaBridge 171:3a7713b1edbc 35 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
AnnaBridge 171:3a7713b1edbc 36 ** ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
AnnaBridge 171:3a7713b1edbc 37 ** WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
AnnaBridge 171:3a7713b1edbc 38 ** DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
AnnaBridge 171:3a7713b1edbc 39 ** ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
AnnaBridge 171:3a7713b1edbc 40 ** (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
AnnaBridge 171:3a7713b1edbc 41 ** LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
AnnaBridge 171:3a7713b1edbc 42 ** ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
AnnaBridge 171:3a7713b1edbc 43 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
AnnaBridge 171:3a7713b1edbc 44 ** SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
AnnaBridge 171:3a7713b1edbc 45 **
AnnaBridge 171:3a7713b1edbc 46 ** http: www.freescale.com
AnnaBridge 171:3a7713b1edbc 47 ** mail: support@freescale.com
AnnaBridge 171:3a7713b1edbc 48 **
AnnaBridge 171:3a7713b1edbc 49 ** Revisions:
AnnaBridge 171:3a7713b1edbc 50 ** - rev. 1.0 (2013-11-22)
AnnaBridge 171:3a7713b1edbc 51 ** Initial version.
AnnaBridge 171:3a7713b1edbc 52 ** - rev. 2.0 (2014-11-26)
AnnaBridge 171:3a7713b1edbc 53 ** update of SystemInit() imlementation
AnnaBridge 171:3a7713b1edbc 54 ** Module access macro module_BASES replaced by module_BASE_PTRS.
AnnaBridge 171:3a7713b1edbc 55 ** Register accessor macros added to the memory map.
AnnaBridge 171:3a7713b1edbc 56 ** MCG - bit LOLS in MCG_S register renamed to LOLS0.
AnnaBridge 171:3a7713b1edbc 57 ** DAC0 registers removed.
AnnaBridge 171:3a7713b1edbc 58 **
AnnaBridge 171:3a7713b1edbc 59 ** ###################################################################
AnnaBridge 171:3a7713b1edbc 60 */
AnnaBridge 171:3a7713b1edbc 61
AnnaBridge 171:3a7713b1edbc 62 /*!
AnnaBridge 171:3a7713b1edbc 63 * @file MKW24D5
AnnaBridge 171:3a7713b1edbc 64 * @version 2.0
AnnaBridge 171:3a7713b1edbc 65 * @date 2014-11-26
AnnaBridge 171:3a7713b1edbc 66 * @brief Device specific configuration file for MKW24D5 (header file)
AnnaBridge 171:3a7713b1edbc 67 *
AnnaBridge 171:3a7713b1edbc 68 * Provides a system configuration function and a global variable that contains
AnnaBridge 171:3a7713b1edbc 69 * the system frequency. It configures the device and initializes the oscillator
AnnaBridge 171:3a7713b1edbc 70 * (PLL) that is part of the microcontroller device.
AnnaBridge 171:3a7713b1edbc 71 */
AnnaBridge 171:3a7713b1edbc 72
AnnaBridge 171:3a7713b1edbc 73 #ifndef _SYSTEM_MKW24D5_H_
AnnaBridge 171:3a7713b1edbc 74 #define _SYSTEM_MKW24D5_H_ /**< Symbol preventing repeated inclusion */
AnnaBridge 171:3a7713b1edbc 75
AnnaBridge 171:3a7713b1edbc 76 #ifdef __cplusplus
AnnaBridge 171:3a7713b1edbc 77 extern "C" {
AnnaBridge 171:3a7713b1edbc 78 #endif
AnnaBridge 171:3a7713b1edbc 79
AnnaBridge 171:3a7713b1edbc 80 #include <stdint.h>
AnnaBridge 171:3a7713b1edbc 81
AnnaBridge 171:3a7713b1edbc 82
AnnaBridge 171:3a7713b1edbc 83 #ifndef DISABLE_WDOG
AnnaBridge 171:3a7713b1edbc 84 #define DISABLE_WDOG 1
AnnaBridge 171:3a7713b1edbc 85 #endif
AnnaBridge 171:3a7713b1edbc 86
AnnaBridge 171:3a7713b1edbc 87 /* Define clock source values */
AnnaBridge 171:3a7713b1edbc 88
AnnaBridge 171:3a7713b1edbc 89 #define CPU_XTAL32k_CLK_HZ 32768U /* Value of the external 32k crystal or oscillator clock frequency of the RTC in Hz */
AnnaBridge 171:3a7713b1edbc 90 #define CPU_INT_SLOW_CLK_HZ 32768U /* Value of the slow internal oscillator clock frequency in Hz */
AnnaBridge 171:3a7713b1edbc 91 #define CPU_INT_FAST_CLK_HZ 4000000U /* Value of the fast internal oscillator clock frequency in Hz */
AnnaBridge 171:3a7713b1edbc 92
AnnaBridge 171:3a7713b1edbc 93 /* RTC oscillator setting */
AnnaBridge 171:3a7713b1edbc 94 /* RTC_CR: SC2P=0,SC4P=0,SC8P=0,SC16P=0,CLKO=1,OSCE=1,WPS=0,UM=0,SUP=0,WPE=0,SWR=0 */
AnnaBridge 171:3a7713b1edbc 95 #define SYSTEM_RTC_CR_VALUE 0x0300U /* RTC_CR */
AnnaBridge 171:3a7713b1edbc 96
AnnaBridge 171:3a7713b1edbc 97 /* Low power mode enable */
AnnaBridge 171:3a7713b1edbc 98 /* SMC_PMPROT: AVLP=1,ALLS=1,AVLLS=1 */
AnnaBridge 171:3a7713b1edbc 99 #define SYSTEM_SMC_PMPROT_VALUE 0x2AU /* SMC_PMPROT */
AnnaBridge 171:3a7713b1edbc 100
AnnaBridge 171:3a7713b1edbc 101 #define DEFAULT_SYSTEM_CLOCK 20971520U /* Default System clock value */
AnnaBridge 171:3a7713b1edbc 102 #define CPU_XTAL_CLK_HZ 4000000U /* Value of the clock provided by the wireless modem by default */
AnnaBridge 171:3a7713b1edbc 103
AnnaBridge 171:3a7713b1edbc 104
AnnaBridge 171:3a7713b1edbc 105
AnnaBridge 171:3a7713b1edbc 106 /**
AnnaBridge 171:3a7713b1edbc 107 * @brief Configure the external clock source
AnnaBridge 171:3a7713b1edbc 108 *
AnnaBridge 171:3a7713b1edbc 109 * The wireless modem present in the system can supply clock which can be used
AnnaBridge 171:3a7713b1edbc 110 * as a clock source for the whole system. This function is defined as weak.
AnnaBridge 171:3a7713b1edbc 111 *
AnnaBridge 171:3a7713b1edbc 112 */
AnnaBridge 171:3a7713b1edbc 113 extern uint8_t ExtClk_Setup_HookUp(uint32_t clk_out_value);
AnnaBridge 171:3a7713b1edbc 114 /**
AnnaBridge 171:3a7713b1edbc 115 * @brief System clock frequency (core clock)
AnnaBridge 171:3a7713b1edbc 116 *
AnnaBridge 171:3a7713b1edbc 117 * The system clock frequency supplied to the SysTick timer and the processor
AnnaBridge 171:3a7713b1edbc 118 * core clock. This variable can be used by the user application to setup the
AnnaBridge 171:3a7713b1edbc 119 * SysTick timer or configure other parameters. It may also be used by debugger to
AnnaBridge 171:3a7713b1edbc 120 * query the frequency of the debug timer or configure the trace clock speed
AnnaBridge 171:3a7713b1edbc 121 * SystemCoreClock is initialized with a correct predefined value.
AnnaBridge 171:3a7713b1edbc 122 */
AnnaBridge 171:3a7713b1edbc 123 extern uint32_t SystemCoreClock;
AnnaBridge 171:3a7713b1edbc 124
AnnaBridge 171:3a7713b1edbc 125 /**
AnnaBridge 171:3a7713b1edbc 126 * @brief Setup the microcontroller system.
AnnaBridge 171:3a7713b1edbc 127 *
AnnaBridge 171:3a7713b1edbc 128 * Typically this function configures the oscillator (PLL) that is part of the
AnnaBridge 171:3a7713b1edbc 129 * microcontroller device. For systems with variable clock speed it also updates
AnnaBridge 171:3a7713b1edbc 130 * the variable SystemCoreClock. SystemInit is called from startup_device file.
AnnaBridge 171:3a7713b1edbc 131 */
AnnaBridge 171:3a7713b1edbc 132 void SystemInit (void);
AnnaBridge 171:3a7713b1edbc 133
AnnaBridge 171:3a7713b1edbc 134 /**
AnnaBridge 171:3a7713b1edbc 135 * @brief Updates the SystemCoreClock variable.
AnnaBridge 171:3a7713b1edbc 136 *
AnnaBridge 171:3a7713b1edbc 137 * It must be called whenever the core clock is changed during program
AnnaBridge 171:3a7713b1edbc 138 * execution. SystemCoreClockUpdate() evaluates the clock register settings and calculates
AnnaBridge 171:3a7713b1edbc 139 * the current core clock.
AnnaBridge 171:3a7713b1edbc 140 */
AnnaBridge 171:3a7713b1edbc 141 void SystemCoreClockUpdate (void);
AnnaBridge 171:3a7713b1edbc 142
AnnaBridge 171:3a7713b1edbc 143 #ifdef __cplusplus
AnnaBridge 171:3a7713b1edbc 144 }
AnnaBridge 171:3a7713b1edbc 145 #endif
AnnaBridge 171:3a7713b1edbc 146
AnnaBridge 171:3a7713b1edbc 147 #endif /* _SYSTEM_MKW24D5_H_ */