Repository navigation
qg-interop 0.2.0: listen, decode, poll, and simulate WSJT-X, N1MM Logger+, and fldigi protocols.
Download the file for your computer, unpack it, and run qg-interop --help. Nothing else needs installing.
- macOS (Apple silicon): signed by Greg Beam (KI7MT) with an Apple Developer ID, and notarized by Apple.
- Windows (x86_64): signed by Gregory Beam (KI7MT).
- Linux (x86_64, arm64): one program for every distribution, and
.deband.rpmpackages; or install it from QSO Graph's signed apt and dnf repositories: https://github.com/qso-graph/qso-graph-packages.
The specification this release implements, QGI-SPEC-001 with its annexes, schema and vectors: qgi-spec-0.2.0.tar.gz.
C and C++: download the matching C library bundle (header, shared and static libraries). Linux C bundles require glibc 2.35 or later; the CLI is static.
Also on crates.io: cargo install qso-graph-interop-cli, and the library, qso-graph-interop.
Check a download against SHA256SUMS.txt. Every file here was built by this repository's workflow, and GitHub signs that it was: gh attestation verify <file> -R qso-graph/qso-graph-interop.
QG Interop 0.2.0 adds, since 0.1.0: IPv4 multicast for listen and the simulators;
PSK Reporter IPFIX (decoder, WSJT-X and fldigi submission encoders, collect, and a
simulator) and offline PSK Reporter MQTT capture decoding; live-peer captures from
WSJT-X 3.0.2, N1MM Logger+ 1.0.11480 and fldigi 4.2.13; listen --human; and
specification 0.2.0, which removes the reserved js8call family. WSJT-X support is
types 0–16 at the 3.0.2 general release (mapping revision 1).
Removed
- WSJT-X 3.3 support from 0.2.0-beta.1 is not in 0.2.0: JTTY, InhibitStatus (type 17),
TxInhibit (type 18) and the proposed JTTYText (type 19), with Annex B's provisional
revisions 2 and 3, their vectors and fixtures, the beta6 and 3.3 pull-request-build
UDP captures, and the simulator's--mode JTTY,--inhibit-statusand
--jtty-text. A release may not carry a
provisional mapping, and both were pinned to pre-release or proposed WSJT-X source.
WSJT-X 3.3 support returns in a later release after WSJT-X 3.3's general release.
listen --humanremains, with one generic line per event. The beta release gate
and Annex B.8's marker rules remain for later betas.
Added
-
Every release attaches
qgi-spec-<version>.tar.gz, the exact specification it
implements, built bygit archivefrom the release commit, listed inSHA256SUMS.txt
and attested. The specification stays a draft until QG Interop 1.0 (QGI-RI-0048),
when it becomes 1.0.0. New §10 states how it changes: by pull request, errata as PATCH
releases, released versions immutable, the maintainer deciding adoption. -
Add a byte-exact N1MM Logger+ 1.0.11480 rotor capture: the
N1MMRotorcommand
N1MM sends to the rotor program on port 12040 (no XML declaration, no line
breaks), decoded as anunknown_typeskip beside 18 live broadcasts. Record that
N1MM accepts and displays QG Interop's encoded Spectrum vectors and confirms kHz
scope frequencies, and that External Callsign Lookup cannot be enabled in its
Configurer. Annex D.8.1 answers Q10 and updates Q1 and Q6.
Changed
- Close the issue #5 review gaps found after 0.2.0-beta.1: a MINOR release may not
narrow an existing field's value domain (QGI-GEN-0005); an fldigi codec takes no
method list (Annex E); every family's public failures now carry its own error as their
source (QGI-RI-0024): PSK Reporter MQTT gainsMqttError, PSK Reporter IPFIX wraps
everyCodec/Profileboundary andencode_submission,recognize()wraps
projection failures in all six families, andqgi::Erroris now public so callers can
recover it;
QGI-RI-0012,0030and0042now match the library (no transport features) and
the enforced unsafe-code policy;docs/NORMALIZATION.mdcites the requirements it
describes.
Fixed
qg-interop sim(WSJT-X and N1MM Logger+) no longer drops a datagram that arrives as
a receive times out on Windows: it polls a non-blocking socket instead of setting
SO_RCVTIMEO, which leaves a Windows socket in an indeterminate state after a timeout.
The N1MM simulator test's receiver does the same, which removes its intermittent
Windows failure.