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

pub mod comfort_level;
pub mod history;
pub mod readings;
pub mod temperature_unit;
pub mod time;

use std::time::SystemTime;
use thiserror::Error;

const TEMPERATURE_MAX: f32 = i16::MAX as f32 * 0.01;
const TEMPERATURE_MIN: f32 = i16::MIN as f32 * 0.01;

/// An error decoding a property from a sensor.
#[derive(Clone, Debug, Error, Eq, PartialEq)]
pub enum DecodeError {
    /// The value being decoded wasn't the expected length.
    #[error("Wrong length {length}, expected {expected_length}")]
    WrongLength {
        length: usize,
        expected_length: usize,
    },
    /// The value being decoded was invalid in some other way.
    #[error("{0}")]
    InvalidValue(String),
}

/// An error encoding a property to be sent to a sensor.
#[derive(Clone, Debug, Error)]
pub enum EncodeError {
    /// The temperature value given is out of the range which can be encoded.
    #[error("Temperature {0} out of range.")]
    TemperatureOutOfRange(f32),
    /// The time value given is out of the range which can be encoded.
    #[error("Time {0:?} out of range.")]
    TimeOutOfRange(SystemTime),
}

fn decode_temperature(bytes: [u8; 2]) -> f32 {
    i16::from_le_bytes(bytes) as f32 / 100.0
}

fn encode_temperature(temperature: f32) -> Result<[u8; 2], EncodeError> {
    if !(TEMPERATURE_MIN..=TEMPERATURE_MAX).contains(&temperature) {
        return Err(EncodeError::TemperatureOutOfRange(temperature));
    }
    let temperature_fixed = (temperature * 100.0) as i16;
    Ok(temperature_fixed.to_le_bytes())
}

fn check_length(length: usize, expected_length: usize) -> Result<(), DecodeError> {
    if length != expected_length {
        Err(DecodeError::WrongLength {
            length,
            expected_length,
        })
    } else {
        Ok(())
    }
}