Xiaomi protobuf watches¶
The following list includes all implemented features for Xiaomi protobuf devices. These are called protobuf devices because they use protobuf for the protocol, unlike other Huami devices. The actual supported features can vary for each device.
Experimental
Support for these devices is recent, and still experimental. This page is also still a work in progress and not complete.
List of supported Xiaomi gadgets by Gadgetbridge which use protobuf:
Implemented features¶
These features are supported by Gadgetbridge and apply to all Xiaomi watch models included in this page. Note that actual available features per device depends on the device capabilities.
List of features supported by Gadgetbridge
Activity Sync¶
Activity sync is very experimental. It was mainly tested on the Mi Band 8, and may present issues on other devices.
Implemented:
- Heart rate, steps
- SpO2
- Stress
- Vitality Score (equivalent to PAI)
- Sleep times and sleep stages
- Skin temperature (Watch S1 Pro)
Missing:
- Calories (fetched, but no UI)
- Moving time
- Standing time (fetched, but no UI)
- VO2 Max
- Blood pressure
- Body temperature (Watch S1 Pro) (fetched, but no UI)
- Training load (fetched, but no UI)
- Sleep respiratory rate
- Heart rate stats (resting, min, max, average - fetched, but no UI)
- SpO2 stats (min, max, average - fetched, but no UI)
- Workouts (partially implemented)
Known issues¶
Open issues
Do not forget to check any other open issues in the project repository.
- Wearing mode must be changed at least once from the watch for the preference to show in Gadgetbridge
- A toast about an error syncing calendar database sometimes appears
- Sleep stages do not work for all devices
Missing features¶
- Some settings:
- Change the app layout
- Raise to wake sensitivity and schedule
- Manage Workouts
- Vibration patterns
- DND Sync
- World Clocks
- Firmware parsing (they can be installed, but must be set in the code)
- Cycles
- Send phone alarms to watch
Multiple connection types¶
Some Xiaomi devices support both Bluetooth LE and Classic, depending on the firmware version. Right now, Gadgetbridge is unable to determine which connection type the device supports, so pairing or connecting to the device might fail.
If you face any issues during pairing or connecting, please attempt the following steps:
- Pair the device in Android bluetooth settings
- In Gadgetbridge, go to the Debug menu
- Click "Add test device manually"
- Select the device type and input the mac address
- Add the device
- Click the ⚙️ button on the device card
- Go to the "Authentication" page, set the auth key
- Go to the "Connection" page, and try to force the connection type to "Bluetooth Classic"
Connecting to the device should now work. If you are still facing issues, please open an issue or reach out on Matrix.