Software APIs
otbn_regs.h
Go to the documentation of this file.
1/**
2 * @file
3 * @brief Generated register defines for otbn
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 _OTBN_REG_DEFS_
14#define _OTBN_REG_DEFS_
15
16#ifdef __cplusplus
17extern "C" {
18#endif
19// Number of alerts
20#define OTBN_PARAM_NUM_ALERTS 2
21
22// Register width
23#define OTBN_PARAM_REG_WIDTH 32
24
25// Common Interrupt Offsets
26#define OTBN_INTR_COMMON_DONE_BIT 0
27
28// Interrupt State Register
29#define OTBN_INTR_STATE_REG_OFFSET 0x0
30#define OTBN_INTR_STATE_REG_RESVAL 0x0u
31#define OTBN_INTR_STATE_DONE_BIT 0
32
33// Interrupt Enable Register
34#define OTBN_INTR_ENABLE_REG_OFFSET 0x4
35#define OTBN_INTR_ENABLE_REG_RESVAL 0x0u
36#define OTBN_INTR_ENABLE_DONE_BIT 0
37
38// Interrupt Test Register
39#define OTBN_INTR_TEST_REG_OFFSET 0x8
40#define OTBN_INTR_TEST_REG_RESVAL 0x0u
41#define OTBN_INTR_TEST_DONE_BIT 0
42
43// Alert Test Register
44#define OTBN_ALERT_TEST_REG_OFFSET 0xc
45#define OTBN_ALERT_TEST_REG_RESVAL 0x0u
46#define OTBN_ALERT_TEST_FATAL_BIT 0
47#define OTBN_ALERT_TEST_RECOV_BIT 1
48
49// Command Register
50#define OTBN_CMD_REG_OFFSET 0x10
51#define OTBN_CMD_REG_RESVAL 0x0u
52#define OTBN_CMD_CMD_MASK 0xffu
53#define OTBN_CMD_CMD_OFFSET 0
54#define OTBN_CMD_CMD_FIELD \
55 ((bitfield_field32_t) { .mask = OTBN_CMD_CMD_MASK, .index = OTBN_CMD_CMD_OFFSET })
56
57// Control Register
58#define OTBN_CTRL_REG_OFFSET 0x14
59#define OTBN_CTRL_REG_RESVAL 0x0u
60#define OTBN_CTRL_SOFTWARE_ERRS_FATAL_BIT 0
61
62// Status Register
63#define OTBN_STATUS_REG_OFFSET 0x18
64#define OTBN_STATUS_REG_RESVAL 0x4u
65#define OTBN_STATUS_STATUS_MASK 0xffu
66#define OTBN_STATUS_STATUS_OFFSET 0
67#define OTBN_STATUS_STATUS_FIELD \
68 ((bitfield_field32_t) { .mask = OTBN_STATUS_STATUS_MASK, .index = OTBN_STATUS_STATUS_OFFSET })
69
70// Operation Result Register
71#define OTBN_ERR_BITS_REG_OFFSET 0x1c
72#define OTBN_ERR_BITS_REG_RESVAL 0x0u
73#define OTBN_ERR_BITS_BAD_DATA_ADDR_BIT 0
74#define OTBN_ERR_BITS_BAD_INSN_ADDR_BIT 1
75#define OTBN_ERR_BITS_CALL_STACK_BIT 2
76#define OTBN_ERR_BITS_ILLEGAL_INSN_BIT 3
77#define OTBN_ERR_BITS_LOOP_BIT 4
78#define OTBN_ERR_BITS_KEY_INVALID_BIT 5
79#define OTBN_ERR_BITS_RND_REP_CHK_FAIL_BIT 6
80#define OTBN_ERR_BITS_RND_FIPS_CHK_FAIL_BIT 7
81#define OTBN_ERR_BITS_MAI_SOFTWARE_ERROR_BIT 8
82#define OTBN_ERR_BITS_IMEM_INTG_VIOLATION_BIT 16
83#define OTBN_ERR_BITS_DMEM_INTG_VIOLATION_BIT 17
84#define OTBN_ERR_BITS_REG_INTG_VIOLATION_BIT 18
85#define OTBN_ERR_BITS_BUS_INTG_VIOLATION_BIT 19
86#define OTBN_ERR_BITS_BAD_INTERNAL_STATE_BIT 20
87#define OTBN_ERR_BITS_ILLEGAL_BUS_ACCESS_BIT 21
88#define OTBN_ERR_BITS_LIFECYCLE_ESCALATION_BIT 22
89#define OTBN_ERR_BITS_FATAL_SOFTWARE_BIT 23
90
91// Fatal Alert Cause Register
92#define OTBN_FATAL_ALERT_CAUSE_REG_OFFSET 0x20
93#define OTBN_FATAL_ALERT_CAUSE_REG_RESVAL 0x0u
94#define OTBN_FATAL_ALERT_CAUSE_IMEM_INTG_VIOLATION_BIT 0
95#define OTBN_FATAL_ALERT_CAUSE_DMEM_INTG_VIOLATION_BIT 1
96#define OTBN_FATAL_ALERT_CAUSE_REG_INTG_VIOLATION_BIT 2
97#define OTBN_FATAL_ALERT_CAUSE_BUS_INTG_VIOLATION_BIT 3
98#define OTBN_FATAL_ALERT_CAUSE_BAD_INTERNAL_STATE_BIT 4
99#define OTBN_FATAL_ALERT_CAUSE_ILLEGAL_BUS_ACCESS_BIT 5
100#define OTBN_FATAL_ALERT_CAUSE_LIFECYCLE_ESCALATION_BIT 6
101#define OTBN_FATAL_ALERT_CAUSE_FATAL_SOFTWARE_BIT 7
102
103// Instruction Count Register
104#define OTBN_INSN_CNT_REG_OFFSET 0x24
105#define OTBN_INSN_CNT_REG_RESVAL 0x0u
106
107// A 32-bit CRC checksum of data written to memory
108#define OTBN_LOAD_CHECKSUM_REG_OFFSET 0x28
109#define OTBN_LOAD_CHECKSUM_REG_RESVAL 0x0u
110
111// Memory area: Instruction Memory Access
112#define OTBN_IMEM_REG_OFFSET 0x4000
113#define OTBN_IMEM_SIZE_WORDS 4096
114#define OTBN_IMEM_SIZE_BYTES 16384
115// Memory area: Data Memory Access
116#define OTBN_DMEM_REG_OFFSET 0x8000
117#define OTBN_DMEM_SIZE_WORDS 4096
118#define OTBN_DMEM_SIZE_BYTES 16384
119#ifdef __cplusplus
120} // extern "C"
121#endif
122#endif // _OTBN_REG_DEFS_
123// End generated register defines for otbn