Repository navigation
Software Defined Radio
Guides for signal capture, protocol analysis, wireless security research, and authorized RF/contactless assessments
Part of the ULTIMATE CYBERSECURITY MASTER GUIDE
RF/IoT source collections: RFSec Toolkit, cellular research, and curated external sources.
Passive IoT telemetry: rtl_433 receive-only lab explains supported-band sensors, privacy controls, JSON event normalization and detection limitations.
M5StickC Plus2 + CC1101: Starter-pack integration covers module prerequisites, receive-only RF observation and upstream file provenance.
| Resource | Role & Compatibility Boundary |
|---|---|
| Evil Crow RF V2 | Matched firmware/web assets and narrowband receiver validation. |
| Resource | Description |
|---|---|
| ESP32 & Related Firmware Catalog | Primary upstream projects, supported targets, use-cases & dated activity notes |
| Firmware Web Flashers | Dedicated installers plus a separate multi-device/multi-firmware reference |
This README is the entry point for the SDR, RF, and contactless section. It connects six companion documents and the NanoVNA guide collection covering SDR fundamentals, HackRF surveys, advanced signal research, Sub-GHz protocols, RFID/NFC, frequency/protocol references, and antenna/RF measurements.
The linked documents contain explanations, examples, and workflows. A tool listed here is not necessarily bundled with the repository, installed on your system, or compatible with every radio.
Use this index to select a guide, identify suitable hardware and software, find regional frequency references, and understand the prerequisites for receiving, decoding, or testing a signal.
Move from an RF question to a documented result: identify the relevant band and protocol, validate the receive chain, capture evidence, analyze it with compatible tools, and report conclusions supported by measurements.
- Learning IQ sampling, antennas, demodulation, or GNU Radio.
- Selecting a receiver, protocol sniffer, RFID reader, or analysis tool.
- Looking up frequency ranges, exact channel centers, and regional differences.
- Investigating interference or analyzing devices within an authorized assessment.
- Planning an end-to-end engagement with the HackRF Audit Playbook.
Operating scope: Start with public broadcasts, provided recordings, or devices within your authorized scope. Transmissions, private communications, and credential interactions require additional checks. See Safe Workflows and Security and Legal Boundaries.
- Guides in This Section
- Choose a Starting Point
- Hardware Ecosystem
- Software and Tool Categories
- Starred SDR and antenna projects
- Target Frequencies and Protocols
- Safe Workflows
- Security and Legal Boundaries
- Contributing
- Resources
- Related Repository Material
- Section Inventory and Maintenance
Looking specifically for GPS-tagged Wi-Fi/BLE mapping? The dedicated Wardriving index includes Kismet wardrive mode, ESP32 Marauder, and a field checklist. RF spectrum measurements and Wi-Fi AP mapping are complementary but different workflows.
| Guide | Level | Focus |
|---|---|---|
| SDR Fundamentals | ๐ข Foundational | IQ sampling, SDR hardware, antennas, GNU Radio, demodulation, and application chapters on wireless and satellite signals. |
| HackRF RF Spectrum and Wireless Security Audits | ๐ก Practical / Bench | Receive-chain validation, spectrum surveys, IQ captures, interference investigation, protocol triage, controlled bench testing, and reporting. |
| Sub-GHz RF Exploration and Protocol Engineering | ๐ก Practical / Bench | Device capture workflows, OOK/FSK analysis, protocol identification, transceiver selection, and capture logs; also includes selected 2.4 GHz topics. |
| RFID and NFC Exploration | ๐ก Practical / Bench | LF/HF tag identification, reader selection, supported authentication/key-recovery research, and authorized emulation or cloning workflows. |
| Advanced SDR Security Research | ๐ด Advanced | Signal reversing, wireless protocol security, firmware/baseband research, TEMPEST, and electromagnetic side-channel topics. |
| Target Frequencies & Protocols MASTER LIST | ๐ข Reference / All Levels | Regional bands, exact channel tables, signal characteristics, hardware limits, decoder selection, and survey documentation. |
| NanoVNA Field Guide | ๐ข Foundational โ ๐ก Practical / Bench | Twelve chapters on H/H4 setup, calibration, antenna testing and tuning, cable/filter measurements, worked examples, and sweep comparison tools. |
Companion playbook: HackRFAuditPlayBook.md provides the engagement procedure in the PlayBooks section. Related HackRF material also exists in hackrf.md; contributors should keep shared procedures and references consistent.
| What you need to do | Start here | Follow with |
|---|---|---|
| Check or tune an antenna, cable, or filter | NanoVNA Field Guide | Calibration, then antenna testing. |
| Learn SDR from the beginning | sdr.md | A known broadcast receive-chain check. |
| Identify a frequency or choose a decoder | Master list | The relevant protocol guide and exact device documentation. |
| Survey a site or investigate interference | hackrf.md | HackRF Audit Playbook. |
| Analyze an owned remote or wireless sensor | subghz.md | IQ/pulse analysis and supported device decoders. |
| Identify an authorized card or tag | rfid.md | A reader and antenna appropriate to that frequency and protocol. |
| Research an unfamiliar waveform or implementation | sdr_hacking.md | Controlled experiments and reproducible evidence. |
| Audit Wi-Fi frames, BLE traffic, or Thread/Zigbee | Master list | A compatible protocol sniffer and network configuration. |
| Device / family | Capabilities | Practical role and limits |
|---|---|---|
| NanoVNA-H / H4 | Vector network analyzer; S11 reflection and S21 transmission | Antenna match, cable and passive-filter measurements. Verify actual hardware/firmware coverage; not a spectrum analyzer or protocol receiver. |
| RTL-SDR Blog V3/V4 | Receive-only SDR | Broadcast, supported Sub-GHz telemetry, ADS-B, and other signals within the model's range. V3/V4 HF operation differs. Common RTL-SDR tuners do not directly reach 2.4 GHz. |
| HackRF One | Half-duplex RX/TX; specified 1 MHzโ6 GHz; up to 20 MS/s complex IQ | Spectrum surveys and waveform captures. Does not directly cover 125/134.2 kHz RFID, the full 6 GHz Wi-Fi band, or wide Wi-Fi channels. |
| Airspy | Receive-only SDR family | Select the exact model for HF versus VHF/UHF work; coverage and bandwidth differ. |
| ADALM-Pluto | RX/TX SDR development platform | DSP and RF experiments within its specified range. Unofficial extensions are not guaranteed specifications. |
| bladeRF, USRP, LimeSDR | SDR families with model-dependent RX/TX and duplex capabilities | Higher-bandwidth or synchronized research setups; verify the model, RF board, clocking, and host throughput. |
| Flipper Zero | Sub-GHz packet functions plus separate LF/NFC features | Supported device and credential triage. It is not a general wideband IQ SDR; region, firmware, and protocol support matter. |
| YARD Stick One | Half-duplex Sub-GHz packet transceiver | Supported ASK/OOK/FSK/MSK-family work through rfcat. Official bands: 300โ348, 391โ464, and 782โ928 MHz. It is not a general IQ receiver. |
| Monitor-mode Wi-Fi / BLE / IEEE 802.15.4 adapters | Protocol-specific reception | Often the best route to decoded frames. Verify chipset, driver, band, PHY, channel-following, and firmware support. |
Tuning range is not decoding capability. Seeing energy at a frequency does not mean the receiver can capture the whole waveform or that software can decode it. HackRF One's 20 MS/s limit represents approximately 20 MHz of nominal instantaneous complex-IQ span, with less useful bandwidth near filter edges. A sweeping survey is not simultaneous recording of the entire sweep range. See the hardware and capture reference.
| Device | Role | Limits to check |
|---|---|---|
| Proxmark3 / RRG firmware | LF/HF identification, capture, supported reading/writing, and emulation | Hardware revision, antenna tuning, firmware/client match, and exact protocol support. |
| Chameleon Ultra | Supported LF/HF credential emulation and reader-side functions | Features depend on firmware and card type; do not assume universal tag support. |
| PN532 + libnfc | Selected 13.56 MHz NFC/ISO 14443/FeliCa workflows | Not an LF or UHF reader; do not assume ISO 15693 support. NXP marks PN532 not recommended for new designs. |
| Flipper Zero | Supported LF credential and HF/NFC identification/emulation | Supported protocol and memory/authentication features vary by card. |
| iCopy-X | Integrated workflows for supported credentials | Product/firmware-specific compatibility; not a guarantee of cloning arbitrary credentials. |
| Regional UHF EPC reader | Passive UHF tag inventory and interaction | Required regional channel plan, antenna, and EPC/ISO protocol support; LF/HF tools do not substitute for it. |
Reading a UID does not reproduce an entire credential. Protected applications can require keys, counters, or backend validation. A card reader also normally generates an RF field and sends commands even when it does not write tag memory. See rfid.md.
Tool roles below describe their intended function. They do not guarantee support for a particular signal, operating system, software version, or hardware combination.
| Tool | Role | Notes |
|---|---|---|
| Gqrx / SDR# | Spectrum display and supported audio demodulation | SDR# is the receiver application; SpyServer is a separate remote-server component. |
| rtl_433 | Supported sensor, remote, and telemetry decoding | Supports several bands and radio backends; not limited to 433 MHz. |
| dump1090 | 1090 MHz Mode S / ADS-B reception | Does not decode 978 MHz UAT; use a suitable UAT decoder for that link. |
| Kismet | Discovery and monitoring through supported data sources | Wi-Fi, Bluetooth, and SDR-related support depend on source hardware and helpers. |
| Kalibrate-RTL | Estimate receiver frequency error using GSM signals | Requires suitable local signals and compatible software; not a general precision calibration guarantee. |
| gr-gsm | GSM reception and analysis tools | Verify the chosen branch/package and GNU Radio compatibility. It is not accurately described as a turnkey IMSI catcher. |
| Tool | Role |
|---|---|
| Universal Radio Hacker | Waveform inspection, demodulation, bit extraction, and protocol investigation. |
| inspectrum | Visual IQ analysis and timing measurements. |
| GNU Radio | DSP flowgraphs, filtering, demodulation, and custom processing; a hardware sink can transmit. |
| Wireshark | Supported packet dissection after a compatible capture/decoder pipeline. |
| Baudline | Time/frequency analysis; check platform and input-format support. |
Record the sample rate, center frequency, signed/unsigned representation, bit depth, I/Q order, gain, and software versions with each capture. Incorrect import settings can produce misleading results.
| Resource | Actual role | Assessment boundary |
|---|---|---|
| HackRF host tools | Hardware control, IQ reception/transmission, and spectrum sweeps | Select receive operations deliberately; validate any transmit path before enabling it. |
| srsRAN Project / srsRAN 4G | Distinct open-source cellular stacks with different components and radio-generation support | Use the matching documentation and an authorized test network. These are not simply โIMSI catcher frameworks.โ |
| GPS-SDR-SIM | Generate GPS simulation IQ for receiver research | File generation is separate from RF transmission; any hardware test requires an appropriately controlled setup. |
| RollJam research | Case study in weaknesses affecting some rolling-code implementations | Not a universal rolling-code bypass or a routine field-test procedure. |
| FCC jammer guidance | Regulatory reference on prohibited jammer use | This is guidance, not a software tool or an assessment workflow. |
Use the host-tool documentation and the controlled bench procedure to distinguish firmware components from the commands used for capture and testing.
| Tool / family | Role | Important qualification |
|---|---|---|
| Proxmark3 / RRG | Supported LF/HF analysis, reading, emulation, and security research | Features are protocol-specific; do not assume success from the frequency alone. |
| libnfc, mfoc, mfcuk | NFC access and particular MIFARE Classic/Crypto1 research workflows | Distinct projects with different prerequisites; applicability depends on card behavior and reader support. |
| mfkey-family utilities in compatible RFID toolchains | Recover candidate MIFARE Classic keys from suitable authentication data | Required nonce/authentication data differs by variant; โone sniffed transaction always yields a keyโ is incorrect. |
| Chameleon Ultra | Supported credential emulation and reader testing | A reproduced UID does not establish that protected application authentication will succeed. |
See rfid.md for the detailed workflows and the master list for LF/HF/UHF distinctions.
- LakeShark โ a handheld SDR and radio-analysis research platform for selected ESP32-P4/LILYGO hardware with documented integrations including RTL-SDR, LoRa/MeshCore and common receive-only signal applications. Hardware modules, build support and licensed radio reception vary by configuration; confirm the current upstream hardware matrix before building.
- CatSniffer โ a hardware platform for selected low-power IoT radio protocols using board-specific radios and firmware (including CC1352/SX1262 configurations). Useful for Zigbee/Thread/LoRa-type protocol labs when supported by the exact hardware/firmware build; it is not a generic Wi-Fi monitor-mode adapter or a universal SDR. Follow the hardware hacking basics for power, pin and target-ownership checks.
- Mobile-Whip โ a Mini-Whip-style active antenna design for low-power/battery-friendly RF receive experiments. Pair it with the NanoVNA antenna guide for measurement concepts, while recognizing that active receive antennas and passive antenna matching need different test setups.
These are complementary projects, not required parts of a HackRF or NanoVNA installation. Use only permitted receive/transmit configurations; do not intercept or disclose protected communications.
The completed master reference contains:
- LF/HF RFID, NFC, UHF EPC, broadcast, amateur, marine, aviation, and weather entries.
- Sub-GHz remotes, telemetry, LoRa/LoRaWAN, Z-Wave, and other building/industrial networks.
- Exact Wi-Fi, BLE, and IEEE 802.15.4 channel tables with regional qualifications.
- Cellular, DECT, GNSS, satellites, drones/Remote ID, UWB, and microwave-system references.
- Capture bandwidth guidance, decoder selection, an evidence ladder, and a survey worksheet.
Interpretation rules: Distinguish channel centers from band edges, standardized assignments from device examples, and active services from historical ones. Frequency alone does not identify a protocol, manufacturer, device, or security weakness. LoRa is not synonymous with LoRaWAN; Matter has no dedicated RF frequency.
The list marks NOAA-15/18/19 APT entries as historical following their 2025 retirement. It does not establish which transmitters are active at your location; consult current operator and device records.
- Define the question, authorized scope, and permitted data handling before capturing.
- Match the receiver, antenna, filters, bandwidth, and decoder to the signal.
- Validate reception using a known reference or controlled device event.
- Capture the necessary data and record settings, time, and limitations.
- Separate observed energy, candidate protocol, validated decode, device attribution, and demonstrated security findings.
- Minimize incidental private data; redact identifiers, keys, and sensitive location information before publishing.
No decoded output can mean the wrong channel, unsupported PHY, weak signal, overload, or a missed burst. It does not establish that the device was silent.
- Confirm the exact device/system, permitted actions, test window, and responsible owner.
- Identify the applicable regulatory basis, equipment requirements, band, power, bandwidth, and operating conditions.
- Use simulated/file-based processing where it answers the question; keep hardware transmit sinks disabled during setup.
- For contained RF tests, calculate attenuation and receiver input levels and validate containment at the test frequencies.
- Check bias-tee voltage, antenna/filter connections, and stop conditions.
- Avoid interference with unrelated systems; do not radiate disruptive test signals into operational networks.
- Log test settings, observations, and the restoration of normal operation.
An ISM band, low transmit power, device ownership, or a Faraday bag does not by itself establish permission or adequate containment. A dummy load reduces radiation from its connected RF port; cables, enclosures, and other paths can still leak.
Receiver protection: HackRF One documentation specifies a maximum input of โ5 dBm. Design an appropriate margin and attenuation arrangement; never connect a transmitter directly to an SDR input without checking the power budget. Manufacturer specifications.
- Confirm authorization from the relevant credential/system owner and the exact permitted operations.
- Identify the tag's frequency, protocol, and application before choosing a tool.
- Use lab readers and test credentials for writes, emulation, and authentication experiments.
- Keep operations away from production doors, payment systems, and identity systems unless specifically authorized under an appropriate specialist engagement.
- Protect dumps, keys, identifiers, and transaction traces as sensitive data.
Read-only memory access can still involve RF transmissions or sensitive information. Do not assume it is appropriate merely because the tool can perform it.
Regulatory baseline: United States. Other jurisdictions can have different reception, transmission, equipment, privacy, and access-control requirements.
| Activity | Boundary |
|---|---|
| Operating a transmitter | Some compliant operations are allowed without an individual license; others require a license or other authorization. Part 15 is conditional, not unrestricted spectrum access. |
| Using an amateur license | A license applies within its service privileges and rules; it does not authorize arbitrary cellular, aviation, commercial, or other transmissions. |
| Receiving, decoding, storing, or sharing traffic | These are separate activities. Unencrypted traffic is not automatically public or unrestricted; applicable exceptions and privacy rules matter. |
| Jamming or disrupting communications | FCC guidance prohibits jammer use by the public. Ownership of nearby equipment or property does not create a general exemption. |
| Testing credentials or access systems | Authorization must cover the credential, relevant system, and intended operation. Possession of a card does not necessarily authorize duplication or access-system testing. |
| Aviation, GNSS, emergency, medical, or other operational systems | Do not introduce disruptive signals. Specialist research requires appropriate authorization and an engineered test environment. |
Sources: FCC Part 15 rules, amateur service rules, FCC jammer guidance, and 18 USC ยง 2511.
This README does not assign blanket criminal classifications, fine amounts, or prison terms to technical activities. Legal consequences depend on the conduct, applicable law, authorization, and other facts. Wi-Fi deauthentication is a protocol-layer action and is not technically identical to RF noise jamming, although either can cause disruption.
See LEGAL.md for repository-wide terms. The materials are provided as is, without a guarantee of compatibility, accuracy, hardware safety, or suitability for an engagement. Documentation is not a substitute for current regulations or qualified advice on a specific legal question. This README's review does not validate every legal claim elsewhere in the repository.
Contributions should be reproducible, properly sourced, and suitable for education or authorized research.
Welcome contributions:
- DSP explanations and GNU Radio examples with documented input/output behavior.
- Receive-only decoders and public or permission-cleared sample captures.
- Defensive RF, interference, and credential-identification workflows.
- Antenna, filter, coupling, and receiver-protection documentation.
- Corrections to frequency tables, regional notes, compatibility, and retired services.
Submission requirements:
- State hardware, firmware, software versions, dependencies, and tested limitations.
- Mark transmit-capable examples clearly and keep transmission disabled by default.
- Cite primary sources for frequencies, specifications, and regulatory claims.
- Include authorization assumptions and data-handling requirements where relevant.
- Validate relative links and update this index when adding or renaming a guide.
- Use synthetic or redacted evidence; exclude real keys, credential dumps, and private traffic without permission to publish.
Not accepted in this section: deployable jamming/disruption payloads, malicious cellular interception deployments, vehicle-theft workflows, or payment/passport/eID cloning tooling. These are repository contribution boundaries, not a claim that every conceivable research activity has the same legal status.
- FCC radio spectrum allocation guidance.
- FCC Part 15 and Part 97.
- ARRL amateur licensing information.
- NFC Forum technology overview.
- GS1 EPC Gen2 specification.
- Master-list primary references for protocol-specific authorities.
- Great Scott Gadgets SDR course.
- HackRF documentation.
- GNU Radio tutorials.
- RTL-SDR setup guide.
- Signal Identification Wiki โ community waveform examples; corroborate identification with primary documentation and captures.
- Proxmark3 RRG documentation.
| Resource | Relationship |
|---|---|
| Main repository | Top-level navigation. |
| START HERE | General learning and navigation guidance. |
| Cybersecurity Master Guide | Broader security reference. |
| HackRF Audit Playbook | Field/bench engagement procedure. |
| Network Audit Playbook | Network assessment context. |
| Hardware Hacking | Embedded systems, interfaces, and hardware investigation. |
| Space Security | Satellite and navigation-security context. |
| CAD & 3D Printing | Printed radio cradles, antenna mounts and SMA bulkhead panels; see the D-flat SMA hole and RF-safe filament choices. |
| Documentation index | Additional tool and platform guides. |
| Bruce firmware | Supported embedded RF workflows; external radio hardware determines capabilities. |
| Flipper Zero guide | Supported Sub-GHz and LF/HF device workflows. |
| Repository terms | Repository-wide terms and use requirements. |
| Item | Current inventory |
|---|---|
| Guide entries linked from this index | 7: six companion documents plus the NanoVNA guide collection. |
Markdown files directly in SDR/
|
7, including this README; NanoVNA chapters are in the subdirectory. |
| NanoVNA collection |
12 chapters, a section README, and a tools README in SDR/nanovna/. |
| External companion playbook |
PlayBooks/HackRFAuditPlayBook.md. |
| Coverage | LF/HF RFID, Sub-GHz devices, wireless protocols, wideband SDR, and specialized higher-frequency topics; coverage depends on hardware. |
| Review scope | README inventory, navigation, tool descriptions, selected hardware specifications, and legal wording. Companion guides remain separate technical documents. |
| Last reviewed | September 15, 2026; NanoVNA navigation and inventory added September 18, 2026. |
| Maintainer | Pacific Northwest Computers / Pnwcomputers. |
Maintenance note: Update counts when adding or removing files. Recheck upstream compatibility and service status before relying on older examples. A guide's presence in this index does not establish that every command or security claim in it has been independently validated.
Learn the signal. Verify the evidence. Respect the scope.
ULTIMATE CYBERSECURITY MASTER GUIDE ยท Pacific Northwest Computers
Master Index | Start Here | Legal Notice
- Evil Crow RF V2: Firmware Setup & Receiver Validation
- HACKRF RF SPECTRUM & WIRELESS SECURITY AUDIT PLAYBOOK
- ๐ณ RFID & NFC Access Control Exploration & Card Engineering Guide
- rtl_433 Passive IoT Telemetry and Detection Lab
- SDR Hacking Advanced: Reversing and Exploiting Wireless Communications
- Software Defined Radio (SDR)
- ๐ป SubGhz RF Exploration & Protocol Engineering Guide
- ๐ก Target Frequencies & Protocols (MASTER LIST)
- ๐ง 01 โ Hardware, Controls, and Setup
- ๐ 02 โ RF Fundamentals and Display Formats
- ๐ฏ 03 โ Calibration and Reference Planes
- ๐ก 04 โ Antenna Testing and Diagnostics
- ๐ ๏ธ 05 โ Antenna Tuning and Matching
- ๐ 06 โ Cables, Filters, and Other Measurements
- ๐ 07 โ Quick Reference Card
- ๐ป 08 โ PC Software, Data Export, and Firmware
- ๐งช 09 โ Worked Tuning Examples by Band
- ๐ป 10 โ Antenna Types and Special Cases
- ๐ 11 โ Field Worksheet and Practice Exercises
- ๐ 12 โ Sources, Scope, and Verification Limits
- ๐ถ NanoVNA Vector Network Analysis โ Antennas, Feedlines & RF Measurement
๐ Folder: SDR | โ๏ธ Suggest an edit | ๐บ๏ธ Browse by Topic
- ๐บ๏ธ Browse by Topic
- ๐ All Repository Files
- ๐งญ Learning Paths
- ๐ Master Guide
- ๐ค Glossary
- โ๏ธ Legal & Disclaimer
๐ Foundations & Learning
๐ก๏ธ Defense & Investigations
- Incident Response
- Open Source Intelligence (OSINT)
- Reverse Engineering
- Operations Security (OPSEC)
- Compliance
โ๏ธ Platforms & Infrastructure
๐ก Hardware, Wireless & Field Projects
- PNWC Cyberdeck
- Hardware Testing
- Hardware Hacking
- Software-Defined Radio
- Wardriving
- uConsole
- Space Security
๐งฐ Assessment & Field Reference
๐ฆ Downloads & Project Resources
๐๏ธ Additional Topics