embedded-drivers 0.0.2

Platform-agnostic Rust drivers for BME280/BMP280/BMP180, LM75, PMSx003
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

use super::Device;

/// DS18B20 digital thermometer.
pub struct DS18B20;

/// Initiates a single temperature conversion.
pub const CMD_CONVERT_T: u8 = 0x44;
/// Writes 3 bytes of data to the DS18B20’s scratchpad.
pub const CMD_WRITE_SCRATCHPAD: u8 = 0x4e;
/// Reads the contents of the scratchpad.
pub const CMD_READ_SCRATCHPAD: u8 = 0xbe;
/// Copies the contents of the scratchpad T_H, T_L and configuration registers
/// (bytes 2, 3 and 4) to EEPROM.
pub const CMD_COPY_SCRATCHPAD: u8 = 0x48;
/// Recalls the alarm trigger values and configuration data from EEPROM and
/// places the data in bytes 2, 3, and 4, respectively, in the scratchpad memory.
pub const CMD_RECALL_EEPROM: u8 = 0xb8;
/// Determines if any DS18B20s on the bus are using parasite power.
pub const CMD_POWER_SUPPLY: u8 = 0xb4;

#[repr(u8)]
pub enum Resolution {
    Nine = 0b000_11111,
    Ten = 0b001_11111,
    Eleven = 0b010_11111,
    Twelve = 0b011_11111,
}

impl Resolution {
    pub fn bits(&self) -> u8 {
        match self {
            Resolution::Nine => 9,
            Resolution::Ten => 10,
            Resolution::Eleven => 11,
            Resolution::Twelve => 12,
        }
    }

    pub fn conversion_time_ms(&self) -> u16 {
        match self {
            Resolution::Nine => 94,
            Resolution::Ten => 188,
            Resolution::Eleven => 375,
            Resolution::Twelve => 750,
        }
    }
}

impl Default for Resolution {
    fn default() -> Self {
        Resolution::Twelve
    }
}

pub struct Config {
    pub resolution: Resolution,
    pub t_h: i8,
    pub t_l: i8,
}

impl Default for Config {
    fn default() -> Self {
        Config {
            resolution: Resolution::Twelve,
            t_h: 125,
            t_l: -55,
        }
    }
}

pub trait DB18B20Ext {
    /// Write Scratchpad
    fn set_config(&mut self, config: Config);

    fn read_config(&mut self) -> Config;

    /// Convert T
    fn start_measurement(&mut self);

    /// Read Scratchpad
    fn read_measurement(&mut self) -> f32;

    /// Read raw measurement, avoiding using floats.
    fn read_raw_measurement(&mut self) -> [u8; 2];

    // Save config to EEPROM
    /// Copy Scratchpad
    fn save_config(&mut self);

    /// Recall E^2
    fn load_saved_config(&mut self);

    /// Read Power Supply
    fn is_parasite(&mut self) -> bool;
}