Skip to content

SDR Suite

7h30th3r0n3 edited this page Aug 31, 2026 · 2 revisions

📻 SDR Suite

Software Defined Radio payloads for the CardputerZero


📋 Overview

RaspyJack includes 10 SDR payloads that work with any RTL-SDR dongle (including the RTL-SDR Blog V4). The driver auto-detects the SDR model and adjusts gain accordingly.

Feature Details
Supported SDR RTL-SDR Blog V4/V4L, Generic RTL2832U, Nooelec NESDR, any rtlsdr-compatible
Driver Osmocom librtlsdr (auto-installed for V4 support)
Frequency Range 24 MHz – 1.7 GHz (SDR dependent)
Auto-install Missing dependencies are installed automatically on first launch

📡 Payloads

1. SDR Suite (sdr_suite.py)

Full-featured SDR receiver with 5 modes:

Mode Description
Waterfall Real-time waterfall display with frequency tuning, zoom, recording
FM Radio FM broadcast receiver with audio output
Scanner Frequency scanner with signal detection
Presets Bookmarked frequencies for quick access
Settings Gain, sample rate, center frequency configuration

Controls:

Button Action
LEFT/RIGHT Tune frequency
UP/DOWN Zoom / adjust gain
OK Start/Stop / Select
KEY1 Switch mode
KEY2 Record toggle
KEY3 Exit

WebUI: Full waterfall + spectrum display at /sdr.html with tuning, zoom, recording, and bookmarks.


2. ADS-B Radar (sdr_adsb.py)

Aircraft tracker on 1090 MHz using dump1090 (auto-compiled if missing).

Feature Details
Decoder dump1090-fa (primary) or rtl_adsb (fallback)
Data Callsign, altitude, speed, heading, position, registration
Database Offline aircraft DB (type, operator, country)
Airline Lookup Callsign → airline name, country
Route Lookup Flight → departure/arrival airports

Controls:

Button Action
UP/DOWN Scroll aircraft list
OK Start/Stop tracking
KEY1 Toggle views
KEY3 Exit

WebUI: Full radar map at /adsb.html with real-time aircraft positions, trails, and info panels.


3. Radio Scanner (sdr_scanner.py)

Pre-configured band scanner with audio output.

Band Frequency Modulation
Airband 118 – 137 MHz USB
Marine 156 – 163 MHz NFM
PMR446 446.0 – 446.2 MHz NFM
FM Radio 87.5 – 108 MHz WBFM
Emergency 150 – 174 MHz NFM

Controls:

Button Action
LEFT/RIGHT Change band
UP/DOWN Tune frequency within band
OK Start/Stop listening
KEY1 Lock on current frequency
KEY3 Exit

WebUI: Scanner interface at /scanner.html.


4. Meteor Receiver (sdr_meteor.py)

NOAA Meteor M2-3/M2-4 satellite image receiver.

Feature Details
Decoder satdump (LRPT QPSK)
Prediction SGP4 orbital mechanics (auto-installs sgp4 pip package)
Frequencies 137.1 / 137.9 MHz
Output Decoded satellite images saved to loot

WebUI: Meteor receiver at /noaa.html with pass prediction map, live status, image gallery.


5. APRS Monitor (sdr_aprs.py)

APRS (Automatic Packet Reporting System) station tracker.

Feature Details
Decoder Direwolf (auto-installed)
Frequency 144.800 MHz (EU)
Data Station callsign, position, distance, bearing

Controls:

Button Action
UP/DOWN Scroll stations
OK Start/Stop receiver
KEY3 Exit

WebUI: APRS map at /aprs.html with station positions and distance rings.


6. POCSAG Decoder (sdr_pocsag.py)

Passive pager message decoder.

Feature Details
Decoder rtl_fm + multimon-ng (auto-installed)
Protocols POCSAG, FLEX
Data Pager address, message text, timestamp

Controls:

Button Action
OK Start/Stop decoding
UP/DOWN Scroll messages
LEFT/RIGHT Change frequency
KEY1 Switch view (Live / Message / Stats)
KEY2 Export log
KEY3 Exit

7. Sub-GHz RTL-433 (sdr_subghz.py)

ISM band decoder using rtl_433.

Feature Details
Decoder rtl_433 (auto-installed)
Frequency 433.92 / 868.35 MHz
Data Temperature, humidity, battery, device ID from ISM sensors

8. SDR Replay (sdr_replay.py)

Capture and replay IQ signals (Flipper-style).

Feature Details
Capture Raw IQ recording at configurable frequency/gain
Library Browse and manage captured signals
Replay Transmit via rpitx (optional)
Bands 315 / 433 / 868 / 915 MHz

9. CC1101 Chat (cc1101_chat.py)

Peer-to-peer text chat over CC1101 Sub-GHz radio.

Feature Details
Radio CC1101 (Cap HAT)
Range ~100m (indoor) to ~1km (outdoor, line of sight)
Input On-screen keyboard with physical keyboard support

10. Sub-GHz Flipper (cap_flipper_subghz.py)

See the dedicated Sub-GHz CC1101 wiki page.


🔧 RTL-SDR V4 Support

The RTL-SDR Blog V4 requires a specific driver version. RaspyJack handles this automatically:

  • Detection: _sdr_core.py identifies V4 via "V4" in rtl_test output
  • Driver: Osmocom librtlsdr is compiled from source during install
  • Gain: Auto-adjusted per model — V4 has a built-in LNA so lower gain is used at high frequencies
SDR Model Gain at <800 MHz Gain at >800 MHz
Generic Clone 40 49
RTL-SDR Blog V4 30 20

🌐 WebUI Pages

Page URL Description
SDR Suite /sdr.html Waterfall, spectrum, tuning
ADS-B Radar /adsb.html Aircraft map with database
APRS Monitor /aprs.html Station map
Meteor Receiver /noaa.html Pass prediction + image gallery
Radio Scanner /scanner.html Band scanner

All WebUI pages support 4 map themes: Dark, Satellite, Topo, OSM.

Clone this wiki locally