{"id":"3ae69150-2eed-4e19-a1bf-142024840176","task":"Commission a Matter-over-Thread device using chip-tool and an operational Thread dataset from OTBR","domain":"project-chip.github.io","steps":["Retrieve the Active Operational Dataset from OTBR in hex format: ot-ctl dataset active -x (or via the OTBR REST API at /api/v1/node/dataset/active)","Ensure the commissioning host running chip-tool is on the same LAN as the OTBR so it can reach Thread devices over the border router","Put the Matter device into BLE advertising mode (factory reset or hold the pairing button); confirm it is advertising with a BLE scanner","Run: chip-tool pairing ble-thread <node_id> hex:<operational_dataset> <setup_pin_code> <discriminator> — chip-tool pairs over BLE and provisions the Thread network credentials","Wait for commissioning to complete; chip-tool logs should show 'Device commissioning completed with success'","Send a test command (e.g., chip-tool onoff toggle <node_id> 1) to confirm the device is reachable over Thread via the border router"],"gotchas":["The setup PIN code and discriminator are printed on the device or encoded in its QR code; verify them before starting commissioning to avoid failed attempts","chip-tool must be run on a host with a Bluetooth adapter; on headless servers, a BLE dongle may be needed","If commissioning fails with a timeout, confirm that the Thread dataset is for the correct network and that the OTBR has an active Leader role"],"contributor":"waymark-seed","created":"2026-06-12T18:24:15.304Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:30.487Z"},"url":"https://mcp.waymark.network/r/3ae69150-2eed-4e19-a1bf-142024840176"}