pub enum CentralRequest {
    Scan {
        options: ScanOptions,
        result_watcher: ServerEnd<ScanResultWatcherMarker>,
        responder: CentralScanResponder,
    },
    Connect {
        id: PeerId,
        options: ConnectionOptions,
        handle: ServerEnd<ConnectionMarker>,
        control_handle: CentralControlHandle,
    },
    GetPeripherals {
        service_uuids: Option<Vec<String>>,
        responder: CentralGetPeripheralsResponder,
    },
    GetPeripheral {
        identifier: String,
        responder: CentralGetPeripheralResponder,
    },
    StartScan {
        filter: Option<Box<ScanFilter>>,
        responder: CentralStartScanResponder,
    },
    StopScan {
        control_handle: CentralControlHandle,
    },
    ConnectPeripheral {
        identifier: String,
        options: ConnectionOptions,
        gatt_client: ServerEnd<ClientMarker>,
        responder: CentralConnectPeripheralResponder,
    },
    DisconnectPeripheral {
        identifier: String,
        responder: CentralDisconnectPeripheralResponder,
    },
}

Variants§

§

Scan

Fields

§options: ScanOptions
§result_watcher: ServerEnd<ScanResultWatcherMarker>

Scans for nearby LE peripherals and broadcasters. If the scan cannot be initiated, then result_watcher will be closed with an epitaph.

A Central client is allowed to have only one active scan at a time. Accordingly, only one Scan request can be outstanding at a time. Additional calls to Scan will fail.

The lifetime of the scan session is tied to the result_watcher protocol provided. The scan will be stopped if the channel is closed.

Once a scan is started, the [fuchsia.bluetooth.le/ScanResultWatcher] can be used to watch for scan results.

  • request options Options used to configure the scan session.
  • request result_watcher Protocol that remains valid for the duration of this scan session.
  • response An empty response will be sent to acknowledge the scan has stopped.

The following epitaphs may be sent by the server on error:

  • error ALREADY_EXISTS: A scan is already in progress. Each Central protocol is only allowed 1 active scan.
  • error INVALID_ARGS: Some of the scan options are invalid. See the ScanOptions documentation.
  • error INTERNAL: An internal error occurred and a scan could not be started.
§

Connect

Fields

§id: PeerId
§handle: ServerEnd<ConnectionMarker>
§control_handle: CentralControlHandle

Connect to the peer with the given identifier.

The requested [fuchsia.bluetooth.le/Connection] represents the client’s interest on the LE connection to the peer. Closing the channel removes interest, but may not result in disconnection if another client holds a valid [fuchsia.bluetooth.le/Connection] to the same peer.

The [fuchsia.bluetooth.le/Connection] handle will be closed by the system if the connection to the peer is lost or an error occurs.

The following epitaphs may be sent by the server on error:

  • INVALID_ARGS: Some of the parameters are invalid.

  • ALREADY_BOUND: A Connection to the peer already exists for this Central. The existing Connection should be used.

  • NOT_CONNECTED: A connection could not be established.

  • CONNECTION_RESET: The peer disconnected.

  • request id Identifier of the peer to initiate a connection to.

  • request options Options used to configure the connection.

  • request handle Handle that remains valid for the duration of this connection.

§

GetPeripherals

Fields

§service_uuids: Option<Vec<String>>

Returns the list of peripherals that are known to the system from previous scan, connection, and/or bonding procedures. The results can be filtered based on service UUIDs that are known to be present on the peripheral.

This method only returns peripherals (i.e. connectable devices).

§

GetPeripheral

Fields

§identifier: String

This method is not implemented by the Fuchsia core stack- TODO(https://fxbug.dev/42087303)

Returns information about a single peripheral that is known to the system from previous scan, connection, and/or bonding procedures based on its unique identifier. Returns null if identifier is not recognized.

§

StartScan

Initiates a scan session for nearby peripherals and broadcasters. Discovered devices will be reported via CentralDelegate.OnDeviceDiscovered(). If a scan session is already in progress, filter will replace the existing session’s filter.

If filter is null or empty (i.e. none of its fields has been populated) then the delegate will be notified for all discoverable devices that are found. This is not recommended; clients should generally filter results by at least one of filter.service_uuids, filter.service_data, and/or filter.manufacturer_identifier.

§

StopScan

Fields

§control_handle: CentralControlHandle

Terminate a previously started scan session.

§

ConnectPeripheral

Fields

§identifier: String
§gatt_client: ServerEnd<ClientMarker>

Creates a connection to the peripheral device with the given identifier. Returns the status of the operation in status.

On success, gatt_client will be bound and can be used for GATT client role procedures. On failure, gatt_client will be closed and status will indicate an error.

§

DisconnectPeripheral

Disconnects this Central’s connection to the peripheral with the given identifier.

Implementations§

Trait Implementations§

source§

impl Debug for CentralRequest

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> Encode<Ambiguous1> for T

§

unsafe fn encode( self, _encoder: &mut Encoder<'_>, _offset: usize, _depth: Depth ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID. Read more
§

impl<T> Encode<Ambiguous2> for T

§

unsafe fn encode( self, _encoder: &mut Encoder<'_>, _offset: usize, _depth: Depth ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more