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_IMEM_INTG_VIOLATION_BIT 16
82#define OTBN_ERR_BITS_DMEM_INTG_VIOLATION_BIT 17
83#define OTBN_ERR_BITS_REG_INTG_VIOLATION_BIT 18
84#define OTBN_ERR_BITS_BUS_INTG_VIOLATION_BIT 19
85#define OTBN_ERR_BITS_BAD_INTERNAL_STATE_BIT 20
86#define OTBN_ERR_BITS_ILLEGAL_BUS_ACCESS_BIT 21
87#define OTBN_ERR_BITS_LIFECYCLE_ESCALATION_BIT 22
88#define OTBN_ERR_BITS_FATAL_SOFTWARE_BIT 23
89
90// Fatal Alert Cause Register
91#define OTBN_FATAL_ALERT_CAUSE_REG_OFFSET 0x20
92#define OTBN_FATAL_ALERT_CAUSE_REG_RESVAL 0x0u
93#define OTBN_FATAL_ALERT_CAUSE_IMEM_INTG_VIOLATION_BIT 0
94#define OTBN_FATAL_ALERT_CAUSE_DMEM_INTG_VIOLATION_BIT 1
95#define OTBN_FATAL_ALERT_CAUSE_REG_INTG_VIOLATION_BIT 2
96#define OTBN_FATAL_ALERT_CAUSE_BUS_INTG_VIOLATION_BIT 3
97#define OTBN_FATAL_ALERT_CAUSE_BAD_INTERNAL_STATE_BIT 4
98#define OTBN_FATAL_ALERT_CAUSE_ILLEGAL_BUS_ACCESS_BIT 5
99#define OTBN_FATAL_ALERT_CAUSE_LIFECYCLE_ESCALATION_BIT 6
100#define OTBN_FATAL_ALERT_CAUSE_FATAL_SOFTWARE_BIT 7
101
102// Instruction Count Register
103#define OTBN_INSN_CNT_REG_OFFSET 0x24
104#define OTBN_INSN_CNT_REG_RESVAL 0x0u
105
106// A 32-bit CRC checksum of data written to memory
107#define OTBN_LOAD_CHECKSUM_REG_OFFSET 0x28
108#define OTBN_LOAD_CHECKSUM_REG_RESVAL 0x0u
109
110// Memory area: Instruction Memory Access
111#define OTBN_IMEM_REG_OFFSET 0x4000
112#define OTBN_IMEM_SIZE_WORDS 2048
113#define OTBN_IMEM_SIZE_BYTES 8192
114// Memory area: Data Memory Access
115#define OTBN_DMEM_REG_OFFSET 0x8000
116#define OTBN_DMEM_SIZE_WORDS 768
117#define OTBN_DMEM_SIZE_BYTES 3072
118#ifdef __cplusplus
119} // extern "C"
120#endif
121#endif // _OTBN_REG_DEFS_
122// End generated register defines for otbn