Struct rustable::Bluetooth

pub struct Bluetooth {
    pub verbose: u8,
    pub filter_dest: Option<String>,
    // some fields omitted
}

Bluetooth is created to interact with Bluez over DBus and file descriptors.

Fields

verbose: u8

filter_dest: Option<String>

Implementations

impl Bluetooth

pub fn new(dbus_name: &str, blue_path: String) -> Result<Self, Error>

Creates a new Bluetooth and setup a DBus client to interact with Bluez.

pub fn get_path(&self) -> &Path

Gets the path of the DBus client

pub fn add_service(&mut self, service: LocalServiceBase) -> Result<(), Error>

Adds a service to the Bluetooth instance. Once registered with register_application(), this service will be a local service that can be interacted with by remote devices.

If register_application() has already called, the service will not be visible to Bluez (or other devices) until the application in reregistered.

pub fn get_service<T: ToUUID>(&mut self, uuid: T) -> Option<LocalService>

Access a service that has been added to the Bluetooth instance.

pub fn get_device<'c>(&'c mut self, mac: &MAC) -> Option<RemoteDevice<'c>>

Gets a remote device by MAC. The device must be discovered using discover_devices() from bluez, before it can be gotten with this device.

pub fn devices(&self) -> HashSet<MAC>

Gets a HashSet of known devices' MAC addresses.

pub fn start_adv(&mut self, adv: Advertisement) -> Result<u16, (u16, Error)>

Registers an advertisement with Bluez. After a successful call, it will persist until the remove_advertise()/remove_advertise_no_dbus() is called or Bluez releases the advertisement (this is typically done on device connect).

Calls process_requests()

pub fn is_adv_active(&self, index: u16) -> Option<bool>

Checks if an advertisement is still active, or if Bluez has signaled it has ended.

pub fn restart_adv(&mut self, index: u16) -> Result<bool, Error>

Restart an inactive advertisement.

If the advertisement is already active this method, does nothing and returns false. If an advertisement is not active it tries to reregister the advertisement and returns true on success otherwise it returns and Err.

pub fn remove_adv(&mut self, index: u16) -> Result<Advertisement, Error>

Unregisters an advertisement with Bluez. Returns the Advertisement if successful.

Calls process_requests()

pub fn remove_adv_no_dbus(&mut self, index: u16) -> Option<Advertisement>

Removes the advertisement from the Bluetooth instance but does not unregister the advertisement with Bluez. It is recommended that this is not used.

pub fn set_discoverable(&mut self, on: bool) -> Result<(), Error>

Set whether the Bluez controller should be discoverable (true) or not.

Calls process_requests()

pub fn set_power(&mut self, on: bool) -> Result<(), Error>

Set the Bluez controller power on (true) or off.

Calls process_requests()

pub fn register_application(&mut self) -> Result<(), Error>

Registers the local application's GATT services/characteristics (TODO: descriptors) with the Bluez controller.

Calls process_requests()

pub fn unregister_application(&mut self) -> Result<(), Error>

Unimplemented

Unregisters the local GATT services from the Bluez controller.

Calls process_requests()

pub fn process_requests(&mut self) -> Result<(), Error>

Process incoming DBus requests for the local application.

When using Bluetooth this function should be called on a regular basis. Bluez uses DBus to handle read/write requests to characteristics and descriptors, as wells advertisement. Failure to call this method frequently enough could result in requests from GATT clients to timeout. Some other functions are guaranteed to call this function at least once while waiting for a responses from the Bluez controller. This property is noted in these functions' descriptions.

pub fn clear_devices(&mut self)

pub fn discover_devices(&mut self) -> Result<HashSet<MAC>, Error>

Used to get devices devices known to Bluez. This function does not trigger scan/discovery on the Bluez controller. Use set_scan() to initiate actual device discovery.

Calls process_requests()

pub fn discover_device(&mut self, mac: &MAC) -> Result<(), Error>

Get a device from the Bluez controller.

Calls process_requests()

Trait Implementations

impl<'a, 'b: 'a, 'c: 'a> Device<'a> for Bluetooth

type ServiceBase = LocalServiceBase

type ServiceType = LocalService<'a>

fn services(&mut self) -> Keys<UUID, Self::ServiceBase>

fn get_service(&'a mut self, uuid: &UUID) -> Option<Self::ServiceType>

fn has_service(&self, uuid: &UUID) -> bool

fn address(&self) -> &MAC

fn address_type(&mut self) -> AddrType

fn name(&mut self) -> String