Struct PeripheralProxy

pub struct PeripheralProxy { /* private fields */ }

Implementations

impl PeripheralProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.bluetooth.le/Peripheral.

pub fn take_event_stream(&self) -> PeripheralEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn listen_l2cap( &self, payload: ChannelListenerRegistryListenL2capRequest, ) -> QueryResponseFut<ChannelListenerRegistryListenL2capResult, DefaultFuchsiaResourceDialect>

Register a listener for incoming channels. The registry will assign a PSM value that is unique for the local device, as well as open a [ChannelListener] for accepting incoming channels. In the unlikely event that all PSMs have been assigned, this call will fail with ZX_ERR_NO_RESOURCES.

Note that the method of service discovery or advertising is defined by the service or protocol, so it is the responsibility of the caller to communicate the assigned PSM to any clients.

pub fn advertise( &self, parameters: &AdvertisingParameters, advertised_peripheral: ClientEnd<AdvertisedPeripheralMarker>, ) -> QueryResponseFut<PeripheralAdvertiseResult, DefaultFuchsiaResourceDialect>

Start advertising continuously as a LE peripheral. If advertising cannot be initiated then advertised_peripheral will be closed and an error will be returned.

This method may be called any number of times. To reconfigure an advertisement, first close the original advertisement and then initiate a new advertisement after an empty response is returned.

If the client closes its end of the [fuchsia.bluetooth.le/AdvertisedPeripheral] channel, advertising will be stopped. If the handle is closed before the request is fulfilled, advertising may be briefly enabled before it is terminated. AdvertisedPeripheral lifetime is bounded by the lifetime of the Peripheral protocol, but this may be changed in the future (https://fxbug.dev/42157682).

• request parameters Parameters used while configuring the advertising instance.
• request advertised_peripheral Protocol that remains valid for the duration of this advertising session.

• response An empty response will be sent when the advertisement is successfully stopped (due to release of the advertised_peripheral protocol). To prevent overlapping similar advertisements and transient errors with limited advertising resources, waiting for a response is recommended before calling Advertise again.

• error If an error occurs, advertised_peripheral will be closed and a PeripheralError will be returned.

pub fn start_advertising( &self, parameters: &AdvertisingParameters, handle: ServerEnd<AdvertisingHandleMarker>, ) -> QueryResponseFut<PeripheralStartAdvertisingResult, DefaultFuchsiaResourceDialect>

Start advertising as a LE peripheral. An empty response is sent to indicate when advertising has successfully initiated. If advertising cannot be initiated, then the response will contain a [fuchsia.bluetooth.le/PeripheralError].

This method can get called any number of times and successive calls can be made to reconfigure the advertising parameters. However only the most recent [fuchsia.bluetooth.le/AdvertisingHandle] will remain valid.

An instance of [fuchsia.bluetooth.le/Peripheral] can only have one active advertisement at a time. Clients must obtain multiple Peripheral instances for multiple simultaneous advertisements.

If the client closes its end of the [fuchsia.bluetooth.le/AdvertisingHandle] channel, advertising will be stopped. If the handle is closed before the request is fulfilled, advertising will be briefly enabled before it is terminated.

• request parameters Parameters used while configuring the advertising instance.
• request handle Handle that remains valid for the duration of this advertising session.

• error Returns a [fuchsia.bluetooth.le/PeripheralError] if advertising cannot be initiated. In this case the handle will be closed.

Trait Implementations

impl Clone for PeripheralProxy

fn clone(&self) -> PeripheralProxy

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PeripheralProxy

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

Formats the value using the given formatter.

impl PeripheralProxyInterface for PeripheralProxy

type ListenL2capResponseFut = QueryResponseFut<Result<ChannelListenerRegistryListenL2capResponse, i32>>

type AdvertiseResponseFut = QueryResponseFut<Result<(), PeripheralError>>

type StartAdvertisingResponseFut = QueryResponseFut<Result<(), PeripheralError>>

fn listen_l2cap( &self, payload: ChannelListenerRegistryListenL2capRequest, ) -> Self::ListenL2capResponseFut

fn advertise( &self, parameters: &AdvertisingParameters, advertised_peripheral: ClientEnd<AdvertisedPeripheralMarker>, ) -> Self::AdvertiseResponseFut

fn start_advertising( &self, parameters: &AdvertisingParameters, handle: ServerEnd<AdvertisingHandleMarker>, ) -> Self::StartAdvertisingResponseFut

impl Proxy for PeripheralProxy

type Protocol = PeripheralMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.