MiYooSDR 0.7.0 (experimental)

MiYooSDR 0.7.0

Two new ways to look at the 2.4 GHz band: a scope that reads one frequency about
3,000 times a second, and a persistence display.

New

• Scope mode. R2 at the 5 MHz zoom, or --scope MHZ, reads the frequency under
  the cursor over and over instead of sweeping: about 3,100 readings a second on
  the Mini Plus, where a sweep comes back to a frequency only every 40 to 200 ms.
  The screen shows a rolling trace, the last burst stretched out with a millisecond
  axis, and burst timing: how many, how long ago, how far apart, and the hits in
  the last one. A hit is a reading well above a background that adapts to the
  noise; hits less than 50 ms apart make one burst.
• Scope controls: Left / Right move one 312.5 kHz bin, SELECT + Left / Right
  change the trace length from 0.05 to 10 s, A holds the screen, B clears the
  count, L2 goes back to the zoom.
• Scope recordings. X in the scope records every reading to
  rec/scope-<date>-<time>.csv. The browser marks them [SCOP] and plays them on
  the scope's own screen, with seeking and 0.25x to 8x speed. --replay plays
  them too.
• Persistence display. SELECT + B now cycles the lower panel through the
  waterfall, channel occupancy and persistence: how often each level has shown up
  at each frequency, so steady carriers become lines, busy channels clouds and
  rare hits dots. --panel N starts on a panel, and the settings file remembers
  it.

Verified

On the same Mini Plus and stock driver as 0.6.0:

• The scope read 3,067 to 3,106 times a second at 2426.06 MHz, Bluetooth LE
  advertising channel 38, and caught bursts there as short as a single 0.3 ms
  reading, most likely advertising (the scope measures energy; it does not decode).
  A scope recording replayed on the Mini and on a PC gave byte-identical screens.
• R2 from the 5 MHz zoom opened the scope at the cursor, SELECT + Right lengthened
  the trace, and L2 went back to the zoom. Live sweeps resumed with no I/O errors,
  and Wi-Fi came back after every run.
• The persistence panel built up at the 5 MHz zoom, showing a steady emitter near
  2428 MHz as a bright streak, and SELECT + B cycled it to the waterfall.

Automated tests grew from 59 to 72. The scope's reader thread also ran under
ThreadSanitizer, and the new screens under AddressSanitizer and
UndefinedBehaviorSanitizer.

Install

Extract miyoosdr-0.7.0.zip to the root of the SD card. It installs
App/MiYooSDR and App/MiYooSDR Replay. Existing recordings and settings are
not included in the archive and are kept.

Packet capture remains a separate command-line utility in research/; see the
driver research notes. No kernel or driver replacement
is included.

SHA-256: 8ed49e610a9dba5d712f7b7690b1119c016ff774418c834909bd61e2a8d63cfe

MiYooSDR 0.6.0 (experimental)

MiYooSDR 0.6.0

A review release: a Replay entry in Onion's Apps list, spectrum recordings that
replay on the right frequency axis, small screenshots, and a long list of fixes
to the launcher, the live view and playback.

New

• MiYooSDR Replay in Onion's Apps list opens the recording browser without
  live mode, so Wi-Fi stays connected while you play recordings and captures.
• --replay FILE.csv plays spectrum recordings directly, including headless
  --shot renders, the same way as PCAPs.
• Screenshots are compressed PNGs of about 25 to 55 KB instead of 922 KB.
• Started over SSH while Onion's menu is on screen, MiYooSDR pauses the menu and
  takes the buttons for itself, then hands both back with the screen as it was.
  A button pressed during a replay no longer reaches the menu as well.
• --help and --version; the browser title shows the version.

Fixes

Live spectrum:

• Zooming or panning during a sweep no longer leaves the previous view's
  readings in max hold and the background, where a SELECT tap could find a
  carrier that was not there.
• Frequencies were shown half a bin high (156 kHz in the full band). Each bin is
  now labelled with the centre of its FFT tone, and zooming in keeps the cursor
  on the frequency it was reading.
