SYSTEM - System Utils#

sl_hal_system_part_family_t#

sl_hal_system_part_family_t

Family identifiers.

SYSTEM_SecurityCapability_TypeDef#

SYSTEM_SecurityCapability_TypeDef

Family security capability.

sl_hal_system_security_capability_t#

sl_hal_system_security_capability_t

Family security capability.

sl_hal_system_fpu_access_t#

sl_hal_system_fpu_access_t

Floating point co-processor access modes.

SYSTEM_PartFamily_TypeDef#

SYSTEM_PartFamily_TypeDef

Family identifiers.

SYSTEM_FpuAccess_TypeDef#

SYSTEM_FpuAccess_TypeDef

Floating point co-processor access modes.

SL_HAL_SYSTEM_DEVINFO_ADC_RESET_VALUES#

const sl_hal_system_devinfo_adc_t SL_HAL_SYSTEM_DEVINFO_ADC_RESET_VALUES

SL_HAL_SYSTEM_DEVINFO_TEMPERATURE_RESET_VALUES#

const sl_hal_system_devinfo_temperature_t SL_HAL_SYSTEM_DEVINFO_TEMPERATURE_RESET_VALUES

SL_HAL_SYSTEM_DEVINFO_ADC_RESET_VALUES#

const sl_hal_system_devinfo_adc_t SL_HAL_SYSTEM_DEVINFO_ADC_RESET_VALUES

SL_HAL_SYSTEM_DEVINFO_TEMPERATURE_RESET_VALUES#

const sl_hal_system_devinfo_temperature_t SL_HAL_SYSTEM_DEVINFO_TEMPERATURE_RESET_VALUES

sl_hal_system_get_family#

sl_hal_system_part_family_t sl_hal_system_get_family (void )

Get the MCU family identifier.

Returns

• Family identifier of MCU.

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).

SYSTEM_GetCalibrationValue#

bool SYSTEM_GetCalibrationValue (volatile uint32_t * regAddress)

Get a factory calibration value for a given peripheral register.

Returns

• True if a calibration value exists, false otherwise.

SYSTEM_GetSecurityCapability#

SYSTEM_SecurityCapability_TypeDef SYSTEM_GetSecurityCapability (void )

Get family security capability.

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.

SYSTEM_GetUnique#

uint64_t SYSTEM_GetUnique (void )

Get the unique number for this device.

Returns

• Unique number for this device.

SYSTEM_GetProdRev#

uint8_t SYSTEM_GetProdRev (void )

Get the production revision for this part.

Returns

• Production revision for this part.

SYSTEM_GetSRAMBaseAddress#

uint32_t SYSTEM_GetSRAMBaseAddress (void )

Get the SRAM Base Address.

Note

• This function is used to retrieve the base address of the SRAM.

Returns

• Base address SRAM (32-bit unsigned integer).

SYSTEM_GetSRAMSize#

uint16_t SYSTEM_GetSRAMSize (void )

Get the SRAM size (in KB).

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).

SYSTEM_GetFlashSize#

uint16_t SYSTEM_GetFlashSize (void )

Get the flash size (in KB).

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).

SYSTEM_GetFlashPageSize#

uint32_t SYSTEM_GetFlashPageSize (void )

Get the flash page size in bytes.

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.

SYSTEM_GetPartNumber#

uint16_t SYSTEM_GetPartNumber (void )

Get the MCU part number.

Returns

• The part number of MCU.

SYSTEM_GetCalibrationTemperature#

uint8_t SYSTEM_GetCalibrationTemperature (void )

Get the calibration temperature (in degrees Celsius).

Returns

• Calibration temperature in Celsius.

SYSTEM_ChipRevisionGet#

void SYSTEM_ChipRevisionGet (SYSTEM_ChipRevision_TypeDef * rev)

Get a chip major/minor revision.

SYSTEM_GetFamily#

SYSTEM_PartFamily_TypeDef SYSTEM_GetFamily (void )

Get the MCU family identifier.

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.

sl_hal_system_get_chip_revision#

void sl_hal_system_get_chip_revision (sl_hal_system_chip_revision_t * rev)

sl_hal_system_get_devinfo_rev#

uint8_t sl_hal_system_get_devinfo_rev (void )

Get DEVINFO revision.

Returns

• Revision of the DEVINFO contents.

sl_hal_system_get_hfrco_default_calibration#

uint32_t sl_hal_system_get_hfrco_default_calibration (void )

Get the default factory calibration value for HFRCO oscillator.

Returns

• HFRCOCAL default value.

sl_hal_system_get_hfrco_speed_calibration#

