improv-wifi 0.1.2

Implementation of the Improv-Wi-Fi BLE peripheral protocol for Linux
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

//! An implementation of the [Improv Wi-Fi] BLE peripheral protocol for Linux.
//!
//! This crate provides the device side of the Improv Wi-Fi configuration protocol via BlueZ's
//! D-Bus API. It is intended for embedded Linux devices that need to be provisioned onto a Wi-Fi
//! network without a display or input peripherals.
//!
//! [Improv Wi-Fi]: https://www.improv-wifi.com
#![cfg(target_os = "linux")]

use uuid::Uuid;

mod backend;
mod bluez;
mod error;
pub mod rpc;
mod service;
mod state;

#[cfg(feature = "networkmanager")]
pub mod networkmanager;

pub use backend::{DeviceInfo, Network, WifiConfigurator};
pub use error::Error;
pub use service::{
	AuthHandle, AuthorizeMode, ImprovWifi, ImprovWifiConfig, find_adapter, power_on_adapter,
};
pub use state::{Capabilities, Status};
pub use zbus::{Connection, zvariant::OwnedObjectPath};

pub const SERVICE_UUID: Uuid = Uuid::from_u128(0x00467768_6228_2272_4663_277478268000);
pub const CHARACTERISTIC_UUID_CAPABILITIES: Uuid =
	Uuid::from_u128(0x00467768_6228_2272_4663_277478268005);
pub const CHARACTERISTIC_UUID_CURRENT_STATE: Uuid =
	Uuid::from_u128(0x00467768_6228_2272_4663_277478268001);
pub const CHARACTERISTIC_UUID_ERROR_STATE: Uuid =
	Uuid::from_u128(0x00467768_6228_2272_4663_277478268002);
pub const CHARACTERISTIC_UUID_RPC_COMMAND: Uuid =
	Uuid::from_u128(0x00467768_6228_2272_4663_277478268003);
pub const CHARACTERISTIC_UUID_RPC_RESULT: Uuid =
	Uuid::from_u128(0x00467768_6228_2272_4663_277478268004);

/// 16-bit Service Data UUID used in BLE advertisements (`0x4677`).
pub const ADVERTISEMENT_SERVICE_DATA_UUID: Uuid =
	Uuid::from_u128(0x00004677_0000_1000_8000_00805f9b34fb);