• Panning past the band edge no longer shows the far side of the local
  oscillator under the wrong frequency labels.
• A gain change applies from the next sweep instead of shifting part of the
  current one.
• Holding X, A, Y or START no longer toggles over and over. Only the d-pad and
  L1 / R1 repeat.
• Screenshots and recordings started in the same second no longer overwrite
  each other.

Playback:

• A spectrum recording that zoomed or panned while recording plays each part on
  its own frequency axis, with its real channel (no more "tuned ch0").
• The review waterfall shows the rows recorded up to the current moment and
  holds still while paused, instead of filling with the paused row.
• Live help text no longer shows through the review footer.
• The browser lists every file in rec/ and research/, newest first. It used
  to stop after 128 entries, before reaching research/stock-monitor.pcap.
• START in a packet replay confirms the screenshot on screen. B after
  --replay goes to the browser, as documented.
• Signal from multi-antenna captures recorded on other machines shows the
  frame's combined value, not the last antenna's.
• A management subtype that was labelled "Action ACK" now reads "Action No Ack".
• A capture clock reset no longer piles every later frame onto one instant.
• The signal-to-sound tone follows the recording in CSV playback and fades out
  during packet replay.
• Replay screens redraw only when something changes, which saves battery while
  paused.

Launcher and capture script:

• Ctrl+C or a signal during setup now restores Wi-Fi once and stops. Before, the
  launcher went on to take Wi-Fi down again with nothing left to restore it.
• The launcher passes on the app's exit status, and refuses mistyped options
  before touching Wi-Fi. The app decides which options need the radio.
• monitor-capture.sh stops before touching Wi-Fi if miyoo-pcap is missing.
  Before, it killed Wi-Fi and could not bring it back until a reboot.
• Its restore brings Wi-Fi back even when wlan0 never left managed mode.
• Unknown options and out-of-range values are errors instead of being ignored.
• The app refuses to start if it cannot read the radio's registers, and no
  longer falls back silently to raw RF tuning, which once hung the chip.

Verified

On the Mini Plus used for earlier releases, with stock driver
v5.7.4.2_36687.20200421:

• Live sweeps through full band, zoom and back with no I/O errors, frozen
  readings or zero readings, at about 5 sweeps per second full band and 15
  at the 20 MHz zoom. Wi-Fi came back after every run.
• A replay and the Replay entry, started over SSH with Onion's menu up, paused
  the menu and grabbed the buttons. On exit the menu resumed with all 4 MB of the
  framebuffer restored byte for byte, and none of the injected button presses had
  reached it.
• PCAP and spectrum CSV replay screenshots matched the host renders byte for
  byte.

Automated tests grew from 21 to 59 and also ran under AddressSanitizer and
UndefinedBehaviorSanitizer. Known stock-driver rate and signal-reporting issues
still apply.

Install

Extract miyoosdr-0.6.0.zip to the root of the SD card. It installs
App/MiYooSDR and App/MiYooSDR Replay. Existing recordings and settings are
not included in the archive and are kept.

Packet capture remains a separate command-line utility in research/; see the
driver research notes. No kernel or driver replacement
is included.

SHA-256: 94b65fe6c4ee737fa83537534692205526c7d4f7d9f3bf54a910f2919d4abf50

MiYooSDR 0.5.0 (experimental)

MiYooSDR 0.5.0

Play saved Wi-Fi packet captures on the Miyoo Mini Plus. The recording browser
now opens PCAPs alongside existing spectrum CSV recordings.

• Browse .pcap and .csv files from App/MiYooSDR/rec/ and research/ with
  SELECT + START. The capture script's research/stock-monitor.pcap appears here.
• Review a packet-count timeline, scrolling frame list, and selected-frame
  addresses, type, length, and available rate, signal and channel metadata.
• Pause / play with A, step packets with Left / Right, seek a second with Up /
  Down, and change speed from 0.25× to 8× with L1 / R1. Playback stops at the end;
  A restarts it. B returns to the browser, MENU quits, and START saves a screenshot.
