Skip to content

Commit 7e2f1f3

Browse files
committed
samples: bluetooth: fast_pair: locator_tag: doc firmware update intents
Added general documentation about the firmware update intents in the Fast Pair Locator Tag sample. Ref: NCSDK-32027 Signed-off-by: Kamil Piszczek <[email protected]>
1 parent bea08a6 commit 7e2f1f3

File tree

2 files changed

+27
-0
lines changed

2 files changed

+27
-0
lines changed

doc/nrf/links.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -406,6 +406,8 @@
406406
.. _`nRF Programmer mobile app`: https://www.nordicsemi.com/Products/Development-tools/nrf-programmer
407407

408408
.. _`nRF Connect Device Manager`: https://www.nordicsemi.com/Products/Development-tools/nrf-connect-device-manager
409+
.. _`nRF Connect Device Manager GitHub repository`: https://github.com/NordicSemiconductor/Android-nRF-Connect-Device-Manager
410+
.. _`nRF Connect Device Manager GitHub PR with support for Fast Pair firmware update intents`: https://github.com/NordicSemiconductor/Android-nRF-Connect-Device-Manager/pull/231
409411

410412
.. _`nRF Mesh mobile app`: https://www.nordicsemi.com/Software-and-Tools/Development-Tools/nRF-Mesh
411413

samples/bluetooth/fast_pair/locator_tag/README.rst

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,6 +237,31 @@ This restriction helps satisfy FMDN privacy requirements, which prohibit the loc
237237
Moreover, after entering the DFU mode, the SMP GATT Service UUID is present in the Fast Pair advertising payload which helps to filter and find the devices that are in the DFU mode.
238238
It is located in advertising data when Fast Pair advertising is in the discoverable mode, or in the scan response data when it is in the not discoverable mode.
239239

240+
Android notifications about firmware updates
241+
--------------------------------------------
242+
243+
You can receive Android notifications about the new firmware version for your accessory if you add it during the FMDN provisioning process to the `Find My Device app`_ of your Android device.
244+
The subsequent sections highlight the most important details to have this feature work properly.
245+
246+
The default device model for this sample is configured to support the Android intent feature for firmware updates (the **Firmware Type** option) and to use the `nRF Connect Device Manager`_ application as the Android companion application for this accessory firmware.
247+
See the :ref:`fast_pair_locator_tag_google_device_model` section for configuration details.
248+
249+
This sample also supports the firmware version read operation over Bluetooth and the GATT Device Information Service (DIS).
250+
This mechanism is used by the Android device to read the local firmware version of the Fast Pair accessory in the following cases:
251+
252+
* During the Fast Pair procedure and the FMDN provisioning operation.
253+
* Asynchronously every 24 hours in the FMDN provisioning state.
254+
255+
Whenever the Android device reads the local firmware version of this Fast Pair accessory, it compares the local version with the version registered in the **Firmware Version** field of the Google Nearby Console.
256+
If the local version is different than the registered version, the Android device generates the firmware update intent that is sent to the `nRF Connect Device Manager`_ application.
257+
Then, the `nRF Connect Device Manager`_ application processes the intent and displays the user notification about the new firmware version available for this accessory.
258+
259+
.. note::
260+
The example code for handling the Fast Pair firmware update intents in the Android companion application is available in the `nRF Connect Device Manager GitHub repository`_.
261+
The code has been added as part of the `nRF Connect Device Manager GitHub PR with support for Fast Pair firmware update intents`_.
262+
263+
To learn more about the Android intent feature for firmware updates, see the :ref:`ug_bt_fast_pair_provisioning_register_firmware_update_intent` section in the Fast Pair user guide.
264+
240265
.. _fast_pair_locator_tag_google_device_model:
241266

242267
Fast Pair device registration

0 commit comments

Comments
 (0)