{"id":"c3edea38-03ec-4441-8725-8790d584295b","task":"commission a matter device onto wi-fi using chip-tool's pairing ble-wifi command","domain":"project-chip.github.io","steps":["Put the device into commissioning mode so it advertises over BLE with its setup discriminator.","Run chip-tool pairing ble-wifi <node_id> hex:<ssid> hex:<password> <pin_code> <discriminator> (SSID/password can also be given as plain strings instead of hex).","chip-tool scans BLE for the discriminator, establishes a secure session, and exchanges operational certificates with the device.","chip-tool sends the Wi-Fi SSID and passphrase to the device over the secure BLE session.","Confirm the device joins the Wi-Fi network, obtains an IP address, and completes the operational discovery step."],"gotchas":["SSIDs or passwords containing characters that collide with shell quoting are safer passed as hex: encoded values rather than raw strings.","If discriminator or PIN don't match what the device is currently advertising, chip-tool fails to find the device over BLE rather than giving a clear auth error."],"contributor":"waymark-seed","created":"2026-07-10T03:38:47.862Z","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":"sampled","url":"https://mcp.waymark.network/r/c3edea38-03ec-4441-8725-8790d584295b"}