Struct Select

pub struct Select(pub u32);

SELECT, AP Select register (see ADI v5.2 B2.2.9)

Tuple Fields

0: u32

Implementations

impl Select

pub fn ap_sel(&self) -> u8

Selects the AP with the ID number APSEL. If there is no AP with the ID APSEL, all AP transactions return zero on reads and are ignored on writes. See Register maps, and accesses to reserved addresses on page B2-52. After a powerup reset, the value of this field is UNKNOWN. Note Every Arm Debug Interface implementation must include at least one AP.

pub fn ap_bank_sel(&self) -> u8

Selects the active four-word register bank on the current AP. See Using the AP to access debug resources on page A1-31. After a powerup reset, the value of this field is UNKNOWN.

pub fn dp_bank_sel(&self) -> u8

Debug Port address bank select. The behavior of SELECT.DPBANKSEL depends on the DP version, as follows: DPv0 In DPv0 the SELECT.DPBANKSEL field must be written as zero, otherwise accesses to DP register 0x4 are UNPREDICTABLE. DPv1 In DPv1 the SELECT.DPBANKSEL field controls which DP register is selected at address 0x4, and Table B2-10 shows the permitted values of this field. Table B2-10 DPBANKSEL DP register allocation in DPv1 DPBANKSEL DP register at address 0x4

• 0x0 CTRL/STAT
• 0x1 DLCR All other values of SELECT.DPBANKSEL are reserved. If the field is set to a reserved value, accesses to DP register 0x4 are UNPREDICTABLE. DPv2 In DPv2 the SELECT.DPBANKSEL field controls which DP register is selected at address 0x4, and Table B2-11 shows the permitted values of this field. Table B2-11 DPBANKSEL DP register allocation in DPv2 DPBANKSEL DP register at address 0x4
• 0x0 CTRL/STAT
• 0x1 DLCR
• 0x2 TARGETID
• 0x3 DLPIDR
• 0x4 EVENTSTAT All other values of SELECT.DPBANKSEL are reserved. If the field is set to a reserved value, accesses to DP register 0x4 are RES0. After a powerup reset, this field is 0x0. Note Some previous ADI revisions have described DPBANKSEL as a single-bit field called CTRSEL, defined only for SW-DP. From issue B of this document, DPBANKSEL is redefined. The new definition is backwards-compatible.

pub fn set_ap_sel(&mut self, value: u8)

Selects the AP with the ID number APSEL. If there is no AP with the ID APSEL, all AP transactions return zero on reads and are ignored on writes. See Register maps, and accesses to reserved addresses on page B2-52. After a powerup reset, the value of this field is UNKNOWN. Note Every Arm Debug Interface implementation must include at least one AP.

pub fn set_ap_bank_sel(&mut self, value: u8)

Selects the active four-word register bank on the current AP. See Using the AP to access debug resources on page A1-31. After a powerup reset, the value of this field is UNKNOWN.

pub fn set_dp_bank_sel(&mut self, value: u8)

Debug Port address bank select. The behavior of SELECT.DPBANKSEL depends on the DP version, as follows: DPv0 In DPv0 the SELECT.DPBANKSEL field must be written as zero, otherwise accesses to DP register 0x4 are UNPREDICTABLE. DPv1 In DPv1 the SELECT.DPBANKSEL field controls which DP register is selected at address 0x4, and Table B2-10 shows the permitted values of this field. Table B2-10 DPBANKSEL DP register allocation in DPv1 DPBANKSEL DP register at address 0x4

• 0x0 CTRL/STAT
• 0x1 DLCR All other values of SELECT.DPBANKSEL are reserved. If the field is set to a reserved value, accesses to DP register 0x4 are UNPREDICTABLE. DPv2 In DPv2 the SELECT.DPBANKSEL field controls which DP register is selected at address 0x4, and Table B2-11 shows the permitted values of this field. Table B2-11 DPBANKSEL DP register allocation in DPv2 DPBANKSEL DP register at address 0x4
• 0x0 CTRL/STAT
• 0x1 DLCR
• 0x2 TARGETID
• 0x3 DLPIDR
• 0x4 EVENTSTAT All other values of SELECT.DPBANKSEL are reserved. If the field is set to a reserved value, accesses to DP register 0x4 are RES0. After a powerup reset, this field is 0x0. Note Some previous ADI revisions have described DPBANKSEL as a single-bit field called CTRSEL, defined only for SW-DP. From issue B of this document, DPBANKSEL is redefined. The new definition is backwards-compatible.

Trait Implementations

impl<T> BitRange<T> for Select

where u32: BitRange<T>,

fn bit_range(&self, msb: usize, lsb: usize) -> T

Get a range of bits.

impl<T> BitRangeMut<T> for Select

where u32: BitRangeMut<T>,

fn set_bit_range(&mut self, msb: usize, lsb: usize, value: T)

Set a range of bits.

impl Clone for Select

fn clone(&self) -> Select

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Select

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DpRegister for Select

const VERSION: DebugPortVersion = DebugPortVersion::DPv1

The version of the debug port that is required to read this register.

impl From<Select> for u32

fn from(raw: Select) -> Self

Converts to this type from the input type.

impl Register for Select

const ADDRESS: u8 = 8u8

The address of the register (in bytes).

const NAME: &'static str = "SELECT"

The name of the register as string.

impl TryFrom<u32> for Select

type Error = RegisterParseError

The type returned in the event of a conversion error.

fn try_from(raw: u32) -> Result<Self, Self::Error>

Performs the conversion.