Skip to content

docs: matter: light swithc: fixed descriminator change note #26085

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
ArekBalysNordic merged 1 commit into from
Dec 9, 2025
+44 −7
Merged

docs: matter: light swithc: fixed descriminator change note #26085

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
3 changes: 3 additions & 0 deletions applications/matter_bridge/doc/matter_bridge_description.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,9 @@ If the Bluetooth LE advertising times out, you can re-enable it manually (see th
Additionally, the controller must get the `Onboarding information`_ from the Matter accessory device and provision the device into the network.
For details, see the `Testing`_ section.

.. note::
|matter_unique_discriminator_note|

.. _matter_bridge_app_ui:

User interface
Expand Down
3 changes: 3 additions & 0 deletions applications/matter_weather_station/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,9 @@ If the Bluetooth LE advertising times out, you can re-enable it manually using *
Additionally, the controller must get the `Onboarding information`_ from the Matter accessory device and provision the device into the network.
For details, see the `Testing`_ section.

.. note::
|matter_unique_discriminator_note|

Requirements
************

Expand Down
5 changes: 5 additions & 0 deletions doc/nrf/protocols/matter/getting_started/advanced_kconfigs.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -181,6 +181,11 @@ Some of these can be configured using the Kconfig options listed below:
This allows filtering of the discovery results to find the nodes that match the device type.
* :kconfig:option:`CONFIG_CHIP_ROTATING_DEVICE_ID` enables an optional rotating device identifier feature that provides an additional unique identifier for each device.
This identifier is similar to the serial number, but it additionally changes at predefined times to protect against long-term tracking of the device.
* :kconfig:option:`CONFIG_CHIP_DEVICE_DISCRIMINATOR` sets the Bluetooth LE discriminator of the device.
In each sample, it is set to the same value by default (hexadecimal: ``0xF00``; decimal: ``3840``).
Without changing the discriminator only one uncommissioned device can be powered up at the same time.
If multiple devices with the same discriminator are powered simultaneously, the Matter controller will commission a random device.
To avoid confusion, keep only a single uncommissioned device powered up, or assign a unique discriminator to each device.

.. _ug_matter_configuring_ffs:

Expand Down
2 changes: 2 additions & 0 deletions doc/nrf/shortcuts.txt
View file
Open in desktop
Copy link
Contributor Author

@Adam-Maciuga Adam-Maciuga Dec 4, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure If this is enough to put it here to then later use it in the other places.
I am also not sure if the ref will work.
I wanted to refer to doc/nrf/protocols/matter/getting_started/advanced_kconfigs.rst (the section I edited)

Original file line number Diff line number Diff line change
Expand Up @@ -177,6 +177,8 @@
.. |matter_cd_definition| replace:: a cryptographic document created by the CSA for each device type, used to confirm that a given type of device was certified
.. |matter_cd_info_note_for_samples| replace:: This data payload also includes test Device Attestation, with test Certification Declaration, Product ID, and Vendor ID.
These are used for :ref:`ug_matter_device_attestation_commissioning_info`, and you can generate your own test Certification Declaration when you :ref:`work on Matter end product <ug_matter_device_attestation_testing_da>`.
.. |matter_unique_discriminator_note| replace:: If you are working with multiple devices, set a unique discriminator for each one, or commission them one at a time.
See :ref:`ug_matter_configuring_device_identification` for more information.

.. ### Other shortcuts

Expand Down
3 changes: 3 additions & 0 deletions samples/matter/closure/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -202,6 +202,9 @@ Testing in a network

To test the sample in a Matter-enabled Thread network, complete the following steps:

.. note::
|matter_unique_discriminator_note|

.. tabs::

.. group-tab:: nRF52, nRF53 DKs
Expand Down
3 changes: 3 additions & 0 deletions samples/matter/contact_sensor/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,9 @@ Testing

After building the sample and programming it to your development kit, complete the following steps to test its basic features.

.. note::
|matter_unique_discriminator_note|

.. note::
The following steps use the CHIP Tool controller as an example.

Expand Down
3 changes: 3 additions & 0 deletions samples/matter/light_bulb/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -379,6 +379,9 @@ Enabling remote control

Remote control allows you to control the Matter light bulb device from an IPv6 network.

.. note::
|matter_unique_discriminator_note|

.. include:: ../lock/README.rst
:start-after: matter_door_lock_sample_remote_control_start
:end-before: matter_door_lock_sample_remote_control_end
Expand Down
8 changes: 1 addition & 7 deletions samples/matter/light_switch/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -344,13 +344,7 @@ Prepare for testing
After building this and the :ref:`Matter Light Bulb <matter_light_bulb_sample>` samples, and programming them to the development kits, complete the following steps:

.. note::
In both samples (light switch and light bulb), a Bluetooth LE discriminator is set with the same value by default (hexadecimal: ``0xF00``; decimal: ``3840``).
This means that only one uncommissioned device can be powered up before commissioning.
If both are powered up at the same time, the CHIP Tool can commission a random device and the node ID assignment is also random.
When one device is commissioned, power up the next device and perform the commissioning.

To avoid this unclear situation, you can set up your unique discriminator in the :file:`src/chip_project_config.h` file by changing the :kconfig:option:`CHIP_DEVICE_CONFIG_USE_TEST_SETUP_DISCRIMINATOR` value.
Then build an example and commission with your unique discriminator.
|matter_unique_discriminator_note|

.. matter_light_switch_sample_prepare_to_testing_start

Expand Down
3 changes: 3 additions & 0 deletions samples/matter/lock/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -536,6 +536,9 @@ Enabling remote control

Remote control allows you to control the Matter door lock device from a Thread or a Wi-Fi network.

.. note::
|matter_unique_discriminator_note|

.. matter_door_lock_sample_remote_control_start

`Commissioning the device`_ allows you to set up a testing environment and remotely control the sample over a Matter-enabled Thread or Wi-Fi network.
Expand Down
3 changes: 3 additions & 0 deletions samples/matter/manufacturer_specific/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -186,6 +186,9 @@ Enabling remote control

Remote control allows you to control the Matter manufacturer-specific device from an IPv6 network.

.. note::
|matter_unique_discriminator_note|

`Commissioning the device`_ allows you to set up a testing environment and remotely control the sample over a Matter-enabled Thread network.

.. _matter_manufacturer_specific_sample_remote_control_commissioning:
Expand Down
3 changes: 3 additions & 0 deletions samples/matter/smoke_co_alarm/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -337,6 +337,9 @@ Enabling remote control

Remote control allows you to control the Matter smoke CO alarm device from an IPv6 network.

.. note::
|matter_unique_discriminator_note|

`Commissioning the device`_ allows you to set up a testing environment and remotely control the sample over a Matter-enabled Thread network.

.. _matter_smoke_co_alarm_sample_remote_control_commissioning:
Expand Down
3 changes: 3 additions & 0 deletions samples/matter/temperature_sensor/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -232,6 +232,9 @@ Enabling remote control

Remote control allows you to control the Matter temperature sensor device from an IPv6 network.

.. note::
|matter_unique_discriminator_note|

`Commissioning the device`_ allows you to set up a testing environment and remotely control the sample over a Matter-enabled Thread network.

.. _matter_temperature_sensor_sample_remote_control_commissioning:
Expand Down
3 changes: 3 additions & 0 deletions samples/matter/template/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -237,6 +237,9 @@ Testing in a network

To test the sample in a Matter-enabled Thread network, complete the following steps:

.. note::
|matter_unique_discriminator_note|

.. tabs::

.. group-tab:: nRF52, nRF53 and nRF70 DKs
Expand Down
3 changes: 3 additions & 0 deletions samples/matter/thermostat/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -292,6 +292,9 @@ Enabling remote control

Remote control allows you to control the Matter thermostat device from an IPv6 network.

.. note::
|matter_unique_discriminator_note|

.. include:: ../lock/README.rst
:start-after: matter_door_lock_sample_remote_control_start
:end-before: matter_door_lock_sample_remote_control_end
Expand Down
3 changes: 3 additions & 0 deletions samples/matter/window_covering/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -271,6 +271,9 @@ Enabling remote control

Remote control allows you to control the Matter window covering device from a Thread network.

.. note::
|matter_unique_discriminator_note|

`Commissioning the device`_ allows you to set up a testing environment and remotely control the sample over a Matter-enabled Thread network.

.. _matter_window_cover_sample_remote_control_commissioning:
Expand Down