ectool version 0.2.1:

- Add hidapi feature
- Add redox_hwio feature
- Add feature documentation

tool/src/access/hid.rs

@@ -0,0 +1,76 @@
+use hidapi::HidDevice;
+
+use crate::{
+    Access,
+    Error,
+};
+
+/// Use USB HID access, only for USB ECs
+pub struct AccessHid {
+    device: HidDevice,
+    retries: u32,
+    timeout: i32,
+}
+
+impl AccessHid {
+    /// Use hidapi device with specified retries and timeout for each try in milliseconds
+    pub fn new(device: HidDevice, retries: u32, timeout: i32) -> Result<Self, Error> {
+        //TODO: probe?
+        Ok(Self {
+            device,
+            retries,
+            timeout,
+        })
+    }
+
+    unsafe fn command_try(&mut self, cmd: u8, data: &mut [u8]) -> Result<Option<u8>, Error> {
+        const HID_CMD: usize = 1;
+        const HID_RES: usize = 2;
+        const HID_DATA: usize = 3;
+
+        let mut hid_data = [0; 33];
+        if data.len() + HID_DATA > hid_data.len() {
+            return Err(Error::DataLength(data.len()));
+        }
+
+        hid_data[HID_CMD] = cmd;
+        for i in 0..data.len() {
+            hid_data[HID_DATA + i] = data[i];
+        }
+
+        let count = self.device.write(&hid_data).map_err(Error::Hid)?;
+        if count != hid_data.len() {
+            return Err(Error::Verify);
+        }
+
+        let count = self.device.read_timeout(&mut hid_data[1..], self.timeout).map_err(Error::Hid)?;
+        if count == hid_data.len() - 1 {
+            for i in 0..data.len() {
+                data[i] = hid_data[HID_DATA + i];
+            }
+
+            Ok(Some(hid_data[HID_RES]))
+        } else if count == 0 {
+            Ok(None)
+        } else {
+            Err(Error::Verify)
+        }
+    }
+}
+
+impl Access for AccessHid {
+    unsafe fn command(&mut self, cmd: u8, data: &mut [u8]) -> Result<u8, Error> {
+        for _ in 0..self.retries {
+            match self.command_try(cmd, data)? {
+                Some(some) => return Ok(some),
+                None => continue,
+            }
+        }
+
+        Err(Error::Timeout)
+    }
+
+    fn data_size(&self) -> usize {
+        32 - 2
+    }
+}

tool/src/access/lpc/mod.rs

@@ -1,14 +1,16 @@
-pub(crate) const SMFI_CMD_BASE: u16 = 0xE00;
-pub(crate) const SMFI_CMD_SIZE: usize = 0x100;
+const SMFI_CMD_BASE: u16 = 0xE00;
+const SMFI_CMD_SIZE: usize = 0x100;
 
-pub(crate) const SMFI_DBG_BASE: u16 = 0xF00;
-pub(crate) const SMFI_DBG_SIZE: usize = 0x100;
+const SMFI_DBG_BASE: u16 = 0xF00;
+const SMFI_DBG_SIZE: usize = 0x100;
 
-pub(crate) const SMFI_CMD_CMD: u8 = 0x00;
-pub(crate) const SMFI_CMD_RES: u8 = 0x01;
-pub(crate) const SMFI_CMD_DATA: u8 = 0x02;
+const SMFI_CMD_CMD: u8 = 0x00;
+const SMFI_CMD_RES: u8 = 0x01;
+const SMFI_CMD_DATA: u8 = 0x02;
 
+#[cfg(feature = "redox_hwio")]
 pub use self::direct::AccessLpcDirect;
+#[cfg(feature = "redox_hwio")]
 mod direct;
 
 #[cfg(all(feature = "std", target_os = "linux"))]

tool/src/access/mod.rs

@@ -1,6 +1,19 @@
 use crate::Error;
 
+#[cfg(feature = "hidapi")]
+pub use self::hid::AccessHid;
+#[cfg(feature = "hidapi")]
+mod hid;
+
+#[cfg(any(
+    feature = "redox_hwio",
+    all(feature = "std", target_os = "linux")
+))]
 pub use self::lpc::*;
+#[cfg(any(
+    feature = "redox_hwio",
+    all(feature = "std", target_os = "linux")
+))]
 mod lpc;
 
 /// Access method for running an EC command