EMU - Energy management unit#

sl_hal_emu_temperature_average_num_t#

sl_hal_emu_temperature_average_num_t

Number of samples to use for temperature averaging.

sl_hal_emu_reset_mode_t#

sl_hal_emu_reset_mode_t

Peripheral reset control.

sl_hal_emu_reset_source_t#

sl_hal_emu_reset_source_t

Peripheral reset control and reset source control.

sl_hal_emu_ram_power_down#

void sl_hal_emu_ram_power_down (uint32_t start, uint32_t end)

Power down RAM memory blocks.

This function will power down all the RAM blocks that are within a given range. The RAM block layout is different between device families, so this function can be used in a generic way to power down a RAM memory region which is known to be unused.

This function will power down blocks from start to the end of RAM. For xg27, it will shut off blocks which are completely enclosed by the memory range given by [start, end].

This is an example to power down all RAM blocks except the first one. The first RAM block is special in that it cannot be powered down by the hardware. The size of the first RAM block is device-specific. See the reference manual to find the RAM block sizes.

sl_hal_emu_ram_power_down(SRAM_BASE, SRAM_BASE + SRAM_SIZE);

Note

• The specified memory block(s) will stay off until a call to sl_hal_emu_ram_power_up() is done.

sl_hal_emu_ram_power_up#

void sl_hal_emu_ram_power_up (void )

Power up all available RAM memory blocks.

This function will power up all the RAM blocks on a device this means that the RAM blocks are retained in EM2/EM3.

sl_hal_emu_lock#

void sl_hal_emu_lock (void )

Lock EMU registers in order to protect them against unintended modification.

Note

• If locking EMU registers, they must be unlocked prior to using any EMU API functions modifying EMU registers, excluding interrupt control and regulator control if the architecture has a EMU_PWRCTRL register.

sl_hal_emu_unlock#

void sl_hal_emu_unlock (void )

Unlock the EMU so that writing to locked registers again is possible.

sl_hal_emu_enable_interrupts#

void sl_hal_emu_enable_interrupts (uint32_t flags)

Enable one or more EMU interrupts.

Note

• Depending on the use, a pending interrupt may already be set prior to enabling the interrupt. To ignore a pending interrupt, consider using sl_hal_emu_clear_interrupts() prior to enabling the interrupt.

sl_hal_emu_disable_interrupts#

void sl_hal_emu_disable_interrupts (uint32_t flags)

Disable one or more EMU interrupts.

sl_hal_emu_clear_interrupts#

void sl_hal_emu_clear_interrupts (uint32_t flags)

Clear one or more pending EMU interrupts.

sl_hal_emu_get_pending_interrupts#

uint32_t sl_hal_emu_get_pending_interrupts (void )

Get pending EMU interrupt flags.

Returns

• EMU interrupt sources pending. Returns one or more valid interrupt flags for the EMU module (EMU_IF_nnn).

Note

• Event bits are not cleared by the use of this function.

sl_hal_emu_get_enabled_pending_interrupts#

uint32_t sl_hal_emu_get_enabled_pending_interrupts (void )

Get enabled and pending EMU interrupt flags.

Useful for handling more interrupt sources in the same interrupt handler.

Returns

• Pending and enabled EMU interrupt sources Return value is the bitwise AND of

  • the enabled interrupt sources in EMU_IEN and

  • the pending interrupt flags EMU_IF.

Note

• Interrupt flags are not cleared by the use of this function.

sl_hal_emu_set_interrupts#

void sl_hal_emu_set_interrupts (uint32_t flags)

Set one or more pending EMU interrupts.

sl_hal_emu_get_status#

uint32_t sl_hal_emu_get_status (void )

Get EMU STATUS register.

Returns

• STATUS register value.

sl_hal_emu_is_temperature_ready#

bool sl_hal_emu_is_temperature_ready (void )

Temperature measurement ready status.

Returns

• True if temperature measurement is ready.

sl_hal_emu_get_averaged_temperature#

float sl_hal_emu_get_averaged_temperature (void )

Get averaged temperature in degrees Celsius.

Returns

• Averaged temperature.

Note

• An averaged temperature measurement must first be requested by calling sl_hal_emu_get_averaged_temperature() and waiting for the TEMPAVG interrupt flag to go high.

sl_hal_emu_request_averaged_temperature#

void sl_hal_emu_request_averaged_temperature (sl_hal_emu_temperature_average_num_t num_samples)

Request averaged temperature.

sl_hal_emu_get_temperature#

float sl_hal_emu_get_temperature (void )

Get temperature in degrees Celsius.

Returns

• Temperature in degrees Celsius.

sl_hal_emu_clear_reset_cause#

