Deleting the wiki page 'Companion Device pairing' cannot be undone. Continue?
15
Companion Device pairing
vanous edited this page 4 months ago
On phones running Android 8.0 (API level 26) and higher, it's possible to use companion device pairing. After the device is paired using this method, the device can leverage the REQUEST_COMPANION_RUN_IN_BACKGROUND permission to start the app from the background. This provides a better way for Gadgetbridge to keep its service running, read more about background service stability here.
In the future there might be a possibility to use companion device pairing to perform a Bluetooth (or Wi-Fi) scan of nearby devices, without requiring the ACCESS_FINE_LOCATION or BLUETOOTH_ADMIN permission. This would minimize the number of permissions needed. Currently, these permissions are still required. See more details here: https://developer.android.com/guide/topics/connectivity/companion-device-pairing
To utilize this in Gadgetbridge, first enable it in the settings and then you must re-pair your device. You can either un-pair it in your phone's settings and re-pair it, or disable "Ignore paired devices" in the settings. After that is done, you can simply disconnect it (long tap the device in Gadgetbridge Control Center) and press the 
icon, locate the device in the list (it might say Already bonded), tap it and follow the process.
See step by step:
- Disconnect first:
- Disconnected:
- Tap the and select device in the list:
- Follow the process:
- Select OK on the Link question:
General
- Home
- ReadMe
- Configuration
- Notifications
- ChangeLog
- Widget
- Weather
- Data Backup
- Pairing
- Permissions Explained
Sports/Activities
Device Related
- Pebble
- PineTime
- Huami devices
- HPlus
- MyKronoz ZeTime
- Casio devices
- Fossil Hybrid HR
- iTag
- Support for a new Device
Development
- How to Release
- Developer Documentation
- BT Protocol Reverse Engineering
- Support for a new Device
- New Device Tutorial
- Translating Gadgetbridge
Feature Discussion
FAQ
Delete Page