Struct LocalServiceProxy

pub struct LocalServiceProxy { /* private fields */ }

Implementations

impl LocalServiceProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.bluetooth.gatt2/LocalService.

pub fn take_event_stream(&self) -> LocalServiceEventStream

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

Panics

Panics if the event stream was already taken.

pub fn characteristic_configuration( &self, peer_id: &PeerId, handle: &Handle, notify: bool, indicate: bool, ) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

This notifies the current configuration of a particular characteristic/descriptor for a particular peer. It will be called when the peer GATT client changes the configuration.

The Bluetooth stack maintains the state of each peer’s configuration across reconnections. As such, this method will also be called when a peer connects for each characteristic with the initial, persisted state of the newly-connected peer’s configuration. However, clients should not rely on this state being persisted indefinitely by the Bluetooth stack.

• request peer_id The PeerId of the GATT client associated with this particular CCC.
• request handle The handle of the characteristic associated with the notify and indicate parameters.
• request notify True if the client has enabled notifications, false otherwise.
• request indicate True if the client has enabled indications, false otherwise.

• response empty Returns nothing to acknowledge the characteristic configuration.

pub fn read_value( &self, peer_id: &PeerId, handle: &Handle, offset: i32, ) -> QueryResponseFut<LocalServiceReadValueResult, DefaultFuchsiaResourceDialect>

Called when a peer requests to read the value of a characteristic or descriptor. It is guaranteed that the peer satisfies the permssions associated with this attribute.

• request peer_id The PeerId of the GATT client making the read request.
• request handle The handle of the requested descriptor/characteristic.
• request offset The offset at which to start reading the requested value.

• response value The value of the characteristic.

• error See gatt2.Error documentation for possible errors.

pub fn write_value( &self, payload: &LocalServiceWriteValueRequest, ) -> QueryResponseFut<LocalServiceWriteValueResult, DefaultFuchsiaResourceDialect>

Called when a peer issues a request to write the value of a characteristic or descriptor. It is guaranteed that the peer satisfies the permissions associated with this attribute.

• request peer_id The PeerId of the GATT client making the write request. Always present.
• request handle The handle of the requested descriptor/characteristic. Always present.
• request offset The offset at which to start writing the value. If the offset is 0, any existing value should be overwritten by the new value. Otherwise, the existing value from offset:(offset + len(value)) should be changed to value. Always present.
• request value The new value for the descriptor/characteristic. Always present, but may be the empty string.

• response The implementation must send an empty response once the value has been updated as confirmation.

• error See gatt2.Error documentation for possible errors.

pub fn peer_update( &self, payload: &LocalServicePeerUpdateRequest, ) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

Called to provide GATT information specific to a peer. PeerUpdate will not be called unless the prior invocation received a response. As such, the implementation can simply ignore the first invocation if they are not interested in any PeerUpdate fields.

A PeerUpdate will be made before propagating any other interaction from the peer to the LocalService (Write/ReadValue, CharacteristicConfiguration) on a best-effort basis, as long as all preceding PeerUpdates were acknowledged.

Not currently sent. Comment on https://fxbug.dev/42178509 to request support

• request peer_id The PeerId the update pertains to. Always present.
• request mtu The maximum number of bytes that fit in a notification/indication to this peer. Any bytes past this limit are silently truncated. Most clients need not concern themselves with this unless they are using notifications/indications for high throughput. Optional.

• response An empty response to acknowledge that the update was received.

pub fn value_changed_credit(&self, additional_credit: u8) -> Result<(), Error>

Add credit for sending indications/notifications. Implementors are defined to start out with INITIAL_VALUE_CHANGED_CREDITS credits before this method is called. Implementors must keep track of the available credit they have. The implementor can send exactly one OnNotifyValue or OnIndicateValue event for each credit. Note that ValueChangedCredit will only be called if at least one indication/notification has been sent since the prior call.

Trait Implementations

impl Clone for LocalServiceProxy

fn clone(&self) -> LocalServiceProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LocalServiceProxy

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

Formats the value using the given formatter.

impl LocalServiceProxyInterface for LocalServiceProxy

type CharacteristicConfigurationResponseFut = QueryResponseFut<()>

type ReadValueResponseFut = QueryResponseFut<Result<Vec<u8>, Error>>

type WriteValueResponseFut = QueryResponseFut<Result<(), Error>>

type PeerUpdateResponseFut = QueryResponseFut<()>

fn characteristic_configuration( &self, peer_id: &PeerId, handle: &Handle, notify: bool, indicate: bool, ) -> Self::CharacteristicConfigurationResponseFut

fn read_value( &self, peer_id: &PeerId, handle: &Handle, offset: i32, ) -> Self::ReadValueResponseFut

fn write_value( &self, payload: &LocalServiceWriteValueRequest, ) -> Self::WriteValueResponseFut

fn peer_update( &self, payload: &LocalServicePeerUpdateRequest, ) -> Self::PeerUpdateResponseFut

fn value_changed_credit(&self, additional_credit: u8) -> Result<(), Error>

impl Proxy for LocalServiceProxy

type Protocol = LocalServiceMarker

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.