Skip to content

sacriphanius/Flipper-Zero-Rf-Jammer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📡 Flipper Zero RF Jammer & Spectrum Analyzer

Flipper Zero Language License Firmware

A powerful Sub-GHz RF analysis and testing tool featuring a custom two-stage frequency scanner, external CC1101 support, and an advanced oscilloscope-style spectrum visualizer.

EnglishTürkçe


Warning

🛑 Educational Purpose Only / Sadece Eğitim Amaçlıdır

EN: This project is created strictly for educational and research purposes. It is designed to help security researchers and engineers understand RF communications, signal analysis, and hardware security. The author(s) do not endorse, encourage, or take responsibility for any illegal use, interference with public/private communications, or malicious activities. Use this tool responsibly and strictly on equipment you own or have explicit permission to test.

TR: Bu proje tamamen eğitim ve güvenlik araştırmaları amacıyla geliştirilmiştir. Sinyal analizi, RF iletişimleri ve donanım güvenliğini anlamaya yardımcı olmak için tasarlanmıştır. Geliştirici(ler), bu yazılımın yasa dışı kullanımından, kamu/özel iletişimlerine müdahale edilmesinden veya kötü niyetli eylemlerden sorumlu tutulamaz. Bu aracı yalnızca sahip olduğunuz veya test etmek için açık izniniz olan cihazlarda kullanınız.


🇬🇧 English

🌟 Overview

This application transforms your Flipper Zero into an advanced RF Jammer and Spectrum Analyzer. Unlike standard implementations, it features a Two-Stage Frequency Scanner (Coarse + Fine) that perfectly locks onto ambient signals and supports External CC1101 Modules for massively increased range and noise isolation.

🚀 Key Features

  • Two-Stage Smart Scanner: Performs a coarse sweep of common frequencies. Once a signal > -73dBm is detected, it triggers a micro-sweep (±300kHz in 20kHz steps) to lock onto the exact peak frequency (e.g., 433.889 MHz).
  • External CC1101 Integration: Full support for external sub-GHz antennas via GPIO. Automatically switches to the external module if detected, providing superior range and eliminating Flipper's internal hardware noise.
  • Advanced Spectrum UI: Replaces clunky bar charts with a smooth, connected waveform graph. Features a background grid and a 25% dithered shadow effect for a professional oscilloscope aesthetic.

🎮 Controls

  • UP / DOWN: Navigate through the detected frequencies list.
  • RIGHT: Start jamming the selected frequencies (auto-hops if multiple are selected).
  • LEFT: Open the Manual Mode to dial in a custom frequency and select a specific noise modulation.
  • OK (Short Press): Select/Deselect a frequency in the scanner. In Manual Mode, cycles through the Jamming Modulation Modes.
  • OK (Long Press): Clear the detected list and restart the scanner from scratch.
  • BACK: Stop active jamming or exit the application.

📡 Jamming Modes

The app includes 14 different noise/modulation modes. The most notable are:

  • OOK / Bruteforce (Continuous Wave): High-power continuous carrier wave. Best for completely deafening simple receivers like garage doors and barriers.
  • 2FSK / GFSK / MSK: Various frequency modulations. Ideal for disrupting digital protocols or smart remotes.
  • White Noise / Random: Scatters noise randomly. Covers a wider spectrum but is less concentrated.
  • Sweep / Burst: Emits short bursts of RF energy. Good for bypassing certain receiver filters.

⚙️ How it Works

  1. Scanning Phase: The device loops through a predefined array of common ISM frequencies.
  2. Detection & Locking: When an active remote or beacon is triggered nearby, the receiver immediately halts the loop, zeroes in on the frequency, measures the peak RSSI, and adds the precise frequency to the target list.
  3. Jamming Phase: The user selects the targeted frequency and presses OK. The app configures the CC1101 PATABLE to maximum software power (+12dBm) and asynchronously drives the GDO0 pin to flood the specific frequency with chosen noise modulations, effectively deafening any nearby receivers.

🛠️ Universal Installation & Compatibility

This application is fully Universal and can be compiled for all major Flipper Zero firmwares (Official, Momentum, Unleashed, Xtreme, RogueMaster, etc.).

Compile the project using the Flipper Build Tool (ufbt or fbt):

# Navigate to the project directory
cd RF_Jammer

# Compile using ufbt
ufbt

The resulting .fap file can be copied to your Flipper Zero's SD card under apps/Sub-GHz/.


🇹🇷 Türkçe

🌟 Genel Bakış

Bu uygulama, Flipper Zero'nuzu gelişmiş bir RF Jammer ve Spektrum Analizörüne dönüştürür. Standart uygulamalardan farklı olarak, havadaki sinyallere kusursuz bir şekilde kilitlenen İki Aşamalı Frekans Tarayıcı (Coarse + Fine) barındırır ve menzili devasa oranda artırmak için Harici CC1101 Modüllerini destekler.

