Enum EmulatorRequest

pub enum EmulatorRequest {
    Publish {
        payload: EmulatorSettings,
        responder: EmulatorPublishResponder,
    },
    AddLowEnergyPeer {
        payload: PeerParameters,
        responder: EmulatorAddLowEnergyPeerResponder,
    },
    AddBredrPeer {
        payload: PeerParameters,
        responder: EmulatorAddBredrPeerResponder,
    },
    WatchControllerParameters {
        responder: EmulatorWatchControllerParametersResponder,
    },
    WatchLeScanStates {
        responder: EmulatorWatchLeScanStatesResponder,
    },
    WatchLegacyAdvertisingStates {
        responder: EmulatorWatchLegacyAdvertisingStatesResponder,
    },
    _UnknownMethod {
        ordinal: u64,
        control_handle: EmulatorControlHandle,
        method_type: MethodType,
    },
}

Protocol used to emulate a Bluetooth controller that supports the standard Bluetooth HCI. Represents the bt-emulator device protocol. A bt-emulator device is used for configuring and publishing fake bt-hci devices.

Variants

Publish

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.

Fields

payload: EmulatorSettings

responder: EmulatorPublishResponder

AddLowEnergyPeer

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.

Fields

payload: PeerParameters

responder: EmulatorAddLowEnergyPeerResponder

AddBredrPeer

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.

Fields

payload: PeerParameters

responder: EmulatorAddBredrPeerResponder

WatchControllerParameters

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

Fields

responder: EmulatorWatchControllerParametersResponder

WatchLeScanStates

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.

Fields

responder: EmulatorWatchLeScanStatesResponder

WatchLegacyAdvertisingStates

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.

Fields

responder: EmulatorWatchLegacyAdvertisingStatesResponder

_UnknownMethod

An interaction was received which does not match any known method.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

ordinal: u64

Ordinal of the method that was called.

control_handle: EmulatorControlHandle

method_type: MethodType

Implementations

impl EmulatorRequest

pub fn into_publish( self, ) -> Option<(EmulatorSettings, EmulatorPublishResponder)>

pub fn into_add_low_energy_peer( self, ) -> Option<(PeerParameters, EmulatorAddLowEnergyPeerResponder)>

pub fn into_add_bredr_peer( self, ) -> Option<(PeerParameters, EmulatorAddBredrPeerResponder)>

pub fn into_watch_controller_parameters( self, ) -> Option<EmulatorWatchControllerParametersResponder>

pub fn into_watch_le_scan_states( self, ) -> Option<EmulatorWatchLeScanStatesResponder>

pub fn into_watch_legacy_advertising_states( self, ) -> Option<EmulatorWatchLegacyAdvertisingStatesResponder>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for EmulatorRequest

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

Formats the value using the given formatter.