EDSCR, External Debug Status and Control Register

The EDSCR characteristics are:

Purpose

Main control register for the debug implementation.

Configuration

External register EDSCR bits [30:29] are architecturally mapped to AArch64 System register MDCCSR_EL0[30:29].

EDSCR is in the Core power domain.

Attributes

EDSCR is a 32-bit register.

Field descriptions

313029282726252423222120191817161514131211109876543210
TFORXfullTXfullITORXOTXUPipeAdvITEINTdisTDAMASC2NSRES0SDDRES0HDERWELAERRSTATUS

TFO, bit [31]
When FEAT_TRF is implemented:

Trace Filter Override. Overrides the Trace Filter controls allowing the external debugger to trace any visible Exception level.

TFOMeaning
0b0

Trace Filter controls are not affected.

0b1

Trace Filter controls in TRFCR_EL1 and TRFCR_EL2 are ignored.

Trace Filter controls TRFCR and HTRFCR are ignored.

When OSLSR_EL1.OSLK == 1, this bit can be indirectly read and written through the MDSCR_EL1 and DBGDSCRext System registers.

This bit is ignored by the PE when ExternalSecureNoninvasiveDebugEnabled() == FALSE and the Effective value of MDCR_EL3.STE == 1.

The reset behavior of this field is:


Otherwise:

Reserved, RES0.

RXfull, bit [30]

DTRRX full.

The reset behavior of this field is:

Access to this field is RO.

TXfull, bit [29]

DTRTX full.

The reset behavior of this field is:

Access to this field is RO.

ITO, bit [28]

ITR overrun.

If the PE is in Non-debug state, this bit is UNKNOWN. ITO is set to 0 on entry to Debug state.

Access to this field is RO.

RXO, bit [27]

DTRRX overrun.

The reset behavior of this field is:

Access to this field is RO.

TXU, bit [26]

DTRTX underrun.

The reset behavior of this field is:

Access to this field is RO.

PipeAdv, bit [25]

Pipeline advance. Set to 1 every time the PE pipeline retires one or more instructions. Cleared to 0 by a write to EDRCR.CSPA.

The architecture does not define precisely when this bit is set to 1. It requires only that this happen periodically in Non-debug state to indicate that software execution is progressing.

Access to this field is RO.

ITE, bit [24]

ITR empty.

If the PE is in Non-debug state, this bit is UNKNOWN. It is always valid in Debug state.

Access to this field is RO.

INTdis, bits [23:22]
When FEAT_Debugv8p4 is implemented:

Interrupt disable. Disables taking interrupts in Non-debug state.

INTdisMeaning
0b00

Masking of interrupts is controlled by PSTATE and interrupt routing controls.

0b01

If ExternalInvasiveDebugEnabled() is TRUE, then all interrupts taken to Non-secure state are masked.

If ExternalSecureInvasiveDebugEnabled() is TRUE, then all interrupts taken to Secure state are masked.

Note

All interrupts includes virtual and SError interrupts.

When OSLSR_EL1.OSLK is 1, this field can be indirectly read and written through the MDSCR_EL1 and DBGDSCRext System registers.

The Effective value of this field is 0b00 when ExternalInvasiveDebugEnabled() is FALSE.

When FEAT_Debugv8p4 is implemented, bit[23] of this register is RES0.

The reset behavior of this field is:


Otherwise:

Interrupt disable. Disables taking interrupts in Non-debug state.

INTdisMeaning
0b00

Masking of interrupts is controlled by PSTATE and interrupt routing controls.

0b01

If ExternalInvasiveDebugEnabled() is TRUE, then all interrupts taken to Non-secure EL1 are masked.

0b10

If ExternalInvasiveDebugEnabled() is TRUE, then all interrupts taken to Non-secure state are masked.

If ExternalSecureInvasiveDebugEnabled() is TRUE, then all interrupts taken to Secure EL1 are masked.

0b11

If ExternalInvasiveDebugEnabled() is TRUE, then all interrupts taken to Non-secure state are masked.

If ExternalSecureInvasiveDebugEnabled() is TRUE, then all interrupts taken to Secure state are masked.

Note

All interrupts includes virtual and SError interrupts.

When OSLSR_EL1.OSLK is 1, this field can be indirectly read and written through the MDSCR_EL1 and DBGDSCRext System registers.

The Effective value of this field is 0b00 when ExternalInvasiveDebugEnabled() is FALSE.

Support for the values 0b01 and 0b10 is IMPLEMENTATION DEFINED. If these values are not supported, they are reserved. If programmed with a reserved value, the PE behaves as if INTdis has been programmed with a defined value, other than for a direct read of EDSCR, and the value returned by a read of EDSCR.INTdis is UNKNOWN.

The reset behavior of this field is:

TDA, bit [21]

Traps accesses to the following debug System registers:

The possible values of this field are:

TDAMeaning
0b0

Accesses to debug System registers do not generate a Software Access Debug event.

