9 Pairing
Petr Vaněk edited this page 4 months ago


Pairing establishing a connection between two Bluetooth devices. It can be a complex process and the type of pairing can determine what possibilities are given to the connected device during day-to-day operation.

Pairing types and Auth Key

This describes types of pairing and how Gadgetbridge uses an auth key as a secret. Read more here.

Huami Server Pairing

Some device (Mi Bands, Amazfit watches and perhaps other brands too) from certain version of their firmware require server based pairing. For example Mi Band 3 does not require this. Mi Band 4 and Mi Band 5 do require this. This means that for devices that require server base pairing you absolutely must use the original MiFit, Amzfit, Zepp or other official app to make the initial pairing, retrieve the pairing key and then use this key to pair with Gadgetbridge. Read more here.

Companion Device pairing

Companion Device Management is a new Android way to establish entrusted connection between devices. It can be benefitial as this can provide better environment for Gadgetbridge to run in the background, launch activities from background - for example during the Find my phone command. Read more here.

Pebble Pairing

Pebble and Pebble2 related tips for the pairing process.