Skip to content

Commit 6fb87b0

Browse files
authored
Merge pull request #2551 from arduino/mcmchris/nano-matter/user-manual-qr-code
[PXCT-1043] Nano Matter - User Manual - QR Section - How to change it
2 parents 1c64530 + 457a415 commit 6fb87b0

File tree

3 files changed

+50
-0
lines changed

3 files changed

+50
-0
lines changed

content/hardware/03.nano/boards/nano-matter/tutorials/01.user-manual/content.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -481,6 +481,56 @@ If you want to commission your Nano Matter solution with another service, follow
481481

482482
***Be aware that the Matter integration for Home Assistant is still in BETA, it can receive major updates and its functionality may vary between different vendors.***
483483

484+
### Updating the Commissioning QR Code
485+
486+
Each Nano Matter board comes with a default QR code used for commissioning. In this section, you will learn how to **generate a unique QR code** for your device by updating its provisioning ID.
487+
488+
![Unique QR Codes for your Matter devices](assets/new-qr-codes.png)
489+
490+
By assigning a unique provisioning ID, you can:
491+
492+
- Generate a distinct QR code for each board.
493+
- Commission multiple Nano Matter boards to the same network without conflicts.
494+
- Prepare your devices for real-world field deployment.
495+
496+
#### Prerequisites
497+
498+
Before starting, make sure you have the following:
499+
500+
- Make sure the **Arduino IDE** and the **Silicon Labs Arduino Core** are both installed.
501+
- Make sure there is only **one** board connected to your computer at a time.
502+
- Your Matter sketch already flashed to the board.
503+
- Clone the [Arduino Matter Provision Tool](https://github.com/silabs-bozont/arduino_matter_provision) repository on your local machine.
504+
505+
#### Changing the Provisioning ID
506+
507+
To assign a new provisioning ID and generate a new QR code:
508+
509+
- Open a terminal and navigate to the cloned `/arduino_matter_provision` folder.
510+
- The provisioning command has the following format:
511+
512+
```bash
513+
python arduino_matter_provision.py <board_name> <config_number>
514+
```
515+
516+
- Replace `<board_name>` with `nano_matter` and choose a configuration number (e.g., `1`):
517+
```bash
518+
python arduino_matter_provision.py nano_matter 1
519+
```
520+
521+
- Run the script to change the provisioning data using the given structure.
522+
523+
![Running the script](assets/qr-code-change.gif)
524+
525+
Once the script finishes, open the **Arduino Serial Monitor**. You will see the updated commissioning credentials there, no need to re-upload the sketch.
526+
527+
Here’s what the new credentials might look like:
528+
529+
- Manual Pairing Code: `00417637863`
530+
- QR code URL: `https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3A8YT00-D000CQ-01VB10`
531+
532+
***Make sure all your Nano Matter boards has been configured with a different ID.***
533+
484534
### Device Decommissioning
485535

486536
If you have a Matter device configured and working with a _specific platform_, for example with the Google Home ecosystem, and you want to integrate it with Alexa or Apple Home instead, you need to decommission it first from the previous service.

0 commit comments

Comments
 (0)