Get info about your Xiaomi Mijia 365 Scooter via BLE (Bluetooth Low Energy). This is using btleplug which is an async Rust BLE library, supporting Windows 10, macOS, Linux, and iOS. I did test this only on my linux laptop and It should in theory work with other systems.
Each example shows you how to interact with your scooter. Before you can read any information, you need to get auth token.
This protocol is used in m365, mi-lite-1-s, mi-pro, mi-pro2 and mi-pro3.
Registering / pairing with devices unpairs the device from all other apps! If you want to use your device with other apps after pairing, either reinstall or remove / re-add the device inside the app.
This package includes the example to scan and list nearby M365 Scooters. Simply execute the package as such:
$ cargo run --example scanner2022-03-01T20:24:52.433166Z DEBUG m365::scanner: Starting scanning for new devices
2022-03-01T20:24:52.445873Z DEBUG m365::scanner: Watching for events in background
2022-03-01T20:25:25.786072Z INFO scanner: Found scooter nearby: MIScooter7353 with mac: D5:01:45:37:ED:FD
To get auth token from scooter run example register and pass mac address of your scooter. Registration token will be persisted as file .mi-token
$ cargo run --example register D5:01:45:37:ED:FDYou can check how you can login and read serial number using this example
$ cargo run --example login D5:01:45:37:ED:FDRead all information from scooter
$ cargo run --example about D5:01:45:37:ED:FD2022-03-12T18:35:47.751207Z INFO about: Searching scooter with address: D5:01:45:37:ED:FD
2022-03-12T18:35:47.769772Z INFO m365::scanner: Found your scooter
2022-03-12T18:36:02.811852Z INFO m365::login: Validating did
2022-03-12T18:36:02.930741Z INFO m365::login: Logged in!
2022-03-12T18:36:03.350317Z INFO about: Logged in with success, reading data...
2022-03-12T18:36:03.410690Z INFO about: Battery info: BatteryInfo { capacity: 7392, percent: 63, current: 0.01, voltage: 36.74, temperature_1: 44, temperature_2: 44 }
2022-03-12T18:36:03.502199Z INFO about: Battery cells (V): [36.71, 36.73, 36.71, 36.75, 36.74, 36.76, 36.78, 36.78, 36.8, 36.77]
2022-03-12T18:36:03.561323Z INFO about: Serial number 26354/00467353
2022-03-12T18:36:03.652204Z INFO about: Motor info: MotorInfo { battery_percent: 63, speed_kmh: 0, speed_average_kmh: 0, total_distance_m: 1306083, trip_distance_m: 0, uptime: 260s, frame_temperature: 24.0 }
2022-03-12T18:36:03.710897Z INFO about: Supplementary info SupplementaryInfo { kers: Weak, is_cruise: false, tail_light: Off }
2022-03-12T18:36:03.771259Z INFO about: General info GeneralInfo { serial: "26354/00467", pin: "353000", version: "00" }
2022-03-12T18:36:03.830117Z INFO about: Distance left 28.35 km
2022-03-12T18:36:03.890595Z INFO about: Trip distance 0 km
2022-03-12T18:36:03.951109Z INFO about: Current Speed 0 km/h
2022-03-12T18:36:04.011104Z INFO about: Cruise enabled: false
2022-03-12T18:36:04.070594Z INFO about: Tail light enabled: Off
2022-03-12T18:36:04.130628Z INFO about: Battery 36.74 V
2022-03-12T18:36:04.221106Z INFO about: 0 A
2022-03-12T18:36:04.311157Z INFO about: 63 %
2022-03-12T18:36:04.370719Z INFO about: BatteryInfo { capacity: 7392, percent: 63, current: 0.0, voltage: 36.74, temperature_1: 44, temperature_2: 44 }
You can check how to change tail light and cruise mode with this example
$ cargo run --example settings D5:01:45:37:ED:FDSee LICENSE.md
I'm in no way affiliated with Xiaomi or any of their subsidiaries and products. This code has been provided for research purposes only.
- https://github.com/danielkucera/mi-standardauth
- https://learning-rust.github.io/docs/a4.cargo,crates_and_basic_project_structure.html
- https://github.com/CamiAlfa/M365-BLE-PROTOCOL
- https://github.com/AntonHakansson/m365py
- https://github.com/michaljach/m365-info/blob/master/M365Info.swift
- https://learn.adafruit.com/introduction-to-bluetooth-low-energy/gatt
- https://github.com/drogue-iot/burrboard/blob/9e10c87a596fe29055e2a302c2753963bcc545cd/gatt-client/src/board.rs
- https://github.com/deviceplug/btleplug
- https://github.com/pretzelhammer/rust-blog/blob/master/posts/common-rust-lifetime-misconceptions.md#2-if-t-static-then-t-must-be-valid-for-the-entire-program
- https://github.com/cheetahdotcat/m365-mi
- https://github.com/dnandha/miauth/tree/main/lib/java
- https://github.com/dnandha/miauth
- https://pypi.org/project/miauth/#files
- https://github.com/cheetahdotcat/m365-mi/blob/master/mim365mi/m365scooter.py
- https://github.com/stepanbenes/doorkeeper/blob/a70c08ad738fe4390e374c925e779fc6b9e67433/src/main.rs
- tokio-rs/tokio#3362
- https://depth-first.com/articles/2020/06/22/returning-rust-iterators/
- https://github.com/Emeryth/ReadM365/blob/master/readM365.py
- https://github.com/heardrwt/Xiaomi-M365-Display/blob/5414aa9ef6a7d6d76c8b88deedc90e148b1812f4/ninebot_module.c#L175