What it makes

The setup code of a Matter smart home device: the QR code, whose text starts with MT:, and the manual pairing codes of 11 and 21 digits that you type in when a camera can't read the QR code. They're the codes a manufacturer prints on a device's label, made from its onboarding data. It's handy when you build a Matter device, for example on a development board, and need a label for it, or when you know a device's setup data and want a fresh label.

How to use it

  • Vendor ID and Product ID: type them as decimal numbers or as hex starting with 0x. Vendor IDs 0xFFF1 to 0xFFF4 are for testing; certified products have a vendor ID from the Connectivity Standards Alliance. Enter 0 for both to leave them out of the QR code.
  • Discriminator: a number from 0 to 4095 that apps use to find the device among others nearby. The dice button picks a random one.
  • Setup passcode: up to eight digits. The specification forbids trivial ones, like eight identical digits, 12345678 and 87654321. The dice button picks a random passcode the specification allows.
  • Commissioning flow: Standard when the device is ready to pair as soon as it's powered on, User action required when the user must press a button or follow the manual first, Custom when the steps are in the manufacturer's entry in the Distributed Compliance Ledger.
  • Discovery methods: how the device can be found while it waits to be set up: Bluetooth LE, already on the IP network, Wi-Fi Public Action Frame or NFC.

The QR code's look (error correction, size, quiet zone and colors) can be changed below the device settings.

What you get

  • The QR code, to download as PNG, JPG, WebP or SVG, with its text under Raw value.
  • The 11-digit manual code, grouped the way devices print it. It exists only for the standard flow.
  • The 21-digit manual code, which adds the vendor and product IDs. The user action required and custom flows need it, so they need both IDs.

A code works only when it matches the device: an app looks for a device with this discriminator and then has to prove the passcode the device stores. A made-up code doesn't pair with anything.

Privacy

The codes are made in your browser, so nothing you enter is sent anywhere. A real device's setup code lets anyone nearby add it while it's waiting to be set up, so keep those to yourself.