Zigbee: Catsniffer v3

The CatSniffer is a multi-radio embedded swiss army knife tool. With the appropriate firmware, it can capture Zigbee traffic with Kismet.

While the CatSniffer v1 and v2 devices contain the same radios, it appears the Zigbee control firmware has not been ported to the previous microcontroller used, so they currently can not capture Zigbee with Kismet.

Added 2025-10

The CatSniffer Zigbee datasource is available on Kismet git and release builds 2025-10 and later.

802.15.4 (Zigbee)

The 802.15.4 standard is a low-bandwidth low-power networking standard. A commercial implementation is Zigbee, however other devices also implement the 802.15.4 physical layer.

Detecting and classifying 802.15.4 networks can be challenging, as they may transmit infrequently. Often 802.15.4 networks report fragmentary network IDs, which may lead to multiple networks being identified as a single device; this is unavoidable due to how 802.15.4 addressing works.

Kismet also decodes what it can of the network above 802.15.4: Zigbee and Thread beacons, the Zigbee network (NWK) header, 6LoWPAN and Thread MLE. Devices are labelled as Zigbee coordinators, routers and devices, Zigbee Green Power devices, Thread devices or 6LoWPAN devices. The device details show the network, role, PAN and short address, the device’s IEEE (EUI-64) address when a Zigbee NWK header carries it, the extended PAN ID, the Thread network name and the Zigbee stack profile. Green Power devices, which have no MAC address of their own, are tracked by their source ID. Frames encrypted at the 802.15.4 MAC layer can’t be read past their header.

After 2026-10-R1, Kismet learns more about Thread networks:

  • Thread Discovery Requests and Responses are decoded. A response gives the network’s name, extended PAN ID, Thread version, whether it is accepting new devices, whether a native commissioner may join, and the joiner port; a request marks its sender as scanning for networks or looking for one to join. An open network raises the THREADJOINABLE alert.
  • Thread 1.1 beacons also give the version and whether the network is accepting new devices, and their extended PAN ID is shown in the right byte order; before, it was reversed like a Zigbee one.
  • Most Thread frames are encrypted, so a device on a PAN which Kismet has seen to be a Thread network, on the same channel, is labelled Thread with the network’s name and extended PAN ID, unless its own frames say it is Zigbee.
  • Thread routers and end devices are told apart by their short address (RLOC16), which gives the router and child ID, and an end device is linked to its parent router. Routers show the children, and the routers of their network, heard in the last hour; sleepy end devices show how often they poll their parent, and CSL end devices their CSL period. The MAC key index and MLE key sequence show how many times the network key has rotated.
FieldContents
802154.device.thread_versionThread version: 2 Thread 1.1, 3 1.2, 4 1.3, 5 1.4
802154.device.thread_joiningWhether its network takes new devices: 1 no, 2 the devices its commissioner lists, 3 any
802154.device.thread_nativeIts network allows a native commissioner
802154.device.thread_joiner_portThe UDP port joining devices use to reach it
802154.device.thread_discoveryIts discovery requests: 1 looking for networks, 2 looking for a network to join
802154.device.thread_router_id, thread_child_idRouter and child ID from its short address; child ID 0 for a router
802154.device.thread_parentThe device key of its parent router
802154.device.thread_children, thread_routersA router’s children, and the routers of its network, heard in the last hour
802154.device.thread_polls, thread_poll_intervalData polls sent to its parent, and the usual time between them in milliseconds
802154.device.thread_csl_periodIts CSL period, in units of 10 symbols (160 µs at 2.4 GHz)
802154.device.thread_key_index, thread_key_seqThe key index of its MAC security, and the key sequence of its MLE security

802.15.4 channels

802.15.4 / Zigbee operates in up to 3 bands. You will need a device for each band. Most devices support the more common 2.4GHz band, with support for 800 and 900MHz being much rarer (currently only supported via the Freaklabs hardware).

BandChannelsDescription
8000European band, single channel
9001-10US / International ISM band
240011-26US / International ISM band

Channels are a fixed width and are identified only by channel number (ie 1, 12, 13, 14). There are no options for wide or fast channels in 802.15.4.

The CatSniffer hardware supports only the 2.4GHz Zigbee channels (11-26).

Despite sharing the frequency range with Wi-Fi on the 2.4GHz band, 802.15.4 uses a different physical encoding standard; a Wi-Fi card is not able to see 802.15.4 packets or networks, and an 802.15.4 device is not able to see Wi-Fi packets.

CatSniffer v3 Zigbee Capture Firmware

Before using the CatSniffer v3 with Kismet, both the RP2040 serial passthrough firmware and the Zigbee capture firmware must be flashed to the device. The CatSniffer v3 contains two processors which are programmed separately:

  • An RP2040 (USB interface / serial passthrough)
  • A TI CC1352P (Zigbee radio)

