Skip to content

Commit 235ede3

Browse files
committed
samples: bluetooth: fast_pair: locator_tag: doc: update testing section
Updated the testing section in the Readme file of the Fast Pair Locator tag sample. The new content describes the procedure to test the firmware update notification feature. Ref: NCSDK-32027 Signed-off-by: Kamil Piszczek <[email protected]>
1 parent 7e2f1f3 commit 235ede3

File tree

2 files changed

+116
-0
lines changed

2 files changed

+116
-0
lines changed
45.6 KB
Loading

samples/bluetooth/fast_pair/locator_tag/README.rst

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -704,6 +704,12 @@ Testing
704704

705705
#. Initiate the connection and trigger the Fast Pair procedure by tapping the :guilabel:`Connect` button.
706706
After the procedure is complete, you will see a pop-up with the Acceptable Use Policy for the `Find My Device app`_.
707+
708+
.. note::
709+
If you use the default debug device model and you have the `nRF Connect Device Manager`_ application installed on your test Android device, you may get the Android notification from this mobile application about the new firmware update.
710+
You can ignore this notification, as it is not related to the Fast Pair provisioning process.
711+
To test the notification feature, follow the :ref:`fast_pair_locator_tag_testing_fw_update_notifications` test section.
712+
707713
#. If you want to start the FMDN provisioning, accept the Acceptable Use Policy by tapping the :guilabel:`Agree and continue` button.
708714

709715
.. figure:: /images/bt_fast_pair_locator_tag_acceptable_use_policy.png
@@ -768,6 +774,12 @@ Testing
768774

769775
#. Initiate the connection and trigger the Fast Pair procedure by tapping the :guilabel:`Connect` button.
770776
After the procedure is complete, you will see a pop-up with the Acceptable Use Policy for the `Find My Device app`_.
777+
778+
.. note::
779+
If you use the default debug device model and you have the `nRF Connect Device Manager`_ application installed on your test Android device, you may get the Android notification from this mobile application about the new firmware update.
780+
You can ignore this notification, as it is not related to the Fast Pair provisioning process.
781+
To test the notification feature, follow the :ref:`fast_pair_locator_tag_testing_fw_update_notifications` test section.
782+
771783
#. If you want to start the FMDN provisioning, accept the Acceptable Use Policy by tapping the :guilabel:`Agree and continue` button.
772784

773785
.. figure:: /images/bt_fast_pair_locator_tag_acceptable_use_policy.png
@@ -816,12 +828,17 @@ Testing
816828
#. Observe that the Android does not display a notification about the detected Fast Pair Provider, as the locator tag device disables advertising after the unprovisioning operation.
817829
#. Press **Button 0** to request turning on the Fast Pair advertising in discoverable mode and to restart the FMDN provisioning process.
818830

831+
.. _fast_pair_locator_tag_testing_clock_sync:
819832

820833
Clock synchronization
821834
---------------------
822835

823836
Testing steps for the clock synchronization feature require a second Android device.
824837
The device must be registered to a **different** Google account from the first Android device.
838+
Testing steps also require the `nRF Connect for Mobile`_ application on your second Android device.
839+
840+
.. note::
841+
You can execute these testing steps in combination with the :ref:`fast_pair_locator_tag_testing_fw_update_notifications` testing steps, as both test variants require you to wait for more than 24 hours.
825842

826843
To test this feature, complete the following steps:
827844

@@ -1028,9 +1045,13 @@ To test this feature, complete the following steps:
10281045
#. Turn on your Android device.
10291046
#. Observe that after up to few hours the **LED 1** goes off, which means that the motion detector has been deactivated, because the device is no longer in the Unwanted Tracking Protection mode.
10301047

1048+
.. _fast_pair_locator_tag_testing_dfu:
1049+
10311050
Performing the DFU procedure
10321051
----------------------------
10331052

1053+
Testing steps for the DFU feature require the `nRF Connect Device Manager`_ application on your test Android device.
1054+
10341055
To perform the DFU procedure, complete the following steps:
10351056

10361057
.. tabs::
@@ -1069,6 +1090,101 @@ To perform the DFU procedure, complete the following steps:
10691090

10701091
.. include:: /includes/suit_fota_update_nrfcdm_test_steps.txt
10711092

