Hardware Interfaces and Registers

Interfaces

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

Primary Clock: clk_i

Other Clocks: clk_aon_i

Bus Device Interfaces (TL-UL): tl

Bus Host Interfaces (TL-UL): none

Peripheral Pins for Chip IO:

Pin name	direction	Description
ast_debug_out[8:0]	output	ast debug outputs to pinmux

Inter-Module Signals: Reference

Inter-Module Signals
Port Name	Package::Struct	Type	Act	Width
ast_alert	ast_pkg::ast_alert	req_rsp	rsp	1
ast_status	ast_pkg::ast_status	uni	rcv	1
ast_init_done	prim_mubi_pkg::mubi4	uni	rcv	1
ast2pinmux	logic	uni	rcv	9
wkup_req	logic	uni	req	1
tl	tlul_pkg::tl	req_rsp	rsp	1

Interrupts:

Interrupt Name	Type	Description
io_status_change	Event	io power status has changed
init_status_change	Event	ast init status has changed

Security Alerts:

Alert Name	Description
recov_alert	recoverable sensor_ctrl alerts
fatal_alert	fatal sensor_ctrl alerts

Security Countermeasures: none

Registers

Summary
Name	Offset	Length	Description
sensor_ctrl.INTR_STATE	0x0	4	Interrupt State Register
sensor_ctrl.INTR_ENABLE	0x4	4	Interrupt Enable Register
sensor_ctrl.INTR_TEST	0x8	4	Interrupt Test Register
sensor_ctrl.ALERT_TEST	0xc	4	Alert Test Register
sensor_ctrl.CFG_REGWEN	0x10	4	Controls the configurability of `FATAL_ALERT_EN` register.
sensor_ctrl.ALERT_TRIG	0x14	4	Alert trigger test
sensor_ctrl.FATAL_ALERT_EN	0x18	4	Each bit marks a corresponding alert as fatal or recoverable.
sensor_ctrl.RECOV_ALERT	0x1c	4	Each bit represents a recoverable alert that has been triggered by AST. Since these are recoverable alerts, they can be cleared by software.
sensor_ctrl.FATAL_ALERT	0x20	4	Each bit represents a fatal alert that has been triggered by AST. Since these registers represent fatal alerts, they cannot be cleared.
sensor_ctrl.STATUS	0x24	4	Status readback for ast

sensor_ctrl.INTR_STATE @ 0x0

Interrupt State Register

Reset default = 0x0, mask 0x3

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
														init_status_change	io_status_change

Bits

Type

Reset

Name

Description

rw1c

0x0

io_status_change

io power status has changed

rw1c

0x0

init_status_change

ast init status has changed

sensor_ctrl.INTR_ENABLE @ 0x4

Interrupt Enable Register

Reset default = 0x0, mask 0x3

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
														init_status_change	io_status_change

Bits Type Reset Name Description

0x0

io_status_change

Enable interrupt when INTR_STATE.io_status_change is set.

0x0

init_status_change

Enable interrupt when INTR_STATE.init_status_change is set.

sensor_ctrl.INTR_TEST @ 0x8

Interrupt Test Register

Reset default = 0x0, mask 0x3

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
														init_status_change	io_status_change

Bits Type Reset Name Description

0x0

io_status_change

Write 1 to force INTR_STATE.io_status_change to 1.

0x0

init_status_change

Write 1 to force INTR_STATE.init_status_change to 1.

sensor_ctrl.ALERT_TEST @ 0xc

Alert Test Register

Reset default = 0x0, mask 0x3

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
														fatal_alert	recov_alert

Bits

Type

Reset

Name

Description

0x0

recov_alert

Write 1 to trigger one alert event of this kind.

0x0

fatal_alert

Write 1 to trigger one alert event of this kind.

sensor_ctrl.CFG_REGWEN @ 0x10

Controls the configurability of FATAL_ALERT_EN register.

Reset default = 0x1, mask 0x1

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
															EN

Bits Type Reset Name Description

rw0c

0x1

Configuration enable.

sensor_ctrl.ALERT_TRIG @ 0x14

Alert trigger test

Reset default = 0x0, mask 0x7ff

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
					VAL_10	VAL_9	VAL_8	VAL_7	VAL_6	VAL_5	VAL_4	VAL_3	VAL_2	VAL_1	VAL_0

Bits Type Reset Name Description

0x0

VAL_0

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_1

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_2

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_3

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_4

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_5

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_6

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_7

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_8

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_9

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

0x0

VAL_10

Alert trigger for testing 0 No alerts triggered 1 Continuously trigger alert until disabled For bit mapping, please see ALERT_TEST

sensor_ctrl.FATAL_ALERT_EN @ 0x18

Each bit marks a corresponding alert as fatal or recoverable.

Reset default = 0x0, mask 0x7ff

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
					VAL_10	VAL_9	VAL_8	VAL_7	VAL_6	VAL_5	VAL_4	VAL_3	VAL_2	VAL_1	VAL_0

Bits

Type

Reset

Name

Description

0x0

VAL_0

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_1

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_2

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_3

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_4

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_5

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_6

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_7

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_8

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_9

1 - An alert event is fatal. 0 - An alert event is recoverable.

0x0

VAL_10

1 - An alert event is fatal. 0 - An alert event is recoverable.

sensor_ctrl.RECOV_ALERT @ 0x1c

Each bit represents a recoverable alert that has been triggered by AST. Since these are recoverable alerts, they can be cleared by software.

Reset default = 0x0, mask 0x7ff

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
					VAL_10	VAL_9	VAL_8	VAL_7	VAL_6	VAL_5	VAL_4	VAL_3	VAL_2	VAL_1	VAL_0

Bits

Type

Reset

Name

Description

rw1c

0x0

VAL_0

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_1

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_2

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_3

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_4

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_5

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_6

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_7

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_8

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_9

1 - An alert event has been set 0 - No alert event has been set

rw1c

0x0

VAL_10

1 - An alert event has been set 0 - No alert event has been set

sensor_ctrl.FATAL_ALERT @ 0x20

Each bit represents a fatal alert that has been triggered by AST. Since these registers represent fatal alerts, they cannot be cleared.

Reset default = 0x0, mask 0xfff

The lower bits are used for ast alert events. The upper bits are used for local events.

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
				VAL_11	VAL_10	VAL_9	VAL_8	VAL_7	VAL_6	VAL_5	VAL_4	VAL_3	VAL_2	VAL_1	VAL_0

Bits

Type

Reset

Name

Description

0x0

VAL_0

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_1

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_2

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_3

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_4

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_5

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_6

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_7

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_8

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_9

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_10

1 - An alert event has been set 0 - No alert event has been set

0x0

VAL_11

1 - An alert event has been set 0 - No alert event has been set

sensor_ctrl.STATUS @ 0x24

Status readback for ast

Reset default = 0x0, mask 0x7

31	30	29	28	27	26	25	24	23	22	21	20	19	18	17	16

15	14	13	12	11	10	9	8	7	6	5	4	3	2	1	0
													io_pok		ast_init_done

Bits

Type

Reset

Name

Description

0x0

ast_init_done

AST has finished initializing

2:1

0x0

io_pok

IO power is ready

OpenTitan Documentation

Hardware Interfaces and Registers

Interfaces

Registers