Skip to content

Xiaomi Scooters

Experimental

Support for Xiaomi scooters is experimental and not heavily tested.

Supported features

  • Settings
    • Ride mode (standard/walking/sport - read-only, not displayed)
    • Motor lock
    • Speed unit (m/h, km/h)
    • Lights
      • Taillight always on
      • Auto lights
      • Ambient light
    • Assisted driving
      • Traction Control System (anti-slip)
      • Slope parking
      • Energy recovery intensity
      • Smart energy recovery
    • Bluetooth always on (search scooter via BT)
    • Find scooter
  • Read information
    • Date put into service
    • Firmware version
    • Serial number
    • Scooter temperature (no UI)
  • Read battery info
    • Real-time battery telemetry
    • Charge percentage
    • Voltage, current, power
    • Range
    • Cycles
    • Manufactured date
    • Serial
    • BMS firmware version
    • Temperature

Missing features

  • Sync ride history
  • Some settings
    • Tire pressure maintenance
  • Some scooter information
    • Total distance
  • Some battery information
    • Status
    • Remaining capacity (mAh)
    • Energy throughput
    • Capacity throughput
    • Over-charging events
    • Charging time in extreme temperatures
    • Storage and use time in extreme temperatures
  • Firmware updates

Auth key

The Xiaomi scooters require server based pairing. This means, that you absolutely must use the original Mi Home app to make the initial pairing, retrieve the auth key, and then use this key to pair with Gadgetbridge. This requires a rooted phone.

Usage of non-free (as-in freedom) software ahead

Unfortunately, these steps will take you outside of Gadgetbridge and require you to create an account with your gadget's vendor's website and/or download a proprietary app.

As the authentication keys are stored on vendor servers, there is no way to generate these keys locally at the moment.

  1. Pull the following file from the Mi Home's data folder, replacing <ownerId> and <countryCode>: 

    /data/data/com.xiaomi.smarthome/shared_prefs/ble_device_prop_cache.<ownerId>.<countryCode>.xml

  2. Decrypt the auth key using the extract_ltmk.py script:<> 

    uv run extract_ltmk.py --xml ble_device_prop_cache.1234567890.de.xml --mac 11:22:33:44:55:66

Scooter 5 Max

Mostly supported
Mostly supportedMissing a few features, but it should be enough to cover essential daily tasks.
Requires vendor app auth keyYou need to pair with vendor app first, and extract the auth key, before being able to connect to Gadgetbridge. After that, the vendor app is not needed anymore.
ExperimentalAs we don't have that device it is not known if it works correctly. You can help us by testing yourself!

device__xiaomi_scooter_5_max

has_flag__feature_most

has_flag__pair_auth_key

has_flag__experimental

Not yet released

Support for this gadget has been added to Gadgetbridge's codebase, but is not yet released. It is already available in the nightly releases.

Tested with firmwares 2.5.3_0011 and 2.7.0_0015.