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
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
| Receiver | Status | Notes |
|---|---|---|
| RTL-SDR Blog V4 | tested | Full receiver path including the HF upconverter. Longest-tested. Discontinued by RTL-SDR Blog. |
| RTL-SDR Blog V3c (USB-C) | tested | AM and shortwave through direct sampling. More on the RTL-SDR Blog gear. |
| RTL-SDR Blog V3 (earlier, USB-A) | experimental | Provisional, 24 MHz and up. |
| RTL-SDR Blog V4L | tested | Recognised from v0.3.0-beta.1. No HF below 24 MHz on OrcSDR. More on the RTL-SDR Blog gear. |
| Nooelec NESDR SMArt v5 | tested | RF 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 XTR | tested | E4000 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 dongles | not verified | No evidence yet. |
Hardware reports with a serial log help: open an issue.
dashboards
| Dashboard | What it does | Evidence |
|---|---|---|
| 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 Radio | Broadcast FM: stereo audio, RDS station info, presets, tuning tools. | RF-validated |
| AM Radio | Broadcast AM with region-aware steps, presets and a 119-channel scan. | Available; hardware-tested |
| Weather | NOAA weather-radio channels. | Available; RF acceptance still open |
| CB Radio | Band-wide scanner that stops on whoever is talking, priority channel, lockouts, AM/USB/LSB. | Available; broad on-air scanner acceptance still open |
| Shortwave | AM, 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 |
| Airband | 118–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 |
| Marine | VHF marine listening through the general receiver workspace. No dedicated marine dashboard or decoder yet. | Limited |
| Satellite | General receiver workspace near 137.5 MHz. No dedicated satellite decoder. | Limited |
| P25 Phase I | Trunked control channel, call following, clear voice. Encrypted audio is not decoded. | RF-validated |
| P25 Phase II | Grants, sync and burst decoding. Payload and audio are not implemented. | In development |
| ADS-B | 1090 MHz aircraft with position, altitude and optional FAA data. Live only. | RF-validated |
| LoRa / Meshtastic | Passive LongFast receive: unencrypted messages, telemetry, node info and GPS. Encrypted traffic is shown as ENCRYPTED FRAME, not decrypted. | Available; live packets decoded |
| POCSAG | Pager traffic at 1200 baud; 512/2400 host-tested only. No searchable archive. | RF-validated at 1200 baud |
| FT8 / FT4 | Receive-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 |
| JS8 | Receive-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 |
| SSTV | Receive 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 |
| ACARS | Live 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 Air | Receive-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 Lab | Live measurements, IQ recording, full-screen visualizers. Not a calibrated laboratory analyzer. | Available |
| 2.4 GHz Wi-Fi | Access point survey through the Tab5's C6 radio. Pauses reception while scanning. | Hardware-tested |
| Transmit | OrcSDR 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




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
Prevents Tab5 USB recovery crashes in normal builds. Not in the published nightly yet.
#233 — E4000 tuning limits on dashboards
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
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
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
The Dead Air Environment tab charts temperature, humidity and pressure trends from the Unit ENV III.
#223 — Native VDL Mode 2 on ACARS
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
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
Adds Axeman72's Handheld OrcSDR Case V1 to the Community Hardware showcase.
releases
v0.6.0
See the release notes on GitHub.
v0.5.0-beta.1
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
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
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
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
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
Hardware-tested V3C support with tuner detected by probe; V4 stays the regression baseline.
v0.2.0-beta.6 multi-dongle RC3
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
First builds beyond the V4 using esp_rtl_sdr 0.8.0; V3 and Nooelec V5 provisional. Superseded.
v0.2.0-beta.5
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
Supersedes the withdrawn beta.3. ADS-B and P25 improvements, FM for Japan, main-task stack headroom restored.
v0.2.0-beta.2
Home screen layout rework, shared radio control between dashboards, automated scan and memory checks.
v0.2.0-beta.1
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.