Hardware Interfaces

Referring to the Comportable guideline for peripheral device functionality, the module pwrmgr has the following hardware interfaces defined

  • Primary Clock: clk_i
  • Other Clocks: clk_slow_i, clk_lc_i, clk_esc_i
  • Bus Device Interfaces (TL-UL): tl
  • Bus Host Interfaces (TL-UL): none
  • Peripheral Pins for Chip IO: none

Inter-Module Signals

Port NamePackage::StructTypeActWidthDescription
pwr_astpwrmgr_pkg::pwr_astreq_rspreq1
pwr_rstpwrmgr_pkg::pwr_rstreq_rspreq1
pwr_clkpwrmgr_pkg::pwr_clkreq_rspreq1
pwr_otppwrmgr_pkg::pwr_otpreq_rspreq1
pwr_lcpwrmgr_pkg::pwr_lcreq_rspreq1
pwr_flashpwrmgr_pkg::pwr_flashunircv1
esc_rst_txprim_esc_pkg::esc_txunircv1
esc_rst_rxprim_esc_pkg::esc_rxunireq1
pwr_cpupwrmgr_pkg::pwr_cpuunircv1
wakeupslogicunircv6
rstreqslogicunircv2
ndmreset_reqlogicunircv1
straplogicunireq1
low_powerlogicunireq1
rom_ctrlrom_ctrl_pkg::pwrmgr_dataunircv1
fetch_enlc_ctrl_pkg::lc_txunireq1
lc_dft_enlc_ctrl_pkg::lc_txunircv1
lc_hw_debug_enlc_ctrl_pkg::lc_txunircv1
sw_rst_reqprim_mubi_pkg::mubi4unircv1
tltlul_pkg::tlreq_rsprsp1

Interrupts

Interrupt NameTypeDescription
wakeupEventWake from low power state. See wake info for more details

Security Alerts

Alert NameDescription
fatal_faultThis fatal alert is triggered when a fatal TL-UL bus integrity fault is detected.

Security Countermeasures

Countermeasure IDDescription
PWRMGR.BUS.INTEGRITYEnd-to-end bus integrity scheme.
PWRMGR.LC_CTRL.INTERSIG.MUBIlife cycle control / debug signals are multibit.
PWRMGR.ROM_CTRL.INTERSIG.MUBIrom control done/good signals are multibit.
PWRMGR.RSTMGR.INTERSIG.MUBIreset manager software request is multibit.
PWRMGR.ESC_RX.CLK.BKGN_CHKEscalation receiver has a background timeout check
PWRMGR.ESC_RX.CLK.LOCAL_ESCEscalation receiver clock timeout has a local reset escalation
PWRMGR.FSM.SPARSESparse encoding for slow and fast state machines.
PWRMGR.FSM.TERMINALWhen FSMs reach a bad state, go into a terminate state that does not recover without user or external host intervention.
PWRMGR.CTRL_FLOW.GLOBAL_ESCWhen global escalation is received, proceed directly to reset.
PWRMGR.MAIN_PD.RST.LOCAL_ESCWhen main power domain reset glitches, proceed directly to reset.
PWRMGR.CTRL.CONFIG.REGWENMain control protected by regwen.
PWRMGR.WAKEUP.CONFIG.REGWENWakeup configuration protected by regwen.
PWRMGR.RESET.CONFIG.REGWENReset configuration protected by regwen.

Registers

Summary

NameOffsetLengthDescription
pwrmgr.INTR_STATE0x04Interrupt State Register
pwrmgr.INTR_ENABLE0x44Interrupt Enable Register
pwrmgr.INTR_TEST0x84Interrupt Test Register
pwrmgr.ALERT_TEST0xc4Alert Test Register
pwrmgr.CTRL_CFG_REGWEN0x104Controls the configurability of the !!CONTROL register.
pwrmgr.CONTROL0x144Control register
pwrmgr.CFG_CDC_SYNC0x184The configuration registers CONTROL, WAKEUP_EN, RESET_EN are all written in the
pwrmgr.WAKEUP_EN_REGWEN0x1c4Configuration enable for wakeup_en register
pwrmgr.WAKEUP_EN0x204Bit mask for enabled wakeups
pwrmgr.WAKE_STATUS0x244A read only register of all current wake requests post enable mask
pwrmgr.RESET_EN_REGWEN0x284Configuration enable for reset_en register
pwrmgr.RESET_EN0x2c4Bit mask for enabled reset requests
pwrmgr.RESET_STATUS0x304A read only register of all current reset requests post enable mask
pwrmgr.ESCALATE_RESET_STATUS0x344A read only register of escalation reset request
pwrmgr.WAKE_INFO_CAPTURE_DIS0x384Indicates which functions caused the chip to wakeup
pwrmgr.WAKE_INFO0x3c4Indicates which functions caused the chip to wakeup.
pwrmgr.FAULT_STATUS0x404A read only register that shows the existing faults

INTR_STATE

Interrupt State Register

  • Offset: 0x0
  • Reset default: 0x0
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0rw1c0x0wakeupWake from low power state. See wake info for more details

INTR_ENABLE

Interrupt Enable Register

  • Offset: 0x4
  • Reset default: 0x0
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0rw0x0wakeupEnable interrupt when INTR_STATE.wakeup is set.

INTR_TEST

Interrupt Test Register

  • Offset: 0x8
  • Reset default: 0x0
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0wo0x0wakeupWrite 1 to force INTR_STATE.wakeup to 1.

ALERT_TEST

Alert Test Register

  • Offset: 0xc
  • Reset default: 0x0
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0wo0x0fatal_faultWrite 1 to trigger one alert event of this kind.

CTRL_CFG_REGWEN

Controls the configurability of the CONTROL register.

This register ensures the contents do not change once a low power hint and WFI has occurred.

It unlocks whenever a low power transition has completed (transition back to the ACTIVE state) for any reason.

  • Offset: 0x10
  • Reset default: 0x1
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0ro0x1ENConfiguration enable. This bit defaults to 1 and is set to 0 by hardware when low power entry is initiated. When the device transitions back from low power state to active state, this bit is set back to 1 to allow software configuration of CONTROL

CONTROL

Control register

  • Offset: 0x14
  • Reset default: 0x180
  • Reset mask: 0x1f1
  • Register enable: CTRL_CFG_REGWEN

Fields

BitsTypeResetName
31:9Reserved
8rw0x1MAIN_PD_N
7rw0x1USB_CLK_EN_ACTIVE
6rw0x0USB_CLK_EN_LP
5rw0x0IO_CLK_EN
4rw0x0CORE_CLK_EN
3:1Reserved
0rw0x0LOW_POWER_HINT

CONTROL . MAIN_PD_N

Active low, main power domain power down

ValueNameDescription
0x0Power downMain power domain is powered down during low power state.
0x1Power upMain power domain is kept powered during low power state

CONTROL . USB_CLK_EN_ACTIVE

USB clock enable during active power state

ValueNameDescription
0x0DisabledUSB clock disabled during active power state
0x1EnabledUSB clock enabled during active power state

CONTROL . USB_CLK_EN_LP

USB clock enable during low power state

ValueNameDescription
0x0DisabledUSB clock disabled during low power state
0x1EnabledUSB clock enabled during low power state. However, if !!CONTROL.MAIN_PD_N is 0, USB clock is disabled during low power state.

CONTROL . IO_CLK_EN

IO clock enable during low power state

ValueNameDescription
0x0DisabledIO clock disabled during low power state
0x1EnabledIO clock enabled during low power state

CONTROL . CORE_CLK_EN

core clock enable during low power state

ValueNameDescription
0x0DisabledCore clock disabled during low power state
0x1EnabledCore clock enabled during low power state

CONTROL . LOW_POWER_HINT

The low power hint to power manager. The hint is an indication for how the manager should treat the next WFI. Once the power manager begins a low power transition, or if a valid reset request is registered, this bit is automatically cleared by HW.

ValueNameDescription
0x0NoneNo low power intent
0x1Low PowerNext WFI should trigger low power entry

CFG_CDC_SYNC

The configuration registers CONTROL, WAKEUP_EN, RESET_EN are all written in the fast clock domain but used in the slow clock domain.

The configuration are not propagated across the clock boundary until this register is triggered and read. See fields below for more details

  • Offset: 0x18
  • Reset default: 0x0
  • Reset mask: 0x1

Fields

BitsTypeResetName
31:1Reserved
0rw0x0SYNC

CFG_CDC_SYNC . SYNC

Configuration sync. When this bit is written to 1, a sync pulse is generated. When the sync completes, this bit then self clears.

Software should write this bit to 1, wait for it to clear, before assuming the slow clock domain has accepted the programmed values.

WAKEUP_EN_REGWEN

Configuration enable for wakeup_en register

  • Offset: 0x1c
  • Reset default: 0x1
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0rw0c0x1ENWhen 1, WAKEUP_EN register can be configured. When 0, WAKEUP_EN register cannot be configured.

WAKEUP_EN

Bit mask for enabled wakeups

  • Offset: 0x20
  • Reset default: 0x0
  • Reset mask: 0x3f
  • Register enable: WAKEUP_EN_REGWEN

Fields

