FISSURE - The RF Framework

Frequency Independent SDR-based Signal Understanding and Reverse Engineering

FISSURE is an open-source RF and reverse engineering framework designed for all skill levels with hooks for signal detection and classification, protocol discovery, attack execution, IQ manipulation, vulnerability analysis, automation, and AI/ML. The framework was built to promote the rapid integration of software modules, radios, protocols, signal data, scripts, flow graphs, reference material, and third-party tools. FISSURE is a workflow enabler that keeps software in one location and allows teams to effortlessly get up to speed while sharing the same proven baseline configuration for specific Linux distributions.

The framework and tools included with FISSURE are designed to detect the presence of RF energy, understand the characteristics of a signal, collect and analyze samples, develop transmit and/or injection techniques, and craft custom payloads or messages. FISSURE contains a growing library of protocol and signal information to assist in identification, packet crafting, and fuzzing. Online archive capabilities exist to download signal files and build playlists to simulate traffic and test systems.

The friendly Python codebase and user interface allows beginners to quickly learn about popular tools and techniques involving RF and reverse engineering. Educators in cybersecurity and engineering can take advantage of the built-in material or utilize the framework to demonstrate their own real-world applications. Developers and researchers can use FISSURE for their daily tasks or to expose their cutting-edge solutions to a wider audience. As awareness and usage of FISSURE grows in the community, so will the extent of its capabilities and the breadth of the technology it encompasses.

Documentation

• AIS Page
• GRCon22 Slides
• GRCon22 Paper
• Hack Chat Transcript

Capabilities

Signal Detector	IQ Manipulation	Signal Lookup	Pattern Recognition
Attacks	Fuzzing	Signal Playlists	Image Gallery
Packet Crafting	Scapy Integration	CRC Calculator	Logging
Dataset Builder	Online Archive	Third-Party Tools	Dark and Custom Themes

Videos

• FISSURE Videos
• AIS YouTube

Install	Target Signal Identification	Protocol Discovery
Packet Crafter	IQ Data	Archive
Attack	Library	GRCon22

Hardware

The following is a list of "supported" hardware with varying levels of integration: - USRP: X3xx, B2xx, B20xmini, USRP2, N2xx, X410 - HackRF - RTL2832U - 802.11 Adapters - LimeSDR - bladeRF, bladeRF 2.0 micro - Open Sniffer - PlutoSDR

Getting Started

Supported

There are three branches within FISSURE to make file navigation easier and reduce code redundancy. Each branch codebase is dependent on the major version of Python and GNU Radio. - Python2_maint-3.7 branch: Python2, PyQt4, GNU Radio 3.7 - Python3_maint-3.8 branch: Python3, PyQt5, GNU Radio 3.8 - Python3_maint-3.10 branch: Python3, PyQt5, GNU Radio 3.10.

In-Progress (beta)

These operating systems are still in beta status. They are under development and several features are known to be missing. Items in the installer might conflict with existing programs or fail to install until the status is removed.

Note: Certain software tools do not work for every OS. Refer to Known Conflicts and Third-Party Software

Installation

git clone https://github.com/ainfosec/FISSURE.git
cd FISSURE
git checkout <Python2_maint-3.7> or <Python3_maint-3.8> or <Python3_maint-3.10>
git submodule update --init
./install

This will install PyQt software dependencies required to launch the installation GUIs if they are not found. The git submodule command will download all missing GNU Radio out-of-tree modules from their repositories.

Next, select the option that best matches your operating system (should be detected automatically if your OS matches an option).

Python2_maint-3.7	Python3_maint-3.8	Python3_maint-3.10

It is recommended to install FISSURE on a clean operating system to avoid conflicts with existing software. The items listed under the "Minimum Install" category are what is required to launch the FISSURE Dashboard without errors. Software programs outside the minimum install are optional and can be installed as needed. Select all the recommended checkboxes (Default button) to avoid errors while operating the various tools within FISSURE. I