jabi 0.1.1

Rust library for JABI (Just Another Bridge Interface)
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

use crate::interfaces::InterfaceRequest;
use crate::Error;
use deku::{DekuContainerWrite, DekuUpdate, DekuWrite};

pub enum I2CFreq {
    Standard = 0, // 100kHz
    Fast = 1,     // 400kHz
    FastPlus = 2, // 1MHz
    High = 3,     // 3.4MHz
    Ultra = 4,    // 5MHz
}

enum Func {
    SetFreq = 0,
    Write = 1,
    Read = 2,
    Transceive = 3,
}

fn gen_req(f: Func, idx: usize, payload: Vec<u8>) -> Result<InterfaceRequest, Error> {
    let mut r = InterfaceRequest {
        periph_id: crate::InstID::I2C as u16,
        periph_idx: idx as u16,
        periph_fn: f as u16,
        payload_len: 0,
        payload: payload,
    };
    r.update().map_or(Err(Error::PacketFormat), |_| Ok(r))
}

impl crate::Device {
    pub fn i2c_set_freq(&self, idx: usize, preset: I2CFreq) -> Result<(), Error> {
        #[derive(DekuWrite)]
        #[deku(endian = "little")]
        struct SetFreqRequest {
            preset: u8,
        }
        let req = SetFreqRequest {
            preset: preset as u8,
        };
        let resp = self.send(&gen_req(Func::SetFreq, idx, req.to_bytes().unwrap())?)?;
        if resp.len() == 0 {
            Ok(())
        } else {
            Err(Error::PacketFormat)
        }
    }

    pub fn i2c_write(&self, idx: usize, addr: u16, data: &[u8]) -> Result<(), Error> {
        #[derive(DekuWrite)]
        #[deku(endian = "little")]
        struct WriteRequest<'a> {
            addr: u16,
            data: &'a [u8],
        }
        let req = WriteRequest { addr, data };
        let resp = self.send(&gen_req(Func::Write, idx, req.to_bytes().unwrap())?)?;
        if resp.len() == 0 {
            Ok(())
        } else {
            Err(Error::PacketFormat)
        }
    }

    pub fn i2c_read(&self, idx: usize, addr: u16, len: usize) -> Result<Vec<u8>, Error> {
        #[derive(DekuWrite)]
        #[deku(endian = "little")]
        struct ReadRequest {
            addr: u16,
            data_len: u16,
        }
        let req = ReadRequest {
            addr,
            data_len: len as u16,
        };
        let resp = self.send(&gen_req(Func::Read, idx, req.to_bytes().unwrap())?)?;
        Ok(resp)
    }

    pub fn i2c_transceive(
        &self,
        idx: usize,
        addr: u16,
        data: &[u8],
        read_len: usize,
    ) -> Result<Vec<u8>, Error> {
        #[derive(DekuWrite)]
        #[deku(endian = "little")]
        struct TransceiveRequest<'a> {
            addr: u16,
            data_len: u16,
            data: &'a [u8],
        }
        let req = TransceiveRequest {
            addr,
            data_len: read_len as u16,
            data,
        };
        let resp = self.send(&gen_req(Func::Transceive, idx, req.to_bytes().unwrap())?)?;
        Ok(resp)
    }
}