wiecosystem / Bluetooth

Documentation of the Bluetooth/BLE devices
85 stars 18 forks source link

Bluetooth/BLE

General information on how BLE is used in Xiaomi's devices.

General context

Xiaomi (and it's many, many sub-brands) uses several wireless protocols for their devices, mainly zigbee (aqara devices), BLE (many "standalone" devices and smartbands/smartwatches from huami and amazfit), and wifi (usually their "biggest" devices such as the vacuum cleaner, and some yeelight devices, basically, what's guaranteed to have enough power at all times)

Xiaomi is known to share it's logistics division with it's sub-OEMs, and also it's "Mi Home" ecosystem. They also seems to share some proprietary protocols, especially in BLE and zigbee.

BLE notes

Devices covered (Aka. what's coming sooner or later)

If you have a xiaomi ecosystem device and did reverse engineer it, feel free to contribute. For now, for obvious reasons, i'll focus on some devices i already own:

Device name Device ID Documentation Status
Mi Body Composition Scale huami.health.scale2* Doc Done
Mi toothbrush soocare.toothbrush.m1 Doc Done
Yeelight Bedside lamp yeelink.light.ble1 Doc TODO
Mi LED Desk lamp yeelink.light.lamp1 Doc TODO
Yeelight Candela yeelink.light.mb2grp Doc TODO
Mi Kettle V1 yunmi.kettle.v1 Doc TODO
Temperature/Humidity sensor cleargrass.sensor_ht.dk1 Doc WIP
Flora plant monitor hhcc.plantmonitor.v1 Doc TODO
Mi Band 1 xiaomi.watch.band1 Doc TODO
Mi Band 2 xiaomi.watch.band2 Doc TODO
iHealth Track Blood Pressure Monitor ihealth.bp.550bt Doc WIP

* Guesstimate, it isn't in mi home, but in some other app, of the ecosysteme or OEM's one

And for other protocols?