m365 0.1.1

A lightweight rust library to receive BLE Xiaomi M365 scooter messages
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
103

use core::fmt::Debug;
use pretty_hex::*;

#[derive(Clone)]
pub enum Direction {
  MasterToMotor,
  MasterToBattery,
  MotorToMaster,
  BatteryToMaster,
}

impl Direction {
  fn value(&self) -> u8 {
    match self {
      Direction::MasterToMotor      => 0x20,
      Direction::MasterToBattery    => 0x22,
      Direction::MotorToMaster      => 0x23,
      Direction::BatteryToMaster    => 0x25,
    }
  }
}

#[derive(Clone)]
pub enum ReadWrite {
  Read,
  Write
}

impl ReadWrite {
  fn value(&self) -> u8 {
    match self {
      ReadWrite::Read     => 0x01,
      ReadWrite::Write    => 0x03
    }
  }
}

#[derive(Clone)]
pub enum Attribute {
  GeneralInfo,
  MotorInfo,
  DistanceLeft,
  Speed,
  TripDistance,
  BatteryVoltage,
  BatteryCurrent,
  BatteryPercent,
  BatteryCellVoltages,
  Supplementary,
  Cruise,
  TailLight,
  BatteryInfo
}

impl Attribute {
  fn value(&self) -> u8 {
    match self {
      Attribute::GeneralInfo          => 0x10,
      Attribute::DistanceLeft         => 0x25,
      Attribute::Speed                => 0xB5,
      Attribute::TripDistance         => 0xB9,
      Attribute::BatteryVoltage       => 0x34,
      Attribute::BatteryCurrent       => 0x33,
      Attribute::BatteryPercent       => 0x32,
      Attribute::MotorInfo            => 0xB0,
      Attribute::BatteryCellVoltages  => 0x40,
      Attribute::Supplementary        => 0x7B,
      Attribute::Cruise               => 0x7C,
      Attribute::TailLight            => 0x7D,
      Attribute::BatteryInfo          => 0x31
    }
  }
}

#[derive(Clone)]
pub struct ScooterCommand {
  pub direction: Direction,
  pub read_write: ReadWrite,
  pub attribute: Attribute,
  pub payload: Vec<u8>
}

impl Debug for ScooterCommand {
  fn fmt(&self, form: &mut std::fmt::Formatter<'_>) -> std::result::Result<(), std::fmt::Error> {
    let message = format!("{:?}", self.as_bytes().hex_dump());
    form.write_str(&message).unwrap();
    Ok(())
  }
}

impl ScooterCommand {
  pub fn as_bytes(&self) -> Vec<u8> {
    let mut bytes : Vec<u8> = Vec::new();
    bytes.push(self.payload.len() as u8 + 2u8);
    bytes.push(self.direction.value());
    bytes.push(self.read_write.value());
    bytes.push(self.attribute.value());
    for byte in &self.payload {
      bytes.push(*byte);
    }
    bytes
  }
}