EZR32 Happy Gecko Software Documentation  ezr32hg-doc-5.1.2
system_ezr32hg.c File Reference

Detailed Description

CMSIS Cortex-M0+ System Layer for EZR32HG devices.

Version
5.1.2

License

Copyright 2017 Silicon Laboratories, Inc. http://www.silabs.com

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software.
  2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.

DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Laboratories, Inc. has no obligation to support this Software. Silicon Laboratories, Inc. is providing the Software "AS IS", with no express or implied warranties of any kind, including, but not limited to, any implied warranties of merchantability or fitness for any particular purpose or warranties against infringement of any proprietary rights of a third party.

Silicon Laboratories, Inc. will not be liable for any consequential, incidental, or special damages, or any other relief, or for any claim by any third party, arising from your use of this Software.

Definition in file system_ezr32hg.c.

#include <stdint.h>
#include "em_device.h"

Go to the source code of this file.

Macros

#define EFM32_HFRCO_MAX_FREQ   (21000000UL)
 
#define EFM32_HFXO_FREQ   (24000000UL)
 
#define EFM32_LFRCO_FREQ   (32768UL)
 
#define EFM32_LFXO_FREQ   (EFM32_LFRCO_FREQ)
 
#define EFM32_ULFRCO_FREQ   (1000UL)
 

Functions

uint32_t SystemCoreClockGet (void)
 Get the current core clock frequency. More...
 
uint32_t SystemHFClockGet (void)
 Get the current HFCLK frequency. More...
 
uint32_t SystemHFXOClockGet (void)
 Get high frequency crystal oscillator clock frequency for target system. More...
 
void SystemHFXOClockSet (uint32_t freq)
 Set high frequency crystal oscillator clock frequency for target system. More...
 
void SystemInit (void)
 Initialize the system. More...
 
uint32_t SystemLFRCOClockGet (void)
 Get low frequency RC oscillator clock frequency for target system. More...
 
uint32_t SystemLFXOClockGet (void)
 Get low frequency crystal oscillator clock frequency for target system. More...
 
void SystemLFXOClockSet (uint32_t freq)
 Set low frequency crystal oscillator clock frequency for target system. More...
 
uint32_t SystemMaxCoreClockGet (void)
 Get the maximum core clock frequency. More...
 
uint32_t SystemULFRCOClockGet (void)
 Get ultra low frequency RC oscillator clock frequency for target system. More...
 

Variables

uint32_t SystemCoreClock
 System System Clock Frequency (Core Clock). More...
 

Macro Definition Documentation

#define EFM32_LFRCO_FREQ   (32768UL)

LFRCO frequency, tuned to below frequency during manufacturing.

Definition at line 41 of file system_ezr32hg.c.

Referenced by SystemHFClockGet(), and SystemLFRCOClockGet().

#define EFM32_LFXO_FREQ   (EFM32_LFRCO_FREQ)

(DO_NOT_INCLUDE_WITH_DOXYGEN)

Definition at line 71 of file system_ezr32hg.c.

Function Documentation

uint32_t SystemCoreClockGet ( void  )

Get the current core clock frequency.

Calculate and get the current core clock frequency based on the current configuration. Assuming that the SystemCoreClock global variable is maintained, the core clock frequency is stored in that variable as well. This function will however calculate the core clock based on actual HW configuration. It will also update the SystemCoreClock global variable.

Note
This is an EZR32 proprietary function, not part of the CMSIS definition.
Returns
The current core clock frequency in Hz.

Definition at line 116 of file system_ezr32hg.c.

References _CMU_HFCORECLKDIV_HFCORECLKDIV_MASK, _CMU_HFCORECLKDIV_HFCORECLKDIV_SHIFT, CMU, SystemCoreClock, and SystemHFClockGet().

Referenced by CMU_ClockDivSet(), CMU_ClockFreqGet(), CMU_ClockSelectSet(), CMU_HFRCOBandSet(), MSC_Init(), SystemCoreClockUpdate(), SystemHFXOClockSet(), SystemLFXOClockSet(), TFT_AddressMappedInit(), and TFT_DirectInit().

uint32_t SystemHFClockGet ( void  )
uint32_t SystemHFXOClockGet ( void  )

Get high frequency crystal oscillator clock frequency for target system.

Note
This is an EZR32 proprietary function, not part of the CMSIS definition.
Returns
HFXO frequency in Hz.

Definition at line 244 of file system_ezr32hg.c.

Referenced by CMU_ClockSelectSet().

void SystemHFXOClockSet ( uint32_t  freq)

Set high frequency crystal oscillator clock frequency for target system.

Note
This function is mainly provided for being able to handle target systems with different HF crystal oscillator frequencies run-time. If used, it should probably only be used once during system startup.
This is an EZR32 proprietary function, not part of the CMSIS definition.
Parameters
[in]freqHFXO frequency in Hz used for target.

Definition at line 270 of file system_ezr32hg.c.

References CMU, CMU_STATUS_HFXOSEL, and SystemCoreClockGet().

void SystemInit ( void  )

Initialize the system.

Do required generic HW system init.

Note
This function is invoked during system init, before the main() routine and any data has been initialized. For this reason, it cannot do any initialization of variables etc.

Definition at line 300 of file system_ezr32hg.c.

uint32_t SystemLFRCOClockGet ( void  )

Get low frequency RC oscillator clock frequency for target system.

Note
This is an EZR32 proprietary function, not part of the CMSIS definition.
Returns
LFRCO frequency in Hz.

Definition at line 315 of file system_ezr32hg.c.

References EFM32_LFRCO_FREQ.

uint32_t SystemLFXOClockGet ( void  )

Get low frequency crystal oscillator clock frequency for target system.

Note
This is an EZR32 proprietary function, not part of the CMSIS definition.
Returns
LFXO frequency in Hz.

Definition at line 351 of file system_ezr32hg.c.

Referenced by UARTDRV_InitLeuart().

void SystemLFXOClockSet ( uint32_t  freq)

Set low frequency crystal oscillator clock frequency for target system.

Note
This function is mainly provided for being able to handle target systems with different HF crystal oscillator frequencies run-time. If used, it should probably only be used once during system startup.
This is an EZR32 proprietary function, not part of the CMSIS definition.
Parameters
[in]freqLFXO frequency in Hz used for target.

Definition at line 377 of file system_ezr32hg.c.

References CMU, CMU_STATUS_LFXOSEL, and SystemCoreClockGet().

uint32_t SystemMaxCoreClockGet ( void  )

Get the maximum core clock frequency.

Note
This is an EZR32 proprietary function, not part of the CMSIS definition.
Returns
The maximum core clock frequency in Hz.

Definition at line 141 of file system_ezr32hg.c.

uint32_t SystemULFRCOClockGet ( void  )

Get ultra low frequency RC oscillator clock frequency for target system.

Note
This is an EZR32 proprietary function, not part of the CMSIS definition.
Returns
ULFRCO frequency in Hz.

Definition at line 334 of file system_ezr32hg.c.

Variable Documentation

uint32_t SystemCoreClock

System System Clock Frequency (Core Clock).

(DO_NOT_INCLUDE_WITH_DOXYGEN)

Required CMSIS global variable that must be kept up-to-date.

Definition at line 93 of file system_ezr32hg.c.

Referenced by SystemCoreClockGet().