|
| 1 | +.. note:: |
| 2 | + There is currently no official commercial NFC commissioner smartphone application available. |
| 3 | + To test NFC-based commissioning, you need an NFC commissioner that implements the Matter NFC Transport Layer (NTL). |
| 4 | + You can develop your own commissioner application based on the Matter 1.6 specification (`Matter Core Specification`_). |
| 5 | + |
| 6 | +To commission the |matter_type| over NFC using a Nordic Semiconductor DK, complete the following steps: |
| 7 | + |
| 8 | +.. rst-class:: numbered-step |
| 9 | + |
| 10 | +Build the |matter_type| with the NFC commissioning support |
| 11 | +---------------------------------------------------------- |
| 12 | + |
| 13 | +Ensure that the |matter_type| is built with NFC-based commissioning enabled. |
| 14 | +See :ref:`matter_configuring_nfc_commissioning` for the required Kconfig options and supported DK targets. |
| 15 | + |
| 16 | +.. rst-class:: numbered-step |
| 17 | + |
| 18 | +Prepare the Matter network |
| 19 | +-------------------------- |
| 20 | + |
| 21 | +Check whether Thread dataset or Wi-Fi credentials are configured. |
| 22 | + |
| 23 | +.. rst-class:: numbered-step |
| 24 | + |
| 25 | +Flash the DK |
| 26 | +------------ |
| 27 | + |
| 28 | +Flash the DK with the proper firmware and connect a terminal emulator to monitor the UART log. |
| 29 | +When the Matter server finishes initializing, the device automatically starts NFC tag emulation and serves an NDEF onboarding payload with the NFC rendezvous flag. |
| 30 | +No button press is required to start NFC commissioning. |
| 31 | + |
| 32 | +.. rst-class:: numbered-step |
| 33 | + |
| 34 | +Start the commissioning process |
| 35 | +------------------------------- |
| 36 | + |
| 37 | +On a smartphone with an NFC commissioner application that supports Matter NTL, tap the NFC antenna area on the DK to start the commissioning session. |
| 38 | + |
| 39 | +Keep the smartphone within NFC range for the duration of the commissioning exchange. |
| 40 | +The required hold time depends on the network variant: |
| 41 | + |
| 42 | +.. tabs:: |
| 43 | + |
| 44 | + .. group-tab:: Matter over Thread |
| 45 | + |
| 46 | + Hold the tap for at least **9 seconds**. |
| 47 | + |
| 48 | + .. group-tab:: Matter over Wi-Fi |
| 49 | + |
| 50 | + Hold the tap for at least **20 seconds**. |
| 51 | + |
| 52 | +Keep the smartphone in the NFC field until the commissioner application indicates that commissioning has completed successfully. |
| 53 | +After commissioning is finished, NFC tag emulation on the DK will automatically stop. |
| 54 | + |
| 55 | +If the commissioner loses connection with the device during the process, wait until the failsafe mechanism is triggered before attempting commissioning again. |
| 56 | +You will see the following UART log messages: |
| 57 | + |
| 58 | +.. code-block:: console |
| 59 | + |
| 60 | + I: 5419 [DL]NFC field lost: the NFC Reader/Writer moved away |
| 61 | + I: 5424 [DL]NFC tag emulation paused until fail-safe completes |
| 62 | + |
| 63 | +The failsafe timeout depends on the commissioner configuration. |
| 64 | + |
| 65 | +.. rst-class:: numbered-step |
| 66 | + |
| 67 | +Control the device |
| 68 | +------------------ |
| 69 | + |
| 70 | +Use the commissioner application to control the device and verify that the expected clusters and attributes are accessible. |
0 commit comments