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
67
68
69
70

use std::ops::Deref;

use deku::prelude::*;
use serde::{Deserialize, Serialize};

use crate::ies::{Field, IeId};

#[derive(Debug, Clone, PartialEq, Eq, Hash, DekuRead, DekuWrite, Serialize, Deserialize)]
#[deku(ctx = "len: usize")]
pub struct VendorSpecific {
    #[deku(count = "len")]
    data: Vec<u8>,
}

impl VendorSpecific {
    pub const NAME: &'static str = "Vendor Specific";
    pub const ID: u8 = 221;
    pub const ID_EXT: Option<u8> = None;
    pub(crate) const IE_ID: IeId = IeId::new(Self::ID, Self::ID_EXT);

    pub fn is_wpa(&self) -> bool {
        self.data.len() >= 4
            && self.data[0..3] == [0x00, 0x50, 0xF2] // Microsoft's OUI
            && self.data[3] == 0x01 // WPA type
    }

    pub fn oui(&self) -> Option<&[u8; 3]> {
        self.data.get(0..3).and_then(|slice| slice.try_into().ok())
    }

    pub fn summary(&self) -> String {
        self.oui()
            .map(|oui| format!("OUI: {:02X}:{:02X}:{:02X}", oui[0], oui[1], oui[2]))
            .unwrap_or_default()
    }

    pub fn fields(&self) -> Vec<Field> {
        let mut fields = Vec::new();

        if let Some(oui) = self.oui() {
            fields.push(
                Field::builder()
                    .title("OUI")
                    .value(format!("{:02X}:{:02X}:{:02X}", oui[0], oui[1], oui[2]))
                    .bytes(oui.to_vec())
                    .build(),
            );
        }

        if let Some(data) = self.data.get(3..) {
            fields.push(
                Field::builder()
                    .title("Data")
                    .value("---")
                    .bytes(data.to_vec())
                    .build(),
            );
        }

        fields
    }
}

impl Deref for VendorSpecific {
    type Target = [u8];

    fn deref(&self) -> &Self::Target {
        &self.data
    }
}