Struct EmulatorSynchronousProxy

pub struct EmulatorSynchronousProxy { /* private fields */ }

Implementations

impl EmulatorSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<EmulatorEvent, Error>

Waits until an event arrives and returns it. It is safe for other threads to make concurrent requests while waiting for an event.

pub fn publish( &self, payload: &EmulatorSettings, ___deadline: MonotonicInstant, ) -> Result<EmulatorPublishResult, Error>

Publish a bt-hci device using the provided settings. Each Emulator instance can only manage a single bt-hci device. Returns Emulator.HCI_ALREADY_PUBLISHED if the device has already been published.

pub fn add_low_energy_peer( &self, payload: PeerParameters, ___deadline: MonotonicInstant, ) -> Result<EmulatorAddLowEnergyPeerResult, Error>

Inserts a new LE peer device to be emulated by this controller. Once registered, the state of the fake peer can be driven and observed using the peer handle.

A reply will be sent to acknowledge the creation of the fake peer. If a peer cannot be initialized (e.g. due to a missing required field in parameters or for containing an address that is already emulated) the peer handle will be closed and an error reply will be sent.

The peer will appear in advertising reports and respond to requests according to its configuration as long as the peer channel is open. The emulator stops emulating this peer when the channel gets closed, which makes it no longer discoverable and not respond to any requests.

pub fn add_bredr_peer( &self, payload: PeerParameters, ___deadline: MonotonicInstant, ) -> Result<EmulatorAddBredrPeerResult, Error>

Inserts a new BR/EDR peer device to be emulated by this controller. Once registered, the state of the fake peer can be driven and observed using the peer handle.

A reply will be sent to acknowledge the creation of the fake peer. If a peer cannot be initialized (e.g. due to a missing required field in parameters or for containing an address that is already emulated) the peer handle will be closed and an error reply will be sent.

The peer will appear in inquiry results and respond to requests according to its configuration as long as the peer channel is open. The emulator stops emulating this peer when the channel gets closed, which makes it no longer discoverable and not respond to any requests.

pub fn watch_controller_parameters( &self, ___deadline: MonotonicInstant, ) -> Result<ControllerParameters, Error>

Hanging get pattern for the controller parameter state will not resolve until the state has changed from the last response.

pub fn watch_le_scan_states( &self, ___deadline: MonotonicInstant, ) -> Result<Vec<LeScanState>, Error>

Returns a vector of the least to most recent states for the link layer LE scan procedure. This method returns when there has been at least one state change since the last invocation of this method by this client.

Multiple calls to this method can be outstanding at a given time. All calls will resolve in a response as soon as there is a change to the scan state.

pub fn watch_legacy_advertising_states( &self, ___deadline: MonotonicInstant, ) -> Result<Vec<LegacyAdvertisingState>, Error>

Returns a vector of the least to most recent states for the link layer LE legacy advertising procedure. This method returns when there has been at least one state change since the last invocation of this method by this client.

Multiple calls to this method can be outstanding at a given time. All calls will resolve in a response as soon as there is a change to the scan state.

Trait Implementations

impl Debug for EmulatorSynchronousProxy

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

Formats the value using the given formatter.

impl SynchronousProxy for EmulatorSynchronousProxy

type Proxy = EmulatorProxy

The async proxy for the same protocol.

type Protocol = EmulatorMarker

The protocol which this Proxy controls.

fn from_channel(inner: Channel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Channel

Convert the proxy back into a channel.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.

fn is_closed(&self) -> Result<bool, Status>

Returns true if the proxy has received the PEER_CLOSED signal.