• Open a PCAP directly with launch.sh --replay FILE.pcap, skipping radio setup
  and the launcher's Wi-Fi and audio teardown.
• Render a desktop screenshot with --replay FILE.pcap --replay-at SECONDS --shot output.png.

Supports classic PCAP with radiotap link type 127, either byte order, and
microsecond or nanosecond timestamps, with a limit of 100,000 records. PCAPNG is
not supported. Playback displays stored frame headers and metadata; it does not
decrypt protected payloads, reconstruct a waveform or spectrum, or transmit frames.
Known stock-driver rate and signal-reporting issues still apply.

Validated against the original 3,647-frame capture: the Miyoo's offline screenshot
matches the host rendering byte for byte, and Wi-Fi stayed connected. Automated
tests cover supported PCAP formats, malformed files, metadata limits, and offline
rendering and launch behavior.

Install and play

Extract miyoosdr-0.5.0.zip to the root of the SD card. It installs under
App/MiYooSDR. Existing recordings and settings are not included in the archive.

Copy a compatible PCAP into App/MiYooSDR/rec/ or research/, start MiYooSDR,
and press SELECT + START. Select the file with Up / Down and press A. Spectrum
CSV review remains available in the same browser.

To open an existing capture over SSH while keeping Wi-Fi connected:

cd /mnt/SDCARD/App/MiYooSDR
./launch.sh --replay research/stock-monitor.pcap

The command-line capture utility and its managed Wi-Fi recovery procedure remain
available in research/. Capture is separate from playback; see the
driver research notes for capture instructions and
metadata limitations. No kernel or driver replacement is included.

SHA-256: 5bd4794cef15936a6880ba56ba21cc47ef583b5030943e3e6f02b885712f61b0

MiYooSDR 0.4.0 (experimental)

MiYooSDR 0.4.0

This release adds an experimental command-line Wi-Fi packet capture utility for
the Miyoo Mini Plus stock RTL8188FU driver. The spectrum application's controls
remain the same.

• Capture 802.11 frames with radiotap metadata into Wireshark-compatible PCAP.
• Run an eight-second capture with managed Wi-Fi restoration and a recovery timer.
• Inspect captures on a computer, including independent FCS checks.
• Includes driver research notes and known metadata limitations.
• Corrects the documentation on PSD timing and the unproven raw-I/Q capture path.

The original on-device test captured 3,647 frames, including 202 beacons, with all
frame checksums verified and zero socket drops. Wi-Fi recovered automatically.
The driver can report an incorrect legacy data rate and suspect signal values;
see the research notes before interpreting PHY metadata.

Install

Extract miyoosdr-0.4.0.zip to the root of the SD card. It installs under
App/MiYooSDR. Existing recordings and settings are not included in the archive.

The capture utility lives in App/MiYooSDR/research/; it is separate from the
spectrum viewer. To start a capture over SSH, run:

nohup sh /mnt/SDCARD/App/MiYooSDR/research/monitor-capture.sh \
  > /mnt/SDCARD/App/MiYooSDR/research/monitor-capture.log 2>&1 < /dev/null &

SSH disconnects during capture. After Wi-Fi returns, retrieve
App/MiYooSDR/research/stock-monitor.pcap. Read
../driver-research.md for prerequisites, recovery,
and how to rearm subsequent experiments. Do not run capture alongside the viewer.

No kernel or driver replacement is included. Raw I/Q, Bluetooth packet decoding,
and Zigbee packet decoding remain unsupported.

SHA-256: 67d7acaeb9311425c35ad1018358a0ba7ce0ef5845f15274c721f99b5cdb95bd

MiYooSDR 0.3.0 (experimental)

Experimental. MiYooSDR 0.3.0: a receive-only 2.4 GHz spectrum analyzer and waterfall for the Miyoo Mini Plus, built from the handheld's own RTL8188FU Wi-Fi chip. No SDR dongle or extra hardware.

New in 0.3.0

