Struct Proxy

pub struct Proxy { /* private fields */ }

Implementation of the Transport trait backed by connection to a remote OpenTitan tool session process.

Implementations

impl Proxy

pub fn open(host: Option<&str>, port: u16) -> Result<Self>

Establish connection with a running session process.

Trait Implementations

impl Transport for Proxy

fn capabilities(&self) -> Result<Capabilities>

Returns a Capabilities object to check the capabilities of this transport object.

fn apply_default_configuration(&self) -> Result<()>

Resets the transport to power-on condition. That is, pin/uart/spi configuration reverts to default, ongoing operations are cancelled, etc.

fn spi(&self, instance: &str) -> Result<Rc<dyn Target>>

Returns a SPI Target implementation.

fn i2c(&self, instance: &str) -> Result<Rc<dyn Bus>>

Returns a I2C Bus implementation.

fn uart(&self, instance_name: &str) -> Result<Rc<dyn Uart>>

Returns a Uart implementation.

fn gpio_pin(&self, pinname: &str) -> Result<Rc<dyn GpioPin>>

Returns a GpioPin implementation.

fn gpio_monitoring(&self) -> Result<Rc<dyn GpioMonitoring>>

Returns a GpioMonitoring implementation, for logic analyzer functionality.

fn gpio_bitbanging(&self) -> Result<Rc<dyn GpioBitbanging>>

Returns a GpioBitbanging implementation, for timed and synchronized manipulation of multiple GPIO pins.

fn emulator(&self) -> Result<Rc<dyn Emulator>>

Returns a Emulator implementation.

fn proxy_ops(&self) -> Result<Rc<dyn ProxyOps>>

Methods available only on Proxy implementation.

fn nonblocking_help(&self) -> Result<Rc<dyn NonblockingHelp>>

Before nonblocking operations can be used on Uart or other traits, this NonblockingHelp object must be invoked, in order to get the Transport implementation a chance to register its internal event sources with the main event loop.

fn jtag(&self, _opts: &JtagParams) -> Result<Box<dyn JtagChain + '_>>

Returns a JtagChain implementation.

fn dispatch(&self, _action: &dyn Any) -> Result<Option<Box<dyn Annotate>>>

Invoke non-standard functionality of some Transport implementations.

fn maintain_connection(&self) -> Result<Rc<dyn MaintainConnection>>

As long as the returned MaintainConnection object is kept by the caller, this driver may assume that no other opentitantool processes attempt to access the same debugger device. This allows for optimzations such as keeping USB handles open across function invocations.