🚀 Temel Özellikler

  • İki Aşamalı Akıllı Tarama: Yaygın frekanslarda kaba (coarse) bir tarama yapar. -73dBm'den güçlü bir sinyal bulunduğunda, o frekansın etrafında (20kHz adımlarla ±300kHz) mikro bir tarama başlatarak tam zirve frekansına (örn: 433.889 MHz) kilitlenir.
  • Harici CC1101 Desteği: GPIO üzerinden bağlanan harici sub-GHz antenlerini otomatik tanır. Flipper'ın kendi işlemci gürültüsünü engeller ve test menzilini devasa boyutlara çıkarır.
  • Gelişmiş Spektrum Ekranı: Kaba siyah sütunlar yerine, profesyonel bir osiloskop hissi veren sürekli dalga formu (waveform) çizer. Arka plan ölçüm ızgarası ve %25 şeffaf gölgelendirme efektlerine sahiptir.

🎮 Kontroller (Kullanım Kılavuzu)

  • YUKARI / AŞAĞI: Tespit edilen frekanslar listesinde gezinmenizi sağlar.
  • SAĞ: Seçili frekanslara saldırmaya (jamming) başlar. Birden fazla frekans seçiliyse otomatik olarak aralarında atlar (Frequency Hopping).
  • SOL: Manuel Modu açar. Buradan dilediğiniz bir frekansı elle girebilir ve özel atak türü seçebilirsiniz.
  • OK (Kısa Basım): Taramada listeden frekans Seç/Kaldır işlemi yapar. Manuel moddayken Gürültü Modunu (Modulation) değiştirir.
  • OK (Uzun Basım): Listeyi tamamen temizler ve taramayı sıfırdan baştan başlatır.
  • GERİ: Aktif jamming işlemini durdurur veya uygulamadan çıkmanızı sağlar.

📡 Gürültü (Jamming) Modları

Uygulama 14 farklı gürültü/modülasyon türü barındırır. En önemlileri şunlardır:

  • OOK / Bruteforce (Sürekli Dalga): En güçlü sinyaldir. Enerjiyi tek frekansta toplayarak bariyer, otopark ve basit alıcıları tamamen sağır etmek için en ideal yöntemdir.
  • 2FSK / GFSK / MSK: Frekans kaydırmalı (dijital) modülasyonlar. Akıllı kumandaları ve dijital protokolleri karıştırmak için kullanılır.
  • White Noise / Random (Rastgele Gürültü): Sinyali daha geniş bir alana yayar. Odaklı olmadığı için gücü düşüktür ama geniş bantlı alıcıları şaşırtır.
  • Sweep / Burst: Kesik kesik şok dalgaları yollar. Bazı alıcıların filtrelerini atlatmak için kullanışlıdır.

⚙️ Nasıl Çalışır

  1. Tarama (Scanning) Aşaması: Cihaz, yaygın ISM frekanslarından oluşan bir dizide döngü başlatır.
  2. Tespit ve Kilitlenme: Yakınlarda bir kumanda veya verici aktif olduğunda, alıcı döngüyü anında durdurur, o frekansın merkezine inip en yüksek sinyal gücünü (Peak RSSI) ölçer ve noktası noktasına listeye ekler.
  3. Jamming Aşaması: Kullanıcı listeden hedef frekansı seçip OK tuşuna bastığında, uygulama CC1101'in PATABLE (Güç Amplifikatörü) değerini maksimuma (+12dBm) çeker. Seçilen gürültü modülasyonu ile GDO0 pini üzerinden o frekansa asenkron sinyal pompalayarak çevredeki alıcıları kör/sağır eder.

🛠️ Evrensel Kurulum ve Uyumluluk

Bu uygulama tamamen Evrenseldir (Universal) ve tüm popüler Flipper Zero firmware'leri (Orijinal, Momentum, Unleashed, Xtreme, RogueMaster vb.) için sorunsuzca derlenip kullanılabilir.

Projeyi Flipper Build Tool (ufbt veya fbt) kullanarak derleyin:

# Proje dizinine gidin
cd RF_Jammer

# ufbt ile derleyin
ufbt

Oluşan .fap dosyasını Flipper Zero SD kartınızın apps/Sub-GHz/ klasörüne kopyalayarak çalıştırabilirsiniz.


🤝 Credits & Acknowledgements / Teşekkürler

EN: A special thanks to the original RocketGod-git/flipper-zero-rf-jammer project. This repository was built upon and heavily inspired by the foundational concepts and jamming mechanisms introduced in RocketGod's original work.

TR: Bu projenin temel jamming mekanizmaları ve fikirleri RocketGod-git/flipper-zero-rf-jammer projesinden ilham alınarak ve üzerine inşa edilerek geliştirilmiştir. Orijinal geliştiriciye katkılarından dolayı teşekkür ederiz.

About

Advanced Sub-GHz RF analysis and testing tool for Flipper Zero featuring a custom two-stage frequency scanner, external CC1101 support, and an oscilloscope-style spectrum visualizer.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages