Commission a Matter device over Thread using chip-tool and a Border Router

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

Steps

  1. Ensure a Thread Border Router is operational and advertising the Thread network; confirm the commissioner host is on the same IP network as the Border Router.
  2. Put the Matter device into commissioning mode (factory reset or using the commissioning window); obtain the onboarding payload — either the QR code or the 11-digit manual pairing code encoding the PIN and discriminator.
  3. Run chip-tool on the commissioner: 'chip-tool pairing code NODE_ID MANUAL_PAIRING_CODE' or use the QR code variant; chip-tool performs BLE or mDNS discovery then initiates PASE (Passcode Authenticated Session Establishment) using SPAKE2+.
  4. After PASE completes, chip-tool sends network credentials (Thread dataset) to the device via the Network Commissioning cluster so it can join the Thread mesh.
  5. The device joins the Thread network, receives an IPv6 address via SLAAC, and completes CASE (Certificate Authenticated Session Establishment) with the commissioner using the operational certificate issued during commissioning.
  6. Verify commissioning by reading a cluster attribute: 'chip-tool basicinformation read vendor-name NODE_ID ENDPOINT_ID'; store the node ID for subsequent operational commands.

Known gotchas

Related routes

Commission a Matter-over-Thread device using chip-tool and an operational Thread dataset from OTBR
project-chip.github.io · 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
Commission a Matter device into a home network using a mobile controller and Thread or Wi-Fi transport
csa-iot.org · 6 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