Skip to content

Latest commit

 

History

History
709 lines (573 loc) · 45.5 KB

registers.md

File metadata and controls

709 lines (573 loc) · 45.5 KB
Raw

Registers

Summary

Name Offset Length Description
sysrst_ctrl.INTR_STATE 0x0 4 Interrupt State Register
sysrst_ctrl.INTR_ENABLE 0x4 4 Interrupt Enable Register
sysrst_ctrl.INTR_TEST 0x8 4 Interrupt Test Register
sysrst_ctrl.ALERT_TEST 0xc 4 Alert Test Register
sysrst_ctrl.REGWEN 0x10 4 Configuration write enable control register
sysrst_ctrl.EC_RST_CTL 0x14 4 EC reset control register
sysrst_ctrl.ULP_AC_DEBOUNCE_CTL 0x18 4 Ultra low power AC debounce control register
sysrst_ctrl.ULP_LID_DEBOUNCE_CTL 0x1c 4 Ultra low power lid debounce control register
sysrst_ctrl.ULP_PWRB_DEBOUNCE_CTL 0x20 4 Ultra low power pwrb debounce control register
sysrst_ctrl.ULP_CTL 0x24 4 Ultra low power control register
sysrst_ctrl.ULP_STATUS 0x28 4 Ultra low power status
sysrst_ctrl.WKUP_STATUS 0x2c 4 wakeup status
sysrst_ctrl.KEY_INVERT_CTL 0x30 4 configure key input output invert property
sysrst_ctrl.PIN_ALLOWED_CTL 0x34 4 This register determines which override values are allowed for a given output.
sysrst_ctrl.PIN_OUT_CTL 0x38 4 Enables the override function for a specific pin.
sysrst_ctrl.PIN_OUT_VALUE 0x3c 4 Sets the pin override value. Note that only the values
sysrst_ctrl.PIN_IN_VALUE 0x40 4 For SW to read the sysrst_ctrl inputs like GPIO
sysrst_ctrl.KEY_INTR_CTL 0x44 4 Define the keys or inputs that can trigger the interrupt
sysrst_ctrl.KEY_INTR_DEBOUNCE_CTL 0x48 4 Debounce timer control register for key-triggered interrupt
sysrst_ctrl.AUTO_BLOCK_DEBOUNCE_CTL 0x4c 4 Debounce timer control register for pwrb_in H2L transition
sysrst_ctrl.AUTO_BLOCK_OUT_CTL 0x50 4 configure the key outputs to auto-override and their value
sysrst_ctrl.COM_PRE_SEL_CTL_0 0x54 4 To define the keys that define the pre-condition of the combo
sysrst_ctrl.COM_PRE_SEL_CTL_1 0x58 4 To define the keys that define the pre-condition of the combo
sysrst_ctrl.COM_PRE_SEL_CTL_2 0x5c 4 To define the keys that define the pre-condition of the combo
sysrst_ctrl.COM_PRE_SEL_CTL_3 0x60 4 To define the keys that define the pre-condition of the combo
sysrst_ctrl.COM_PRE_DET_CTL_0 0x64 4 To define the duration that the combo pre-condition should be pressed
sysrst_ctrl.COM_PRE_DET_CTL_1 0x68 4 To define the duration that the combo pre-condition should be pressed
sysrst_ctrl.COM_PRE_DET_CTL_2 0x6c 4 To define the duration that the combo pre-condition should be pressed
sysrst_ctrl.COM_PRE_DET_CTL_3 0x70 4 To define the duration that the combo pre-condition should be pressed
sysrst_ctrl.COM_SEL_CTL_0 0x74 4 To define the keys that trigger the combo
sysrst_ctrl.COM_SEL_CTL_1 0x78 4 To define the keys that trigger the combo
sysrst_ctrl.COM_SEL_CTL_2 0x7c 4 To define the keys that trigger the combo
sysrst_ctrl.COM_SEL_CTL_3 0x80 4 To define the keys that trigger the combo
sysrst_ctrl.COM_DET_CTL_0 0x84 4 To define the duration that the combo should be pressed
sysrst_ctrl.COM_DET_CTL_1 0x88 4 To define the duration that the combo should be pressed
sysrst_ctrl.COM_DET_CTL_2 0x8c 4 To define the duration that the combo should be pressed
sysrst_ctrl.COM_DET_CTL_3 0x90 4 To define the duration that the combo should be pressed
sysrst_ctrl.COM_OUT_CTL_0 0x94 4 To define the actions once the combo is detected
sysrst_ctrl.COM_OUT_CTL_1 0x98 4 To define the actions once the combo is detected
sysrst_ctrl.COM_OUT_CTL_2 0x9c 4 To define the actions once the combo is detected
sysrst_ctrl.COM_OUT_CTL_3 0xa0 4 To define the actions once the combo is detected
sysrst_ctrl.COMBO_INTR_STATUS 0xa4 4 Combo interrupt source. These registers will only be set if the
sysrst_ctrl.KEY_INTR_STATUS 0xa8 4 key interrupt source

INTR_STATE

Interrupt State Register

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

Fields

{"reg": [{"name": "event_detected", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"bits": 31}], "config": {"lanes": 1, "fontsize": 10, "vspace": 160}}
Bits Type Reset Name Description
31:1 Reserved
0 rw1c 0x0 event_detected Common interrupt triggered by combo or keyboard events.

INTR_ENABLE

Interrupt Enable Register

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

Fields

{"reg": [{"name": "event_detected", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 31}], "config": {"lanes": 1, "fontsize": 10, "vspace": 160}}
Bits Type Reset Name Description
31:1 Reserved
0 rw 0x0 event_detected Enable interrupt when INTR_STATE.event_detected is set.

INTR_TEST

Interrupt Test Register

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

Fields

{"reg": [{"name": "event_detected", "bits": 1, "attr": ["wo"], "rotate": -90}, {"bits": 31}], "config": {"lanes": 1, "fontsize": 10, "vspace": 160}}
Bits Type Reset Name Description
31:1 Reserved
0 wo 0x0 event_detected Write 1 to force INTR_STATE.event_detected to 1.

ALERT_TEST

Alert Test Register

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

Fields

{"reg": [{"name": "fatal_fault", "bits": 1, "attr": ["wo"], "rotate": -90}, {"bits": 31}], "config": {"lanes": 1, "fontsize": 10, "vspace": 130}}
Bits Type Reset Name Description
31:1 Reserved
0 wo 0x0 fatal_fault Write 1 to trigger one alert event of this kind.

REGWEN

Configuration write enable control register

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

Fields

{"reg": [{"name": "write_en", "bits": 1, "attr": ["rw0c"], "rotate": -90}, {"bits": 31}], "config": {"lanes": 1, "fontsize": 10, "vspace": 100}}
Bits Type Reset Name Description
31:1 Reserved
0 rw0c 0x1 write_en config write enable. 0: cfg is locked(not writable); 1: cfg is not locked(writable)

EC_RST_CTL

EC reset control register

  • Offset: 0x14
  • Reset default: 0x7d0
  • Reset mask: 0xffff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "ec_rst_pulse", "bits": 16, "attr": ["rw"], "rotate": 0}, {"bits": 16}], "config": {"lanes": 1, "fontsize": 10, "vspace": 80}}
Bits Type Reset Name Description
31:16 Reserved
15:0 rw 0x7d0 ec_rst_pulse Configure the pulse width of ec_rst_l. Each step is 5 us for a 200 kHz clock.

ULP_AC_DEBOUNCE_CTL

Ultra low power AC debounce control register

  • Offset: 0x18
  • Reset default: 0x1f40
  • Reset mask: 0xffff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "ulp_ac_debounce_timer", "bits": 16, "attr": ["rw"], "rotate": 0}, {"bits": 16}], "config": {"lanes": 1, "fontsize": 10, "vspace": 80}}
Bits Type Reset Name Description
31:16 Reserved
15:0 rw 0x1f40 ulp_ac_debounce_timer Configure the debounce timer for the AC input in number of clock cycles. Each step is 5 us for a 200 kHz clock. The signal must exceed the debounce time by at least one clock cycle to be detected.

ULP_LID_DEBOUNCE_CTL

Ultra low power lid debounce control register

  • Offset: 0x1c
  • Reset default: 0x1f40
  • Reset mask: 0xffff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "ulp_lid_debounce_timer", "bits": 16, "attr": ["rw"], "rotate": 0}, {"bits": 16}], "config": {"lanes": 1, "fontsize": 10, "vspace": 80}}
Bits Type Reset Name Description
31:16 Reserved
15:0 rw 0x1f40 ulp_lid_debounce_timer Configure the debounce timer for the lid in number of clock cycles. Each step is 5 us for a 200 kHz clock. The signal must exceed the debounce time by at least one clock cycle to be detected.

ULP_PWRB_DEBOUNCE_CTL

Ultra low power pwrb debounce control register

  • Offset: 0x20
  • Reset default: 0x1f40
  • Reset mask: 0xffff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "ulp_pwrb_debounce_timer", "bits": 16, "attr": ["rw"], "rotate": 0}, {"bits": 16}], "config": {"lanes": 1, "fontsize": 10, "vspace": 80}}
Bits Type Reset Name Description
31:16 Reserved
15:0 rw 0x1f40 ulp_pwrb_debounce_timer Configure the debounce timer for the power button in number of clock cycles. Each step is 5 us for a 200 kHz clock. The signal must exceed the debounce time by at least one clock cycle to be detected.

ULP_CTL

Ultra low power control register

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

Fields

{"reg": [{"name": "ulp_enable", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 31}], "config": {"lanes": 1, "fontsize": 10, "vspace": 120}}
Bits Type Reset Name Description
31:1 Reserved
0 rw 0x0 ulp_enable 0: disable ULP wakeup feature and reset the ULP FSM; 1: enable ULP wakeup feature

ULP_STATUS

Ultra low power status

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

Fields

{"reg": [{"name": "ulp_wakeup", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"bits": 31}], "config": {"lanes": 1, "fontsize": 10, "vspace": 120}}
Bits Type Reset Name Description
31:1 Reserved
0 rw1c 0x0 ulp_wakeup 0: ULP wakeup not detected; 1: ULP wakeup event is detected

WKUP_STATUS

wakeup status

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

Fields

{"reg": [{"name": "wakeup_sts", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"bits": 31}], "config": {"lanes": 1, "fontsize": 10, "vspace": 120}}
Bits Type Reset Name Description
31:1 Reserved
0 rw1c 0x0 wakeup_sts 0: wakeup event not detected; 1: wakeup event is detected

KEY_INVERT_CTL

configure key input output invert property

  • Offset: 0x30
  • Reset default: 0x0
  • Reset mask: 0xfff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "key0_in", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key0_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_in", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_in", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_in", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ac_present", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "bat_disable", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "lid_open", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "z3_wakeup", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 20}], "config": {"lanes": 1, "fontsize": 10, "vspace": 130}}
Bits Type Reset Name Description
31:12 Reserved
11 rw 0x0 z3_wakeup 0: don't invert; 1: invert
10 rw 0x0 lid_open 0: don't invert; 1: invert
9 rw 0x0 bat_disable 0: don't invert; 1: invert
8 rw 0x0 ac_present 0: don't invert; 1: invert
7 rw 0x0 pwrb_out 0: don't invert; 1: invert
6 rw 0x0 pwrb_in 0: don't invert; 1: invert
5 rw 0x0 key2_out 0: don't invert; 1: invert
4 rw 0x0 key2_in 0: don't invert; 1: invert
3 rw 0x0 key1_out 0: don't invert; 1: invert
2 rw 0x0 key1_in 0: don't invert; 1: invert
1 rw 0x0 key0_out 0: don't invert; 1: invert
0 rw 0x0 key0_in 0: don't invert; 1: invert

PIN_ALLOWED_CTL

This register determines which override values are allowed for a given output. If an override value programmed via PIN_OUT_VALUE is not configured as an allowed value, it will not have any effect.

  • Offset: 0x34
  • Reset default: 0x82
  • Reset mask: 0xffff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "bat_disable_0", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ec_rst_l_0", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_out_0", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key0_out_0", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_out_0", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_out_0", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "z3_wakeup_0", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "flash_wp_l_0", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "bat_disable_1", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ec_rst_l_1", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_out_1", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key0_out_1", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_out_1", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_out_1", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "z3_wakeup_1", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "flash_wp_l_1", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 16}], "config": {"lanes": 1, "fontsize": 10, "vspace": 150}}
Bits Type Reset Name Description
31:16 Reserved
15 rw 0x0 flash_wp_l_1 0: not allowed; 1: allowed
14 rw 0x0 z3_wakeup_1 0: not allowed; 1: allowed
13 rw 0x0 key2_out_1 0: not allowed; 1: allowed
12 rw 0x0 key1_out_1 0: not allowed; 1: allowed
11 rw 0x0 key0_out_1 0: not allowed; 1: allowed
10 rw 0x0 pwrb_out_1 0: not allowed; 1: allowed
9 rw 0x0 ec_rst_l_1 0: not allowed; 1: allowed
8 rw 0x0 bat_disable_1 0: not allowed; 1: allowed
7 rw 0x1 flash_wp_l_0 0: not allowed; 1: allowed
6 rw 0x0 z3_wakeup_0 0: not allowed; 1: allowed
5 rw 0x0 key2_out_0 0: not allowed; 1: allowed
4 rw 0x0 key1_out_0 0: not allowed; 1: allowed
3 rw 0x0 key0_out_0 0: not allowed; 1: allowed
2 rw 0x0 pwrb_out_0 0: not allowed; 1: allowed
1 rw 0x1 ec_rst_l_0 0: not allowed; 1: allowed
0 rw 0x0 bat_disable_0 0: not allowed; 1: allowed

PIN_OUT_CTL

Enables the override function for a specific pin.

  • Offset: 0x38
  • Reset default: 0x82
  • Reset mask: 0xff

Fields

{"reg": [{"name": "bat_disable", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ec_rst_l", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key0_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "z3_wakeup", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "flash_wp_l", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 24}], "config": {"lanes": 1, "fontsize": 10, "vspace": 130}}
Bits Type Reset Name Description
31:8 Reserved
7 rw 0x1 flash_wp_l 0: disable override; 1: enable override
6 rw 0x0 z3_wakeup 0: disable override; 1: enable override
5 rw 0x0 key2_out 0: disable override; 1: enable override
4 rw 0x0 key1_out 0: disable override; 1: enable override
3 rw 0x0 key0_out 0: disable override; 1: enable override
2 rw 0x0 pwrb_out 0: disable override; 1: enable override
1 rw 0x1 ec_rst_l 0: disable override; 1: enable override
0 rw 0x0 bat_disable 0: disable override; 1: enable override

PIN_OUT_VALUE

Sets the pin override value. Note that only the values configured as 'allowed' in PIN_ALLOWED_CTL will have an effect. Otherwise the pin value will not be overridden.

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

Fields

{"reg": [{"name": "bat_disable", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ec_rst_l", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key0_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_out", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "z3_wakeup", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "flash_wp_l", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 24}], "config": {"lanes": 1, "fontsize": 10, "vspace": 130}}
Bits Type Reset Name Description
31:8 Reserved
7 rw 0x0 flash_wp_l 0: override to 1b0; 1: override to 1b1
6 rw 0x0 z3_wakeup 0: override to 1b0; 1: override to 1b1
5 rw 0x0 key2_out 0: override to 1b0; 1: override to 1b1
4 rw 0x0 key1_out 0: override to 1b0; 1: override to 1b1
3 rw 0x0 key0_out 0: override to 1b0; 1: override to 1b1
2 rw 0x0 pwrb_out 0: override to 1b0; 1: override to 1b1
1 rw 0x0 ec_rst_l 0: override to 1b0; 1: override to 1b1
0 rw 0x0 bat_disable 0: override to 1b0; 1: override to 1b1

PIN_IN_VALUE

For SW to read the sysrst_ctrl inputs like GPIO

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

Fields

{"reg": [{"name": "pwrb_in", "bits": 1, "attr": ["ro"], "rotate": -90}, {"name": "key0_in", "bits": 1, "attr": ["ro"], "rotate": -90}, {"name": "key1_in", "bits": 1, "attr": ["ro"], "rotate": -90}, {"name": "key2_in", "bits": 1, "attr": ["ro"], "rotate": -90}, {"name": "lid_open", "bits": 1, "attr": ["ro"], "rotate": -90}, {"name": "ac_present", "bits": 1, "attr": ["ro"], "rotate": -90}, {"name": "ec_rst_l", "bits": 1, "attr": ["ro"], "rotate": -90}, {"name": "flash_wp_l", "bits": 1, "attr": ["ro"], "rotate": -90}, {"bits": 24}], "config": {"lanes": 1, "fontsize": 10, "vspace": 120}}
Bits Type Reset Name Description
31:8 Reserved
7 ro 0x0 flash_wp_l raw flash_wp_l value; before the invert logic
6 ro 0x0 ec_rst_l raw ec_rst_l value; before the invert logic
5 ro 0x0 ac_present raw ac_present value; before the invert logic
4 ro 0x0 lid_open raw lid_open value; before the invert logic
3 ro 0x0 key2_in raw key2_in value; before the invert logic
2 ro 0x0 key1_in raw key1_in value; before the invert logic
1 ro 0x0 key0_in raw key0_in value; before the invert logic
0 ro 0x0 pwrb_in raw pwrb_in value; before the invert logic

KEY_INTR_CTL

Define the keys or inputs that can trigger the interrupt

  • Offset: 0x44
  • Reset default: 0x0
  • Reset mask: 0x3fff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "pwrb_in_H2L", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key0_in_H2L", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_in_H2L", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_in_H2L", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ac_present_H2L", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ec_rst_l_H2L", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "flash_wp_l_H2L", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_in_L2H", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key0_in_L2H", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_in_L2H", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_in_L2H", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ac_present_L2H", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ec_rst_l_L2H", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "flash_wp_l_L2H", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 18}], "config": {"lanes": 1, "fontsize": 10, "vspace": 160}}
Bits Type Reset Name Description
31:14 Reserved
13 rw 0x0 flash_wp_l_L2H 0: disable, 1: enable
12 rw 0x0 ec_rst_l_L2H 0: disable, 1: enable
11 rw 0x0 ac_present_L2H 0: disable, 1: enable
10 rw 0x0 key2_in_L2H 0: disable, 1: enable
9 rw 0x0 key1_in_L2H 0: disable, 1: enable
8 rw 0x0 key0_in_L2H 0: disable, 1: enable
7 rw 0x0 pwrb_in_L2H 0: disable, 1: enable
6 rw 0x0 flash_wp_l_H2L 0: disable, 1: enable
5 rw 0x0 ec_rst_l_H2L 0: disable, 1: enable
4 rw 0x0 ac_present_H2L 0: disable, 1: enable
3 rw 0x0 key2_in_H2L 0: disable, 1: enable
2 rw 0x0 key1_in_H2L 0: disable, 1: enable
1 rw 0x0 key0_in_H2L 0: disable, 1: enable
0 rw 0x0 pwrb_in_H2L 0: disable, 1: enable

KEY_INTR_DEBOUNCE_CTL

Debounce timer control register for key-triggered interrupt

  • Offset: 0x48
  • Reset default: 0x7d0
  • Reset mask: 0xffff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "debounce_timer", "bits": 16, "attr": ["rw"], "rotate": 0}, {"bits": 16}], "config": {"lanes": 1, "fontsize": 10, "vspace": 80}}
