github adswill/OnAir v0.1.4
OnAir 0.1.4

latest releases: v4.4.0, v4.3.0, v4.2.0...
one month ago

New: ISDB-T, experimental

  • OnAir can now receive ISDB-T, the digital TV standard of Japan, Brazil, most of South America and the Philippines: pick ISDB-T in the switch at the top. It covers all three modes and all guard intervals, QPSK, 16QAM, 64QAM and DQPSK, the 13 segments in up to three layers (including the one-segment mobile layer and partial reception), the signalling, both interleavers and the error correction.
  • Experimental. It decodes simulated signals exactly, with carrier offset, clock error, noise and echoes, at 6 to 20 Msps, but it has not been checked against a real broadcast yet, so details may need adjusting once we have a recording. Channel names written in the Japanese character set are not converted yet. The channel scanner covers the 6 MHz channel raster of Japan and Brazil. If you can try it on air, or have a recording, please tell us on Discord or in Issues.
  • To try it without a signal, isdbtgen --out sample.cs8 (built with the tools) makes a recording with the built-in test programme: open it as an IQ recording, 10 Msps, CS8, with ISDB-T selected.

New: DVB-T2 Lite

  • DVB-T2 Lite signals now decode like any other DVB-T2 signal: the extra 1/3 and 2/5 code rates, the short error-correction frames and 1.7 MHz channels.
  • Checked end to end on simulated signals from QPSK to 256QAM: every decoded frame matches what was sent. The error correction sits close to where theory says it should.
  • Not tried on a real T2-Lite broadcast yet. A Lite signal that shares a channel with a normal T2 signal (inside its future-extension frames) is not decoded; the normal T2 part keeps working.

New: automatic updates

  • OnAir checks GitHub for a newer version a few seconds after it starts (and then at most once a day), downloads the package for your system in the background, checks it against the SHA-256 that GitHub lists for the file, and puts it in place when you close the program. The button at the top right shows the version and the state, and has the settings: turn the check off, turn the automatic install off (you then get a button instead), or leave out pre-releases.
  • macOS replaces OnAir.app, Windows runs the installer quietly (Windows asks for permission), Linux replaces the portable folder, and a .deb install asks for your password through the system's installer. Only github.com is contacted, and nothing is sent but the usual request.
  • This is the first version that has it, so 0.1.3 and older need one manual download of this version. It has been tested against simulated releases; the first real updates on Windows and with the .deb are still to be proven. Pre-releases are included by default; you can leave them out in the update settings.

Better on slow computers

  • When the computer cannot keep up with the radio, OnAir used to drop a few samples out of every chunk, which put a hole in every frame, so nothing decoded even with a clean signal. It now throws away one stretch at a time (and says so in the log), and the frames in between decode. For DVB-T2 the receiver also carries its frame timing across the gap, so it picks up again at once. This applies to radios only; recordings still wait for the receiver and never lose samples.
  • The DVB-T2 receiver does about a third less work: in a heavy mode (16K carriers, guard interval 1/4) it went from 48% to 31% of real time on one core in our measurement. The data stage is more than twice as fast, mostly because the channel estimate is calculated once per frame instead of once per symbol, and several per-sample calculations were replaced by cheaper ones. The effect is largest on low-end computers.
  • ISDB-T got a faster demapper and a faster Reed-Solomon decoder.

Also

  • The README now lists DVB-T2 Lite, ISDB-T and the update system.
  • Many more automated tests: ISDB-T from the channel coding to the engine, T2-Lite end to end, the overloaded-receiver case and the updater. The build and tests pass on macOS (Apple silicon and Intel), Linux (x86-64 and arm64) and Windows.

Known limits

  • ISDB-T and ATSC 3.0 are experimental (no real recording yet). T2-Lite is untried on air.
  • ISDB-T loses a few packets in the harshest echo we simulate (an echo as strong as the signal, inside the guard interval); in simulation it decodes at least 97% of the packets there.
  • Dropping a stretch of signal on a slow computer still shows as a short glitch in the picture. It is far better than before, but a computer that is much too slow still cannot decode everything.

Still true: the HackRF is the radio OnAir is developed and tested with; the other radios are experimental and have had little real-world testing. An RTL-SDR can only receive DAB radio, not TV. Not code-signed: on macOS right-click the app and choose Open the first time; Windows shows an unknown-publisher warning. Please report problems in Issues, and for support and feature requests there is a Discord link in the README.

Don't miss a new OnAir release

NewReleases is sending notifications on new releases.