mijia 0.8.0

A library for connecting to Xiaomi Mijia 2 Bluetooth temperature/humidity sensors.
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

use crate::decode::{DecodeError, check_length, decode_temperature};
use std::cmp::max;
use std::convert::TryInto;
use std::fmt::{self, Display, Formatter};

/// A set of readings from a Mijia sensor.
#[derive(Clone, Debug, PartialEq)]
pub struct Readings {
    /// Temperature in ºC, with 2 decimal places of precision
    pub temperature: f32,
    /// Percent humidity
    pub humidity: u8,
    /// Voltage in millivolts
    pub battery_voltage: u16,
    /// Inferred from `battery_voltage` with a bit of hand-waving.
    pub battery_percent: u16,
}

impl Display for Readings {
    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
        write!(
            f,
            "Temperature: {:.2}ºC Humidity: {:?}% Battery: {:?} mV ({:?}%)",
            self.temperature, self.humidity, self.battery_voltage, self.battery_percent
        )
    }
}

impl Readings {
    /// Decode the readings from the raw bytes of the Bluetooth characteristic value, if they are
    /// valid.
    /// Returns `None` if the value is not valid.
    pub(crate) fn decode(value: &[u8]) -> Result<Readings, DecodeError> {
        check_length(value.len(), 5)?;

        let mut temperature_array = [0; 2];
        temperature_array.clone_from_slice(&value[..2]);
        let temperature = decode_temperature(temperature_array);
        let humidity = value[2];
        let battery_voltage = u16::from_le_bytes(value[3..5].try_into().unwrap());
        let battery_percent = (max(battery_voltage, 2100) - 2100) / 10;
        Ok(Readings {
            temperature,
            humidity,
            battery_voltage,
            battery_percent,
        })
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn decode_empty() {
        assert_eq!(
            Readings::decode(&[]),
            Err(DecodeError::WrongLength {
                length: 0,
                expected_length: 5
            })
        );
    }

    #[test]
    fn decode_too_short() {
        assert_eq!(
            Readings::decode(&[1, 2, 3, 4]),
            Err(DecodeError::WrongLength {
                length: 4,
                expected_length: 5
            })
        );
    }

    #[test]
    fn decode_too_long() {
        assert_eq!(
            Readings::decode(&[1, 2, 3, 4, 5, 6]),
            Err(DecodeError::WrongLength {
                length: 6,
                expected_length: 5
            })
        );
    }

    #[test]
    fn decode_valid() {
        assert_eq!(
            Readings::decode(&[1, 2, 3, 4, 10]),
            Ok(Readings {
                temperature: 5.13,
                humidity: 3,
                battery_voltage: 2564,
                battery_percent: 46
            })
        );
    }
}