Struct opentitanlib::debug::elf_debugger::ElfDebugger

pub struct ElfDebugger<'a> { /* private fields */ }

Implementations

impl<'a> ElfDebugger<'a>

pub fn disconnect(self) -> Result<()>

pub fn resolve( &self, address: impl Into<SymbolicAddress> ) -> Result<ResolvedAddress>

pub fn read_reg(&mut self, reg: impl Into<RiscvReg>) -> Result<u32>

Read a RISC-V register.

This is a convience wrapper around read_riscv_reg provided by the JTAG trait.

pub fn write_reg(&mut self, reg: impl Into<RiscvReg>, value: u32) -> Result<()>

Write a RISC-V register.

This is a convience wrapper around write_riscv_reg provided by the JTAG trait.

pub fn read_u32(&mut self, addr: u32) -> Result<u32>

Read a 32-bit word from memory.

This is a convience wrapper around read_memory32 provided by the JTAG trait.

pub fn write_u32(&mut self, addr: u32, value: u32) -> Result<()>

Write a 32-bit word to memory.

This is a convience wrapper around write_memory32 provided by the JTAG trait.

pub fn get_pc(&mut self) -> Result<u32>

Read the program counter.

pub fn set_pc(&mut self, address: impl Into<SymbolicAddress>) -> Result<()>

Set the program counter to the given address.

pub fn set_breakpoint( &mut self, address: impl Into<SymbolicAddress> ) -> Result<()>

Set a breakpoint at the given address.

pub fn expect_pc(&mut self, address: impl Into<SymbolicAddress>) -> Result<()>

Assert the current program counter is at the given address.

pub fn expect_pc_range( &mut self, range: Range<impl Into<SymbolicAddress>> ) -> Result<()>

Assert the current program counter is within the given range.

pub fn run_until( &mut self, address: impl Into<SymbolicAddress>, timeout: Duration ) -> Result<()>

Continue execution until the address is hit.

Note that a breakpoint must not already exist for the target address, otherwise this function will fail.

This function will also fail if a pre-existing breakpoint is hit before the target address is hit.

pub fn finish(&mut self, timeout: Duration) -> Result<()>

Execute until the current function returns.

This implementation does not use the debugging information from ELF files, and only uses the RA register, so it only works when RA has not been overriden, e.g. at the preamble of the function.

pub fn call( &mut self, address: impl Into<SymbolicAddress>, args: &[u32], timeout: Duration ) -> Result<(u32, u32)>

Call a function with the given arguments.

Trait Implementations

impl<'a> Deref for ElfDebugger<'a>

type Target = dyn Jtag + 'a

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a> DerefMut for ElfDebugger<'a>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.