Skip to content

doc: Add NFC commissioning testing section to samples #45

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kkasperczyk-no merged 1 commit into from
Aug 25, 2026
Merged

doc: Add NFC commissioning testing section to samples #45

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/bridge/matter_bridge_description.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -973,6 +973,10 @@ Complete the following steps depending on your configuration:
a. On the Peripheral LBS device, press the |First Button| to turn on the |Second LED| located on the bound light bulb device.
#. On the Peripheral LBS device, release the |First Button| to turn off the light again.

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================
Expand Down
51 changes: 51 additions & 0 deletions docs/includes/testing/nfc_commissioning.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
.. note::
Currently, no commercially available smartphone application supports Matter commissioner functionality using NFC transport.
To test NFC-based commissioning, you need a Matter commissioner that implements the Matter NFC Transport Layer (NTL).
You can develop your own commissioner application based on the Matter 1.6 specification (`Matter Core Specification`_).

To commission the |matter_type| over NFC using a Nordic Semiconductor DK, complete the following steps:

1. Build the |matter_type| with the NFC commissioning support.

See `NFC-based commissioning`_ for the required Kconfig options and supported DK targets.

#. Ensure that a Thread dataset or Wi-Fi credentials are configured.
#. Program the DK with the proper firmware and connect a terminal emulator to monitor the UART log.
#. When the Matter server finishes initializing, the device automatically starts NFC tag emulation and serves an NDEF onboarding payload with the NFC rendezvous flag.
No button press is required to start NFC commissioning.

#. On a smartphone with a Matter commissioner application that supports Matter NTL, tap the NFC antenna area on the DK to start the commissioning session.

#. Keep the smartphone within NFC range for the duration of the commissioning exchange.

The required hold time depends on the network variant:

.. tabs::

.. group-tab:: Matter over Thread

Hold the tap for at least **9 seconds**.

.. group-tab:: Matter over Wi-Fi

Hold the tap for at least **20 seconds**.

#. Keep the smartphone in the NFC field until the commissioner application indicates that commissioning has completed successfully.

Once device is commissioned the |Second LED| stops blinking and the light is solid and the NFC tag emulation on the DK stops automatically.

.. note::

If the commissioner loses connection with the device during the process, wait until the failsafe mechanism is triggered before attempting commissioning again.
You will see the following UART log messages:

.. code-block:: console

I: 5419 [DL]NFC field lost: the NFC Reader/Writer moved away
I: 5424 [DL]NFC tag emulation paused until fail-safe completes

The failsafe timeout depends on the commissioner configuration.

Press the reset button to clean-up the device faster and make it reachable over NFC again.

#. Use the commissioner application to control the device and verify that the expected clusters and attributes are accessible.
2 changes: 1 addition & 1 deletion docs/matter/end_product/platform_dmp_cert.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ If you follow within the Matter Platform SOE and the platform's certified scope,
.. _ug_matter_platform_and_dmp_matrix:

Matter Compliant Platform certification information
==================================================
===================================================

Use the following Matter CIDs compatibility matrices to find the current Matter Compliant Platform Certification IDs (CIDs), |NCS| release mappings, dependent certification references, and supported hardware within the SOE for each SoC that supports Matter in the |NCS|:

Expand Down
5 changes: 5 additions & 0 deletions samples/closure/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -218,6 +218,11 @@ Complete the following points by calling the corresponding commands in the CHIP

closurecontrol read-attribute countdown-time |node_id| 1

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
5 changes: 5 additions & 0 deletions samples/contact_sensor/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -206,6 +206,11 @@ Observe the contact detection state changes

Press and release the |Second Button| a few times and observe the state changes reported automatically in the CHIP Tool interactive mode.

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
5 changes: 5 additions & 0 deletions samples/light_bulb/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -192,6 +192,11 @@ To prepare the light switch device, follow the first three steps in the :ref:`Ma
:start-after: matter_light_switch_sample_testing_start
:end-before: matter_light_switch_sample_testing_end

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
5 changes: 5 additions & 0 deletions samples/light_switch/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -418,6 +418,11 @@ Control the light bulb device

.. matter_light_switch_sample_testing_end

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
5 changes: 5 additions & 0 deletions samples/manufacturer_specific/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -298,6 +298,11 @@ In the interactive mode, read the ``Basic Information`` cluster's ``RandomNumber

any read-event-by-id 0x0028 0x4 |node_id| 0

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
5 changes: 5 additions & 0 deletions samples/smoke_co_alarm/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -238,6 +238,11 @@ In the interactive mode, stop the Smoke alarm by running the following command,

The |Second LED| will be turned off and the |Third LED| will start blinking evenly with 300 ms interval, to express the CO alarm, as the next one in the order.

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
5 changes: 5 additions & 0 deletions samples/temperature_sensor/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -190,6 +190,11 @@ The received value will be different, for example:
[1755081048.320] [99348:99350] [TOO] Endpoint: 1 Cluster: 0x0000_0402 Attribute 0x0000_0000 DataVersion: 1994139940
[1755081048.320] [99348:99350] [TOO] MeasuredValue: 1200

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
7 changes: 6 additions & 1 deletion samples/template/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,11 +60,11 @@ Advanced configuration options
.. include:: /includes/configuration/advanced/dfu.txt
.. include:: /includes/configuration/advanced/tfm.txt
.. include:: /includes/configuration/advanced/factory_data.txt
.. include:: /includes/configuration/advanced/nfc_commissioning.txt
.. include:: /includes/configuration/advanced/custom_board.txt
.. include:: /includes/configuration/advanced/internal_memory.txt
.. include:: /includes/configuration/advanced/nfc_commissioning.txt


User interface
**************

Expand Down Expand Up @@ -125,6 +125,11 @@ To see if the communication with the device is working, run the following comman

See the output and verify that the product ID is set to ``32768`` (0x8000 in hexadecimal).

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
5 changes: 5 additions & 0 deletions samples/thermostat/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -231,6 +231,11 @@ Press the |Second Button|

Press the |Second Button| to print the most recent temperature data from the thermostat device to the UART terminal.

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
9 changes: 7 additions & 2 deletions samples/weather_station/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@

.. _matter_weather_station_app:

Matter weather station
######################
Matter: Weather Station
#######################

.. contents::
:local:
Expand Down Expand Up @@ -312,6 +312,11 @@ Run the following command:

This means that the current air pressure value is equal to 1015 hPa.

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
5 changes: 5 additions & 0 deletions samples/window_covering/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -254,6 +254,11 @@ Press the |Second Button| 20 times
Press the |Second Button| 20 times to fully tilt the cover into the open position.
The brightness of |Third LED| decreases with each button press until the LED turns off.

Testing with Matter Commissioner over NFC
=========================================

.. include:: /includes/testing/nfc_commissioning.txt

Testing with commercial ecosystem
=================================

Expand Down
Loading