rxprog 1.0.2

Library implementing the Boot Mode protocol for specific Renesas microcontrollers and CLI for programming firmware images
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

use std::str;

use super::command_impl_prelude::*;

/// Request a list of devices supported by the boot program
#[derive(Debug)]
pub struct SupportedDeviceInquiry {}

impl TransmitCommandData for SupportedDeviceInquiry {
    fn command_data(&self) -> CommandData {
        CommandData {
            opcode: 0x20,
            has_size_field: false,
            payload: vec![],
        }
    }
}

impl Receive for SupportedDeviceInquiry {
    type Response = Vec<SupportedDevice>;

    fn rx<T: io::Read>(&self, p: &mut T) -> Result<Self::Response> {
        let mut reader =
            ResponseReader::<_, SizedResponse<u8>, NoError>::new(p, ResponseFirstByte::Byte(0x30));

        let data = reader.read_response()?.data;

        let device_count = data[0];

        let mut devices: Vec<SupportedDevice> = vec![];
        let mut remaining_data = &data[1..];
        for _ in 0..device_count {
            let (character_count, device_bytes) = remaining_data.split_first().unwrap();
            let character_count = *character_count as usize;
            let device_bytes = &device_bytes[..character_count];

            let (device_code_bytes, series_name_bytes) = device_bytes.split_at(4);

            devices.push(SupportedDevice {
                device_code: str::from_utf8(device_code_bytes)
                    .expect("Could not decode device code")
                    .to_string(),
                series_name: str::from_utf8(series_name_bytes)
                    .expect("Could not decode series name")
                    .to_string(),
            });

            remaining_data = &remaining_data[(1 + character_count)..];
        }

        Ok(devices)
    }
}

#[cfg(test)]
mod tests {
    use super::super::test_util::is_script_complete;
    use super::*;

    #[test]
    fn test_tx() -> Result<()> {
        let cmd = SupportedDeviceInquiry {};
        let command_bytes = [0x20];
        let mut p = mock_io::Builder::new().write(&command_bytes).build();

        cmd.tx(&mut p)?;

        assert!(is_script_complete(&mut p));

        Ok(())
    }

    #[test]
    fn test_rx() {
        let cmd = SupportedDeviceInquiry {};
        let response_bytes = [
            0x30, 0x14, 0x02, // Header
            0x08, 0x44, 0x45, 0x56, 0x31, 0x41, 0x42, 0x43, 0x44, // Device 1
            0x09, 0x44, 0x45, 0x56, 0x32, 0x56, 0x57, 0x58, 0x59, 0x5A, // Device 2
            0xC6, // Checksum
        ];
        let mut p = mock_io::Builder::new().read(&response_bytes).build();

        let response = cmd.rx(&mut p);

        assert_eq!(
            response,
            Ok(vec![
                SupportedDevice {
                    device_code: "DEV1".to_string(),
                    series_name: "ABCD".to_string(),
                },
                SupportedDevice {
                    device_code: "DEV2".to_string(),
                    series_name: "VWXYZ".to_string(),
                },
            ])
        );
        assert!(is_script_complete(&mut p));
    }
}