• What's at the cursor: the side panel names the Bluetooth LE channel (the advertising channels 37, 38 and 39 in yellow, where beacons, phones and most BLE remotes transmit), the Wi-Fi channel and the Zigbee channel under the cursor. Yellow ticks mark the three advertising channels on the spectrum.
• Burst counter: counts transmissions at the cursor (8 dB over the background), with the time since the last one, the typical spacing and the last one's length. Park the cursor on a remote or sensor to see how often it sends. B clears it.
• Remembers your view: palette, view style, lower panel, enhance, max hold, zoom and cursor are restored on the next start (App/MiYooSDR/settings.txt).
• PNG screenshots: START saves App/MiYooSDR/shots/sdr-<date>-<time>.png, which opens on any phone or PC and no longer overwrites the last one.
• Fix: after reviewing a zoomed recording, live sweeps now go back to the view you had (they used to continue with the recording's view and no channel).
• The help line fits the screen again.

Requirements

• A Miyoo Mini Plus (the plain Mini has no Wi-Fi chip and will not work).
• OnionOS with its stock 8188fu driver.

Install

Download miyoosdr-0.3.0.zip, extract to the root of your SD card (it lands as App/MiYooSDR), and launch MiYooSDR from Onion's Apps list. Wi-Fi goes offline while it runs and returns a few seconds after you quit. Levels are uncalibrated; it is receive-only and cannot decode signals. Controls are in the README.

SHA-256 661eb89a168fa4c170a54d76c803dfde6f8e31d99205b399262369495e4ff201

MiYooSDR 0.2.0 (experimental)

Experimental. MiYooSDR 0.2.0: a receive-only 2.4 GHz spectrum analyzer and waterfall for the Miyoo Mini Plus, built from the handheld's own RTL8188FU Wi-Fi chip. No SDR dongle or extra hardware.

New in 0.2.0

• Filled, multi-colour spectrum with a lit top edge, a Wi-Fi band shading view, and four palettes (Ember, Spectrum, Ice, Matrix). Cycle with SELECT+Y and SELECT+A.
• Channel occupancy (SELECT+B): per-Wi-Fi-channel activity bars to spot a clear channel.
• Signal-to-sound (SELECT+X): a tone whose pitch tracks the level under the cursor, handy for direction finding.
• Review mode (SELECT+START): browse and replay saved recordings on the handheld.
• Single-channel burst recorder: miyoosdr --burst <MHz> <seconds> logs power-vs-time at high rate.

Requirements

• A Miyoo Mini Plus (the plain Mini has no Wi-Fi chip and will not work).
• OnionOS with its stock 8188fu driver.

Install

Download miyoosdr-0.2.0.zip, extract to the root of your SD card (it lands as App/MiYooSDR), and launch MiYooSDR from Onion's Apps list. Wi-Fi goes offline while it runs and returns a few seconds after you quit. Levels are uncalibrated; it is receive-only and cannot decode signals. Controls are in the README.

SHA-256 45502a3f8e015047c7be39b8f4a82b286983a191bbb5db9c6e2d8581835eed22

MiYooSDR 0.1.0 (experimental)

Experimental. A live 2.4 GHz spectrum analyzer and waterfall for the Miyoo Mini Plus, built from the handheld's own RTL8188FU Wi-Fi chip. No SDR dongle or extra hardware. It is receive-only: it measures energy, never transmits, and restores Wi-Fi when it exits.

Requirements

• A Miyoo Mini Plus (the plain Mini has no Wi-Fi chip and will not work).
• OnionOS with its stock 8188fu Wi-Fi driver.

Install

1. Download miyoosdr-0.1.0.zip below.
2. Extract it to the root of your SD card. It lands as App/MiYooSDR.
3. Launch MiYooSDR from Onion's Apps list.

Wi-Fi goes offline while it runs and comes back a few seconds after you quit.

Controls

R2/L2 zoom, D-pad moves the cursor, SELECT jumps to the strongest peak, Y enhances weak signals, A toggles max-hold, B clears, X records to CSV, L1/R1 gain, Up/Down level, START screenshot, MENU quit. Levels are uncalibrated.

SHA-256 f35289ce9cb2e2567f460ad2531620562c46edd87ebc4fb678d906d8ee6b567b