Decode Thread with an SDR
Thread: networks and devices from beacons and 802.15.4 headers, 6LoWPAN where sent in the clear (receive only, encrypted traffic is shown as encrypted; needs a fast 2.4 GHz radio).
- Group
- IoT & sensors
- In the mode list
- IoT, 2.4 GHz
- GitHub wiki
- Mode-Thread
What Thread is
Thread (the IPv6 mesh of Matter smart homes) on the 2.4 GHz 802.15.4 channels 11 - 26 (O-QPSK, 250 kbit/s): networks from their beacons (network name, extended PAN ID, version), devices from their 802.15.4 addresses, 6LoWPAN headers (mesh, fragments, IPHC, UDP ports, MLE and CoAP) where a frame is sent in the clear, a live frame log; channel scan. Receive only. Almost all Thread traffic is….
Frequencies and settings
OnAir takes any frequency you type; the numbers above are the mode's starting point and the range its table describes. In the app the shortcut label is IoT, 2.4 GHz.
What OnAir shows
Thread (the IPv6 mesh of Matter smart homes) on the 2.4 GHz 802.15.4 channels 11 - 26 (O-QPSK, 250 kbit/s): networks from their beacons (network name, extended PAN ID, version), devices from their 802.15.4 addresses, 6LoWPAN headers (mesh, fragments, IPHC, UDP ports, MLE and CoAP) where a frame is sent in the clear, a live frame log; channel scan. Receive only. Almost all Thread traffic is AES-CCM encrypted at the link layer: those frames show the 802.15.4 header, the frame counter and key index and are marked encrypted; their content (IPv6, MLE, CoAP) is not readable without the network key, and OnAir does not decrypt or recover keys. Needs a fast radio (4 Msps or more), not an RTL-SDR.
Limits and what it was checked with
Checked with generated signals and impairments; recordings of real signals welcome.
Which radio you need
This mode sits at a high frequency, so check that your radio tunes it: a HackRF covers 1 MHz to 6 GHz, and RTL-SDR stops near 1.7 GHz. Some modes at these frequencies also need a fast radio (10 to 20 Msps) or a dish and an LNB.
Receiving and the law
Questions about Thread
Can I decode Thread with an RTL-SDR?
Probably not: an RTL-SDR tunes up to about 1.7 GHz. A HackRF (1 MHz to 6 GHz) or another wideband radio is the usual choice for this frequency range.
Is it legal to receive Thread?
This mode is passive. It only receives, never connects, pairs or joins networks, and never decrypts payloads. Check the rules where you live.
Can I try Thread in OnAir without a radio?
Yes. Most modes include a built-in synthetic test signal, so you can open the screen and try the controls before you own a radio.