SDCR, Secure Debug Control Register
The SDCR characteristics are:
Purpose
Provides EL3 configuration options for self-hosted debug, trace, and the Performance Monitors Extension.
Configuration
AArch32 System register SDCR bits [31:0] can be mapped to AArch64 System register MDCR_EL3[31:0] , but this is not architecturally mandated.
Some or all RW fields of this register have defined reset values. These apply whenever the register is accessible. This means they apply when the PE resets into EL3 using AArch32.
Attributes
SDCR is a 32-bit register.
Field descriptions
The SDCR bit assignments are:
Bits [31:24]
Reserved, RES0.
SCCD, bit [23]
When ARMv8.5-PMU is implemented:
When ARMv8.5-PMU is implemented:
Secure Cycle Counter Disable. Prohibits PMCCNTR from counting in Secure state.
SCCD | Meaning |
---|---|
0b0 |
Cycle counting by PMCCNTR is not affected by this bit. |
0b1 |
Cycle counting by PMCCNTR is prohibited in Secure state. |
This bit does not affect the CPU_CYCLES event or any other event that counts cycles.
In a system where the PE resets into EL3, this field resets to 0.
Otherwise:
Otherwise:
Reserved, RES0.
Bit [22]
Reserved, RES0.
EPMAD, bit [21]
When ARMv8.4-Debug is implemented and PMUv3 is implemented:
When ARMv8.4-Debug is implemented and PMUv3 is implemented:
External Performance Monitors Non-secure access disable. Controls Non-secure access to Performance Monitors registers by an external debugger.
EPMAD | Meaning |
---|---|
0b0 |
Non-secure access to the Performance Monitors registers from an external debugger is permitted. |
0b1 |
Non-secure access to the Performance Monitors registers from an external debugger is not permitted. |
If the Performance Monitors Extension does not support external debug interface accesses this bit is RES0.
Otherwise, if EL3 is not implemented and the Effective value of SCR.NS is 0b0, then the Effective value of this field is 0b1.
In a system where the PE resets into EL3, this field resets to 0.
When PMUv3 is implemented:
When PMUv3 is implemented:
External Performance Monitors access disable. Controls access to Performance Monitors registers by an external debugger.
EPMAD | Meaning |
---|---|
0b0 |
Access to Performance Monitors registers from an external debugger is permitted. |
0b1 |
Access to Performance Monitors registers from an external debugger is not permitted, unless overridden by the IMPLEMENTATION DEFINED authentication interface. |
If the Performance Monitors Extension does not support external debug interface accesses this bit is RES0.
Otherwise, if EL3 is not implemented and the Effective value of SCR.NS is 0b0, then the Effective value of this field is 0b1.
In a system where the PE resets into EL3, this field resets to 0.
Otherwise:
Otherwise:
Reserved, RES0.
EDAD, bit [20]
When ARMv8.4-Debug is implemented:
When ARMv8.4-Debug is implemented:
External debug Non-secure access disable. Controls Non-secure access to breakpoint, watchpoint, and OSLAR_EL1 registers by an external debugger.
EDAD | Meaning |
---|---|
0b0 |
Non-secure access to debug registers from an external debugger is permitted. |
0b1 |
Non-secure access to breakpoint registers, watchpoint registers, and OSLAR_EL1 from an external debugger is not permitted. |
If EL3 is not implemented and the Effective value of SCR.NS is 0b0, then the Effective value of this field is 0b1.
In a system where the PE resets into EL3, this field resets to 0.
When ARMv8.2-Debug is implemented:
When ARMv8.2-Debug is implemented:
External debug access disable. Controls access to breakpoint, watchpoint, and OSLAR_EL1 registers by an external debugger.
EDAD | Meaning |
---|---|
0b0 |
Access to debug registers from an external debugger is permitted. |
0b1 |
Access to breakpoint registers, watchpoint registers and OSLAR_EL1 from an external debugger is not permitted, unless overridden by the IMPLEMENTATION DEFINED authentication interface. |
If EL3 is not implemented and the Effective value of SCR.NS is 0b0, then the Effective value of this field is 0b1.
In a system where the PE resets into EL3, this field resets to 0.
Otherwise:
Otherwise:
External debug access disable. Controls access to breakpoint, watchpoint, and optionally OSLAR_EL1 registers by an external debugger.
EDAD | Meaning |
---|---|
0b0 |
Access to debug registers from an external debugger is permitted. |
0b1 |
Access to breakpoint registers and watchpoint registers from an external debugger is not permitted, unless overridden by the IMPLEMENTATION DEFINED authentication interface. It is IMPLEMENTATION DEFINED whether access to the OSLAR_EL1 register from an external debugger is permitted or not permitted. |
If EL3 is not implemented and the Effective value of SCR.NS is 0b0, then the Effective value of this field is 0b1.
In a system where the PE resets into EL3, this field resets to 0.
TTRF, bit [19]
When ARMv8.4-Trace is implemented:
When ARMv8.4-Trace is implemented:
Trap Trace Filter controls. Controls whether accesses at EL2 and EL1 to the trace filter control registers are trapped to EL3.
TTRF | Meaning |
---|---|
0b0 |
Accesses to HTRFCR and TRFCR registers are not affected by this control bit. |
0b1 |
When not in Monitor mode, accesses to HTRFCR and TRFCR registers generate a Monitor Trap exception, unless the access generates a higher priority exception. |
In a system where the PE resets into EL3, this field resets to 0.
Otherwise:
Otherwise:
Reserved, RES0.
STE, bit [18]
When ARMv8.4-Trace is implemented:
When ARMv8.4-Trace is implemented:
Secure Trace Enable. This bit enables tracing in Secure state and controls the level of authentication required by an external debugger to enable external tracing.
STE | Meaning |
---|---|
0b0 |
Trace is prohibited in Secure state unless overridden by the IMPLEMENTATION DEFINED authentication interface. |
0b1 |
Trace in Secure state is not affected by this bit. |
This bit also controls the level of authentication required by an external debugger to enable external tracing. See 'Register controls to enable self-hosted trace' in the Arm® Architecture Reference Manual, Armv8, for Armv8-A architecture profile.
If EL3 is not implemented and the Effective value of SCR.NS is 0b0, the PE behaves as if this bit is set to 0b1.
In a system where the PE resets into EL3, this field resets to 0.
Otherwise:
Otherwise:
Reserved, RES0.
SPME, bit [17]
When ARMv8.2-Debug is implemented and PMUv3 is implemented:
When ARMv8.2-Debug is implemented and PMUv3 is implemented:
Secure Performance Monitors enable. This allows event counting in Secure state.
SPME | Meaning |
---|---|
0b0 |
Event counting prohibited in Secure state. |
0b1 |
Event counting allowed in Secure state. |
If EL3 is not implemented and the Effective value of SCR.NS is 0b0, then the Effective value of this bit is 0b1.
In a system where the PE resets into EL3, this field resets to 0.
When PMUv3 is implemented:
When PMUv3 is implemented:
Secure Performance Monitors enable. This allows event counting in Secure state.
SPME | Meaning |
---|---|
0b0 |
Event counting prohibited in Secure state, unless ExternalSecureNoninvasiveDebugEnabled() is TRUE. |
0b1 |
Event counting allowed in Secure state. |
If EL3 is not implemented and the Effective value of SCR.NS is 0b0, then the Effective value of this bit is 0b1.
In a system where the PE resets into EL3, this field resets to 0.
Otherwise:
Otherwise:
Reserved, RES0.
Bit [16]
Reserved, RES0.
SPD, bits [15:14]
AArch32 Secure self-hosted Privileged Debug. Enables or disables debug exceptions from EL3, other than Breakpoint Instruction exceptions
SPD | Meaning |
---|---|
0b00 |
Legacy mode. Debug exceptions from EL3 are enabled by the authentication interface. |
0b10 |
Secure privileged debug disabled. Debug exceptions from EL3 are disabled. |
0b11 |
Secure privileged debug enabled. Debug exceptions from EL3 are enabled. |
Other values are reserved, and have the CONSTRAINED UNPREDICTABLE behavior that they must have the same behavior as 0b00. Software must not rely on this property as the behavior of reserved values might change in a future revision of the architecture.
This field has no effect on Breakpoint Instruction exceptions. These are always enabled.
This field is ignored in Non-secure state.
If debug exceptions from EL3 are enabled, then debug exceptions from Secure EL0 are also enabled.
Otherwise, debug exceptions from Secure EL0 are enabled only if the value of SDER.SUIDEN is 0b1.
If EL3 is not implemented and the Effective value of SCR.NS is 0b0, then the Effective value of this field is 0b11.
In a system where the PE resets into EL3, this field resets to 0.
Bits [13:0]
Reserved, RES0.
Accessing the SDCR
Accesses to this register use the following encodings:
MRC{<c>}{<q>} <coproc>, {#}<opc1>, <Rt>, <CRn>, <CRm>{, {#}<opc2>}
coproc | opc1 | CRn | CRm | opc2 |
---|---|---|---|---|
0b1111 | 0b000 | 0b0001 | 0b0011 | 0b001 |
if PSTATE.EL == EL0 then UNDEFINED; elsif PSTATE.EL == EL1 then if EL2Enabled() && !ELUsingAArch32(EL2) && HSTR_EL2.T1 == '1' then AArch64.AArch32SystemAccessTrap(EL2, 0x03); elsif EL2Enabled() && ELUsingAArch32(EL2) && HSTR.T1 == '1' then AArch32.TakeHypTrapException(0x03); elsif !ELUsingAArch32(EL2) && SCR_EL3.<NS,EEL2> == '01' then AArch64.AArch32SystemAccessTrap(EL2, 0x03); elsif !ELUsingAArch32(EL3) && SCR_EL3.NS == '0' then AArch64.AArch32SystemAccessTrap(EL3, 0x03); else UNDEFINED; elsif PSTATE.EL == EL2 then UNDEFINED; elsif PSTATE.EL == EL3 then return SDCR;
MCR{<c>}{<q>} <coproc>, {#}<opc1>, <Rt>, <CRn>, <CRm>{, {#}<opc2>}
coproc | opc1 | CRn | CRm | opc2 |
---|---|---|---|---|
0b1111 | 0b000 | 0b0001 | 0b0011 | 0b001 |
if PSTATE.EL == EL0 then UNDEFINED; elsif PSTATE.EL == EL1 then if EL2Enabled() && !ELUsingAArch32(EL2) && HSTR_EL2.T1 == '1' then AArch64.AArch32SystemAccessTrap(EL2, 0x03); elsif EL2Enabled() && ELUsingAArch32(EL2) && HSTR.T1 == '1' then AArch32.TakeHypTrapException(0x03); elsif !ELUsingAArch32(EL2) && SCR_EL3.<NS,EEL2> == '01' then AArch64.AArch32SystemAccessTrap(EL2, 0x03); elsif !ELUsingAArch32(EL3) && SCR_EL3.NS == '0' then AArch64.AArch32SystemAccessTrap(EL3, 0x03); else UNDEFINED; elsif PSTATE.EL == EL2 then UNDEFINED; elsif PSTATE.EL == EL3 then if SCR.NS == '0' && CP15SDISABLE2 == HIGH then UNDEFINED; else SDCR = R[t];