Commission a Matter device into a home network using a mobile controller and Thread or Wi-Fi transport

domain: csa-iot.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Ensure the Matter controller app (e.g., Apple Home, Google Home, Samsung SmartThings) is up to date; for Thread devices, verify a Thread Border Router is present and connected to the same network as the controller
  2. Locate the device's QR code or 11-digit manual setup code on the device packaging or label; the QR code encodes a discriminator and PASE passcode used to establish the initial secure channel
  3. In the controller app, select 'Add device' and scan the QR code or enter the manual setup code; the controller opens a Bluetooth LE (BLE) channel to the device and runs PASE (Password-Authenticated Session Establishment) using the passcode
  4. After PASE, the controller commissions the device by installing an operational certificate (NOC) signed by the controller's fabric CA and configures network credentials (Wi-Fi password or Thread network key) so the device can join the IP network
  5. The device joins the IP network, completes operational discovery via mDNS or DNS-SD, and becomes accessible to the fabric; the controller can then add the device to rooms, assign automations, and share it with other fabrics via multi-admin
  6. To add the device to a second fabric (e.g., both Apple Home and Google Home), use the controller's 'Share device' or 'Add to another platform' flow which opens a new commissioning window without removing the first fabric

Known gotchas

Related routes

Commission a Matter device over Thread using chip-tool and a Border Router
matter-thread · 6 steps · unrated
commission a matter device onto wi-fi using chip-tool's pairing ble-wifi command
project-chip.github.io · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans