Skip to content

Xiaomi Scooters

See also other Xiaomi devices

This page lists scooters only of Xiaomi. They also has different kind of gadgets supported by Gadgetbridge:

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
    • Tire pressure maintenance
      • Enable / disable
      • Set interval (14d, 30, 60d, 180d)
      • Reset reminder
    • Bluetooth always on (search scooter via BT)
    • Find scooter
  • Read information
    • Date put into service
    • Firmware version
    • Serial number
    • Scooter temperature (with charts)
  • Read battery info
    • Real-time battery telemetry
    • Charge percentage
    • Voltage, current, power (with charts)
    • Range
    • Cycles
    • Manufactured date
    • Serial
    • BMS firmware version
    • Temperature (with charts)
  • Sync ride history
    • Duration, distance, average speed
    • Device does not report the time where the ride took place, so it is persisted at time of sync

Missing features

  • 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

Highly supported
Highly supportedAll features or at least all major features are supported, which is enough to cover almost all cases.
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.

device__xiaomi_scooter_5_max

has_flag__feature_high

has_flag__pair_auth_key

Tested with firmwares 2.5.3_0011 and 2.7.0_0015.