Struct RiscvCommunicationInterface

pub struct RiscvCommunicationInterface<'state> { /* private fields */ }

A interface that implements controls for RISC-V cores.

Implementations

impl<'state> RiscvCommunicationInterface<'state>

pub fn new( dtm: Box<dyn DtmAccess + 'state>, state: &'state mut RiscvCommunicationInterfaceState, ) -> Self

Creates a new RISC-V communication interface with a given probe driver.

pub fn select_hart(&mut self, hart: u32) -> Result<(), RiscvError>

Select current hart

pub fn hart_enabled(&self, hart: u32) -> bool

Check if the given hart is enabled

pub fn target_reset_assert(&mut self) -> Result<(), DebugProbeError>

Assert the target reset

pub fn target_reset_deassert(&mut self) -> Result<(), DebugProbeError>

Deassert the target reset.

pub fn read_idcode(&mut self) -> Result<Option<u32>, DebugProbeError>

Read the targets idcode used as hint for chip detection

pub fn read_csr_progbuf(&mut self, address: u16) -> Result<u32, RiscvError>

Read the CSR progbuf register.

pub fn write_csr_progbuf( &mut self, address: u16, value: u32, ) -> Result<(), RiscvError>

Write the CSR progbuf register.

Trait Implementations

impl<'state> Debug for RiscvCommunicationInterface<'state>

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

Formats the value using the given formatter.

impl MemoryInterface for RiscvCommunicationInterface<'_>

fn supports_native_64bit_access(&mut self) -> bool

Does this interface support native 64-bit wide accesses

fn read_word_64(&mut self, address: u64) -> Result<u64, Error>

Read a 64bit word of at address.

fn read_word_32(&mut self, address: u64) -> Result<u32, Error>

Read a 32bit word of at address.

fn read_word_16(&mut self, address: u64) -> Result<u16, Error>

Read a 16bit word of at address.

fn read_word_8(&mut self, address: u64) -> Result<u8, Error>

Read an 8bit word of at address.

fn read_64(&mut self, address: u64, data: &mut [u64]) -> Result<(), Error>

Read a block of 64bit words at address in the target’s endianness.

fn read_32(&mut self, address: u64, data: &mut [u32]) -> Result<(), Error>

Read a block of 32bit words at address in the target’s endianness.

fn read_16(&mut self, address: u64, data: &mut [u16]) -> Result<(), Error>

Read a block of 16bit words at address in the target’s endianness.

fn read_8(&mut self, address: u64, data: &mut [u8]) -> Result<(), Error>

Read a block of 8bit words at address.

fn read(&mut self, address: u64, data: &mut [u8]) -> Result<(), Error>

Read data from address.

fn write_word_64(&mut self, address: u64, data: u64) -> Result<(), Error>

Write a 64bit word at address.

fn write_word_32(&mut self, address: u64, data: u32) -> Result<(), Error>

Write a 32bit word at address.

fn write_word_16(&mut self, address: u64, data: u16) -> Result<(), Error>

Write a 16bit word at address.

fn write_word_8(&mut self, address: u64, data: u8) -> Result<(), Error>

Write an 8bit word at address.

fn write_64(&mut self, address: u64, data: &[u64]) -> Result<(), Error>

Write a block of 64bit words at address in the target’s endianness.

fn write_32(&mut self, address: u64, data: &[u32]) -> Result<(), Error>

Write a block of 32bit words at address in the target’s endianness.

fn write_16(&mut self, address: u64, data: &[u16]) -> Result<(), Error>

Write a block of 16bit words at address in the target’s endianness.

fn write_8(&mut self, address: u64, data: &[u8]) -> Result<(), Error>

Write a block of 8bit words at address.

fn write(&mut self, address: u64, data: &[u8]) -> Result<(), Error>

Write a block of 8bit words at address. May use 64 bit memory access, so should only be used if reading memory locations that don’t have side effects. Generally faster than MemoryInterface::write_8.

fn supports_8bit_transfers(&self) -> Result<bool, Error>

Returns whether the current platform supports native 8bit transfers.

fn flush(&mut self) -> Result<(), Error>

Flush any outstanding operations.

fn read_mem_64bit(&mut self, address: u64, data: &mut [u8]) -> Result<(), ERR>

Reads bytes using 64 bit memory access.

fn read_mem_32bit(&mut self, address: u64, data: &mut [u8]) -> Result<(), ERR>

Reads bytes using 32 bit memory access.

fn write_mem_64bit(&mut self, address: u64, data: &[u8]) -> Result<(), ERR>

Writes bytes using 64 bit memory access. Address must be 64 bit aligned and data must be an exact multiple of 8.

fn write_mem_32bit(&mut self, address: u64, data: &[u8]) -> Result<(), ERR>

Writes bytes using 32 bit memory access. Address must be 32 bit aligned and data must be an exact multiple of 8.