1093+
.. _fast_pair_locator_tag_testing_fw_update_notifications:
1094+
1095+
Android notifications about firmware updates
1096+
--------------------------------------------
1097+
1098+
Testing steps for the firmware update notification feature require the `nRF Connect Device Manager`_ application on your test Android device.
1099+
1100+
.. note::
1101+
The support for the Android notifications about the firmware updates in the context of the FMDN extension is a new feature.
1102+
Before you start the testing, ensure that versions for the following applications and services are equal to or greater than the specified minimum versions:
1103+
1104+
* `Google Play Services`_ - ``v25.12.33``
1105+
* `nRF Connect Device Manager`_ - ``v2.5.0``
1106+
1107+
.. note::
1108+
You can execute these testing steps in combination with the :ref:`fast_pair_locator_tag_testing_clock_sync` testing steps, as both test variants require you to wait for more than 24 hours.
1109+
1110+
To test this feature, complete the following steps:
1111+
1112+
.. tabs::
1113+
1114+
.. group-tab:: nRF52 and nRF53 DKs
1115+
1116+
1. Go to the :ref:`fast_pair_locator_tag_testing` section and follow the instructions on performing the FMDN provisioning operation.
1117+
#. Observe that **LED 3** is lit, which indicates that the device is provisioned as an FMDN beacon.
1118+
#. Power off the development kit and wait for 24 hours.
1119+
#. Power off your test Android device.
1120+
#. Power on the development kit.
1121+
#. |connect_terminal_specific|
1122+
#. Power on your test Android device and unlock it after the smartphone screen is turned on.
1123+
#. Wait for the Android device to connect to the development kit, read the local firmware version, and disconnect.
1124+
#. Observe that you get the Android notification about the new firmware update on your test Android device.
1125+
1126+
.. figure:: /images/bt_fast_pair_locator_tag_android_fw_update_notification.png
1127+
:scale: 80 %
1128+
:alt: Firmware update notification in the Android notification center
1129+
1130+
#. Upgrade the sample firmware to the latest version:
1131+
1132+
a. Set the application firmware version to ``v99.99.99`` by modifying the following files:
1133+
1134+
* The :file:`VERSION` file.
1135+
* The :file:`configuration/prj.conf` file (the :kconfig:option:`CONFIG_BT_FAST_PAIR_FMDN_DULT_FIRMWARE_VERSION_MAJOR`, :kconfig:option:`CONFIG_BT_FAST_PAIR_FMDN_DULT_FIRMWARE_VERSION_MINOR`, and :kconfig:option:`CONFIG_BT_FAST_PAIR_FMDN_DULT_FIRMWARE_VERSION_REVISION` Kconfig option group).
1136+
1137+
The new firmware version should match the version specified in the **Firmware Version** field from the :ref:`fast_pair_locator_tag_google_device_model` section.
1138+
1139+
#. Rebuild the sample application to generate the DFU package.
1140+
#. Follow the instructions from the :ref:`fast_pair_locator_tag_testing_dfu` section to perform the DFU procedure.
1141+
1142+
#. Validate the new firmware version is correct by reading the application boot banner.
1143+
#. Power off the development kit and wait again for 24 hours.
1144+
#. Power off your test Android device.
1145+
#. Power on the development kit.
1146+
#. |connect_terminal_specific|
1147+
#. Power on your test Android device and unlock it after the smartphone screen is turned on.
1148+
#. Wait for the Android device to connect to the development kit, read the local firmware version, and disconnect.
1149+
#. Observe that you no longer get the Android notification about the new firmware update on your test Android device.
1150+
1151+
.. group-tab:: nRF54 DKs
1152+
1153+
1. Go to the :ref:`fast_pair_locator_tag_testing` section and follow the instructions on performing the FMDN provisioning operation.
1154+
#. Observe that **LED 2** is lit, which indicates that the device is provisioned as an FMDN beacon.
1155+
#. Power off the development kit and wait for 24 hours.
1156+
#. Power off your test Android device.
1157+
#. Power on the development kit.
1158+
#. |connect_terminal_specific|
1159+
#. Power on your test Android device and unlock it after the smartphone screen is turned on.
1160+
#. Wait for the Android device to connect to the development kit, read the local firmware version, and disconnect.
1161+
#. Observe that you get the Android notification about the new firmware update on your test Android device.
1162+
1163+
.. figure:: /images/bt_fast_pair_locator_tag_android_fw_update_notification.png
1164+
:scale: 80 %
1165+
:alt: Firmware update notification in the Android notification center
1166+
1167+
#. Upgrade the sample firmware to the latest version:
1168+
1169+
a. Set the application firmware version to ``v99.99.99`` by modifying the following files:
1170+
1171+
* The :file:`VERSION` file.
1172+
* The :file:`configuration/prj.conf` file (the :kconfig:option:`CONFIG_BT_FAST_PAIR_FMDN_DULT_FIRMWARE_VERSION_MAJOR`, :kconfig:option:`CONFIG_BT_FAST_PAIR_FMDN_DULT_FIRMWARE_VERSION_MINOR`, and :kconfig:option:`CONFIG_BT_FAST_PAIR_FMDN_DULT_FIRMWARE_VERSION_REVISION` Kconfig option group).
1173+
1174+
The new firmware version should match the version specified in the **Firmware Version** field from the :ref:`fast_pair_locator_tag_google_device_model` section.
1175+
1176+
#. Rebuild the sample application to generate the DFU package.
1177+
#. Follow the instructions from the :ref:`fast_pair_locator_tag_testing_dfu` section to perform the DFU procedure.
1178+
1179+
#. Validate the new firmware version is correct by reading the application boot banner.
1180+
#. Power off the development kit and wait again for 24 hours.
1181+
#. Power off your test Android device.
1182+
#. Power on the development kit.
1183+
#. |connect_terminal_specific|
1184+
#. Power on your test Android device and unlock it after the smartphone screen is turned on.
1185+
#. Wait for the Android device to connect to the development kit, read the local firmware version, and disconnect.
1186+
#. Observe that you no longer get the Android notification about the new firmware update on your test Android device.
1187+
10721188
Disabling the locator tag
10731189
-------------------------
10741190

0 commit comments

Comments
 (0)