# CatSniffer

**Repository Path**: tanganrong/CatSniffer

## Basic Information

- **Project Name**: CatSniffer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-17
- **Last Updated**: 2025-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CatSniffer

<a href="https://github.com/ElectronicCats/CatSniffer/wiki">
  <img src="https://github.com/ElectronicCats/CatSniffer/assets/139595394/8ec74cfa-f5e9-42d0-aa6f-9f2a7513a761" />
</a>

<p align=center>
  <a href="https://electroniccats.com/store/catsniffer/">
    <img src="https://electroniccats.com/wp-content/uploads/badge_store.png" width="200" height="104" />
  </a>
  <a href="https://github.com/ElectronicCats/CatSniffer/wiki">
    <img src="https://github.com/ElectronicCats/flipper-shields/assets/44976441/6aa7f319-3256-442e-a00d-33c8126833ec" width="200" height="104" />
  </a>
</p>

<p align=center>
    Also available at distributors:
  </p>
<p align=center>
  <a href="https://labs.ksec.co.uk/product-category/electronic-cat/">
    <img src="https://cdn.ksec.co.uk/ksec-solutions/ksec-W-BW-MV-small-clipped.png" width="200" />
  </a>
</p>

CatSniffer :smirk_cat: is an original multiprotocol, and multiband board made for sniffing, communicating, and attacking IoT (Internet of Things) devices. It was designed as a highly portable USB stick that integrates the new chips TI CC1352, Semtech SX1262, and an RP2040 for V3 or a Microchip SAMD21E17 for V2.

