AUX_MQTT v0.1.0

AUX_MQTT v0.1.0

The first stable AUX_MQTT community firmware release adds a complete,
operator-controlled MQTT packet feed while preserving the official TinyGS
connection.

Why use it

• TinyGS continues automatic satellite tuning, normal community-network
  operation, and official packet contribution.
• AUX_MQTT runs in parallel with its own client and bounded queue, publishing
  to the operator's Mosquitto broker without consuming the TinyGS queue.
• The station-side JSON envelope preserves the full base64 packet payload and
  raw FSK packet copy when present, plus complete reception metadata. It does
  not depend on a cloud or web view that may expose only selected fields.
• Retained tuned-radio status is published on the companion status topic when
  tuning changes and as a periodic heartbeat.
• COSMOS C3 / OpenC3 can consume the feed, but any MQTT 3.1.1 application that
  accepts JSON can subscribe.

Which file to download

Choose the board MCU and physical radio first. For an existing TinyGS station,
upload the matching *-ota.bin through the authenticated local firmware page.
The *-recovery.bin files are merged serial-recovery images for offset 0x0;
they are not OTA files and can replace stored station configuration.

Board and radio	Release filename contains
Classic ESP32 with a supported SX126x, SX127x, or SX1280 TinyGS board template	classic-ESP32-multi-radio
Heltec WiFi LoRa 32 V3, ESP32-S3, SX1262	Heltec-WiFi-LoRa-32-V3-SX1262
Same Heltec V3 with USB CDC enabled at boot	Heltec-WiFi-LoRa-32-V3-SX1262-USB-CDC
Heltec HT-CT62/SX1262 or custom ESP32-C3/SX1278 template	ESP32-C3-SX1262-SX1278
LILYGO T3-S3 with 2.4 GHz SX1280	LILYGO-T3-S3-SX1280-2.4GHz

The standard Heltec V3/SX1262 image is the field-tested target for this
release. The other four environments are compilation-validated; hardware
testing can vary by board and radio template.

Clean deployment

No broker address, credential, station identity, private topic, or downstream
application configuration is embedded in the source or binaries. After the
first AUX_MQTT installation, open Configure AUX_MQTT on the station and
enter the operator's own broker settings. Disable official automatic firmware
updates before installing this custom build.

Mosquitto should use separate write-only device and read-only consumer
accounts, topic ACLs, and a host firewall. This firmware currently uses
unencrypted MQTT, so the listener must remain on a trusted LAN or private
tunnel. The complete broker, firewall, test-client, COSMOS C3, and generic
subscriber instructions are in
the AUX_MQTT deployment guide.

Validation

• 24 source-contract regression tests.
• Five PlatformIO firmware environments compiled locally before tagging.
• Board/radio-specific OTA and recovery images are rebuilt by GitHub Actions
  on a clean runner from the signed release tag before the release is created.
• Every release binary is accompanied by SHA256SUMS and BUILD-INFO.md.
• The branch and release assets are scanned for deployment-specific secrets
  and configuration.

This is a community-maintained fork feature and is not an official TinyGS
release or part of the official TinyGS web installer.