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 0x80000000u
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#define SOC_DBG_CTRL_ALERT_TEST_REGWEN_BIT 31
31
32// Debug Policy Valid.
33#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_REG_OFFSET 0x4
34#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_REG_RESVAL 0x9u
35#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_DEBUG_POLICY_VALID_MASK 0xfu
36#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_DEBUG_POLICY_VALID_OFFSET 0
37#define SOC_DBG_CTRL_DEBUG_POLICY_VALID_SHADOWED_DEBUG_POLICY_VALID_FIELD \
38 ((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 })
39
40// Debug Policy category
41#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_REG_OFFSET 0x8
42#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_REG_RESVAL 0x50u
43#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_DEBUG_POLICY_CATEGORY_MASK \
44 0x7fu
45#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_DEBUG_POLICY_CATEGORY_OFFSET \
46 0
47#define SOC_DBG_CTRL_DEBUG_POLICY_CATEGORY_SHADOWED_DEBUG_POLICY_CATEGORY_FIELD \
48 ((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 })
49
50// Debug Policy relocked
51#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_REG_OFFSET 0xc
52#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_REG_RESVAL 0x9u
53#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_DEBUG_POLICY_RELOCKED_MASK 0xfu
54#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_DEBUG_POLICY_RELOCKED_OFFSET 0
55#define SOC_DBG_CTRL_DEBUG_POLICY_RELOCKED_DEBUG_POLICY_RELOCKED_FIELD \
56 ((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 })
57
58// Trace register to observe the debug category that is determined either by
59// hardware or by software.
60#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_REG_OFFSET 0x10
61#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_REG_RESVAL 0x50u
62#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_MASK 0x7fu
63#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_OFFSET 0
64#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_FIELD \
65 ((bitfield_field32_t) { .mask = SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_MASK, .index = SOC_DBG_CTRL_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_OFFSET })
66
67// Trace register to observe the valid or relocked state that is determined
68// either by hardware or by software.
69#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_REG_OFFSET 0x14
70#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_REG_RESVAL 0x99u
71#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_MASK 0xfu
72#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_OFFSET 0
73#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_FIELD \
74 ((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 })
75#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_MASK 0xfu
76#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_OFFSET 4
77#define SOC_DBG_CTRL_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_FIELD \
78 ((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 })
79
80// Debug Status Register
81#define SOC_DBG_CTRL_STATUS_REG_OFFSET 0x18
82#define SOC_DBG_CTRL_STATUS_REG_RESVAL 0x0u
83#define SOC_DBG_CTRL_STATUS_AUTH_DEBUG_INTENT_SET_BIT 0
84#define SOC_DBG_CTRL_STATUS_AUTH_WINDOW_OPEN_BIT 4
85#define SOC_DBG_CTRL_STATUS_AUTH_WINDOW_CLOSED_BIT 5
86#define SOC_DBG_CTRL_STATUS_AUTH_UNLOCK_SUCCESS_BIT 6
87#define SOC_DBG_CTRL_STATUS_AUTH_UNLOCK_FAILED_BIT 7
88
89// Trace register to observe the debug category that is determined either by
90// hardware or by software.
91#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_REG_OFFSET 0x0
92#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_REG_RESVAL 0x50u
93#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_MASK 0x7fu
94#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_OFFSET 0
95#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_CATEGORY_CATEGORY_FIELD \
96 ((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 })
97
98// Trace register to observe the valid or relocked state that is determined
99// either by hardware or by software.
100#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_REG_OFFSET 0x4
101#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_REG_RESVAL 0x99u
102#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_MASK 0xfu
103#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_OFFSET 0
104#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_VALID_FIELD \
105 ((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 })
106#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_MASK 0xfu
107#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_OFFSET 4
108#define SOC_DBG_CTRL_JTAG_TRACE_DEBUG_POLICY_VALID_RELOCKED_RELOCKED_FIELD \
109 ((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 })
110
111// JTAG control register to interact with the boot flow.
112#define SOC_DBG_CTRL_JTAG_CONTROL_REG_OFFSET 0x8
113#define SOC_DBG_CTRL_JTAG_CONTROL_REG_RESVAL 0x0u
114#define SOC_DBG_CTRL_JTAG_CONTROL_BOOT_CONTINUE_BIT 0
115
116// Debug Status Register
117#define SOC_DBG_CTRL_JTAG_STATUS_REG_OFFSET 0xc
118#define SOC_DBG_CTRL_JTAG_STATUS_REG_RESVAL 0x0u
119#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_DEBUG_INTENT_SET_BIT 0
120#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_WINDOW_OPEN_BIT 4
121#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_WINDOW_CLOSED_BIT 5
122#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_UNLOCK_SUCCESS_BIT 6
123#define SOC_DBG_CTRL_JTAG_STATUS_AUTH_UNLOCK_FAILED_BIT 7
124
125// Debug boot status register that tells important boot state information.
126#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_REG_OFFSET 0x10
127#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_REG_RESVAL 0x0u
128#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_MAIN_CLK_STATUS_BIT 0
129#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_IO_CLK_STATUS_BIT 1
130#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_OTP_DONE_BIT 2
131#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_LC_DONE_BIT 3
132#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_CPU_FETCH_EN_BIT 4
133#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_HALT_FSM_STATE_MASK 0x3fu
134#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_HALT_FSM_STATE_OFFSET 5
135#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_HALT_FSM_STATE_FIELD \
136 ((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 })
137#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_DONE_MASK 0x7u
138#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_DONE_OFFSET 11
139#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_DONE_FIELD \
140 ((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 })
141#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_GOOD_MASK 0x7u
142#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_GOOD_OFFSET 14
143#define SOC_DBG_CTRL_JTAG_BOOT_STATUS_BOOT_GREENLIGHT_GOOD_FIELD \
144 ((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 })
145
146// Reports the current debug state coming from OTP.
147#define SOC_DBG_CTRL_JTAG_TRACE_SOC_DBG_STATE_REG_OFFSET 0x14
148#define SOC_DBG_CTRL_JTAG_TRACE_SOC_DBG_STATE_REG_RESVAL 0x0u
149
150#ifdef __cplusplus
151} // extern "C"
152#endif
153#endif // _SOC_DBG_CTRL_REG_DEFS_
154// End generated register defines for soc_dbg_ctrl