Matter/IoT QR Code Guide
Learn how to assemble a Matter setup QR payload, check its fields, and test it with the exact device and controller used for commissioning.
Test the target ecosystem
Compatible Matter controllers in Apple Home, Google Home, Amazon Alexa, Samsung SmartThings, and other ecosystems can read setup payloads. Actual commissioning still depends on the accessory, controller version, network, valid provisioning data, and supported device type.
What is Matter?
Understanding Matter Protocol
Matter (formerly Project CHIP) is an industry-unifying standard for smart home devices. It enables secure, reliable, and seamless cross-platform connectivity between devices from different manufacturers.
Key Benefits
- Designed for compatible Apple Home, Google Home, Amazon Alexa, and other Matter controllers
- Supports local device control when the device and ecosystem provide it
- Enhanced security with encrypted communications
- Simple setup via QR code scanning
QR Code Components
Required Information
Vendor ID (VID)
A 16-bit vendor identifier used in the setup payload. The generator recognizes 0xFFF1-0xFFF4 as local test VIDs; it does not query the CSA registry.
Example: 0xFFF1Product ID (PID)
A 16-bit product identifier supplied by the device maker. Confirm the correct production VID/PID allocation with your certification and provisioning process.
Example: 0x8001Setup PIN
8-digit code for device pairing. Avoid patterns like 12345678 or 00000000.
Example: 20202021Discriminator
12-bit value (0-4095) to differentiate devices during commissioning.
Example: 3840Optional Parameters
Step-by-Step Guide
Generating Matter QR Codes
- 1Navigate to the Matter/IoT page from the main menu
- 2Enter your Vendor ID (VID) - use test range 0xFFF1-0xFFF4 for development
- 3Enter the Product ID (PID) assigned in your provisioning records; use a designated test value during development
- 4Enter the device-provisioned 8-digit Setup PIN and avoid prohibited or predictable values
- 5Set Discriminator value between 0-4095 (e.g., 3840)
- 6Optionally compare the VID with the generator's small local list of known test IDs
- 7Select additional options like version info or NFC data
- 8Click "Generate Matter setup QR"
- 9Test the QR code with your smart home app
Validation Process
The generator checks numeric field ranges, basic setup PIN patterns, payload structure, and—when enabled—whether the VID appears in its small local list of known test IDs. It does not query a CSA database, verify a production PID assignment, certify a device, or guarantee commissioning.
Testing Your QR Code
Compatible Platforms
Apple Home
- 1. Open Home app
- 2. Tap + button
- 3. Scan Matter QR code
- 4. Follow setup prompts
Google Home
- 1. Open Google Home
- 2. Tap + button
- 3. Select "Set up device"
- 4. Choose "Matter-enabled device"
- 5. Scan QR code
Amazon Alexa
- 1. Open Alexa app
- 2. Go to Devices
- 3. Tap + button
- 4. Select "Add Device"
- 5. Choose Matter
- 6. Scan code
Common Issues
QR code not recognized
Ensure you're using a Matter-compatible app version and the QR code size is at least 30mm²
Invalid PIN message
Avoid sequential (12345678) or repeated (11111111) patterns. Use random 8-digit numbers.
VID/PID validation fails
The optional check only recognizes a small local test-VID list. For a production device, verify the assigned VID and manufacturer-managed PID through your certification and provisioning records.
Best Practices
Security
- •Generate unique PINs for each device
- •Store PINs securely during manufacturing
- •Never use default or predictable PINs
Production
- •Confirm the assigned VID, manufacturer-managed PID, and current certification requirements
- •Test with multiple ecosystems
- •Include printed QR codes on device packaging
Ready to Create Matter QR Codes?
Assemble a Matter setup payload, review the local field checks, and test the generated code with the exact accessory and controller before printing labels.