wchisp 0.3.0

A command-line implementation of WCHISPTool, for flashing ch32 MCUs
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

//! Abstract Device transport interface.
use std::{thread::sleep, time::Duration};

use anyhow::Result;

use crate::protocol::{Command, Response};

pub use self::serial::{Baudrate, SerialTransport};
pub use self::usb::UsbTransport;

mod serial;
mod usb;

const DEFAULT_TRANSPORT_TIMEOUT_MS: u64 = 1000;

/// Abstraction of the transport layer.
/// Might be a USB, a serial port, or Network.
pub trait Transport {
    fn send_raw(&mut self, raw: &[u8]) -> Result<()>;
    fn recv_raw(&mut self, timeout: Duration) -> Result<Vec<u8>>;

    fn transfer(&mut self, cmd: Command) -> Result<Response> {
        self.transfer_with_wait(cmd, Duration::from_millis(DEFAULT_TRANSPORT_TIMEOUT_MS))
    }

    fn transfer_with_wait(&mut self, cmd: Command, wait: Duration) -> Result<Response> {
        let req = &cmd.into_raw()?;
        log::debug!("=> {}   {}", hex::encode(&req[..3]), hex::encode(&req[3..]));
        self.send_raw(&req)?;
        sleep(Duration::from_micros(1)); // required for some Linux platform

        let resp = self.recv_raw(wait)?;
        anyhow::ensure!(req[0] == resp[0], "response command type mismatch");
        log::debug!("<= {} {}", hex::encode(&resp[..4]), hex::encode(&resp[4..]));
        Response::from_raw(&resp)
    }
}