libarch/arm64/
debug.rs

1// Copyright 2026 The Fuchsia Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5use bitrs::layout;
6use regio::arm64::{SysReg, spec};
7
8/// The number of registers in each of the `DBGB{C,V}R<n>_EL1` and
9/// `DBGW{C,V}R<n>_EL1` banks; the count actually implemented is reported by
10/// `ID_AA64DFR0_EL1`.
11pub const DEBUG_BANK_SIZE: usize = 16;
12
13layout!({
14    /// The layout of `DBGBCR<n>_EL1`.
15    pub struct BreakpointControlRegister(u64);
16    {
17        let __ @ 63..24;
18        let bt @ 23..20; // Breakpoint type
19        let lbn @ 19..16; // Linked breakpoint number
20        let ssc @ 15..14; // Security state control
21        let hmc @ 13; // Higher mode control
22        let __ @ 12..9;
23        let bas @ 8..5; // Byte address select
24        let __ @ 4..3;
25        let pmc @ 2..1; // Privilege mode control
26        let e @ 0; // Enable
27    }
28});
29
30layout!({
31    /// The layout of `DBGWCR<n>_EL1`.
32    pub struct WatchpointControlRegister(u64);
33    {
34        let __ @ 63..29;
35        let mask @ 28..24; // Address mask
36        let __ @ 23..21;
37        let wt @ 20; // Watchpoint type
38        let lbn @ 19..16; // Linked breakpoint number
39        let ssc @ 15..14; // Security state control
40        let hmc @ 13; // Higher mode control
41        let bas @ 12..5; // Byte address select
42        let lsc @ 4..3; // Load/store control
43        let pac @ 2..1; // Privilege access control
44        let e @ 0; // Enable
45    }
46});
47
48// Stamps out the consts of an indexed register bank, along with accessors
49// dispatching on a runtime index. Register instances are distinct types, so a
50// bank cannot be an array.
51macro_rules! sysreg_bank {
52    (
53        $doc:literal, $layout:ty, $read:ident, $write:ident;
54        $($n:literal => $name:ident),* $(,)?
55    ) => {
56        $(
57            #[doc = $doc]
58            pub const $name: SysReg<spec::$name, $layout> = SysReg::new();
59        )*
60
61        /// Reads register `n` of the bank.
62        ///
63        /// Panics if `n` is not below [`DEBUG_BANK_SIZE`].
64        #[cfg(target_arch = "aarch64")]
65        #[inline]
66        pub fn $read(n: usize) -> $layout {
67            match n {
68                $($n => $name.read(),)*
69                _ => panic!("debug register index {n} out of range"),
70            }
71        }
72
73        /// Writes register `n` of the bank.
74        ///
75        /// Panics if `n` is not below [`DEBUG_BANK_SIZE`].
76        #[cfg(target_arch = "aarch64")]
77        #[inline]
78        pub fn $write(n: usize, value: $layout) {
79            match n {
80                $($n => $name.write(value),)*
81                _ => panic!("debug register index {n} out of range"),
82            }
83        }
84    };
85}
86
87sysreg_bank!(
88    "[arm/sysreg]/dbgbcrn_el1: DBGBCR<n>_EL1, Debug Breakpoint Control Registers",
89    BreakpointControlRegister, read_dbgbcr, write_dbgbcr;
90    0 => DBGBCR0_EL1, 1 => DBGBCR1_EL1, 2 => DBGBCR2_EL1, 3 => DBGBCR3_EL1,
91    4 => DBGBCR4_EL1, 5 => DBGBCR5_EL1, 6 => DBGBCR6_EL1, 7 => DBGBCR7_EL1,
92    8 => DBGBCR8_EL1, 9 => DBGBCR9_EL1, 10 => DBGBCR10_EL1, 11 => DBGBCR11_EL1,
93    12 => DBGBCR12_EL1, 13 => DBGBCR13_EL1, 14 => DBGBCR14_EL1, 15 => DBGBCR15_EL1,
94);
95
96sysreg_bank!(
97    "[arm/sysreg]/dbgbvrn_el1: DBGBVR<n>_EL1, Debug Breakpoint Value Registers",
98    u64, read_dbgbvr, write_dbgbvr;
99    0 => DBGBVR0_EL1, 1 => DBGBVR1_EL1, 2 => DBGBVR2_EL1, 3 => DBGBVR3_EL1,
100    4 => DBGBVR4_EL1, 5 => DBGBVR5_EL1, 6 => DBGBVR6_EL1, 7 => DBGBVR7_EL1,
101    8 => DBGBVR8_EL1, 9 => DBGBVR9_EL1, 10 => DBGBVR10_EL1, 11 => DBGBVR11_EL1,
102    12 => DBGBVR12_EL1, 13 => DBGBVR13_EL1, 14 => DBGBVR14_EL1, 15 => DBGBVR15_EL1,
103);
104
105sysreg_bank!(
106    "[arm/sysreg]/dbgwcrn_el1: DBGWCR<n>_EL1, Debug Watchpoint Control Registers",
107    WatchpointControlRegister, read_dbgwcr, write_dbgwcr;
108    0 => DBGWCR0_EL1, 1 => DBGWCR1_EL1, 2 => DBGWCR2_EL1, 3 => DBGWCR3_EL1,
109    4 => DBGWCR4_EL1, 5 => DBGWCR5_EL1, 6 => DBGWCR6_EL1, 7 => DBGWCR7_EL1,
110    8 => DBGWCR8_EL1, 9 => DBGWCR9_EL1, 10 => DBGWCR10_EL1, 11 => DBGWCR11_EL1,
111    12 => DBGWCR12_EL1, 13 => DBGWCR13_EL1, 14 => DBGWCR14_EL1, 15 => DBGWCR15_EL1,
112);
113
114sysreg_bank!(
115    "[arm/sysreg]/dbgwvrn_el1: DBGWVR<n>_EL1, Debug Watchpoint Value Registers",
116    u64, read_dbgwvr, write_dbgwvr;
117    0 => DBGWVR0_EL1, 1 => DBGWVR1_EL1, 2 => DBGWVR2_EL1, 3 => DBGWVR3_EL1,
118    4 => DBGWVR4_EL1, 5 => DBGWVR5_EL1, 6 => DBGWVR6_EL1, 7 => DBGWVR7_EL1,
119    8 => DBGWVR8_EL1, 9 => DBGWVR9_EL1, 10 => DBGWVR10_EL1, 11 => DBGWVR11_EL1,
120    12 => DBGWVR12_EL1, 13 => DBGWVR13_EL1, 14 => DBGWVR14_EL1, 15 => DBGWVR15_EL1,
121);
122
123/// [arm/sysreg]/mdscr_el1: Monitor Debug System Control Register
124pub const MDSCR_EL1: SysReg<spec::MDSCR_EL1, MonitorDebugSystemControlRegister> = SysReg::new();
125
126layout!({
127    /// The layout of [`MDSCR_EL1`].
128    pub struct MonitorDebugSystemControlRegister(u64);
129    {
130        let __ @ 63..36;
131        let ehbwe @ 35;
132        let enspm @ 34;
133        let tta @ 33;
134        let embwe @ 32;
135        let tfo @ 31; // EDSCR.TFO save/restore (FEAT_TRF)
136        let rxfull @ 30; // EDSCR.RXfull save/restore
137        let txfull @ 29; // EDSCR.TXfull save/restore
138        let __ @ 28;
139        let rxo @ 27; // EDSCR.RXO save/restore
140        let txu @ 26; // EDSCR.TXU save/restore
141        let __ @ 25..24;
142        let intdis @ 23..22; // EDSCR.INTdis save/restore
143        let tda @ 21; // EDSCR.TDA save/restore
144        let __ @ 20;
145        let sc2 @ 19;
146        let __ @ 18..16;
147        let mde @ 15; // Monitor debug events
148        let hde @ 14; // EDSCR.HDE save/restore
149        let kde @ 13; // Local (kernel) debug enable
150        let tdcc @ 12; // Trap EL0 accesses to the DCC registers
151        let __ @ 11..7;
152        let err @ 6; // EDSCR.ERR save/restore
153        let __ @ 5..1;
154        let ss @ 0; // Software step
155    }
156});
libarch/arm64/debug.rs

libarch/arm64/
debug.rs
