Crate bluez_async

An async wrapper around the D-Bus interface of BlueZ, the Linux Bluetooth daemon. This provides type-safe interfaces to a subset of the Bluetooth client (i.e. central, in Bluetooth terminology) interfaces exposed by BlueZ, focussing on the Generic Attribute Profile (GATT) of Bluetooth Low Energy (BLE).

Start by creating a BluetoothSession.

Structs

AdapterId

Opaque identifier for a Bluetooth adapter on the system.

AdapterInfo

Information about a Bluetooth adapter on the system.

BluetoothSession

A connection to the Bluetooth daemon. This can be cheaply cloned and passed around to be used from different places. It is the main entry point to the library.

CharacteristicFlags

The set of flags (a.k.a. properties) of a characteristic, defining how the characteristic can be used.

CharacteristicId

Opaque identifier for a GATT characteristic on a Bluetooth device.

CharacteristicInfo

Information about a GATT characteristic on a Bluetooth device.

DescriptorId

Opaque identifier for a GATT characteristic descriptor on a Bluetooth device.

DescriptorInfo

Information about a GATT descriptor on a Bluetooth device.

DeviceId

Opaque identifier for a Bluetooth device which the system knows about. This includes a reference to which Bluetooth adapter it was discovered on, which means that any attempt to connect to it will also happen from that adapter (in case the system has more than one).

DeviceInfo

Information about a Bluetooth device which was discovered. See https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/doc/device-api.txt

DiscoveryFilter

A set of filter parameters for discovery. Parameters may be set to None to use the BlueZ defaults.

MacAddress

MAC address of a Bluetooth device.

Modalias

A parsed modalias string.

ParseMacAddressError

An error parsing a MAC address from a string.

ParseModaliasError

An error parsing a Modalias from a string.

ServiceId

Opaque identifier for a GATT service on a Bluetooth device.

ServiceInfo

Information about a GATT service on a Bluetooth device.

WriteOptions

A set of options for a characteristic write operation.

Enums

AdapterEvent

Details of an event related to a Bluetooth adapter.

AddressType

MAC address type of a Bluetooth device.

BluetoothError

An error carrying out a Bluetooth operation.

BluetoothEvent

An event relating to a Bluetooth device or adapter.

CharacteristicEvent

Details of an event related to a GATT characteristic.

DeviceEvent

Details of an event related to a Bluetooth device.

SpawnError

Error type for futures representing tasks spawned by this crate.

Transport

The type of transport to use for a scan.

WriteType

The type of write operation to use.

Traits

BleUuid

An extension trait for Uuid which provides BLE-specific methods.

Functions

uuid_from_u16

Convert a 16-bit BLE short UUID to a full 128-bit UUID by filling in the standard Bluetooth Base UUID.

uuid_from_u32

Convert a 32-bit BLE short UUID to a full 128-bit UUID by filling in the standard Bluetooth Base UUID.