Struct PeripheralSynchronousProxy

pub struct PeripheralSynchronousProxy { /* private fields */ }

Implementations

impl PeripheralSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<PeripheralEvent, 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 listen_l2cap( &self, payload: ChannelListenerRegistryListenL2capRequest, ___deadline: MonotonicInstant, ) -> Result<ChannelListenerRegistryListenL2capResult, Error>

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>, ___deadline: MonotonicInstant, ) -> Result<PeripheralAdvertiseResult, Error>

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>, ___deadline: MonotonicInstant, ) -> Result<PeripheralStartAdvertisingResult, Error>

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 Debug for PeripheralSynchronousProxy

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

Formats the value using the given formatter.

impl SynchronousProxy for PeripheralSynchronousProxy

type Proxy = PeripheralProxy

The async proxy for the same protocol.

type Protocol = PeripheralMarker

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.