rfe 0.1.0

Communicate with RF Explorer spectrum analyzers and signal generators over USB serial
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

use super::Model;
use crate::common::MessageParseError;
use crate::rf_explorer::SetupInfo;

impl SetupInfo<Model> {
    pub(crate) const PREFIX: &'static [u8] = b"#C2-M:";
}

impl<'a> TryFrom<&'a [u8]> for SetupInfo<Model> {
    type Error = MessageParseError<'a>;

    fn try_from(bytes: &'a [u8]) -> Result<Self, Self::Error> {
        Self::try_from_with_prefix(bytes, Self::PREFIX)
    }
}

#[cfg(test)]
mod tests {
    use super::Model;
    use crate::rf_explorer::SetupInfo;

    #[test]
    fn accept_wsub1g_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:003,255,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::RfeWSub1G));
        assert_eq!(setup.expansion_radio_model, None);
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_24g_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:004,255,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::Rfe24G));
        assert_eq!(setup.expansion_radio_model, None);
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_ism_combo_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:003,004,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::RfeWSub1G));
        assert_eq!(setup.expansion_radio_model, Some(Model::Rfe24G));
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_3g_combo_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:003,005,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::RfeWSub1G));
        assert_eq!(setup.expansion_radio_model, Some(Model::RfeWSub3G));
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_6g_combo_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:006,005,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::Rfe6G));
        assert_eq!(setup.expansion_radio_model, Some(Model::RfeWSub3G));
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_wsub1g_plus_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:010,255,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::RfeWSub1GPlus));
        assert_eq!(setup.expansion_radio_model, None);
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_ism_combo_plus_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:010,012,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::RfeWSub1GPlus));
        assert_eq!(setup.expansion_radio_model, Some(Model::Rfe24GPlus));
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_4g_combo_plus_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:010,013,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::RfeWSub1GPlus));
        assert_eq!(setup.expansion_radio_model, Some(Model::Rfe4GPlus));
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_6g_combo_plus_setup() {
        let setup = SetupInfo::<Model>::try_from(b"#C2-M:010,014,XX.XXXX".as_ref()).unwrap();
        assert_eq!(setup.main_radio_model, Some(Model::RfeWSub1GPlus));
        assert_eq!(setup.expansion_radio_model, Some(Model::Rfe6GPlus));
        assert_eq!(setup.firmware_version, "XX.XXXX");
    }

    #[test]
    fn accept_setup_without_main_model() {
        assert!(SetupInfo::<Model>::try_from(b"#C2-M:255,005,01.12B26".as_ref()).is_ok());
        assert!(SetupInfo::<Model>::try_from(b"#C2-M:255,014,03.41".as_ref()).is_ok());
    }

    #[test]
    fn accept_setup_without_expansion_model() {
        assert!(SetupInfo::<Model>::try_from(b"#C2-M:006,255,01.12B26".as_ref()).is_ok());
    }

    #[test]
    fn reject_setup_without_firmware_version() {
        assert!(SetupInfo::<Model>::try_from(b"#C2-M:006,005".as_ref()).is_err());
    }

    #[test]
    fn reject_setup_with_incorrect_prefix() {
        assert!(SetupInfo::<Model>::try_from(b"$C2-M:006,005,01.12B26".as_ref()).is_err());
    }
}