TheOrc.devOregon Radio Company LLC

cat OrcSDR/README.md

OrcSDR

Turn an M5Stack Tab5 and a compatible RTL-SDR receiver into a portable, touchscreen software-defined radio. The radio processing, dashboards, audio and controls all run on the Tab5. No laptop, Raspberry Pi or desktop SDR app after installation.

It started with one question: how far can the ESP32-P4 be pushed as a real SDR host? The first step was a clean-room USB driver (esp-rtl-sdr) so the microcontroller could own an RTL-SDR directly. Once the Tab5 could keep up with the IQ stream itself, that driver became the base for a whole radio.

It's an open-source hobby project, built with a lot of AI help, outside review and community testing. Features are labelled tested, experimental or unfinished based on the evidence I actually have.

release
v0.6.0 (release) · 2026-11-11
image
OrcSDR-Tab5-v0.6.0.bin · 7,490,479 bytes
sha256
3090d26cbc2230884cb5b484dc150a4831b4cb84942b6bc0bb12d4b3393cfbbe
built with
ESP-IDF 5.5.4 · esp_rtl_sdr v0.9.3
M5Stack Tab5 running OrcSDR with a live FM spectrum and waterfall
Live FM spectrum and waterfall on the Tab5.

getting started

What you need

  • M5Stack Tab5 (ESP32-P4). OrcSDR's test unit is hardware revision 1.3. More on the M5Stack hardware OrcSDR runs on, including the Tab5 Keyboard.
  • An RTL-SDR receiver. Tested: RTL-SDR Blog V3c, V4 (discontinued) and V4L, and Nooelec NESDR SMArt v5 and SMArt XTR (table below; picks in the RTL-SDR guide).
  • An antenna suited to the band you want. This matters more than almost anything else.
  • A USB-C data cable for installing.
  • Optional: a microSD card for maps, data packs, logs and IQ captures; headphones or a speaker on the 3.5 mm jack for better audio than the built-in speaker.

Install routes

  • M5Burner: pick the OrcSDR Tab5 package and burn it. Resets saved settings (Wi-Fi, location, rotation).
  • Windows settings-safe installer (release zip): writes only bootloader, partition table and app. Keeps settings. Linux/macOS builds exist but are untested on hardware.
  • Browser installer (Chrome/Edge desktop). Writes the same bootloader, partition table and app. Keeps settings unless you tick Erase device.

First boot

Boot lands on Home. SD, Wi-Fi and USB start in stages with time-outs, so a missing card, network or dongle still gets you to the OrcSDR button. Plug the dongle in any time. Reception doesn't need Wi-Fi. After installing, unplug the PC USB cable: on the test bench it could contribute to brownouts under Wi-Fi plus radio load.

what you need

An M5Stack Tab5 and any supported RTL-SDR dongle. You don't need a V4: the tested receivers today are the RTL-SDR Blog V3c, V4 and V4L and the Nooelec NESDR SMArt v5 and SMArt XTR, and the goal is for OrcSDR to work with all RTL-SDR dongles. OrcSDR is free and open source; install it with the browser installer.

Oregon Radio Company isn't affiliated with M5Stack, RTL-SDR Blog or Nooelec. Nooelec has provided hardware for testing (more).

receivers

ReceiverStatusNotes
RTL-SDR Blog V4testedFull receiver path including the HF upconverter. Longest-tested. Discontinued by RTL-SDR Blog.
RTL-SDR Blog V3c (USB-C)testedAM and shortwave through direct sampling. More on the RTL-SDR Blog gear.
RTL-SDR Blog V3 (earlier, USB-A)experimentalProvisional, 24 MHz and up.
RTL-SDR Blog V4LtestedRecognised from v0.3.0-beta.1. No HF below 24 MHz on OrcSDR. More on the RTL-SDR Blog gear.
Nooelec NESDR SMArt v5testedRF filter follows the tuned band from v0.3.0-beta.2. No HF below 24 MHz on OrcSDR. More on the Nooelec gear.
Nooelec NESDR SMArt XTRtestedE4000 extended range (~65 MHz–2.3 GHz) with a gap near 1.1 GHz — not for ADS-B or HF without an upconverter. Fully tested with OrcSDR. Driver work (recognition, gain, identity and offset) is in esp-rtl-sdr v0.9.4 and the OrcSDR nightly; the next tagged release will ship it. More on the Nooelec gear.
Other RTL2832U donglesnot verifiedNo evidence yet.