Bits Type Reset Name Description
31:16 Reserved
15:0 rw 0x7d0 debounce_timer Define the timer value so that the key or input is not oscillating in clock cycles. Each step is 5 us for a 200 kHz clock. The signal must exceed the debounce time by at least one clock cycle to be detected.

AUTO_BLOCK_DEBOUNCE_CTL

Debounce timer control register for pwrb_in H2L transition

  • Offset: 0x4c
  • Reset default: 0x7d0
  • Reset mask: 0x1ffff
  • Register enable: REGWEN

Fields

{"reg": [{"name": "debounce_timer", "bits": 16, "attr": ["rw"], "rotate": 0}, {"name": "auto_block_enable", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 15}], "config": {"lanes": 1, "fontsize": 10, "vspace": 190}}
Bits Type Reset Name Description
31:17 Reserved
16 rw 0x0 auto_block_enable 0: disable, 1: enable
15:0 rw 0x7d0 debounce_timer Define the timer value so that the pwrb_in is not oscillating in clock cycles. Each step is 5 us for a 200 kHz clock. The signal must exceed the debounce time by at least one clock cycle to be detected.

AUTO_BLOCK_OUT_CTL

configure the key outputs to auto-override and their value

  • Offset: 0x50
  • Reset default: 0x0
  • Reset mask: 0x77
  • Register enable: REGWEN

Fields

