SYSTEM - System Utils#

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.

sl_hal_system_hfrcodpll_freq_t#

sl_hal_system_hfrcodpll_freq_t

HFRCODPLL frequency bands.

sl_hal_system_hfrcoem23_freq_t#

sl_hal_system_hfrcoem23_freq_t

HFRCOEM23 frequency bands.

sl_hal_system_part_family_t#

sl_hal_system_part_family_t

Family identifiers.

SL_HAL_SYSTEM_DEVINFO_ADC_RESET_VALUES#

const sl_hal_system_devinfo_adc_t SL_HAL_SYSTEM_DEVINFO_ADC_RESET_VALUES

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

DEVINFO temperature reset values.

sl_hal_system_init#

void sl_hal_system_init (void )

Chip initialization routine for revision errata workarounds.

Note

• This function must be called immediately in main().

This initialization function configures the device to a state as similar to later revisions as possible to improve software compatibility with newer parts. See the device-specific errata for details.

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 (uint32_t frequency)

Get a factory calibration value for HFRCOEM23 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_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.

sl_hal_system_is_debugger_connected#

bool sl_hal_system_is_debugger_connected (void )

Check if a debugger is connected (and debug session activated).

Used to make run-time decisions depending on whether or not a debug session has been active since last reset, i.e., using a debug probe or similar. In some cases, special handling is required in that scenario.

Returns

• True if a debug session is active since last reset, otherwise false.

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