0b1

Accesses to debug System registers generate a Software Access Debug event, if OSLSR_EL1.OSLK is 0 and if halting is allowed.

The reset behavior of this field is:

MA, bit [20]

Memory access mode. Controls the use of memory-access mode for accessing ITR and the DCC. This bit is ignored if in Non-debug state and set to zero on entry to Debug state.

Possible values of this field are:

MAMeaning
0b0

Normal access mode.

0b1

Memory access mode.

The reset behavior of this field is:

SC2, bit [19]
When FEAT_PCSRv8 is implemented, (FEAT_VHE is implemented or FEAT_Debugv8p2 is implemented) and FEAT_PCSRv8p2 is not implemented:

Sample CONTEXTIDR_EL2. Controls whether the PC Sample-based Profiling Extension samples CONTEXTIDR_EL2 or VTTBR_EL2.VMID.

SC2Meaning
0b0

Sample VTTBR_EL2.VMID.

0b1

Sample CONTEXTIDR_EL2.

The reset behavior of this field is:


Otherwise:

Reserved, RES0.

NS, bit [18]

Non-secure status. When in Debug state, gives the current Security state:

NSMeaning
0b0

Secure state.

0b1

Non-secure state.

In Non-debug state, this bit is UNKNOWN.

Access to this field is RO.

Bit [17]

Reserved, RES0.

SDD, bit [16]

Secure debug disabled.

On entry to Debug state:

In Debug state, the value of the SDD bit does not change, even if ExternalSecureInvasiveDebugEnabled() changes.

In Non-debug state:

If EL3 is not implemented and the implementation is Non-secure, this bit is RES1.

Access to this field is RO.

Bit [15]

Reserved, RES0.

HDE, bit [14]

Halting debug enable. The possible values of this field are:

HDEMeaning
0b0

Halting disabled for Breakpoint, Watchpoint and Halt Instruction debug events.

0b1

Halting enabled for Breakpoint, Watchpoint and Halt Instruction debug events.

The reset behavior of this field is:

RW, bits [13:10]

Exception level Execution state status. In Debug state, each bit gives the current Execution state of each Exception level.

RWMeaningApplies when
0b1111

Any of the following:

  • The PE is in Non-debug state.

  • The PE is at EL0 using AArch64.

  • The PE is not at EL0, and EL1, EL2, and EL3 are using AArch64.

0b1110

The PE is in Debug state at EL0. EL0 is using AArch32. EL1, EL2, and EL3 are using AArch64.

When AArch32 is supported
0b110x

The PE is in Debug state. EL0 and EL1 are using AArch32. EL2 is enabled in the current Security state and is using AArch64. If implemented, EL3 is using AArch64.

When AArch32 is supported and EL2 is implemented
0b10xx

The PE is in Debug state. EL0 and EL1 are using AArch32. EL2 is not implemented, disabled in the current Security state, or using AArch32. EL3 is using AArch64.

When AArch32 is supported and EL3 is implemented
0b0xxx

The PE is in Debug state. All Exception levels are using AArch32.

When AArch32 is supported

In Non-debug state, this field is RAO.

Access to this field is RO.

EL, bits [9:8]

Exception level. In Debug state, this gives the current Exception level of the PE.

In Non-debug state, this field is RAZ.

Access to this field is RO.

A, bit [7]

SError interrupt pending. In Debug state, indicates whether an SError interrupt is pending:

AMeaning
0b0

No SError interrupt pending.

0b1

SError interrupt pending.

A debugger can read EDSCR to check whether an SError interrupt is pending without having to execute further instructions. A pending SError might indicate data from target memory is corrupted.

UNKNOWN in Non-debug state.

Access to this field is RO.

ERR, bit [6]

Cumulative error flag. This bit is set to 1 following exceptions in Debug state and on any signaled overrun or underrun on the DTR or EDITR.

The reset behavior of this field is:

Access to this field is RO.

STATUS, bits [5:0]

Debug status flags.

STATUSMeaning
0b000001

PE is restarting, exiting Debug state.

0b000010

PE is in Non-debug state.

0b000111

Breakpoint.

0b010011

External debug request.

0b011011

Halting step, normal.

0b011111

Halting step, exclusive.

0b100011

OS Unlock Catch.

0b100111

Reset Catch.

0b101011

Watchpoint.

0b101111

HLT instruction.

0b110011

Software access to debug register.

0b110111

Exception Catch.

0b111011

Halting step, no syndrome.

All other values of STATUS are reserved.

Access to this field is RO.

Accessing EDSCR

EDSCR can be accessed through the external debug interface:

ComponentOffsetInstance
Debug0x088EDSCR

This interface is accessible as follows:


20/09/2021 11:02; d4a233ffbdfb36e47856c443a7ce9a85f5e501ca

Copyright © 2010-2021 Arm Limited or its affiliates. All rights reserved. This document is Non-Confidential.