Software APIs
dt_ac_range_check.h
Go to the documentation of this file.
1
// Copyright lowRISC contributors (OpenTitan project).
2
// Licensed under the Apache License, Version 2.0, see LICENSE for details.
3
// SPDX-License-Identifier: Apache-2.0
4
//
5
// Device table API auto-generated by `dtgen`
6
7
#ifndef OPENTITAN_DT_AC_RANGE_CHECK_H_
8
#define OPENTITAN_DT_AC_RANGE_CHECK_H_
9
10
#ifdef __cplusplus
11
extern
"C"
{
12
#endif
// __cplusplus
13
14
/**
15
* @file
16
* @brief Device Tables (DT) for IP ac_range_check and top darjeeling.
17
*
18
* This file contains the type definitions and global functions of the ac_range_check.
19
*/
20
21
#include "
dt_api.h
"
22
#include <stdint.h>
23
24
25
26
/**
27
* List of instances.
28
*/
29
typedef
enum
dt_ac_range_check
{
30
kDtAcRangeCheck
= 0,
/**< ac_range_check */
31
kDtAcRangeCheckFirst = 0,
/**< \internal First instance */
32
kDtAcRangeCheckCount = 1,
/**< \internal Number of instances */
33
}
dt_ac_range_check_t
;
34
35
/**
36
* List of register blocks.
37
*
38
* Register blocks are guaranteed to start at 0 and to be consecutively numbered.
39
*/
40
typedef
enum
dt_ac_range_check_reg_block
{
41
kDtAcRangeCheckRegBlockCore = 0,
/**< */
42
kDtAcRangeCheckRegBlockCount = 1,
/**< \internal Number of register blocks */
43
}
dt_ac_range_check_reg_block_t
;
44
45
/** Primary register block (associated with the "primary" set of registers that control the IP). */
46
static
const
dt_ac_range_check_reg_block_t
kDtAcRangeCheckRegBlockPrimary = kDtAcRangeCheckRegBlockCore;
47
48
/**
49
* List of IRQs.
50
*
51
* IRQs are guaranteed to be numbered consecutively from 0.
52
*/
53
typedef
enum
dt_ac_range_check_irq
{
54
kDtAcRangeCheckIrqDenyCntReached
= 0,
/**< Deny counter has exceeded threshold. */
55
kDtAcRangeCheckIrqCount = 1,
/**< \internal Number of IRQs */
56
}
dt_ac_range_check_irq_t
;
57
58
/**
59
* List of Alerts.
60
*
61
* Alerts are guaranteed to be numbered consecutively from 0.
62
*/
63
typedef
enum
dt_ac_range_check_alert
{
64
kDtAcRangeCheckAlertRecovCtrlUpdateErr
= 0,
/**< This recoverable alert is triggered upon detecting an update error in the shadowed Control Register. */
65
kDtAcRangeCheckAlertFatalFault
= 1,
/**< This fatal alert is triggered when a fatal TL-UL bus integrity fault is detected or the internal counter has an error. */
66
kDtAcRangeCheckAlertCount = 2,
/**< \internal Number of Alerts */
67
}
dt_ac_range_check_alert_t
;
68
69
/**
70
* List of clock ports.
71
*
72
* Clock ports are guaranteed to be numbered consecutively from 0.
73
*/
74
typedef
enum
dt_ac_range_check_clock
{
75
kDtAcRangeCheckClockClk
= 0,
/**< Clock port clk_i */
76
kDtAcRangeCheckClockCount = 1,
/**< \internal Number of clock ports */
77
}
dt_ac_range_check_clock_t
;
78
79
/**
80
* List of reset ports.
81
*
82
* Reset ports are guaranteed to be numbered consecutively from 0.
83
*/
84
typedef
enum
dt_ac_range_check_reset
{
85
kDtAcRangeCheckResetRst
= 0,
/**< Reset port rst_ni */
86
kDtAcRangeCheckResetCount = 1,
/**< \internal Number of reset ports */
87
}
dt_ac_range_check_reset_t
;
88
89
90
/**
91
* Get the ac_range_check instance from an instance ID
92
*
93
* For example, `dt_uart_from_instance_id(kDtInstanceIdUart3) == kDtUart3`.
94
*
95
* @param inst_id Instance ID.
96
* @return A ac_range_check instance.
97
*
98
* **Note:** This function only makes sense if the instance ID has device type ac_range_check,
99
* otherwise the returned value is unspecified.
100
*/
101
dt_ac_range_check_t
dt_ac_range_check_from_instance_id
(
dt_instance_id_t
inst_id);
102
103
/**
104
* Get the instance ID of an instance.
105
*
106
* @param dt Instance of ac_range_check.
107
* @return The instance ID of that instance.
108
*/
109
dt_instance_id_t
dt_ac_range_check_instance_id
(
dt_ac_range_check_t
dt);
110
111
/**
112
* Get the register base address of an instance.
113
*
114
* @param dt Instance of ac_range_check.
115
* @param reg_block The register block requested.
116
* @return The register base address of the requested block.
117
*/
118
uint32_t
dt_ac_range_check_reg_block
(
119
dt_ac_range_check_t
dt,
120
dt_ac_range_check_reg_block_t
reg_block);
121
122
/**
123
* Get the primary register base address of an instance.
124
*
125
* This is just a convenience function, equivalent to
126
* `dt_ac_range_check_reg_block(dt, kDtAcRangeCheckRegBlockCore)`
127
*
128
* @param dt Instance of ac_range_check.
129
* @return The register base address of the primary register block.
130
*/
131
static
inline
uint32_t dt_ac_range_check_primary_reg_block(
132
dt_ac_range_check_t
dt) {
133
return
dt_ac_range_check_reg_block
(dt, kDtAcRangeCheckRegBlockCore);
134
}
135
136
/**
137
* Get the PLIC ID of a ac_range_check IRQ for a given instance.
138
*
139
* If the instance is not connected to the PLIC, this function
140
* will return `kDtPlicIrqIdNone`.
141
*
142
* @param dt Instance of ac_range_check.
143
* @param irq A ac_range_check IRQ.
144
* @return The PLIC ID of the IRQ of this instance.
145
*/
146
dt_plic_irq_id_t
dt_ac_range_check_irq_to_plic_id
(
147
dt_ac_range_check_t
dt,
148
dt_ac_range_check_irq_t
irq);
149
150
/**
151
* Convert a global IRQ ID to a local ac_range_check IRQ type.
152
*
153
* @param dt Instance of ac_range_check.
154
* @param irq A PLIC ID that belongs to this instance.
155
* @return The ac_range_check IRQ, or `kDtAcRangeCheckIrqCount`.
156
*
157
* **Note:** This function assumes that the PLIC ID belongs to the instance
158
* of ac_range_check passed in parameter. In other words, it must be the case that
159
* `dt_ac_range_check_instance_id(dt) == dt_plic_id_to_instance_id(irq)`. Otherwise, this function
160
* will return `kDtAcRangeCheckIrqCount`.
161
*/
162
dt_ac_range_check_irq_t
dt_ac_range_check_irq_from_plic_id
(
163
dt_ac_range_check_t
dt,
164
dt_plic_irq_id_t
irq);
165
166
167
/**
168
* Get the alert ID of a ac_range_check alert for a given instance.
169
*
170
* **Note:** This function only makes sense if the instance is connected to the Alert Handler. For any
171
* instances where the instance is not connected, the return value is unspecified.
172
*
173
* @param dt Instance of ac_range_check.
174
* @param alert A ac_range_check alert.
175
* @return The Alert Handler alert ID of the alert of this instance.
176
*/
177
dt_alert_id_t
dt_ac_range_check_alert_to_alert_id
(
178
dt_ac_range_check_t
dt,
179
dt_ac_range_check_alert_t
alert);
180
181
/**
182
* Convert a global alert ID to a local ac_range_check alert type.
183
*
184
* @param dt Instance of ac_range_check.
185
* @param alert A global alert ID that belongs to this instance.
186
* @return The ac_range_check alert, or `kDtAcRangeCheckAlertCount`.
187
*
188
* **Note:** This function assumes that the global alert ID belongs to the
189
* instance of ac_range_check passed in parameter. In other words, it must be the case
190
* that `dt_ac_range_check_instance_id(dt) == dt_alert_id_to_instance_id(alert)`. Otherwise,
191
* this function will return `kDtAcRangeCheckAlertCount`.
192
*/
193
dt_ac_range_check_alert_t
dt_ac_range_check_alert_from_alert_id
(
194
dt_ac_range_check_t
dt,
195
dt_alert_id_t
alert);
196
197
198
199
/**
200
* Get the clock signal connected to a clock port of an instance.
201
*
202
* @param dt Instance of ac_range_check.
203
* @param clk Clock port.
204
* @return Clock signal.
205
*/
206
dt_clock_t
dt_ac_range_check_clock
(
207
dt_ac_range_check_t
dt,
208
dt_ac_range_check_clock_t
clk);
209
210
/**
211
* Get the reset signal connected to a reset port of an instance.
212
*
213
* @param dt Instance of ac_range_check.
214
* @param rst Reset port.
215
* @return Reset signal.
216
*/
217
dt_reset_t
dt_ac_range_check_reset
(
218
dt_ac_range_check_t
dt,
219
dt_ac_range_check_reset_t
rst);
220
221
222
223
#ifdef __cplusplus
224
}
// extern "C"
225
#endif
// __cplusplus
226
227
#endif
// OPENTITAN_DT_AC_RANGE_CHECK_H_
(darjeeling)
hw
top
dt
dt_ac_range_check.h
Return to
OpenTitan Documentation