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
60
61
62
63
64
65
66

use std::{fmt::Display, ops::RangeInclusive};

/// A Wi-Fi frequency band.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Ord, PartialOrd, Hash, Default)]
pub enum Band {
    /// The 2.4 GHz band.
    #[default]
    TwoPointFourGhz,
    /// The 5 GHz band.
    FiveGhz,
    /// The 6 GHz band.
    SixGhz,
}

impl Band {
    pub fn from_freq_mhz(freq_mhz: u32) -> Self {
        if Self::TwoPointFourGhz.range_mhz().contains(&freq_mhz) {
            Self::TwoPointFourGhz
        } else if Self::FiveGhz.range_mhz().contains(&freq_mhz) {
            Self::FiveGhz
        } else if Self::SixGhz.range_mhz().contains(&freq_mhz) {
            Self::SixGhz
        } else {
            Self::TwoPointFourGhz
        }
    }

    /// The lowest frequency, in MHz, included in this band.
    pub const fn min_freq_mhz(&self) -> u32 {
        match self {
            Band::TwoPointFourGhz => 2401,
            Band::FiveGhz => 5150,
            Band::SixGhz => 5945,
        }
    }

    /// The highest frequency, in MHz, included in this band.
    pub const fn max_freq_mhz(&self) -> u32 {
        match self {
            Band::TwoPointFourGhz => 2495,
            Band::FiveGhz => 5895,
            Band::SixGhz => 7125,
        }
    }

    /// The inclusive frequency range, in MHz, included in this band.
    pub const fn range_mhz(&self) -> RangeInclusive<u32> {
        match self {
            Self::TwoPointFourGhz => {
                Self::TwoPointFourGhz.min_freq_mhz()..=Self::TwoPointFourGhz.max_freq_mhz()
            }
            Self::FiveGhz => Self::FiveGhz.min_freq_mhz()..=Self::FiveGhz.max_freq_mhz(),
            Self::SixGhz => Self::SixGhz.min_freq_mhz()..=Self::SixGhz.max_freq_mhz(),
        }
    }
}

impl Display for Band {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Band::TwoPointFourGhz => write!(f, "2.4 GHz"),
            Band::FiveGhz => write!(f, "5 GHz"),
            Band::SixGhz => write!(f, "6 GHz"),
        }
    }
}