Huawei/Honor pairing¶

Pair without factory reset¶

As of pull request #3721 it is possible to pair a device with Gadgetbridge without factory reset after using the official app. For this, you need to get the Huawei account ID, a 17-digit number.

Authentication key negotiation failed¶

If you connected to the official app and are now seeing a "Authentication key negotiation failed" error, you need to follow one of the following options:

1. Factory reset the watch before connecting back to Gadgetbridge
2. Get the account ID, so that Gadgetbridge is able to connect again, by following the steps below

Getting the account ID¶

Through the website¶

On Firefox:¶

1. Go to https://cloud.huawei.com/ and log in
2. Press F12
3. Go to the Storage tab in the newly opened view
4. If not selected, select https://cloud.huawei.com/ under the Cookies header on the left (this should be selected by default)
5. In the Name column, look for userId. In the Value column, you should see a 17 digit number.
6. Copy that key into your clipboard and jump to the next section to continue.

Entering key

On Chrome/a Chromium based browser:¶

1. Go to https://cloud.huawei.com/ and log in
2. Press F12
3. Go to the Application tab in the newly opened view
4. To the left under Storage, click the little downward arrow next to Cookies and open the cookie named https://cloud.huawei.com/
5. In the Name column, look for userId. In the Value column, you should see a 17 digit number.
6. Copy that key into your clipboard and jump to the next section to continue.

Entering key

On rooted phones¶

Run following command in a root shell. (e.g. Termux for on-device, or ADB for on-computer)

grep old_user_id /data/data/com.huawei.health/shared_prefs/login_data.xml

This should output something similar to this:

 <string name="old_user_id">20007000023812345</string>

The account ID in this example would be 20007000023812345.

Now, keep that key in your clipboard and jump to the next section to continue.

Entering key

Without root¶

It has also been reported that the key is printed to logcat by the official app.

Use the adb logcat command and search for huid=, you should be able to find the value for the key.

Entering key

Entering key¶

Before entering the key and attempting to connect, you should remove all permissions from the vendor app or uninstall it, since it can conflict with Gadgetbridge. Do not unpair the watch from the vendor app, as that will invalidate the auth key.

If you are currently on the "Device discovery" page, long press on the device name and click on "Auth key" to enter the key.

If you added the gadget already, touch the icon under your gadget name (while on the home screen) to go to the "Device specific settings", open the " Authentication" menu, and click on "Auth key" to enter the key.

After entering your account ID, you should be able to connect to both the official app and Gadgetbridge without resetting the band every time.

Note that reconnecting to Gadgetbridge requires you to pair the device again - you can do this by disconnecting the device first, and then using the Add on the bottom-right corner of the home screen to pair the device again. You do not delete the device before you do this! Deleting the device will also delete the associated data!

Now you're ready to start using Gadgetbrigde!

Configuring your gadget