Skip to content

Releases

QG Interop 0.2.0

Choose a tag to compare

@github-actions github-actions released this 16 Nov 18:37
3648de0

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 .deb and .rpm packages; 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-status and
    --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 --human remains, 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 by git archive from the release commit, listed in SHA256SUMS.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 N1MMRotor command
    N1MM sends to the rotor program on port 12040 (no XML declaration, no line
    breaks), decoded as an unknown_type skip 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 gains MqttError, PSK Reporter IPFIX wraps
    every Codec/Profile boundary and encode_submission, recognize() wraps
    projection failures in all six families, and qgi::Error is now public so callers can
    recover it;
    QGI-RI-0012, 0030 and 0042 now match the library (no transport features) and
    the enforced unsafe-code policy; docs/NORMALIZATION.md cites 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

Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 17:23
33aa44d

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 .deb and .rpm packages; 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 .txt evidence 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, and sim --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-port listen, 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_event C 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-ffi C 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 --fldigi with explicit response method or request file, and loopback-only
    poll --fldigi for 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
    and cargo 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 --n1mm contest 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...

Read more

QG Interop 0.1.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 21:08
0aff9a4

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 .deb and .rpm packages; 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.