BitsTypeResetNameDescription
31:6Reserved
5rw0x0EN_5Whenever a particular bit is set to 1, that wakeup is also enabled. Whenever a particular bit is set to 0, that wakeup cannot wake the device from low power.
4rw0x0EN_4Whenever a particular bit is set to 1, that wakeup is also enabled. Whenever a particular bit is set to 0, that wakeup cannot wake the device from low power.
3rw0x0EN_3Whenever a particular bit is set to 1, that wakeup is also enabled. Whenever a particular bit is set to 0, that wakeup cannot wake the device from low power.
2rw0x0EN_2Whenever a particular bit is set to 1, that wakeup is also enabled. Whenever a particular bit is set to 0, that wakeup cannot wake the device from low power.
1rw0x0EN_1Whenever a particular bit is set to 1, that wakeup is also enabled. Whenever a particular bit is set to 0, that wakeup cannot wake the device from low power.
0rw0x0EN_0Whenever a particular bit is set to 1, that wakeup is also enabled. Whenever a particular bit is set to 0, that wakeup cannot wake the device from low power.

WAKE_STATUS

A read only register of all current wake requests post enable mask

  • Offset: 0x24
  • Reset default: 0x0
  • Reset mask: 0x3f

Fields

BitsTypeResetNameDescription
31:6Reserved
5ro0x0VAL_5Current value of wake requests
4ro0x0VAL_4Current value of wake requests
3ro0x0VAL_3Current value of wake requests
2ro0x0VAL_2Current value of wake requests
1ro0x0VAL_1Current value of wake requests
0ro0x0VAL_0Current value of wake requests

RESET_EN_REGWEN

Configuration enable for reset_en register

  • Offset: 0x28
  • Reset default: 0x1
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0rw0c0x1ENWhen 1, RESET_EN register can be configured. When 0, RESET_EN register cannot be configured.

RESET_EN

Bit mask for enabled reset requests

  • Offset: 0x2c
  • Reset default: 0x0
  • Reset mask: 0x3
  • Register enable: RESET_EN_REGWEN

Fields

BitsTypeResetNameDescription
31:2Reserved
1rw0x0EN_1Whenever a particular bit is set to 1, that reset request is enabled. Whenever a particular bit is set to 0, that reset request cannot reset the device.
0rw0x0EN_0Whenever a particular bit is set to 1, that reset request is enabled. Whenever a particular bit is set to 0, that reset request cannot reset the device.

RESET_STATUS

A read only register of all current reset requests post enable mask

  • Offset: 0x30
  • Reset default: 0x0
  • Reset mask: 0x3

Fields

BitsTypeResetNameDescription
31:2Reserved
1ro0x0VAL_1Current value of reset request
0ro0x0VAL_0Current value of reset request

ESCALATE_RESET_STATUS

A read only register of escalation reset request

  • Offset: 0x34
  • Reset default: 0x0
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0ro0x0VALWhen 1, an escalation reset has been seen. When 0, there is no escalation reset.

WAKE_INFO_CAPTURE_DIS

Indicates which functions caused the chip to wakeup

  • Offset: 0x38
  • Reset default: 0x0
  • Reset mask: 0x1

Fields

BitsTypeResetNameDescription
31:1Reserved
0rw0x0VALWhen written to 1, this actively suppresses the wakeup info capture. When written to 0, wakeup info capture timing is controlled by HW.

WAKE_INFO

Indicates which functions caused the chip to wakeup. The wake info recording begins whenever the device begins a valid low power entry.

This capture is continued until it is explicitly disabled through WAKE_INFO_CAPTURE_DIS. This means it is possible to capture multiple wakeup reasons.

  • Offset: 0x3c
  • Reset default: 0x0
  • Reset mask: 0xff

Fields

BitsTypeResetName
31:8Reserved
7rw1c0x0ABORT
6rw1c0x0FALL_THROUGH
5:0rw1c0x0REASONS

WAKE_INFO . ABORT

The abort wakeup reason indicates that despite setting a WFI and providing a low power hint, an active flash / lifecycle / otp transaction was ongoing when the power controller attempted to initiate low power entry.

The power manager detects this condition, halts low power entry and reports as a wakeup reason

WAKE_INFO . FALL_THROUGH

The fall through wakeup reason indicates that despite setting a WFI and providing a low power hint, an interrupt arrived at just the right time to break the executing core out of WFI.

The power manager detects this condition, halts low power entry and reports as a wakeup reason

WAKE_INFO . REASONS

Various peripheral wake reasons

FAULT_STATUS

A read only register that shows the existing faults

  • Offset: 0x40
  • Reset default: 0x0
  • Reset mask: 0x7

Fields

BitsTypeResetNameDescription
31:3Reserved
2ro0x0MAIN_PD_GLITCHWhen 1, unexpected power glitch was observed on main PD.
1ro0x0ESC_TIMEOUTWhen 1, an escalation clock / reset timeout has occurred.
0ro0x0REG_INTG_ERRWhen 1, an integrity error has occurred.