void sl_hal_emu_clear_reset_cause (void )

Clear the reset cause register.

This function clears all the reset cause bits of the RSTCAUSE register. The reset cause bits must be cleared by software before a new reset occurs. Otherwise, reset causes may accumulate. See sl_hal_emu_get_reset_cause().

sl_hal_emu_get_reset_cause#

uint32_t sl_hal_emu_get_reset_cause (void )

Get the cause of the last reset.

To be useful, the reset cause must be cleared by software before a new reset occurs. Otherwise, reset causes may accumulate, See sl_hal_emu_clear_reset_cause(). This function call will return the main cause for reset, which can be a bit mask (several causes) and clear away "noise".

Returns

• A reset cause mask. See the reference manual for a description of the reset cause mask.

sl_hal_emu_set_reset_control#

void sl_hal_emu_set_reset_control (sl_hal_emu_reset_source_t reset, sl_hal_emu_reset_mode_t mode)

Disable/enable reset for various peripherals and signal sources.

sl_hal_emu_efp_disable_interrupts#

void sl_hal_emu_efp_disable_interrupts (uint32_t flags)

Disable one or more EFP interrupts.

sl_hal_emu_efp_enable_interrupts#

void sl_hal_emu_efp_enable_interrupts (uint32_t flags)

Enable one or more EFP interrupts.

sl_hal_emu_efp_get_pending_interrupts#

uint32_t sl_hal_emu_efp_get_pending_interrupts (void )

Get pending EMU EFP interrupt flags.

Note

• Event bits are not cleared by the use of this function.

Returns

• EMU EFP interrupt sources pending.

sl_hal_emu_efp_set_interrupts#

void sl_hal_emu_efp_set_interrupts (uint32_t flags)

Set one or more pending EMU EFP interrupts.

sl_hal_emu_efp_clear_interrupts#

void sl_hal_emu_efp_clear_interrupts (uint32_t flags)

Clear one or more pending EMU EFP interrupts.

sl_hal_emu_efp_get_enabled_pending_interrupts#

uint32_t sl_hal_emu_efp_get_enabled_pending_interrupts (void )

Get enabled and pending EMU EFP interrupt flags.

Useful for handling more interrupt sources in the same interrupt handler.

Note

• Interrupt flags are not cleared by the use of this function.

Returns

• Pending and enabled EMU EFP interrupt sources Return value is the bitwise AND of

  • the enabled interrupt sources in EMU_EFPIEN and

  • the pending interrupt flags EMU_EFPIF.

sl_hal_emu_enable_efp_drive_dvdd#

void sl_hal_emu_enable_efp_drive_dvdd (void )

Enable EFP to drive DVDD voltage.

Set this if EFP's DCDC output is powering DVDD supply. This mode assumes that internal DCDC is not being used.

sl_hal_emu_disable_efp_drive_dvdd#

void sl_hal_emu_disable_efp_drive_dvdd (void )

Disable EFP to drive DVDD voltage.

sl_hal_emu_enable_efp_direct_mode#

void sl_hal_emu_enable_efp_direct_mode (void )

Enable EFP Direct Mode.

sl_hal_emu_disable_efp_direct_mode#

void sl_hal_emu_disable_efp_direct_mode (void )

Disable EFP Direct Mode.

sl_hal_emu_enable_efp_drive_decouple#

void sl_hal_emu_enable_efp_drive_decouple (void )

Set to enable EFP to drive Decouple voltage.

Once set, internal LDO will be disabled, and the EMU will control EFP for voltage-scaling. Note that because this bit disables the internal LDO powering the core, it should not be set until after EFP's DECOUPLE output has been configured and enabled.

sl_hal_emu_disable_efp_drive_decouple#

void sl_hal_emu_disable_efp_drive_decouple (void )

Set to disable EFP to drive Decouple voltage.

sl_hal_emu_dcdc_lock#

void sl_hal_emu_dcdc_lock (void )

Lock DCDC registers in order to protect them against unintended modification.

sl_hal_emu_dcdc_unlock#

void sl_hal_emu_dcdc_unlock (void )

Unlock the DCDC so that writing to locked registers again is possible.

sl_hal_emu_dcdc_sync#

void sl_hal_emu_dcdc_sync (uint32_t mask)

Wait for the DCDC to complete all synchronization of register changes.

sl_hal_emu_dcdc_enable_interrupts#

void sl_hal_emu_dcdc_enable_interrupts (uint32_t flags)

Enable EMU DCDC interrupts.

sl_hal_emu_dcdc_disable_interrupts#

void sl_hal_emu_dcdc_disable_interrupts (uint32_t flags)

Disable EMU DCDC interrupts.