kawaiifi 0.2.0

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
51
52
53
54
55
56
57
58
59

use objc2_core_wlan::{CWChannelBand, CWNetwork, CWSecurity};

use crate::{Bss, ies, interface::parse_bssid};

impl Bss {
    /// The noise measurement in dBm.
    pub fn noise_dbm(&self) -> i32 {
        self.noise_dbm
    }

    pub(crate) fn from_core_wlan_network(network: &CWNetwork) -> Option<Self> {
        let bssid = unsafe { network.bssid() }
            .and_then(|bssid| parse_bssid(&bssid.to_string()))
            .unwrap_or_default();
        let channel = unsafe { network.wlanChannel() }?;
        let information_element_data = unsafe { network.informationElementData() };
        let ies = information_element_data
            .as_ref()
            .map(|data| ies::from_bytes(unsafe { data.as_bytes_unchecked() }))
            .unwrap_or_default();

        let mut bss = Bss {
            bssid,
            frequency_mhz: channel_to_frequency_mhz(
                unsafe { channel.channelNumber() } as u32,
                unsafe { channel.channelBand() },
            ),
            signal_dbm: unsafe { network.rssiValue() } as i32,
            beacon_interval_tu: beacon_interval_ms_to_tu(unsafe { network.beaconInterval() }),
            ies,
            noise_dbm: unsafe { network.noiseMeasurement() } as i32,
            is_wep: unsafe { network.supportsSecurity(CWSecurity::WEP) },
        };
        bss.resolve_ie_dependencies();

        Some(bss)
    }
}

fn beacon_interval_ms_to_tu(beacon_interval_ms: isize) -> u16 {
    if beacon_interval_ms <= 0 {
        return 0;
    }

    ((beacon_interval_ms as f64) / 1.024)
        .round()
        .clamp(0.0, u16::MAX as f64) as u16
}

fn channel_to_frequency_mhz(channel: u32, band: CWChannelBand) -> u32 {
    match band {
        CWChannelBand::Band2GHz => match channel {
            14 => 2484,
            _ => 2407u32.saturating_add(channel.saturating_mul(5)),
        },
        CWChannelBand::Band6GHz => 5950u32.saturating_add(channel.saturating_mul(5)),
        _ => 5000u32.saturating_add(channel.saturating_mul(5)),
    }
}