You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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]>
Copy file name to clipboardExpand all lines: samples/bluetooth/fast_pair/locator_tag/README.rst
+116Lines changed: 116 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -704,6 +704,12 @@ Testing
704
704
705
705
#. Initiate the connection and trigger the Fast Pair procedure by tapping the :guilabel:`Connect` button.
706
706
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
+
707
713
#. If you want to start the FMDN provisioning, accept the Acceptable Use Policy by tapping the :guilabel:`Agree and continue` button.
#. Initiate the connection and trigger the Fast Pair procedure by tapping the :guilabel:`Connect` button.
770
776
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
+
771
783
#. If you want to start the FMDN provisioning, accept the Acceptable Use Policy by tapping the :guilabel:`Agree and continue` button.
#. 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.
817
829
#. Press **Button 0** to request turning on the Fast Pair advertising in discoverable mode and to restart the FMDN provisioning process.
818
830
831
+
.. _fast_pair_locator_tag_testing_clock_sync:
819
832
820
833
Clock synchronization
821
834
---------------------
822
835
823
836
Testing steps for the clock synchronization feature require a second Android device.
824
837
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.
825
842
826
843
To test this feature, complete the following steps:
827
844
@@ -1028,9 +1045,13 @@ To test this feature, complete the following steps:
1028
1045
#. Turn on your Android device.
1029
1046
#. 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.
1030
1047
1048
+
.. _fast_pair_locator_tag_testing_dfu:
1049
+
1031
1050
Performing the DFU procedure
1032
1051
----------------------------
1033
1052
1053
+
Testing steps for the DFU feature require the `nRF Connect Device Manager`_ application on your test Android device.
1054
+
1034
1055
To perform the DFU procedure, complete the following steps:
1035
1056
1036
1057
.. tabs::
@@ -1069,6 +1090,101 @@ To perform the DFU procedure, complete the following steps:
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.
: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.
: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.
0 commit comments