{"reg": [{"name": "key0_out_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_out_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_out_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 1}, {"name": "key0_out_value", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_out_value", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_out_value", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 25}], "config": {"lanes": 1, "fontsize": 10, "vspace": 160}}
Bits Type Reset Name Description
31:7 Reserved
6 rw 0x0 key2_out_value 0: override to 1'b0; 1: override to 1'b1
5 rw 0x0 key1_out_value 0: override to 1'b0; 1: override to 1'b1
4 rw 0x0 key0_out_value 0: override to 1'b0; 1: override to 1'b1
3 Reserved
2 rw 0x0 key2_out_sel 0: disable auto-block; 1: enable auto-block
1 rw 0x0 key1_out_sel 0: disable auto-block; 1: enable auto-block
0 rw 0x0 key0_out_sel 0: disable auto-block; 1: enable auto-block

COM_PRE_SEL_CTL

To define the keys that define the pre-condition of the combo [0]: key0_in_sel [1]: key1_in_sel [2]: key2_in_sel [3]: pwrb_in_sel [4]: ac_present_sel HW will start matching the combo as defined by COM_SEL_CTL if this precondition is fulfilled.

If no keys are configured for the pre-condition, the pre-condition always evaluates to true.

The debounce timing is defined via KEY_INTR_DEBOUNCE_CTL whereas the pre-condition pressed timing is defined via COM_PRE_DET_CTL.

  • Reset default: 0x0
  • Reset mask: 0x1f

Instances

Name Offset
COM_PRE_SEL_CTL_0 0x54
COM_PRE_SEL_CTL_1 0x58
COM_PRE_SEL_CTL_2 0x5c
COM_PRE_SEL_CTL_3 0x60

Fields

{"reg": [{"name": "key0_in_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_in_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_in_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_in_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ac_present_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 27}], "config": {"lanes": 1, "fontsize": 10, "vspace": 160}}
Bits Type Reset Name Description
31:5 Reserved
4 rw 0x0 ac_present_sel 0: disable, 1: enable
3 rw 0x0 pwrb_in_sel 0: disable, 1: enable
2 rw 0x0 key2_in_sel 0: disable, 1: enable
1 rw 0x0 key1_in_sel 0: disable, 1: enable
0 rw 0x0 key0_in_sel 0: disable, 1: enable

COM_PRE_DET_CTL

To define the duration that the combo pre-condition should be pressed 0-60s, each step is 5us(200KHz clock)

  • Reset default: 0x0
  • Reset mask: 0xffffffff

Instances

Name Offset
COM_PRE_DET_CTL_0 0x64
COM_PRE_DET_CTL_1 0x68
COM_PRE_DET_CTL_2 0x6c
COM_PRE_DET_CTL_3 0x70

Fields

{"reg": [{"name": "precondition_timer", "bits": 32, "attr": ["rw"], "rotate": 0}], "config": {"lanes": 1, "fontsize": 10, "vspace": 80}}
Bits Type Reset Name Description
31:0 rw 0x0 precondition_timer 0-60s, each step is 5us(200KHz clock)

COM_SEL_CTL

To define the keys that trigger the combo [0]: key0_in_sel [1]: key1_in_sel [2]: key2_in_sel [3]: pwrb_in_sel [4]: ac_present_sel HW will detect H2L transition in the combo use case.

Optionally, a pre-condition can be configured for the combo detection via COM_PRE_SEL_CTL.

If no keys are configured for the combo, the combo detection is disabled.

The debounce timing is defined via KEY_INTR_DEBOUNCE_CTL whereas the key-pressed timing is defined via COM_DET_CTL.

  • Reset default: 0x0
  • Reset mask: 0x1f

Instances

Name Offset
COM_SEL_CTL_0 0x74
COM_SEL_CTL_1 0x78
COM_SEL_CTL_2 0x7c
COM_SEL_CTL_3 0x80

Fields

{"reg": [{"name": "key0_in_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key1_in_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "key2_in_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "pwrb_in_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ac_present_sel", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 27}], "config": {"lanes": 1, "fontsize": 10, "vspace": 160}}
Bits Type Reset Name Description
31:5 Reserved
4 rw 0x0 ac_present_sel 0: disable, 1: enable
3 rw 0x0 pwrb_in_sel 0: disable, 1: enable
2 rw 0x0 key2_in_sel 0: disable, 1: enable
1 rw 0x0 key1_in_sel 0: disable, 1: enable
0 rw 0x0 key0_in_sel 0: disable, 1: enable

COM_DET_CTL

To define the duration that the combo should be pressed 0-60s, each step is 5us(200KHz clock)

  • Reset default: 0x0
  • Reset mask: 0xffffffff

Instances

Name Offset
COM_DET_CTL_0 0x84
COM_DET_CTL_1 0x88
COM_DET_CTL_2 0x8c
COM_DET_CTL_3 0x90

Fields

{"reg": [{"name": "detection_timer", "bits": 32, "attr": ["rw"], "rotate": 0}], "config": {"lanes": 1, "fontsize": 10, "vspace": 80}}
Bits Type Reset Name Description
31:0 rw 0x0 detection_timer 0-60s, each step is 5us(200KHz clock)

COM_OUT_CTL

To define the actions once the combo is detected [0]: bat_disable [1]: interrupt (to OpenTitan processor) [2]: ec_rst (for Embedded Controller) [3]: rst_req (to OpenTitan reset manager)

  • Reset default: 0x0
  • Reset mask: 0xf

Instances

Name Offset
COM_OUT_CTL_0 0x94
COM_OUT_CTL_1 0x98
COM_OUT_CTL_2 0x9c
COM_OUT_CTL_3 0xa0

Fields

{"reg": [{"name": "bat_disable", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "interrupt", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "ec_rst", "bits": 1, "attr": ["rw"], "rotate": -90}, {"name": "rst_req", "bits": 1, "attr": ["rw"], "rotate": -90}, {"bits": 28}], "config": {"lanes": 1, "fontsize": 10, "vspace": 130}}
Bits Type Reset Name Description
31:4 Reserved
3 rw 0x0 rst_req 0: disable, 1: enable
2 rw 0x0 ec_rst 0: disable, 1: enable
1 rw 0x0 interrupt 0: disable, 1: enable
0 rw 0x0 bat_disable 0: disable, 1: enable

COMBO_INTR_STATUS

Combo interrupt source. These registers will only be set if the interrupt action is configured in the corresponding COM_OUT_CTL register.

  • Offset: 0xa4
  • Reset default: 0x0
  • Reset mask: 0xf

Fields

{"reg": [{"name": "combo0_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "combo1_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "combo2_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "combo3_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"bits": 28}], "config": {"lanes": 1, "fontsize": 10, "vspace": 120}}
Bits Type Reset Name Description
31:4 Reserved
3 rw1c 0x0 combo3_H2L 0: case not detected;1: case detected
2 rw1c 0x0 combo2_H2L 0: case not detected;1: case detected
1 rw1c 0x0 combo1_H2L 0: case not detected;1: case detected
0 rw1c 0x0 combo0_H2L 0: case not detected;1: case detected

KEY_INTR_STATUS

key interrupt source

  • Offset: 0xa8
  • Reset default: 0x0
  • Reset mask: 0x3fff

Fields

{"reg": [{"name": "pwrb_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "key0_in_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "key1_in_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "key2_in_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "ac_present_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "ec_rst_l_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "flash_wp_l_H2L", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "pwrb_L2H", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "key0_in_L2H", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "key1_in_L2H", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "key2_in_L2H", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "ac_present_L2H", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "ec_rst_l_L2H", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"name": "flash_wp_l_L2H", "bits": 1, "attr": ["rw1c"], "rotate": -90}, {"bits": 18}], "config": {"lanes": 1, "fontsize": 10, "vspace": 160}}
Bits Type Reset Name Description
31:14 Reserved
13 rw1c 0x0 flash_wp_l_L2H 0: case not detected;1: case detected
12 rw1c 0x0 ec_rst_l_L2H 0: case not detected;1: case detected
11 rw1c 0x0 ac_present_L2H 0: case not detected;1: case detected
10 rw1c 0x0 key2_in_L2H 0: case not detected;1: case detected
9 rw1c 0x0 key1_in_L2H 0: case not detected;1: case detected
8 rw1c 0x0 key0_in_L2H 0: case not detected;1: case detected
7 rw1c 0x0 pwrb_L2H 0: case not detected;1: case detected
6 rw1c 0x0 flash_wp_l_H2L 0: case not detected;1: case detected
5 rw1c 0x0 ec_rst_l_H2L 0: case not detected;1: case detected
4 rw1c 0x0 ac_present_H2L 0: case not detected;1: case detected
3 rw1c 0x0 key2_in_H2L 0: case not detected;1: case detected
2 rw1c 0x0 key1_in_H2L 0: case not detected;1: case detected
1 rw1c 0x0 key0_in_H2L 0: case not detected;1: case detected
0 rw1c 0x0 pwrb_H2L 0: case not detected;1: case detected