SYSTEM - System Utils#
System API.
This module contains functions to read information such as RAM and Flash size, device unique ID, chip revision, family, and part number from DEVINFO and SCB blocks. Functions to configure and read status from FPU are available for compatible devices.
Modules#
Enumerations#
Family security capability.
Family identifiers.
Floating point co-processor access modes.
Functions#
Get a chip major/minor revision.
Get a factory calibration value for a given peripheral register.
Get family security capability.
Get the unique number for this device.
Get the production revision for this part.
Get the SRAM Base Address.
Get the SRAM size (in KB).
Get the flash size (in KB).
Get the flash page size in bytes.
Get the MCU part number.
Get the calibration temperature (in degrees Celsius).
Get the MCU family identifier.
Get DEVINFO revision.
Set floating point co-processor (FPU) access mode.
Enumeration Documentation#
SYSTEM_SecurityCapability_TypeDef#
SYSTEM_SecurityCapability_TypeDef
Family security capability.
Enumerator | |
---|---|
securityCapabilityUnknown | Unknown security capability. |
securityCapabilityNA | Security capability not applicable. |
securityCapabilityBasic | Basic security capability. |
securityCapabilityRoT | Root of Trust security capability. |
securityCapabilitySE | Secure Element security capability. |
securityCapabilityVault | Secure Vault security capability. |
50
of file platform/emlib/inc/em_system_generic.h
SYSTEM_PartFamily_TypeDef#
SYSTEM_PartFamily_TypeDef
Family identifiers.
Enumerator | |
---|---|
systemPartFamilyMighty21 | EFR32 Mighty Gecko Series 2 Config 1 Value Device Family. |
systemPartFamilyFlex21 | EFR32 Flex Gecko Series 2 Config 1 Value Device Family. |
systemPartFamilyBlue21 | EFR32 Blue Gecko Series 2 Config 1 Value Device Family. |
systemPartFamilyMightyRcp21 | EFR32 Mighty RCP Series 2 Config 1 Value Device Family. |
systemPartFamilyUnknown | Unknown Device Family. |
57
of file platform/emlib/inc/em_system.h
SYSTEM_FpuAccess_TypeDef#
SYSTEM_FpuAccess_TypeDef
Floating point co-processor access modes.
Enumerator | |
---|---|
fpuAccessDenied | Access denied, any attempted access generates a NOCP UsageFault. |
fpuAccessPrivilegedOnly | Privileged access only, an unprivileged access generates a NOCP UsageFault. |
fpuAccessReserved | Reserved. |
fpuAccessFull | Full access. |
310
of file platform/emlib/inc/em_system.h
Function Documentation#
SYSTEM_ChipRevisionGet#
void SYSTEM_ChipRevisionGet (SYSTEM_ChipRevision_TypeDef * rev)
Get a chip major/minor revision.
[out] | rev | A location to place the chip revision information. |
69
of file platform/emlib/src/em_system.c
SYSTEM_GetCalibrationValue#
bool SYSTEM_GetCalibrationValue (volatile uint32_t * regAddress)
Get a factory calibration value for a given peripheral register.
[in] | regAddress | The peripheral calibration register address to get a calibration value for. If the calibration value is found, this register is updated with the calibration value. |
Returns
True if a calibration value exists, false otherwise.
120
of file platform/emlib/src/em_system.c
SYSTEM_GetSecurityCapability#
SYSTEM_SecurityCapability_TypeDef SYSTEM_GetSecurityCapability (void )
Get family security capability.
N/A |
Note
This function retrieves the family security capability based on the device number. The device number is one letter and 3 digits: DEVICENUMBER = (alpha-'A')*1000 + numeric. i.e. 0d = "A000"; 1123d = "B123". The security capabilities are represented by SYSTEM_SecurityCapability_TypeDef.
Returns
Security capability of MCU.
162
of file platform/emlib/src/em_system.c
SYSTEM_GetUnique#
uint64_t SYSTEM_GetUnique (void )
Get the unique number for this device.
N/A |
Returns
Unique number for this device.
213
of file platform/emlib/src/em_system.c
SYSTEM_GetProdRev#
uint8_t SYSTEM_GetProdRev (void )
Get the production revision for this part.
N/A |
Returns
Production revision for this part.
233
of file platform/emlib/src/em_system.c
SYSTEM_GetSRAMBaseAddress#
uint32_t SYSTEM_GetSRAMBaseAddress (void )
Get the SRAM Base Address.
N/A |
Note
This function is used to retrieve the base address of the SRAM.
Returns
Base address SRAM (32-bit unsigned integer).
256
of file platform/emlib/src/em_system.c
SYSTEM_GetSRAMSize#
uint16_t SYSTEM_GetSRAMSize (void )
Get the SRAM size (in KB).
N/A |
Note
This function retrieves SRAM size by reading the chip device info structure. If your binary is made for one specific device only, use SRAM_SIZE instead.
Returns
Size of internal SRAM (in KB).
273
of file platform/emlib/src/em_system.c
SYSTEM_GetFlashSize#
uint16_t SYSTEM_GetFlashSize (void )
Get the flash size (in KB).
N/A |
Note
This function retrieves flash size by reading the chip device info structure. If your binary is made for one specific device only, use FLASH_SIZE instead.
Returns
Size of internal flash (in KB).
307
of file platform/emlib/src/em_system.c
SYSTEM_GetFlashPageSize#
uint32_t SYSTEM_GetFlashPageSize (void )
Get the flash page size in bytes.
N/A |
Note
This function retrieves flash page size by reading the chip device info structure. If your binary is made for one specific device only, use FLASH_PAGE_SIZE instead.
Returns
Page size of internal flash in bytes.
332
of file platform/emlib/src/em_system.c
SYSTEM_GetPartNumber#
uint16_t SYSTEM_GetPartNumber (void )
Get the MCU part number.
N/A |
Returns
The part number of MCU.
371
of file platform/emlib/src/em_system.c
SYSTEM_GetCalibrationTemperature#
uint8_t SYSTEM_GetCalibrationTemperature (void )
Get the calibration temperature (in degrees Celsius).
N/A |
Returns
Calibration temperature in Celsius.
391
of file platform/emlib/src/em_system.c
SYSTEM_GetFamily#
SYSTEM_PartFamily_TypeDef SYSTEM_GetFamily (void )
Get the MCU family identifier.
N/A |
Note
This function retrieves family ID by reading the chip's device info structure in flash memory. Users can retrieve family ID directly by reading DEVINFO->PART item and decode with mask and shift #defines defined in <part_family>_devinfo.h (refer to code below for details).
Returns
Family identifier of MCU.
418
of file platform/emlib/src/em_system.c
SYSTEM_GetDevinfoRev#
uint8_t SYSTEM_GetDevinfoRev (void )
Get DEVINFO revision.
N/A |
Returns
Revision of the DEVINFO contents.
333
of file platform/emlib/inc/em_system.h
SYSTEM_FpuAccessModeSet#
void SYSTEM_FpuAccessModeSet (SYSTEM_FpuAccess_TypeDef accessMode)
Set floating point co-processor (FPU) access mode.
[in] | accessMode | Floating point co-processor access mode. See SYSTEM_FpuAccess_TypeDef for details. |
354
of file platform/emlib/inc/em_system.h