EFR32 Blue Gecko 1 Software Documentation  efr32bg1-doc-5.1.2
system_efr32bg1p.c File Reference

Detailed Description

CMSIS Cortex-M3/M4 System Layer for EFR32 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_efr32bg1p.c.

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

Go to the source code of this file.

Macros

#define EFR32_HFRCO_MAX_FREQ   (38000000UL)
 
#define EFR32_HFRCO_STARTUP_FREQ   (19000000UL)
 
#define EFR32_HFXO_FREQ   (38400000UL)
 
#define EFR32_LFRCO_FREQ   (32768UL)
 
#define EFR32_LFXO_FREQ   (EFR32_LFRCO_FREQ)
 
#define EFR32_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...
 
uint32_t SystemHfrcoFreq = EFR32_HFRCO_STARTUP_FREQ
 System HFRCO frequency. More...
 

Macro Definition Documentation

#define EFR32_LFRCO_FREQ   (32768UL)

LFRCO frequency, tuned to below frequency during manufacturing.

Definition at line 41 of file system_efr32bg1p.c.

Referenced by SystemHFClockGet(), and SystemLFRCOClockGet().

#define EFR32_LFXO_FREQ   (EFR32_LFRCO_FREQ)

(DO_NOT_INCLUDE_WITH_DOXYGEN)

Definition at line 78 of file system_efr32bg1p.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 EFR32 proprietary function, not part of the CMSIS definition.
Returns
The current core clock frequency in Hz.

Definition at line 137 of file system_efr32bg1p.c.

References _CMU_HFCOREPRESC_PRESC_MASK, _CMU_HFCOREPRESC_PRESC_SHIFT, CMU, SystemCoreClock, and SystemHFClockGet().

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

uint32_t SystemHFClockGet ( void  )

Get the current HFCLK frequency.

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

Definition at line 181 of file system_efr32bg1p.c.

References _CMU_HFCLKSTATUS_SELECTED_MASK, _CMU_HFPRESC_PRESC_MASK, _CMU_HFPRESC_PRESC_SHIFT, CMU, CMU_HFCLKSTATUS_SELECTED_HFXO, CMU_HFCLKSTATUS_SELECTED_LFRCO, CMU_HFCLKSTATUS_SELECTED_LFXO, EFR32_LFRCO_FREQ, and SystemHfrcoFreq.

Referenced by CMU_ClockDivSet(), CMU_ClockFreqGet(), and SystemCoreClockGet().

uint32_t SystemHFXOClockGet ( void  )

Get high frequency crystal oscillator clock frequency for target system.

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

Definition at line 231 of file system_efr32bg1p.c.

Referenced by CMU_ClockSelectSet(), and CMU_HFXOAutostartEnable().

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 EFR32 proprietary function, not part of the CMSIS definition.
Parameters
[in]freqHFXO frequency in Hz used for target.

Definition at line 257 of file system_efr32bg1p.c.

References _CMU_HFCLKSTATUS_SELECTED_MASK, CMU, CMU_HFCLKSTATUS_SELECTED_HFXO, 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 287 of file system_efr32bg1p.c.

uint32_t SystemLFRCOClockGet ( void  )

Get low frequency RC oscillator clock frequency for target system.

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

Definition at line 307 of file system_efr32bg1p.c.

References EFR32_LFRCO_FREQ.

uint32_t SystemLFXOClockGet ( void  )

Get low frequency crystal oscillator clock frequency for target system.

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

Definition at line 343 of file system_efr32bg1p.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 EFR32 proprietary function, not part of the CMSIS definition.
Parameters
[in]freqLFXO frequency in Hz used for target.

Definition at line 369 of file system_efr32bg1p.c.

References _CMU_HFCLKSTATUS_SELECTED_MASK, CMU, CMU_HFCLKSTATUS_SELECTED_LFXO, and SystemCoreClockGet().

uint32_t SystemMaxCoreClockGet ( void  )

Get the maximum core clock frequency.

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

Definition at line 164 of file system_efr32bg1p.c.

uint32_t SystemULFRCOClockGet ( void  )

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

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

Definition at line 326 of file system_efr32bg1p.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 100 of file system_efr32bg1p.c.

Referenced by SystemCoreClockGet().

uint32_t SystemHfrcoFreq = EFR32_HFRCO_STARTUP_FREQ

System HFRCO frequency.

Note
This is an EFR32 proprietary variable, not part of the CMSIS definition.

Frequency of the system HFRCO oscillator

Definition at line 113 of file system_efr32bg1p.c.

Referenced by CMU_HFRCOBandGet(), CMU_HFRCOBandSet(), and SystemHFClockGet().