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
Copy file name to clipboardExpand all lines: doc/nrf/external_comp/bt_fast_pair.rst
+23-3Lines changed: 23 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -180,13 +180,33 @@ Provisioning registration data onto device
180
180
The Fast Pair standard requires provisioning the device with Model ID and Anti-Spoofing Private Key obtained during device model registration.
181
181
In the |NCS|, the provisioning data is generated as a hexadecimal file using the :ref:`bt_fast_pair_provision_script`.
182
182
183
-
When building the Fast Pair in the |NCS|, the build system automatically calls the Fast Pair provision script and includes the resulting hexadecimal file in the firmware (the :file:`merged.hex` file).
183
+
When building Fast Pair in the |NCS|, the build system automatically calls the Fast Pair provision script.
184
+
It then includes the resulting hexadecimal file in the final firmware that you can flash onto the device.
185
+
The Fast Pair provisioning data is stored on the dedicated Fast Pair partition, which has to be defined.
186
+
187
+
Partition definition using the Partition Manager (PM)
For devices that support :ref:`partition_manager` and have the :kconfig:option:`CONFIG_PM_SINGLE_IMAGE` Kconfig option automatically enabled by the Fast Pair build system, the system also automatically creates the ``bt_fast_pair`` partition.
191
+
The partition is defined in the :file:`subsys/partition_manager/pm.yml.bt_fast_pair` file.
192
+
The :ref:`fast_pair_input_device` sample follows this approach.
193
+
Alternatively, the Fast Pair partition can be defined manually in the application's configuration file.
194
+
To see how to do this, refer to the example in the :file:`samples/bluetooth/fast_pair/locator_tag/configuration/pm_static_nrf52840dk_nrf52840.yml` file which is a part of the :ref:`fast_pair_locator_tag` sample.
195
+
For more information about defining Partition Manager partitions, see the :ref:`Configuration <pm_configuration>` section of the :ref:`partition_manager` page.
196
+
197
+
Partition definition using the Devicetree (DTS)
198
+
-----------------------------------------------
199
+
200
+
For devices that do not support :ref:`partition_manager`, you must declare the ``bt_fast_pair_partition`` partition manually in the devicetree.
201
+
Currently, the :ref:`zephyr:nrf54h20dk_nrf54h20` is the only device that requires manual partition definition.
202
+
To see how to do this, refer to the example in the :file:`samples/bluetooth/fast_pair/input_device/boards/nrf54h20dk_nrf54h20_cpuapp.overlay` file.
203
+
184
204
To build an application with the Fast Pair support, include the following additional CMake options:
185
205
186
206
* ``FP_MODEL_ID`` - Fast Pair Model ID in format ``0xXXXXXX``,
187
207
* ``FP_ANTI_SPOOFING_KEY`` - base64-encoded Fast Pair Anti-Spoofing Private Key.
188
208
189
-
The ``bt_fast_pair`` partition address is provided automatically by the build system.
209
+
The Fast Pair partition address is provided automatically by the build system.
190
210
191
211
For example, when building an application with the |nRFVSC|, you need to add the following parameters in the **Extra CMake arguments** field on the **Add Build Configuration view**: ``-DFP_MODEL_ID=0xFFFFFF -DFP_ANTI_SPOOFING_KEY=AbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbA=``.
192
212
Make sure to replace ``0xFFFFFF`` and ``AbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbAbA=`` with values obtained for your device.
@@ -1070,5 +1090,5 @@ The following are the required dependencies for the Fast Pair integration:
1070
1090
* :ref:`nrfxlib:crypto`
1071
1091
* :ref:`zephyr:bluetooth`
1072
1092
* :ref:`zephyr:settings_api`
1073
-
* :ref:`partition_manager`
1093
+
* :ref:`partition_manager` (only for supported board targets)
Copy file name to clipboardExpand all lines: doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -502,7 +502,7 @@ This section provides detailed lists of changes by :ref:`integration <integratio
502
502
Google Fast Pair integration
503
503
----------------------------
504
504
505
-
|no_changes_yet_note|
505
+
* Added instructions on how to provision the Fast Pair data onto devices without the :ref:`partition_manager` support, specifically for the :ref:`zephyr:nrf54h20dk_nrf54h20`.
Copy file name to clipboardExpand all lines: scripts/nrf_provision/fast_pair/README.rst
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -90,7 +90,7 @@ The ID and the key are required by the Google Fast Pair Service and are provided
90
90
The magic data with predefined value is placed right before the mentioned provisioning data.
91
91
The SHA-256 hash is calculated using the magic data and the provisioning data, and then placed right after the provisioning data to ensure data integrity.
92
92
93
-
The generated data must be placed on a dedicated ``bt_fast_pair`` partition defined by the :ref:`partition_manager`.
93
+
The generated data must be placed on a dedicated Fast Pair partition defined by the build system.
94
94
The :ref:`bt_fast_pair_readme` knows both the offset sizes and lengths of the individual data fields in the provisioning data.
95
95
The service accesses the data by reading flash content.
96
96
The service calculates the hash on its own and checks whether it matches the hash stored on the partition.
0 commit comments