uint32_t sl_hal_system_get_hfrco_speed_calibration (void )

Get the speed factory calibration value for HFRCO oscillator.

Returns

• HFRCOCAL speed value.

sl_hal_system_get_hfrcodpll_band_calibration#

uint32_t sl_hal_system_get_hfrcodpll_band_calibration (uint32_t frequency)

Get the HFRCO calibration based on the frequency band.

Returns

• HFRCOCAL value for the given band.

Note

• Those calibrations are only valid for the HFRCO oscillator when used with the DPLL module.

sl_hal_system_get_hfrcoem23_calibration#

uint32_t sl_hal_system_get_hfrcoem23_calibration (void )

Get a factory calibration value for HFRCOCEM23 oscillator.

Returns

• HFRCOEM23 calibration value.

sl_hal_system_get_hfxocal#

uint32_t sl_hal_system_get_hfxocal (void )

Get a factory calibration value for HFXOCAL.

Returns

• HFXOCAL value.

sl_hal_system_get_security_capability#

sl_hal_system_security_capability_t sl_hal_system_get_security_capability (void )

Get family security capability.

Note

• This function retrieves the family security capability based on the device number.

Returns

• Security capability of MCU.

sl_hal_system_get_unique#

uint64_t sl_hal_system_get_unique (void )

Get the unique number for this device.

Returns

• Unique number for this device.

sl_hal_system_get_prod_rev#

uint8_t sl_hal_system_get_prod_rev (void )

Get the production revision for this part.

Returns

• Production revision for this part.

sl_hal_system_get_sram_base_address#

uint32_t sl_hal_system_get_sram_base_address (void )

Get the SRAM Base Address.

Returns

• Base address SRAM (32-bit unsigned integer).

sl_hal_system_get_sram_size#

uint16_t sl_hal_system_get_sram_size (void )

Get the SRAM size (in KB).

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).

sl_hal_system_get_flash_size#

uint16_t sl_hal_system_get_flash_size (void )

Get the flash size (in KB).

Note

• This function retrieves flash size by reading the chip device info structure or DEVINFO->EMBMSIZE (embedded flash. not the case for S3 for now) or user config (external flash).

Returns

• Size of flash (in KB).

sl_hal_system_get_flash_page_size#

uint32_t sl_hal_system_get_flash_page_size (void )

Get the flash page size in bytes.

Note

• This function retrieves flash page size by reading the SE or user config (external flash)

Returns

• Page size of flash in bytes.

sl_hal_system_get_part_number#

uint16_t sl_hal_system_get_part_number (void )

Get the MCU part number.

Returns

• The part number of MCU.

sl_hal_system_get_part_features#

sl_hal_system_features_t sl_hal_system_get_part_features (void )

Get the SoC or MCU features.

Returns

• The features of the current SoC or MCU.

Note

• The features can be decoded by referring to the SoC or MCU datasheet.

sl_hal_system_get_temperature_info#

void sl_hal_system_get_temperature_info (sl_hal_system_devinfo_temperature_t * info)

Get the temperature information.

sl_hal_syscfg_read_chip_rev#

uint32_t sl_hal_syscfg_read_chip_rev (void )

sl_hal_syscfg_set_systicextclken_cfgsystic#

void sl_hal_syscfg_set_systicextclken_cfgsystic (void )

sl_hal_syscfg_clear_systicextclken_cfgsystic#

void sl_hal_syscfg_clear_systicextclken_cfgsystic (void )

sl_hal_system_fpu_set_access_mode#

void sl_hal_system_fpu_set_access_mode (sl_hal_system_fpu_access_t access_mode)

Set floating point co-processor (FPU) access mode.

sl_hal_system_get_adc_calibration_info#

void sl_hal_system_get_adc_calibration_info (sl_hal_system_devinfo_adc_t * info)

Get the ADC calibration info.

SYSTEM_GetDevinfoRev#

uint8_t SYSTEM_GetDevinfoRev (void )

Get DEVINFO revision.

Returns

• Revision of the DEVINFO contents.

SYSTEM_FpuAccessModeSet#

void SYSTEM_FpuAccessModeSet (SYSTEM_FpuAccess_TypeDef accessMode)

Set floating point co-processor (FPU) access mode.

HFRCO_DPLL_FREQUENCY_TABLE_SIZE#

#define HFRCO_DPLL_FREQUENCY_TABLE_SIZE

11

DEVINFO_TEMPERATURE_CALTEMP_INTEGER_SHIFT#

#define DEVINFO_TEMPERATURE_CALTEMP_INTEGER_SHIFT

4