How do I set up the Commission Flow?

RE: How do I set up the Commission Flow?

Priyanka — Wed, 02 Jul 2025 14:00:24 GMT

Hi,

It looks like you already have an ongoing ticket for the similar issue. Please continue your conversation there.

How to retrieve the Matter QR code?

As mentioned in the ticket, my colleague will get back to you there as soon as he gets updates from the developers.

Due to the summer vacations we are slightly short staffed and hence the slight delays.

-Priyanka

RE: How do I set up the Commission Flow?

SunHuang — Wed, 02 Jul 2025 08:52:58 GMT

Hi,

I discovered another issue. Modifying the "generate_nrfconnect_chip_factory_data.py" script only affects the files generated by Python, such as build.txt. However, the QR code printed by the firmware during boot-up (i.e., [SVR]SetupQRCode) remains unchanged. After tracing through the SDK, I found that this value is hardcoded. Is there a way to modify it without changing the SDK itself?

RE: How do I set up the Commission Flow?

SunHuang — Tue, 01 Jul 2025 08:43:58 GMT

Hi,

Thank you for your assistance

RE: How do I set up the Commission Flow?

Priyanka — Tue, 01 Jul 2025 07:13:06 GMT

Of course you can change the Commissioning Flow inside QR code using Python script. Here is the variable: https://github.com/nrfconnect/sdk-connectedhomeip/blob/d56ca73159fd5973d839b14714f0a08b9695d4a8/scripts/tools/nrfconnect/generate_nrfconnect_chip_factory_data.py#L425

RE: How do I set up the Commission Flow?

SunHuang — Tue, 01 Jul 2025 00:50:37 GMT

Hi,

I'm using Nordic's generate_nrfconnect_chip_factory_data.py to generate the QR code, so does that mean this Python script can't change the Commission Flow?

RE: How do I set up the Commission Flow?

Priyanka — Wed, 25 Jun 2025 11:38:50 GMT

Hi,

We do not have option to specify the commissioning-flow in these scripts. It would be useful for the QR code generation indeed - however I guess you are using your own scripting for Matter QR code generation.

-Priyanka

RE: How do I set up the Commission Flow?

SunHuang — Mon, 23 Jun 2025 09:29:46 GMT

Hi,

You can test it with this command and you should see" Custom flow: 0 (STANDARD)"

./chip-tool payload parse-setup-payload <QR code>

RE: How do I set up the Commission Flow?

SunHuang — Fri, 20 Jun 2025 07:57:38 GMT

Hi,

Then I’d like to confirm one last thing: does Nordic’s generate_nrfconnect_chip_factory_data.py already handle this task by default? Because the parameters of generate_nrfconnect_chip_factory_data.py don’t seem to include this option.

RE: How do I set up the Commission Flow?

Priyanka — Wed, 18 Jun 2025 12:28:39 GMT

Yes in the link that you attached, it looks like there is an added field "commissioning-flow" but we don't see any usage of it in the code - which again is understandable, as FW should not have such information.

But anyway, this is correct the commissioning flow should be configured when generating QR code - which is not bound to the FW build process.

-Priyanka

RE: How do I set up the Commission Flow?

SunHuang — Wed, 18 Jun 2025 06:38:54 GMT

Hi,

Please refer to page 56 of the document. The content described there seems to align with my understanding , when generating the QR code, the 'Commission Flow' should also be configured at the same time. This way, users will know whether any additional actions are required when they scan the QR code.

wiki.telink-semi.cn/.../TelinkMatterDevelopersGuide-en_v0.2.15.pdf

RE: How do I set up the Commission Flow?

Priyanka — Tue, 17 Jun 2025 13:16:04 GMT

Hi,

What I understood from your query is, how to change the Commissioning Flow bits in the BLE advertisement using either prj.conf or Factory Data configuration? ope this is correct.

The Commissioning Flow is not defined by the FW but by QR code and DCL entry. The Custom Flow bits are only part of QR code. When manual pairing code is used, then Custom Flow bits are not present there, but instead Matter Controller can look at VID and PID of the device, and then check if Custom Commissioning Flow is necessary by checking the DCL entry of the given device.

Based on above, there is no KConfig or Factory Data entry for Custom Flow bits.

There is one place in the code where this Custom Flow can be modified in the code, and this is only for debugging purpose to change printed QR code in the console:

https://github.com/nrfconnect/sdk-nrf/blob/1d7f28e82f31e751dda42ce40e5b6d1d94fef1aa/samples/matter/common/src/app/matter_init.cpp#L345

Here you may change it - but it does not have any impact on the device behaviour - it's just helper string in debug logs.

-Priyanka

RE: How do I set up the Commission Flow?

Priyanka — Fri, 13 Jun 2025 10:39:46 GMT

Hi,

I am checking this internally and will get back to you soon.

-Priyanka

RE: How do I set up the Commission Flow?

SunHuang — Thu, 12 Jun 2025 07:13:29 GMT

What I mean is the configuration, which could be factory data or the prj.conf settings.

As shown in the image below

0:Standard, 1:User-Intent, 2:Custom.

RE: How do I set up the Commission Flow?

Priyanka — Wed, 11 Jun 2025 12:11:23 GMT

Hi,

Please take a look at the fllowng:

https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/protocols/matter/overview/commissioning.html

Hope this helps.

-Priyanka