Software APIs
clkmgr_regs.h
Go to the documentation of this file.
1/**
2 * @file
3 * @brief Generated register defines for clkmgr
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 _CLKMGR_REG_DEFS_
14#define _CLKMGR_REG_DEFS_
15
16#ifdef __cplusplus
17extern "C" {
18#endif
19// Number of clock groups
20#define CLKMGR_PARAM_NUM_GROUPS 8
21
22// Number of SW gateable clocks
23#define CLKMGR_PARAM_NUM_SW_GATEABLE_CLOCKS 4
24
25// Number of hintable clocks
26#define CLKMGR_PARAM_NUM_HINTABLE_CLOCKS 1
27
28// Number of alerts
29#define CLKMGR_PARAM_NUM_ALERTS 2
30
31// Register width
32#define CLKMGR_PARAM_REG_WIDTH 32
33
34// Alert Test Register
35#define CLKMGR_ALERT_TEST_REG_OFFSET 0x0
36#define CLKMGR_ALERT_TEST_REG_RESVAL 0x80000000u
37#define CLKMGR_ALERT_TEST_RECOV_FAULT_BIT 0
38#define CLKMGR_ALERT_TEST_FATAL_FAULT_BIT 1
39#define CLKMGR_ALERT_TEST_REGWEN_BIT 31
40
41// External clock control write enable
42#define CLKMGR_EXTCLK_CTRL_REGWEN_REG_OFFSET 0x4
43#define CLKMGR_EXTCLK_CTRL_REGWEN_REG_RESVAL 0x1u
44#define CLKMGR_EXTCLK_CTRL_REGWEN_EN_BIT 0
45
46// Select external clock
47#define CLKMGR_EXTCLK_CTRL_REG_OFFSET 0x8
48#define CLKMGR_EXTCLK_CTRL_REG_RESVAL 0x99u
49#define CLKMGR_EXTCLK_CTRL_SEL_MASK 0xfu
50#define CLKMGR_EXTCLK_CTRL_SEL_OFFSET 0
51#define CLKMGR_EXTCLK_CTRL_SEL_FIELD \
52 ((bitfield_field32_t) { .mask = CLKMGR_EXTCLK_CTRL_SEL_MASK, .index = CLKMGR_EXTCLK_CTRL_SEL_OFFSET })
53#define CLKMGR_EXTCLK_CTRL_HI_SPEED_SEL_MASK 0xfu
54#define CLKMGR_EXTCLK_CTRL_HI_SPEED_SEL_OFFSET 4
55#define CLKMGR_EXTCLK_CTRL_HI_SPEED_SEL_FIELD \
56 ((bitfield_field32_t) { .mask = CLKMGR_EXTCLK_CTRL_HI_SPEED_SEL_MASK, .index = CLKMGR_EXTCLK_CTRL_HI_SPEED_SEL_OFFSET })
57
58// Status of requested external clock switch
59#define CLKMGR_EXTCLK_STATUS_REG_OFFSET 0xc
60#define CLKMGR_EXTCLK_STATUS_REG_RESVAL 0x9u
61#define CLKMGR_EXTCLK_STATUS_ACK_MASK 0xfu
62#define CLKMGR_EXTCLK_STATUS_ACK_OFFSET 0
63#define CLKMGR_EXTCLK_STATUS_ACK_FIELD \
64 ((bitfield_field32_t) { .mask = CLKMGR_EXTCLK_STATUS_ACK_MASK, .index = CLKMGR_EXTCLK_STATUS_ACK_OFFSET })
65
66// Jitter write enable
67#define CLKMGR_JITTER_REGWEN_REG_OFFSET 0x10
68#define CLKMGR_JITTER_REGWEN_REG_RESVAL 0x1u
69#define CLKMGR_JITTER_REGWEN_EN_BIT 0
70
71// Enable jittery clock
72#define CLKMGR_JITTER_ENABLE_REG_OFFSET 0x14
73#define CLKMGR_JITTER_ENABLE_REG_RESVAL 0x9u
74#define CLKMGR_JITTER_ENABLE_VAL_MASK 0xfu
75#define CLKMGR_JITTER_ENABLE_VAL_OFFSET 0
76#define CLKMGR_JITTER_ENABLE_VAL_FIELD \
77 ((bitfield_field32_t) { .mask = CLKMGR_JITTER_ENABLE_VAL_MASK, .index = CLKMGR_JITTER_ENABLE_VAL_OFFSET })
78
79// Clock enable for software gateable clocks.
80#define CLKMGR_CLK_ENABLES_REG_OFFSET 0x18
81#define CLKMGR_CLK_ENABLES_REG_RESVAL 0xfu
82#define CLKMGR_CLK_ENABLES_CLK_IO_DIV4_PERI_EN_BIT 0
83#define CLKMGR_CLK_ENABLES_CLK_IO_DIV2_PERI_EN_BIT 1
84#define CLKMGR_CLK_ENABLES_CLK_IO_PERI_EN_BIT 2
85#define CLKMGR_CLK_ENABLES_CLK_USB_PERI_EN_BIT 3
86
87// Clock hint for software gateable transactional clocks during active mode.
88#define CLKMGR_CLK_HINTS_REG_OFFSET 0x1c
89#define CLKMGR_CLK_HINTS_REG_RESVAL 0x1u
90#define CLKMGR_CLK_HINTS_CLK_MAIN_AES_HINT_BIT 0
91
92// Since the final state of !!CLK_HINTS is not always determined by software,
93#define CLKMGR_CLK_HINTS_STATUS_REG_OFFSET 0x20
94#define CLKMGR_CLK_HINTS_STATUS_REG_RESVAL 0x1u
95#define CLKMGR_CLK_HINTS_STATUS_CLK_MAIN_AES_VAL_BIT 0
96
97// Measurement control write enable
98#define CLKMGR_MEASURE_CTRL_REGWEN_REG_OFFSET 0x24
99#define CLKMGR_MEASURE_CTRL_REGWEN_REG_RESVAL 0x1u
100#define CLKMGR_MEASURE_CTRL_REGWEN_EN_BIT 0
101
102// Enable for measurement control
103#define CLKMGR_IO_MEAS_CTRL_EN_REG_OFFSET 0x28
104#define CLKMGR_IO_MEAS_CTRL_EN_REG_RESVAL 0x9u
105#define CLKMGR_IO_MEAS_CTRL_EN_EN_MASK 0xfu
106#define CLKMGR_IO_MEAS_CTRL_EN_EN_OFFSET 0
107#define CLKMGR_IO_MEAS_CTRL_EN_EN_FIELD \
108 ((bitfield_field32_t) { .mask = CLKMGR_IO_MEAS_CTRL_EN_EN_MASK, .index = CLKMGR_IO_MEAS_CTRL_EN_EN_OFFSET })
109
110// Configuration controls for io measurement.
111#define CLKMGR_IO_MEAS_CTRL_SHADOWED_REG_OFFSET 0x2c
112#define CLKMGR_IO_MEAS_CTRL_SHADOWED_REG_RESVAL 0x759eau
113#define CLKMGR_IO_MEAS_CTRL_SHADOWED_HI_MASK 0x3ffu
114#define CLKMGR_IO_MEAS_CTRL_SHADOWED_HI_OFFSET 0
115#define CLKMGR_IO_MEAS_CTRL_SHADOWED_HI_FIELD \
116 ((bitfield_field32_t) { .mask = CLKMGR_IO_MEAS_CTRL_SHADOWED_HI_MASK, .index = CLKMGR_IO_MEAS_CTRL_SHADOWED_HI_OFFSET })
117#define CLKMGR_IO_MEAS_CTRL_SHADOWED_LO_MASK 0x3ffu
118#define CLKMGR_IO_MEAS_CTRL_SHADOWED_LO_OFFSET 10
119#define CLKMGR_IO_MEAS_CTRL_SHADOWED_LO_FIELD \
120 ((bitfield_field32_t) { .mask = CLKMGR_IO_MEAS_CTRL_SHADOWED_LO_MASK, .index = CLKMGR_IO_MEAS_CTRL_SHADOWED_LO_OFFSET })
121
122// Enable for measurement control
123#define CLKMGR_IO_DIV4_MEAS_CTRL_EN_REG_OFFSET 0x30
124#define CLKMGR_IO_DIV4_MEAS_CTRL_EN_REG_RESVAL 0x9u
125#define CLKMGR_IO_DIV4_MEAS_CTRL_EN_EN_MASK 0xfu
126#define CLKMGR_IO_DIV4_MEAS_CTRL_EN_EN_OFFSET 0
127#define CLKMGR_IO_DIV4_MEAS_CTRL_EN_EN_FIELD \
128 ((bitfield_field32_t) { .mask = CLKMGR_IO_DIV4_MEAS_CTRL_EN_EN_MASK, .index = CLKMGR_IO_DIV4_MEAS_CTRL_EN_EN_OFFSET })
129
130// Configuration controls for io_div4 measurement.
131#define CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_REG_OFFSET 0x34
132#define CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_REG_RESVAL 0x6e82u
133#define CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_HI_MASK 0xffu
134#define CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_HI_OFFSET 0
135#define CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_HI_FIELD \
136 ((bitfield_field32_t) { .mask = CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_HI_MASK, .index = CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_HI_OFFSET })
137#define CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_LO_MASK 0xffu
138#define CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_LO_OFFSET 8
139#define CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_LO_FIELD \
140 ((bitfield_field32_t) { .mask = CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_LO_MASK, .index = CLKMGR_IO_DIV4_MEAS_CTRL_SHADOWED_LO_OFFSET })
141
142// Enable for measurement control
143#define CLKMGR_MAIN_MEAS_CTRL_EN_REG_OFFSET 0x38
144#define CLKMGR_MAIN_MEAS_CTRL_EN_REG_RESVAL 0x9u
145#define CLKMGR_MAIN_MEAS_CTRL_EN_EN_MASK 0xfu
146#define CLKMGR_MAIN_MEAS_CTRL_EN_EN_OFFSET 0
147#define CLKMGR_MAIN_MEAS_CTRL_EN_EN_FIELD \
148 ((bitfield_field32_t) { .mask = CLKMGR_MAIN_MEAS_CTRL_EN_EN_MASK, .index = CLKMGR_MAIN_MEAS_CTRL_EN_EN_OFFSET })
149
150// Configuration controls for main measurement.
151#define CLKMGR_MAIN_MEAS_CTRL_SHADOWED_REG_OFFSET 0x3c
152#define CLKMGR_MAIN_MEAS_CTRL_SHADOWED_REG_RESVAL 0x7a9feu
153#define CLKMGR_MAIN_MEAS_CTRL_SHADOWED_HI_MASK 0x3ffu
154#define CLKMGR_MAIN_MEAS_CTRL_SHADOWED_HI_OFFSET 0
155#define CLKMGR_MAIN_MEAS_CTRL_SHADOWED_HI_FIELD \
156 ((bitfield_field32_t) { .mask = CLKMGR_MAIN_MEAS_CTRL_SHADOWED_HI_MASK, .index = CLKMGR_MAIN_MEAS_CTRL_SHADOWED_HI_OFFSET })
157#define CLKMGR_MAIN_MEAS_CTRL_SHADOWED_LO_MASK 0x3ffu
158#define CLKMGR_MAIN_MEAS_CTRL_SHADOWED_LO_OFFSET 10
159#define CLKMGR_MAIN_MEAS_CTRL_SHADOWED_LO_FIELD \
160 ((bitfield_field32_t) { .mask = CLKMGR_MAIN_MEAS_CTRL_SHADOWED_LO_MASK, .index = CLKMGR_MAIN_MEAS_CTRL_SHADOWED_LO_OFFSET })
161
162// Enable for measurement control
163#define CLKMGR_USB_MEAS_CTRL_EN_REG_OFFSET 0x40
164#define CLKMGR_USB_MEAS_CTRL_EN_REG_RESVAL 0x9u
165#define CLKMGR_USB_MEAS_CTRL_EN_EN_MASK 0xfu
166#define CLKMGR_USB_MEAS_CTRL_EN_EN_OFFSET 0
167#define CLKMGR_USB_MEAS_CTRL_EN_EN_FIELD \
168 ((bitfield_field32_t) { .mask = CLKMGR_USB_MEAS_CTRL_EN_EN_MASK, .index = CLKMGR_USB_MEAS_CTRL_EN_EN_OFFSET })
169
170// Configuration controls for usb measurement.
171#define CLKMGR_USB_MEAS_CTRL_SHADOWED_REG_OFFSET 0x44
172#define CLKMGR_USB_MEAS_CTRL_SHADOWED_REG_RESVAL 0x1ccfau
173#define CLKMGR_USB_MEAS_CTRL_SHADOWED_HI_MASK 0x1ffu
174#define CLKMGR_USB_MEAS_CTRL_SHADOWED_HI_OFFSET 0
175#define CLKMGR_USB_MEAS_CTRL_SHADOWED_HI_FIELD \
176 ((bitfield_field32_t) { .mask = CLKMGR_USB_MEAS_CTRL_SHADOWED_HI_MASK, .index = CLKMGR_USB_MEAS_CTRL_SHADOWED_HI_OFFSET })
177#define CLKMGR_USB_MEAS_CTRL_SHADOWED_LO_MASK 0x1ffu
178#define CLKMGR_USB_MEAS_CTRL_SHADOWED_LO_OFFSET 9
179#define CLKMGR_USB_MEAS_CTRL_SHADOWED_LO_FIELD \
180 ((bitfield_field32_t) { .mask = CLKMGR_USB_MEAS_CTRL_SHADOWED_LO_MASK, .index = CLKMGR_USB_MEAS_CTRL_SHADOWED_LO_OFFSET })
181
182// Recoverable Error code
183#define CLKMGR_RECOV_ERR_CODE_REG_OFFSET 0x48
184#define CLKMGR_RECOV_ERR_CODE_REG_RESVAL 0x0u
185#define CLKMGR_RECOV_ERR_CODE_SHADOW_UPDATE_ERR_BIT 0
186#define CLKMGR_RECOV_ERR_CODE_IO_MEASURE_ERR_BIT 1
187#define CLKMGR_RECOV_ERR_CODE_IO_DIV4_MEASURE_ERR_BIT 2
188#define CLKMGR_RECOV_ERR_CODE_MAIN_MEASURE_ERR_BIT 3
189#define CLKMGR_RECOV_ERR_CODE_USB_MEASURE_ERR_BIT 4
190#define CLKMGR_RECOV_ERR_CODE_IO_TIMEOUT_ERR_BIT 5
191#define CLKMGR_RECOV_ERR_CODE_IO_DIV4_TIMEOUT_ERR_BIT 6
192#define CLKMGR_RECOV_ERR_CODE_MAIN_TIMEOUT_ERR_BIT 7
193#define CLKMGR_RECOV_ERR_CODE_USB_TIMEOUT_ERR_BIT 8
194
195// Error code
196#define CLKMGR_FATAL_ERR_CODE_REG_OFFSET 0x4c
197#define CLKMGR_FATAL_ERR_CODE_REG_RESVAL 0x0u
198#define CLKMGR_FATAL_ERR_CODE_REG_INTG_BIT 0
199#define CLKMGR_FATAL_ERR_CODE_IDLE_CNT_BIT 1
200#define CLKMGR_FATAL_ERR_CODE_SHADOW_STORAGE_ERR_BIT 2
201
202#ifdef __cplusplus
203} // extern "C"
204#endif
205#endif // _CLKMGR_REG_DEFS_
206// End generated register defines for clkmgr