Software APIs
soc_dbg_ctrl_regs.h
Go to the documentation of this file.
1/**
2 * @file
3 * @brief Generated register defines for soc_dbg_ctrl
4 */
5
6// Copyright information found in source file:
7// Copyright lowRISC contributors (OpenTitan project).
8
9// Licensing information found in source file:
10// Licensed under the Apache License, Version 2.0, see LICENSE for details.
11// SPDX-License-Identifier: Apache-2.0
12
13#ifndef _SOC_DBG_CTRL_REG_DEFS_
14#define _SOC_DBG_CTRL_REG_DEFS_
15
16#ifdef __cplusplus
17extern "C" {
18#endif
19// Number of alerts
20#define SOC_DBG_CTRL_PARAM_NUM_ALERTS 2
21
22// Register width
23#define SOC_DBG_CTRL_PARAM_REG_WIDTH 32
24
25// Alert Test Register
26#define SOC_DBG_CTRL_ALERT_TEST_REG_OFFSET 0x0
27#define SOC_DBG_CTRL_ALERT_TEST_REG_RESVAL 0x0u
28#define SOC_DBG_CTRL_ALERT_TEST_FATAL_FAULT_BIT 0
29#define SOC_DBG_CTRL_ALERT_TEST_RECOV_CTRL_UPDATE_ERR_BIT 1
30
31// Debug Policy Valid.
32#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_REG_OFFSET 0x4
33#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_REG_RESVAL 0x9u
34#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_DEBUG_POLICY_VALID_MASK 0xfu
35#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_DEBUG_POLICY_VALID_OFFSET 0
36#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_DEBUG_POLICY_VALID_FIELD \
37 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_DEBUG_POLICY_VALID_MASK, .index = SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_DEBUG_POLICY_VALID_OFFSET })
38
39// Debug Policy category
40#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_REG_OFFSET 0x8
41#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_REG_RESVAL 0x50u
42#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_DEBUG_POLICY_CATEGORY_MASK \
43 0x7fu
44#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_DEBUG_POLICY_CATEGORY_OFFSET \
45 0
46#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_DEBUG_POLICY_CATEGORY_FIELD \
47 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_DEBUG_POLICY_CATEGORY_MASK, .index = SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_DEBUG_POLICY_CATEGORY_OFFSET })
48
49// Debug Policy relocked
50#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_REG_OFFSET 0xc
51#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_REG_RESVAL 0x9u
52#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_DEBUG_POLICY_RELOCKED_MASK 0xfu
53#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_DEBUG_POLICY_RELOCKED_OFFSET 0
54#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_DEBUG_POLICY_RELOCKED_FIELD \
55 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_DEBUG_POLICY_RELOCKED_MASK, .index = SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_DEBUG_POLICY_RELOCKED_OFFSET })
56
57// Trace register to observe the debug category that is determined either by
58// hardware or by software.
59#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_REG_OFFSET 0x10
60#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_REG_RESVAL 0x50u
61#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_MASK 0x7fu
62#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_OFFSET 0
63#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_FIELD \
64 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_MASK, .index = SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_OFFSET })
65
66// Trace register to observe the valid or relocked state that is determined
67// either by hardware or by software.
68#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_REG_OFFSET 0x14
69#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_REG_RESVAL 0x99u
70#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_MASK 0xfu
71#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_OFFSET 0
72#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_FIELD \
73 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_MASK, .index = SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_OFFSET })
74#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_MASK 0xfu
75#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_OFFSET 4
76#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_FIELD \
77 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_MASK, .index = SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_OFFSET })
78
79// Debug Status Register
80#define SOC_DBG_CTRL_STATUS_REG_OFFSET 0x18
81#define SOC_DBG_CTRL_STATUS_REG_RESVAL 0x0u
82#define SOC_DBG_CTRL_STATUS_AUTH_DEBUG_INTENT_SET_BIT 0
83#define SOC_DBG_CTRL_STATUS_AUTH_WINDOW_OPEN_BIT 4
84#define SOC_DBG_CTRL_STATUS_AUTH_WINDOW_CLOSED_BIT 5
85#define SOC_DBG_CTRL_STATUS_AUTH_UNLOCK_SUCCESS_BIT 6
86#define SOC_DBG_CTRL_STATUS_AUTH_UNLOCK_FAILED_BIT 7
87
88// Trace register to observe the debug category that is determined either by
89// hardware or by software.
90#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_REG_OFFSET 0x0
91#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_REG_RESVAL 0x50u
92#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_MASK 0x7fu
93#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_OFFSET 0
94#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_FIELD \
95 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_MASK, .index = SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_OFFSET })
96
97// Trace register to observe the valid or relocked state that is determined
98// either by hardware or by software.
99#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_REG_OFFSET 0x4
100#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_REG_RESVAL 0x99u
101#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_MASK 0xfu
102#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_OFFSET 0
103#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_FIELD \
104 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_MASK, .index = SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_OFFSET })
105#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_MASK 0xfu
106#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_OFFSET 4
107#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_FIELD \
108 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_MASK, .index = SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_OFFSET })
109
110// JTAG control register to interact with the boot flow.
111#define SOC_DBG_CTRL_JTAG_CONTROL_REG_OFFSET 0x8
112#define SOC_DBG_CTRL_JTAG_CONTROL_REG_RESVAL 0x0u
113#define SOC_DBG_CTRL_JTAG_CONTROL_BOOT_CONTINUE_BIT 0
114
115// Debug Status Register
116#define SOC_DBG_CTRL_JTAG_STATUS_REG_OFFSET 0xc
117#define SOC_DBG_CTRL_JTAG_STATUS_REG_RESVAL 0x0u
118#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_DEBUG_INTENT_SET_BIT 0
119#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_WINDOW_OPEN_BIT 4
120#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_WINDOW_CLOSED_BIT 5
121#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_UNLOCK_SUCCESS_BIT 6
122#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_UNLOCK_FAILED_BIT 7
123
124// Debug boot status register that tells important boot state information.
125#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_REG_OFFSET 0x10
126#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_REG_RESVAL 0x0u
127#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_MAIN_CLK_STATUS_BIT 0
128#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_IO_CLK_STATUS_BIT 1
129#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_OTP_DONE_BIT 2
130#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_LC_DONE_BIT 3
131#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_CPU_FETCH_EN_BIT 4
132#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_HALT_FSM_STATE_MASK 0x3fu
133#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_HALT_FSM_STATE_OFFSET 5
134#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_HALT_FSM_STATE_FIELD \
135 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_JTAG_BOOT_STATUS_HALT_FSM_STATE_MASK, .index = SOC_DBG_CTRL_JTAG_BOOT_STATUS_HALT_FSM_STATE_OFFSET })
136#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_DONE_MASK 0x7u
137#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_DONE_OFFSET 11
138#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_DONE_FIELD \
139 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_DONE_MASK, .index = SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_DONE_OFFSET })
140#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_GOOD_MASK 0x7u
141#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_GOOD_OFFSET 14
142#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_GOOD_FIELD \
143 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_GOOD_MASK, .index = SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_GOOD_OFFSET })
144
145// Reports the current debug state coming from OTP.
146#define SOC_DBG_CTRL_JTAG_TRACE_SOC_DBG_STATE_REG_OFFSET 0x14
147#define SOC_DBG_CTRL_JTAG_TRACE_SOC_DBG_STATE_REG_RESVAL 0x0u
148
149#ifdef __cplusplus
150} // extern "C"
151#endif
152#endif // _SOC_DBG_CTRL_REG_DEFS_
153// End generated register defines for soc_dbg_ctrl