Zepp OS extras¶
Experimental settings¶
Some Zepp OS features are experimental - they are not fully tested, and they can be unstable. Use them at your own risk.
To enable them:
- Open " Settings → Developer options" in the main menu, and enable "Experimental settings".
- Open " Device specific settings" for the watch. Go to "Experimental settings", and enable the features that you want to use.
- Reconnect the watch.
| Setting | Description |
|---|---|
| App management | Manage the installed apps from Gadgetbridge. It is possible to uninstall system apps, which may be dangerous. The UI sometimes does not refresh. |
| Assistant service | Receive the voice from the Alexa / Zepp Flow assistant. This adds the "Voice Assistant" screen in "Developer settings", with debug options and the voice service preferences. |
Assistant voice service¶
Not yet released
Support for this feature has been added to Gadgetbridge's codebase, but is not yet released. It is already available in the nightly releases.
Added in pull request #7233.
Gadgetbridge can send the voice from the watch assistant (Alexa / Zepp Flow) to a voice service app on the phone. The voice service app can then send a text reply back, and the watch displays it.
To use it:
- Enable the assistant service experimental setting, and reconnect the watch.
- Open "Device specific settings" → "Developer settings" → "Voice Assistant".
- Set "Voice service package" and "Voice service class" to the package name and the full class name of the service in the voice service app.
Voice Service API¶
Gadgetbridge binds to the configured service with the following action:
Gadgetbridge sends Messages to the service's Messenger. Each message has a replyTo messenger.
what
| Direction | Extras | Description |
|---|---|---|---|
0
| Gadgetbridge → Service | VOICE_DATA (byte array), VOICE_ENCODING (always "OPUS")
| One Opus frame, 16 kHz, mono. |
1
| Gadgetbridge → Service | none | The recording ended. The service can now send its reply. |
100
| Service → Gadgetbridge | TITLE, SUBTITLE, TEXT (strings)
| The reply to show on the watch. If TITLE and SUBTITLE are empty, the watch shows only TEXT.
|
101
| Service → Gadgetbridge | TEXT (string)
| An error message to show on the watch. |
Decoding workout summary¶
The workout summary consists of 2 bytes containing the summary version, followed by a protobuf encoded payload.
You can decode it using the following, for version 0x0080:
cat null_summary.bin | \
dd bs=1 skip=2 | \
protoc --decode WorkoutSummary --proto_path ~/workspace/Gadgetbridge/app/src/main/proto huami.proto
Change region¶
You can use the Device Settings Intent API to change the device region, by setting the device_region string preference (added in commit 483ef27a4f). The region should be a 2-letter code (eg. de for Germany).