Action Required! Starting November 21st, 2022, Nest Hubs opted into the Preview Program are being updated to support Matter 1.0 in anticipation of Google's general availability (GA) of Matter. All Matter devices being used with the Preview Program will need to be updated. See the Release Notes for more details.

Pair a Matter device

Stay organized with collections Save and categorize content based on your preferences.

Pair your Matter-enabled device. To do this, you'll need a QR code for pairing. Depending on the platform of your Matter device, you may need to generate this QR code yourself.

Get a QR code

Bouffalo Lab

BL602

The QR code string is printed in the serial console when device boots up. Check out your serial console and you should see messages like this:

Booting BL602 Chip...
██████╗ ██╗      ██████╗  ██████╗ ██████╗
██╔══██╗██║     ██╔════╝ ██╔═████╗╚════██╗
██████╔╝██║     ███████╗ ██║██╔██║ █████╔╝
██╔══██╗██║     ██╔═══██╗████╔╝██║██╔═══╝
██████╔╝███████╗╚██████╔╝╚██████╔╝███████╗
╚═════╝ ╚══════╝ ╚═════╝  ╚═════╝ ╚══════╝
...
[INFO] ==================================================
[INFO] chip-bl602-lighting-example starting
[INFO] ==================================================
...
[INFO] [SVR] SetupQRCode: [MT:6FCJ142C00KA0648G00]
[INFO] [SVR] Copy/paste the below URL in a browser to see the QR Code:
[INFO] [SVR] https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3A6FCJ142C00KA0648G00
...

Open the link in a web browser to display the QR code.

Espressif

Getting the QR code differs for each type of ESP32-based kit:

ESP32 DevkitC

  1. Connect the device to a host machine and use a serial terminal to connect to it and display its logs. For example, on a Linux host machine, you might use screen /dev/ttyUSB0 115200 to connect to the device and view logs if it is attached to the host at /dev/ttyUSB0.
  2. A URL is displayed in the logs when the device is first booted. Open the link in a web browser to display the QR code.

M5Stack ESP32

When first booted, the device will display a QR code menu option. Select it to see the QR code in the device's display.

ESP32 WROVER Kit

The device shows the QR code immediately after booting.

Nordic Semiconductor

nRF52840

Since the nRF52840 board doesn't have a display, the QR code string is printed in the serial console when it boots up. For example:

I: 1317 [SVR]SetupQRCode:  [MT:I347HHY00 0C9SS0]
I: 1321 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1327 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI347HHY00%200C9SS0

Open the link in a web browser to display the QR code.

NXP

K32W

The QR code string is printed in the serial console when device boots up. Check out your serial console and you should see messages like this:

[Info]Welcome to NXP Lighting Demo App
[Info]OpenThread started: OK
...
[Info]Server Listening...
[Info]SetupQRCode:  [MT:I34DVDY00 0C9SS0]
[Info]Copy/paste the below URL in a browser to see the QR Code:
[Info]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AI34DVDY00%200C9SS0
...

Open the link in a web browser to display the QR code.

Realtek

Ameba D

The QR code is encoded in a URL, which is printed in the serial console when the Ameba D board boots up:

Setup PIN code: 20202021 (0x1344225)
Short Manual(decimal) setup code: 34970112332
Long Manual(decimal) setup code:  749701123309050652796
QR CODE Text: 'MT:YNJV75HZ00KA0648G00'
Copy/paste the below URL in a browser to see the QR CODE:

https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AYNJV75HZ00KA0648G00

Open the link in a web browser to display the QR code.

Silicon Labs

EFR32MG12

Once the board boots up, you should find a QR code on its small LCD display.

Pair the device

There are two ways to pair the device:

  1. Google Home app (GHA)
  2. Google's Home Mobile and Thread Network SDKs for Android (which can be used in a 3rd party app)

Both methods use the same Matter and Thread Network APIs.

Google Home App

  1. Open the GHA.
  2. Tap on the in the upper-left corner.
  3. Tap on Set up device.
  4. Tap on New device.
  5. Select your home and tap on Next.
  6. GHA will scan for your device. Once it prompts on whether you'd like to set up your device, tap on Set up a different device.
  7. Tap on Matter device for any device type.
  8. Point your camera at your device's QR code (or the website-generated QR code).
  9. Continue the pairing process as indicated in the GHA flow.

If you encounter any issues during pairing with GHA on your mobile device:

  1. Make sure you have Developer options enabled for your mobile device.
  2. Immediately after the failed pairing attempt, capture a bug report.

Android SDKs

Android SDKs have been made available in Play services for testing and pairing in a 3rd party app.

We suggest starting with the Google Home Sample App for Matter, which illustrates how to commission, pair, and control a Matter-enabled device in the Google Home ecosystem with these SDKs.