How to retrieve the Matter QR code?

RE: How to retrieve the Matter QR code?

JONATHAN LL — Wed, 02 Jul 2025 08:59:15 GMT

I have pinged the developers internally to assist in options here. Will update when i have something, sorry for the delays.

Regards,
Jonathan

RE: How to retrieve the Matter QR code?

SunHuang — Tue, 01 Jul 2025 00:51:31 GMT

Hi,

Are there any updates on this case?

RE: How to retrieve the Matter QR code?

SunHuang — Wed, 25 Jun 2025 01:57:32 GMT

Hi,

As I mentioned earlier, I must call PrintOnboardingCodes after executing Nrf::Matter::StartServer(), otherwise the system crashes. That’s why I’ve been emphasizing whether it’s possible to directly obtain the QR code string,because I believe it’s stored somewhere (likely in the factory data). So, how can I retrieve the QR code from anywhere in the program?

RE: How to retrieve the Matter QR code?

JONATHAN LL — Tue, 24 Jun 2025 12:03:46 GMT

https://github.com/nrfconnect/sdk-connectedhomeip/blob/3ccd6078b9b33af0fa6ddb71e51bb9860f9198a0/src/setup_payload/OnboardingCodesUtil.cpp#L52

void PrintOnboardingCodes(const chip::PayloadContents & payload)
{
    char payloadBuffer[chip::QRCodeBasicSetupPayloadGenerator::kMaxQRCodeBase38RepresentationLength + 1];
    chip::MutableCharSpan qrCode(payloadBuffer);

    if (GetQRCode(qrCode, payload) == CHIP_NO_ERROR)
    {
        PrintQrCodeURL(qrCode);
    }
    else
    {
        ChipLogError(AppServer, "Getting QR code failed!");
    }

    chip::MutableCharSpan manualPairingCode(payloadBuffer);
    if (GetManualPairingCode(manualPairingCode, payload) == CHIP_NO_ERROR)
    {
        ChipLogProgress(AppServer, "Manual pairing code: [%s]", manualPairingCode.data());
    }
    else
    {
        ChipLogError(AppServer, "Getting manual pairing code failed!");
    }
}

RE: How to retrieve the Matter QR code?

SunHuang — Tue, 24 Jun 2025 08:54:53 GMT

[quote userid="91187" url="~/f/nordic-q-a/122087/how-to-retrieve-the-matter-qr-code/540281"]However, to save it to the buffer[/quote]

I don't understand what you mean. Can't I get the string directly?

RE: How to retrieve the Matter QR code?

JONATHAN LL — Tue, 24 Jun 2025 08:32:41 GMT

From the developers here, this is the recommendation.

When the customer generates QR code externally, but at the same time would like the accessory to generate and transmit QR code using some propriatary protocol.

To make it possible, Matter Factory Data must contain passcode. Then for example in our samples we do use the PrintOnboardingCodes function to print the QR code on UART.

Here is the example: https://github.com/nrfconnect/sdk-nrf/blob/main/samples/matter/common/src/app/matter_init.cpp#L345C2-L345C22

However, to save it to the buffer, please take a look at the functions here, which should help: https://github.com/nrfconnect/sdk-connectedhomeip/blob/3ccd6078b9b33af0fa6ddb71e51bb9860f9198a0/src/setup_payload/OnboardingCodesUtil.cpp

Regards,
Jonathan

RE: How to retrieve the Matter QR code?

SunHuang — Thu, 19 Jun 2025 03:57:27 GMT

Hi,

I understand what you mean, and we do generate the QR code in that way as well. However, what I'm referring to is the production testing phase. I would like to verify that the hardware functions correctly before transmitting data using our custom communication protocol. You only need to tell me how to read the QR code before calling Nrf::Matter::StartServer().

RE: How to retrieve the Matter QR code?

JONATHAN LL — Wed, 18 Jun 2025 12:37:46 GMT

Checked internally and for production we do recommend to use our Factory Data module. Here is an instruction for QR code generation: https://docs.nordicsemi.com/bundle/ncs-latest/page/matter/nrfconnect_factory_data_configuration.html#generating_onboarding_codes . but it can be used independently based on VID/PID/discriminator and passcode.

You may use the helper python script and integrate it in production line, where factory_data partition content can be generated uniquely for each device. For development, we also include the passcode in the firmware which allows to print the URL to QR code in the shell command.

RE: How to retrieve the Matter QR code?

SunHuang — Mon, 16 Jun 2025 09:18:33 GMT

Hi,

I understand the steps you mentioned, but in my case, it's for mass production purposes. I need to transmit the QR code using a specific communication format. This protocol is for internal use. I must send out the QR code immediately upon startup.

RE: How to retrieve the Matter QR code?

JONATHAN LL — Mon, 16 Jun 2025 07:47:48 GMT

Hi there,

For factory data it should be made if you have the --generate_onboarding command.
https://docs.nordicsemi.com/bundle/ncs-latest/page/matter/nrfconnect_factory_data_configuration.html#generating_onboarding_codes

So you can get the QR code while generating with the factory data or with the chip-tool.

So like the example here shows: https://docs.nordicsemi.com/bundle/ncs-2.9.0/page/matter/nrfconnect_factory_data_configuration.html

With the chip-tool:
./chip-tool payload generate-qrcode --discriminator 1234 --setup-pin-code 13243546 --vendor-id 0x123 --product-id 0x123
This will output a QR code payload, which you can then visualize using a QR code generator website, such as appending the result to:
project-chip.github.io/.../qrcode.html

Regards,
Jonathan