Precompiled firmware images are available from the CatSniffer Firmware GitHub releases page.


Required firmware files

Download the following firmware files:

RP2040 serial passthrough firmware

Zigbee capture firmware (CC1352P)

Flashing the CC1352P firmware requires the cc2538-bsl utility from the CatSniffer Tools repository.


Flashing the RP2040 serial passthrough firmware

This step was tested on Windows. Linux behavior should be similar, though the volume may have to be mounted manually.

  1. Connect the unflashed CatSniffer v3 to the system using its USB-C port.
  2. Quickly double-click the reset1 button.
  3. A removable storage device named RPI-RP2 should appear. At this point, the on-board LEDs should be off.
  4. Copy the SerialPassthroughwithboot_RP2040_v1.1.uf2 file into the root of the RPI-RP2 volume.
  5. Once the file is copied, the volume should automatically disconnect.

Verifying RP2040 firmware behavior

  1. Press and hold the boot1 button.
  2. While holding boot1, press and release reset1.
  3. Release the boot1 button.

Two solid blue LEDs should now be visible. After physically disconnecting and reconnecting the device, the LEDs should exhibit a sequential “waterfall” blink pattern, indicating that the serial passthrough firmware is running correctly.

In some cases, the serial passthrough firmware may need to be loaded twice before the waterfall LED behavior appears. The cause of this behavior is currently unknown.

A general visual reference for flashing the serial passthrough firmware is available here:


Preparing a Linux environment for Zigbee firmware flashing

The following steps were tested using a Kali Linux virtual machine.

Install required Python dependencies for cc2538-bsl.py:

pip install pyserial
pip install intelhex
pip install python-magic

Flashing the CC1352P Zigbee firmware

  1. Connect the CatSniffer v3 to the Linux system.
  2. The device should enumerate as /dev/ttyACM0.

Verify the device identity:

lsusb

Expected output should be similar to:

ID 2e8a:00c0 Arduino RaspberryPi Pico

Additional confirmation:

udevadm info -a -n /dev/ttyACM0 | grep ATTRS{product}

Expected output:

ATTRS{product}=="RaspberryPi Pico"
  1. Use the cc2538-bsl.py uploader to flash the Zigbee firmware:
sudo python3 cc2538-bsl.py -e -w -v sniffer_fw_CC1352P_7_v1.10.hex

The CatSniffer catnip uploader did not function reliably during testing; cc2538-bsl.py is recommended.

After flashing, you may need to unplug and reconnect the device before it begins operating normally.


Testing the CatSniffer with cat_sniffer.py

To validate that the device is working correctly, use the cat_sniffer.py tool from the CatSniffer Tools repository:

A Zigbee device must be active nearby, and the correct channel must be known.

Example usage:

cd pycatsniffer_bv3
sudo python3 cat_sniffer.py sniff /dev/ttyACM0 -phy 1 -ch 15 -v

To capture packets directly into Wireshark:

sudo python3 cat_sniffer.py sniff /dev/ttyACM0 -phy 1 -ch 12 -ff -ws -v

Type stop in the CLI to end capture and save the PCAP file. Closing Wireshark directly may terminate the script.


Known issues

  • The current version of cat_sniffer.py does not display Zigbee channel information correctly. The channel is not embedded in the packet frame, contrary to the tool’s assumption.

Supported Hardware

While the CatSniffer v1 and v2 devices may be capable of running the sniffer firmware, it is not immediately obvious if there is a version of the sniffer firmware which works on the v1 and v2 versions of the hardware.

Source parameters

Naming and description options

All data sources accept the common naming and description options.

Channel control options

channel_hop={ true } / { false }

Enable or disable channel hopping on this data source. Even if Kismet is configured for channel hopping.

channel_hoprate={ rate/sec } / { rate/min }

Change the hop rate for this source.

channel={ channel }

Set the source to a specific channel; combine with channel_hop=false to set the capture to a single channel forever. Valid channels are 11-26; an invalid channel fails the source. Without channel=, the source starts on channel 11.

Example:

source=catsniffer_zigbee:device=/dev/ttyUSB0,name=Foo,channel_hop=false,channel=12

channels={ channel1,channel2,...,channelN }

Set a fixed list of channels instead of probing the source for all supported channels.

The list of channels must be:

  • Comma separated
  • Contained in quotes

Example:

source=catsniffer_zigbee:device=/dev/ttyUSB0,name=Foo,channels="12,13,14,15"

If defining datasources on the command line when launching Kismet, be aware that most shells will elide the quotes, leading to a setup error. You can avoid this by surrounding the source definition in single quotes:

kismet -c 'catsniffer_zigbee:device=/dev/ttyUSB0,name=Foo,channels="12,13,14,15"'