Repository navigation
Releases
QG Interop 0.2.0
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.
QG Interop 0.2.0-beta.1
qg-interop 0.2.0-beta.1: 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.
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.
-
Provisional mapping:
wsjtx/2; pin:tag:v3.3.0-beta6,tarball-sha256:cbbbfd213de2dabfb0d2bac626a3b2ebb9e7b1836bd2771f90d12800771694be. -
Provisional mapping:
wsjtx/3; pin:repo:github.com/qso-graph/wsjtx,commit:53313c109194de1ce8e82e44f6846d8579645e56,patch-sha256:fb245ccea54033ace6b43fce6302bae03e1dc6518a08b455bdf080ef411679bf. -
Add the byte-exact fldigi 4.2.13 live PSK Reporter IPFIX submission, LF transmitter
log, SHA-256 provenance, and independent field oracle. Check receiver information,
three PSK31 spots with literal zero-Hz frequencies and reception times, template
IDs, evidence verification, and byte-exact fldigi submission encoding. Confirm
Annex H's fldigi profile without codec changes and complete its QGI-RI-0063
live evidence. Document sender setup, Spot gating, printable call delimiter,
queue timing, and duplicate suppression separately from protocol requirements.
Fix the fixture callsign scan to separate fldigi's variable fields from adjacent
timestamps without discarding bytes; check lowercase.txtevidence too.
Plant unauthorized calls, suffixes, mode text, and framing failures. -
Add byte-exact normal-operation WSJT-X 3.0.2 and 3.3.0-beta6 live FT8/IPFIX
captures with SHA-256 provenance and independent field oracles. Verify all four
submissions and 420 WSJT-X UDP messages, correlate six spots with Decode/Status
messages, and check receiver-only template refreshes and exact submission encoding.
Confirm Annex H's WSJT-X profiles without codec changes and mark live WSJT-X
IPFIX evidence done for QGI-RI-0063. Exclude WSJT-X Decode scalar bytes from
the recorder callsign scan while preserving text, ID, and extension checks;
fix a Clippy error in the pinned-file storage check. -
Store byte-exact live WSJT-X, N1MM Logger+, and fldigi lab captures with SHA-256
provenance, offline codec conformance tests, QSY/RadioInfo comparisons, and
numbered Annex D/E findings. Preserve and test four truncated N1MM payloads;
record fldigi's empty timeout, slow get_char_rates, and XML-RPC fault. Track
live-peer evidence without claiming independent qgi captures. Confine the five
owner-authorized FT8 calls to live fixtures and
plant policy failures for other calls and locations. Existing mappings remain
unchanged. -
Add PSK Reporter MQTT mapping revision 1 for offline captures, strict topic/payload
agreement with capture-observed callsign/to topic.escaping, bounded JSON,
shared spot and receiver-information events, a capture decoder, corrected capture
vectors covering all 460 records, and MQTT decoder fuzzing. Reject ambiguous
literal payload callsign periods and retain strict disagreement errors. -
Add provisional WSJT-X mapping revision 3 for proposed JTTYText type 19, with
exact proposal pins, full-text updates, UTC starts, independent Windows/macOS
captures, schema 2/3 vectors, listener human output, andsim --jtty-text. -
Permit provisional mappings only in exactly named beta pre-releases whose
versioned CHANGELOG section lists every mapping and identical source pin;
enforce this at all publication gates with planted refusal cases. -
Add PSK Reporter IPFIX mapping revision 1, bounded template decoding with record evidence, byte-exact WSJT-X and fldigi submission encoders, numeric unicast collector and simulator, source-derived vectors, and decoder fuzzing.
Removed
- JS8Call family reservation and placeholder Annex C in specification 0.2.0.
Changed
-
Verify the packaged CLI against the current workspace library so an older
registry crate at the development version cannot hide or reject new APIs. -
Advance QGI-SPEC-001 and generated conformance vectors to specification 0.2.0; retain the published 0.1.0 schema and add the 0.2.0 schema.
Added
-
Provisional WSJT-X mapping revision 2 pinned to
v3.3.0-beta6: InhibitStatus
snapshots, validated TxInhibit commands, source-verified JTTY Status and logging
vectors, independent source fixtures, and JTTY / inhibit simulator snapshots. Preserve Decode mode markers. -
Offline verification uses cached cargo-vet and advisory data without fetching.
-
Release guard for provisional family annexes and catalog entries, with planted
failures that pass only after removing the provisional mark. -
IPv4 multicast receive and send on an explicit numeric local interface with
--interface: shared-portlisten, WSJT-X and N1MM simulators, and capture replay.
Validate group and interface addresses, restrict multicast traffic to that interface,
and test two listeners receiving the same stream in Linux, macOS, and Windows CI. -
Manual main-only release checks, signed CLI archives and C library bundles for
four platforms, Linux packages, crates.io publication, provenance, and release
setup instructions. Add local and CI release tests, package-content checks,
Cargo packaging, and pinned workflow linting; keep embedded CLI inputs inside
its package and distribute the FFI crate only as C library bundles. -
Complete the pre-publish public API review (API-1 through API-12): immutable typed
event views; private typed options and per-call fldigi request association;
canonical open, object-safe traits and validated external profile recognition;
explicit stream progress and QGI carriage; bounded publication options and opaque
native evidence; ordered nonempty command plans with response metadata;
extensible payloads, immutable error categories, and value/equality contracts.
Update CLI, FFI, fuzzing, conformance, tests, and documentation. Add the explicit
qgi_encode_eventC entry point while preserving existing ABI behavior and JSON. -
Run Rust FFI boundary tests under pinned-nightly Miri and the linked C caller under
Rust AddressSanitizer plus C AddressSanitizer/UndefinedBehaviorSanitizer on
Linux x86_64 GNU in verification and CI. Require both tools to catch isolated,
cfg-gated heap overreads. Cover rejected lengths, stale handles, double frees,
and round trips for every supported ABI family/transport. -
qso-graph-interop-ffiC ABI as shared and static libraries for WSJT-X, N1MM,
fldigi, and QGI. Includes JSON outcomes, native command requests, re-encoding,
caller-buffered stream decoding, owned buffers, thread-safe opaque handles,
stable errors, and panic containment. -
Pinned cbindgen header generation and drift checks, Rust ABI vector tests,
linked C consumer and C++ header checks in full verification and CI. Restrict
unsafe Rust to the FFI package with checked safety comments and planted failures. -
sim --fldigi [ADDRESS]: loopback-only fldigi 4.2.13 XML-RPC stand-in serving all
50 Annex E mappings, bundled empty-string results and unknown-method faults,
mutable radio/contact state, timed queued transmission, and seeded synthetic RX text.
Includes bounded concurrent HTTP connections, policy mutation checks, deterministic
state tests, and serialized CLI poll/controller tests over loopback. -
Default-feature fldigi codec for Annex E revision 1, with all 50 mapped methods,
typed XML-RPC values and faults, caller-supplied request association and correlation,
ordered canonical command requests, and exact observed re-encoding. -
decode --fldigiwith explicit response method or request file, and loopback-only
poll --fldigifor state and RX text over bounded HTTP/1.1. -
Execute all 650 fldigi vectors, including 455 native re-encoding checks, and fuzz
decoding, association, command encoding, and round trips from vector seeds in CI
andcargo xtask verify. -
Reuse the bounded N1MM XML tokenizer with configurable family limits; preserve
N1MM admission rules. Extend CLI policy with an audited loopback TCP boundary
and planted DNS, external-connect, guard-removal, and timeout failures. -
Complete draft Annex E fldigi request/response profile pinned to released 4.2.13:
all 174 method names, 50 common mappings, bounded XML-RPC values and faults,
caller-supplied correlation, canonical ordered command bodies, and independent
conformance vectors with strict schema and planted policy failures. Re-pins the
source tarball and member hashes, audits every method change from 4.1.23 and
manual/type discrepancies, and corrects sequence acknowledgment types. -
qg-interop sim --n1mmcontest traffic with seeded synthetic contacts, UTC timing,
periodic radio reports, SO2R handoffs, edits and deletions, spots, and matching scores.
Adds target-filtered QSY reactions without acknowledgments, rate/speed/count/loop controls,
independent synthetic expectations, loopback tests, and planted invariant failures. -
Default-feature N1MM Logger+ codec implementing Annex D revision 1: bounded XML,
all documented roots, radio and SO2R state, exact frequency units, UTC timestamps,
canonical frequency/spectrum commands, and byte-preservi...
QG Interop 0.1.0
qg-interop 0.1.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.
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.