kawaiifi 0.2.1

Wi-Fi scanning library for Linux, macOS, and Windows.
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
45
46
47
48
49
50

use std::collections::HashMap;

use zbus::{proxy, zvariant};

use crate::{Interface, ScanError};

#[proxy(
    interface = "org.freedesktop.NetworkManager",
    default_service = "org.freedesktop.NetworkManager",
    default_path = "/org/freedesktop/NetworkManager"
)]
pub(crate) trait NetworkManager {
    async fn get_device_by_ip_iface(&self, iface: &str) -> zbus::Result<zvariant::OwnedObjectPath>;
}

#[proxy(
    interface = "org.freedesktop.NetworkManager.Device.Wireless",
    default_service = "org.freedesktop.NetworkManager"
)]
pub(crate) trait WirelessDevice {
    async fn request_scan(&self, options: HashMap<&str, zvariant::Value<'_>>) -> zbus::Result<()>;
}

pub(crate) async fn device_path(
    connection: &zbus::Connection,
    interface_name: &str,
) -> Result<zbus::zvariant::OwnedObjectPath, ScanError> {
    // Create proxy for NetworkManager main interface
    let nm_proxy = NetworkManagerProxy::new(connection).await?;

    // Get device path by interface name
    Ok(nm_proxy.get_device_by_ip_iface(interface_name).await?)
}

#[tracing::instrument(skip(interface), fields(interface = %interface.name()))]
pub(crate) async fn trigger_scan(interface: &Interface) -> Result<(), ScanError> {
    tracing::debug!("Triggering NetworkManager scan");
    let connection = zbus::Connection::system().await?;

    let device_path = device_path(&connection, interface.name()).await?;

    let proxy = WirelessDeviceProxy::builder(&connection)
        .path(device_path)?
        .build()
        .await?;

    proxy.request_scan(HashMap::new()).await?;

    Ok(())
}