Hardware reports with a serial log help: open an issue.

dashboards

DashboardWhat it doesEvidence
Home (Smart VFO)Tune across the attached receiver's range: 78 named US bands with their usual mode, per-band steps, keypad entry, NFM/AM/WFM/USB/LSB. OrcDial works as the VFO knob. In the v0.4.0-beta.1 release.Available
FM RadioBroadcast FM: stereo audio, RDS station info, presets, tuning tools.RF-validated
AM RadioBroadcast AM with region-aware steps, presets and a 119-channel scan.Available; hardware-tested
WeatherNOAA weather-radio channels.Available; RF acceptance still open
CB RadioBand-wide scanner that stops on whoever is talking, priority channel, lockouts, AM/USB/LSB.Available; broad on-air scanner acceptance still open
ShortwaveAM, USB and LSB listening, band-plan AUTO, filters, clarifier, memories and a log. Maintainer-confirmed reception; not a calibrated HF lab.Available; live RF heard
Airband118–136.975 MHz AM, 25/8.33 kHz steps, scanner controls, 121.500 guard. Live arrival/departure voice has been heard on the Tab5.Available; live aviation voice heard
MarineVHF marine listening through the general receiver workspace. No dedicated marine dashboard or decoder yet.Limited
SatelliteGeneral receiver workspace near 137.5 MHz. No dedicated satellite decoder.Limited
P25 Phase ITrunked control channel, call following, clear voice. Encrypted audio is not decoded.RF-validated
P25 Phase IIGrants, sync and burst decoding. Payload and audio are not implemented.In development
ADS-B1090 MHz aircraft with position, altitude and optional FAA data. Live only.RF-validated
LoRa / MeshtasticPassive LongFast receive: unencrypted messages, telemetry, node info and GPS. Encrypted traffic is shown as ENCRYPTED FRAME, not decrypted.Available; live packets decoded
POCSAGPager traffic at 1200 baud; 512/2400 host-tested only. No searchable archive.RF-validated at 1200 baud
FT8 / FT4Receive-only weak-signal digital modes in one dashboard: native FT8 (15 s slots) and FT4 (7.5 s slots), with a decode list, stations heard, an offline grid map and an FT8 band Hunter. Needs HF reception. In the v0.4.0-beta.1 release. FT8 was accepted on four dongles on 40 m (2026-10-09); FT4 is implemented, and live RF qualification is separate.FT8 RF-validated FT4 implementation ready
JS8Receive-only JS8 Normal in the same FT8 dashboard. Directed heartbeat/SNR frames are shown as text; other speeds are off. Native backend with narrower on-device evidence.Native backend; narrower physical evidence
SSTVReceive and decode the supported 14-mode colour set (Robot, Martin, Scottie and PD families), watch pictures build live, and save images to microSD. In the v0.5.0-beta.1 release. Conducted image/SD tests cover Robot 36, PD120 and Scottie S1 on the V3c, V4, V4L and Nooelec V5.Available; 14 modes supported
ACARSLive VHF ACARS with interpreted aircraft messages and an archive (in v0.5.0-beta.1). Unknown airline-specific payloads stay raw. Native VDL Mode 2 (136.725–136.975 MHz) is in nightly: live AVLC/ACARS frames with partial interpretation (#223).Available; live RF decoded
Dead AirReceive-only RF investigation: real relative RF and audio measurements, plus event logging. In the v0.5.0-beta.1 release. Unit ENV III temperature, humidity and pressure, Environment trend charts, and optional VEIL-26 symbolic analysis are in nightly. VEIL-26 is an interpretation of measured values, not paranormal detection.Available; real measurements
RF LabLive measurements, IQ recording, full-screen visualizers. Not a calibrated laboratory analyzer.Available
2.4 GHz Wi-FiAccess point survey through the Tab5's C6 radio. Pauses reception while scanning.Hardware-tested
TransmitOrcSDR is receive-only.Not available

Labels describe evidence, not marketing maturity. Rows or notes marked “in nightly” landed after v0.5.0-beta.1 and are in the nightly build or on main, not yet in a tagged release. Source: OrcSDR README and feature status (updated 2026-11-05); PROJECT_STATUS.md remains the project's evidence ledger.

screens

OrcSDR FM dashboard tuned to 96.1 MHz showing RDS station information
FM: Listen tab with RDS.
OrcSDR ADS-B dashboard with aircraft radar and aircraft list
ADS-B: radar and aircraft list.
OrcSDR RF Lab dashboard with spectrum, waterfall and receiver measurements
RF Lab: peak, noise floor, SNR, occupied bandwidth, I/Q balance.
Six OrcSDR visualization modes: spectrum, phosphor persistence, 3D history, polar, channel occupancy, channelized tiles
Some of the full-screen visualization modes.

under the hood

Antenna → RTL-SDR tuner → High-Speed USB → esp-rtl-sdr → IQ buffers
                                                        ├─ DSP and decoders
                                                        ├─ touchscreen UI
                                                        ├─ speaker audio
                                                        └─ optional storage
  • ESP32-P4 on the Tab5 runs radio control, USB, DSP, graphics, touch and audio locally.
  • 1280 × 720 touchscreen UI (M5Unified / M5GFX).
  • High-Speed USB Host straight to the dongle; three 32 KiB transfers, with drop diagnostics.
  • 48 kHz stereo audio through the Tab5 speaker.
  • Wi-Fi from the onboard ESP32-C6 over SDIO (ESP-Hosted).
  • Optional microSD for maps, data packs, logs and IQ captures.
  • Native ESP-IDF 5.5.4 build with locked component versions.

faq

Do I need a computer to use it?
Only to install. After that the Tab5 does all the radio processing, display and audio by itself.
Will installing erase my settings?
M5Burner writes a complete image from address 0, which resets Wi-Fi profiles, location and rotation. The Windows settings-safe installer and the browser installer keep them; the browser installer only wipes them if you tick Erase device.
Can it transmit?
No. OrcSDR is receive-only.
Does it decode encrypted P25?
No. The P25 dashboard follows encrypted calls but doesn't decode their audio. P25 Phase II audio isn't implemented.
Why is the built-in speaker thin?
It's a small monitoring speaker. The 3.5 mm output was hardware-tested and sounds as intended.
My Tab5 resets during live radio.
The docs trace many brownout resets to the PC flashing cable. Unplug it after installing and run from the Tab5's battery or a USB-C supply. Capture a serial log if it keeps happening.
Signals are weak.
Use an antenna suited to the frequency and keep the feed line short. Signal readings are relative dBFS, not calibrated dBm.
What's the LAN web console?
An opt-in browser control and audio page on your local network. It has no TLS or login, so only use it on a trusted network.

updates

The latest tagged release is v0.5.0-beta.1 (2026-10-26). These entries are changes merged to main after that release, sourced from the merged pull requests. A commit-by-commit list is on the nightly changelog.

The published nightly is currently cdc8181 (2026-11-03). Entries through the 0.9.4 driver integration below are in that nightly. Later entries are on main and will be in the next successful nightly and the next tagged release.

#239 — USB recovery crash fix

2026-11-09 · on main

Prevents Tab5 USB recovery crashes in normal builds. Not in the published nightly yet.

#233 — E4000 tuning limits on dashboards

2026-11-06 · on main

With an E4000 receiver such as the Nooelec NESDR SMArt XTR, dashboards now show the receiver and a rejected frequency instead of sitting idle. Out-of-range tunes are not sent to the tuner; a supported retune restores the live waterfall. Not in the published nightly yet.

#229 — esp-rtl-sdr v0.9.4 / E4000 controls

2026-11-02 · in nightly

Integrates esp-rtl-sdr v0.9.4 (driver PR #64): E4000 gain, identity and hardware offset controls. That is the driver work behind Nooelec NESDR SMArt XTR support in OrcSDR. The next tagged OrcSDR release will ship it.

#226 — OrcDial FT8 preview and SSTV controls

2026-10-30 · in nightly

A paired OrcDial can show FT8 decode summaries and SSTV receive progress, with guarded save, abort, demodulation, gain and tuning controls.

#220 — Dead Air Environment trend charts

2026-10-30 · in nightly

The Dead Air Environment tab charts temperature, humidity and pressure trends from the Unit ENV III.

#223 — Native VDL Mode 2 on ACARS

2026-10-29 · in nightly

ACARS on the Tab5 gains a native VDL Mode 2 receiver (136.725–136.975 MHz), a plain-language interpreter for what used to be raw text, and tooling to work with the SD log. Analog ACARS from the v0.5.0-beta.1 release is unchanged.

#221 / #219 — Dead Air ENV III and VEIL-26

2026-10-29 · in nightly

Unit ENV III driver and environment events, PSRAM reclaim, and optional VEIL-26 symbolic analysis of measured frequency and level. VEIL-26 is a reproducible interpretation, not a paranormal detector. The Dead Air dashboard itself shipped in v0.5.0-beta.1.

#225 — Community handheld case

2026-10-29 · in nightly

Adds Axeman72's Handheld OrcSDR Case V1 to the Community Hardware showcase.

Full nightly changelog · Tagged releases on GitHub

releases

v0.6.0

2026-11-11 · release

See the release notes on GitHub.

v0.5.0-beta.1

2026-10-26 · beta

Guided startup wizard. OrcMaps integration. Downloadable worldwide regional map. Offline map operation. Smoother map interaction. Improved LoRa memory handling. Dead Air. Native full-color SSTV reception. Live ACARS reception. Shortwave USB/LSB listening. FT8 timing improvements. More consistent screen updates and storage behavior.

v0.4.0-beta.1

2026-10-10 · beta

Native FT8 and FT4 reception, limited JS8 Normal, Smart VFO Home, on-device clock setup and OrcDial connection improvements. The FT8 workspace tabs are LIVE, DECODES, MAP, HUNTER, HEARD and SETUP. OrcSDR remains receive-only.

v0.3.0-beta.2

2026-10-02 · beta

Driver esp_rtl_sdr v0.9.3: the RF filter now follows the tuned band, so the Blog V3c and Nooelec hear well away from FM, and unplugging a dongle mid-stream is handled. New Airband dashboard with an AM scanner, airport catalog and live scope. Smoother spectrum and waterfall views across FM, Airband, Shortwave, AM, CB and P25. Tab5 keyboard support and a reworked Home layout. C6 firmware 2.12.6 and 3.0.6 both accepted; the 3.0.6 update is optional. Fixes a boot hang after a software restart and a crash on unplug during audio.

v0.3.0-beta.1

2026-09-28 · beta

V4, V4L and V3/V3c recognised with their own gain steps and bias-T rules (driver esp_rtl_sdr v0.9.1). Tuner bandwidth changes no longer shift frequency. New Home gain panel. CB tuned directly on V4/V4L, so no AM ghosts. FM stereo + RDS DSP load down from about 68% to 45%. Hot-plug a dongle any time. Browser audio in the LAN console. SD writes about 15× faster. First Windows settings-safe installer.

v0.2.0-beta7

2026-09-15 · beta

Hardware-tested RTL-SDR Blog V3c. New Shortwave dashboard. V3c cold-start spectrum fix. The first .bin upload was app-only by mistake and was replaced on Sep 18 with the complete image.

v0.2.0-beta.6 multi-dongle RC4

2026-09-12 · experimental

Hardware-tested V3C support with tuner detected by probe; V4 stays the regression baseline.

v0.2.0-beta.6 multi-dongle RC3

2026-09-11 · experimental

Driver fix for reusing USB transfers after a drain timeout; AM scan reworked across all 119 channels.

v0.2.0-beta.6 multi-dongle RC1/RC2

2026-09-10 · prerelease

First builds beyond the V4 using esp_rtl_sdr 0.8.0; V3 and Nooelec V5 provisional. Superseded.

v0.2.0-beta.5

2026-09-09 · beta

Fixes a battery-power boot loop by moving Wi-Fi start-up out of early boot. Wider Meshtastic coverage beyond the US. Native POCSAG receiver.

v0.2.0-beta.4

2026-09-07 · beta

Supersedes the withdrawn beta.3. ADS-B and P25 improvements, FM for Japan, main-task stack headroom restored.

v0.2.0-beta.2

2026-09-04 · beta

Home screen layout rework, shared radio control between dashboards, automated scan and memory checks.

v0.2.0-beta.1

2026-09-03 · prerelease

One M5Burner package with a pinned ESP-Hosted C6 3.0.6 image and in-app C6 update.

All releases and full notes on GitHub →

License: GNU AGPL-3.0-only, with separate commercial licensing in LICENSING.md. You're responsible for using a receiver legally where you live.

Sources: OrcSDR README.md, CHANGELOG.md, docs/user-guide/feature-status.md (2026-11-05), GitHub releases, and merged pull requests after v0.5.0-beta.1, fetched 2026-11-10. Dates are Pacific Time.