i2cdriver 0.1.0

Use Excamera I2CDriver and I2CMini devices from Rust, optionally via embeddded-hal traits.
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

use thiserror::Error;

#[derive(Error, Debug)]
pub enum ProtocolError {
    #[error(transparent)]
    UTF(#[from] core::str::Utf8Error),
    #[error(transparent)]
    Scan(#[from] scan_fmt::parse::ScanError),
    #[error("Unparsable response: {0:?}")]
    Parse(Vec<u8>),
}

#[derive(Error, Debug)]
pub enum Error {
    #[error("No ACK received for address")]
    MissingAddrAck,
    #[error("No ACK received for data")]
    MissingDataAck,
    #[error("I2C bus arbitration lost")]
    Arbitration,
    #[error("Timeout waiting for response")]
    Timeout,
    #[error("Could not open {path}: {source}")]
    Open {
        path: String,
        source: serialport::Error,
    },
    #[error("Invalid Address: {0}")]
    Address(u8),
    #[error("Communication Failure: {0}")]
    Transport(#[source] std::io::Error),
    #[error("Could not parse response: {0}")]
    Protocol(#[from] ProtocolError),
}

impl From<std::io::Error> for Error {
    fn from(item: std::io::Error) -> Self {
        match item.kind() {
            std::io::ErrorKind::TimedOut => Error::Timeout,
            _ => Error::Transport(item),
        }
    }
}

#[cfg(feature = "eh1")]
impl embedded_hal_1::i2c::Error for Error {
    fn kind(&self) -> embedded_hal_1::i2c::ErrorKind {
        use embedded_hal_1::i2c::ErrorKind;

        match self {
            Self::Arbitration => ErrorKind::ArbitrationLoss,
            Self::MissingAddrAck => {
                ErrorKind::NoAcknowledge(embedded_hal_1::i2c::NoAcknowledgeSource::Address)
            }
            Self::MissingDataAck => {
                ErrorKind::NoAcknowledge(embedded_hal_1::i2c::NoAcknowledgeSource::Data)
            }
            _ => ErrorKind::Other,
        }
    }
}