This board is a swiss army knife for IoT security researchers, developers, and enthusiasts. The board can be used with different types of software including third-party sniffers such as [SmartRF Packet Sniffer](https://www.ti.com/tool/PACKET-SNIFFER), [Sniffle](https://github.com/ElectronicCats/Sniffle), [zigbee2mqtt](https://github.com/Koenkk/zigbee2mqtt), [Z-Stack-firmware](https://github.com/Koenkk/Z-Stack-firmware), [Ubiqua Protocol Analyzer](https://www.ubilogix.com/ubiqua/), [our custom software](https://github.com/ElectronicCats/CatSniffer-Tools), or you can even write your own software for your specific needs.

CatSniffer can operate in 3 different technologies:
* LoRa
* Sub 1 GHz
* 2.4 GHz

This work was inspired by our friend's work [Michael Ossmann](https://twitter.com/michaelossmann) as a tribute to his outstanding job in [Greatscott Gadgets](https://greatscottgadgets.com/), making devices like the YardStick, GreatFET, HackRF, and Ubertooth.

<a href="https://electroniccats.com/store/catsniffer/">
  <img src="https://electroniccats.com/wp-content/uploads/badge_store.png" width="200" height="104" />
</a>

## Versions

The CatSniffer has been evolving since its first release:

- CatSniffer v1.2
- CatSniffer v1.3
- CatSniffer v2.0
- CatSniffer v2.1
- CatSniffer v3.1

We as an pro-open-source companies decided to keep the support for each version, but having in mind that newer versions will have more features than the first versions.

The different firmwares are inside the repository and not in the realese section to keep a propper track of the compiled and source files.

## Protocols
- Thread
- Zigbee
- Bluetooth 5 Low Energy (BLE)
- IEEE 802.15.4g
- 6LoWPAN (IPv6 over Low power Wireless Personal Area Networks)
- Sub 1Ghz and patented systems
- LoRa/LoRaWAN
- Wi-SUN
- Amazon Sidewalk
- mioty®
    

## Features
- "The SimpleLink™ [CC1352P1F3RGZ](https://www.ti.com/lit/ds/symlink/cc1352p.pdf?ts=1631314674885) device is a multiprotocol and multi-band Sub-1 GHz and 2.4-GHz wireless microcontroller (MCU) supporting Thread, Zigbee®, Bluetooth® 5.2 Low Energy, IEEE 802.15.4g, IPv6-enabled smart objects (6LoWPAN), MIOTY®, Wi-SUN®, proprietary systems".
- CatSniffer uses Microchip SAMD21E17 (V2 or previous) and RP2040 (V3 or later) as a USB-UART bridge to communicate with the CC1352 chip; it's not necessary for a manual driver installation (exceptions could exist).
- Compatible OS: Windows and Linux.
- Auto program through the bootloader from TI CC (as long as it's not disabled in the code). No need for an external programmer, and it can be debugged with cJTAG through the default pin.
- Antenna SMA port for an Antenna of your choice.
- LEDs of general-purpose.
- Reset button for RP2040, SAMD21 & CC1352, Boot of CC1352, and one more for general purpose.

## Wiki and Getting Started

[Getting Started in our Wiki](https://github.com/ElectronicCats/CatSniffer/wiki)

[![WIKI](https://user-images.githubusercontent.com/40640735/217364175-6e3af8df-e6b4-4fcd-9515-09ff02639f64.jpg)](https://github.com/ElectronicCats/CatSniffer/wiki)

## Firmware Repository
All Catsniffer Firmware has been moved to a different repository, to have a better version control, and issue tracking you will find it here:

https://github.com/ElectronicCats/CatSniffer-Firmware

All catsniffer versions are supported in this repository, you will need to check what version you own and select the proper branch to develop or release for just program your board.

## Software Repository
All Catsniffer Software has been moved to a different repository, to have a better version control, and issue tracking you will find it here:

https://github.com/ElectronicCats/CatSniffer-Tools

## Compatible Software
* [Smart RF Packet Sniffer 2](https://github.com/ElectronicCats/CatSniffer/wiki/06.-Supported-Software#smart-rf-packet-sniffer-2)
* [Wireshark](https://github.com/ElectronicCats/CatSniffer/wiki/06.-Supported-Software#wireshark)
* [pycatsniffer tool (BETA)](https://github.com/ElectronicCats/CatSniffer/wiki/06.-Supported-Software#pycatsniffer-tool)
* [Sniffle](https://github.com/ElectronicCats/CatSniffer/wiki/06.-Supported-Software#sniffle)
* [Ubiqua Protocol Analyzer](https://github.com/ElectronicCats/CatSniffer/wiki/06.-Supported-Software#ubiqua-protocol-analyzer)
* [zigbee2mqtt](https://github.com/Koenkk/zigbee2mqtt)
* [Z-Stack-firmware](https://github.com/Koenkk/Z-Stack-firmware)

## Pre-requisites for building firmware
* Arduino IDE for RP2040 or SAMD21E17
* CCS version: The packet sniffer firmware has been tested with CCS 10.2
* SimpleLink CC13x2 and CC26x2 SDK 
* Python 3

## Note
This kit is designed to allow Product developers to evaluate electronic components, circuit, or software associated with the kit to determine whether to incorporate such items in a finished product and Software developers to write software applications for use with the end product. This kit is a developer product and when assembled may not be resold or otherwise marketed unless all required FCC (or any other local authority) equipment authorizations are first obtained. Operation is subject to the condition that this product not cause harmful interference to licensed radio stations and that this product accept harmful interference.

## Workshops

We have been doing worshops held in different security related events the material avaible is public and can be found [here](https://drive.google.com/drive/folders/1SxkF2-uWVFw2BZa5lym5f42ivyW23bVV)

## How to contribute <img src="https://electroniccats.com/wp-content/uploads/2018/01/fav.png" height="35"><img src="https://raw.githubusercontent.com/gist/ManulMax/2d20af60d709805c55fd784ca7cba4b9/raw/bcfeac7604f674ace63623106eb8bb8471d844a6/github.gif" height="30">
 Contributions are welcome! 

Please read the document  [**Contribution Manual**](https://github.com/ElectronicCats/electroniccats-cla/blob/main/electroniccats-contribution-manual.md)  which will show you how to contribute your changes to the project.

✨ Thanks to all our [contributors](https://github.com/ElectronicCats/CatSniffer/graphs/contributors)! ✨

See [**_Electronic Cats CLA_**](https://github.com/ElectronicCats/electroniccats-cla/blob/main/electroniccats-cla.md) for more information.

See the  [**community code of conduct**](https://github.com/ElectronicCats/electroniccats-cla/blob/main/electroniccats-community-code-of-conduct.md) for a vision of the community we want to build and what we expect from it.


## License

Electronic Cats invests time and resources providing this open source design, please support Electronic Cats and open-source hardware by purchasing products from Electronic Cats!

Designed by Electronic Cats.

Firmware released under an GNU AGPL v3.0 license. See the LICENSE file for more information.

Hardware released under an CERN Open Hardware [Licence v1.2](https://github.com/ElectronicCats/CatSniffer/blob/master/LICENSE.md) See the LICENSE_HARDWARE file for more.
Electronic Cats is a registered trademark, please do not use if you sell these PCBs.

3 April 2021