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.

TinyGS AUX_MQTT v0.1.0-rc.2 — ESP32-S3

TinyGS AUX_MQTT v0.1.0-rc.2

Corrected pre-release firmware for the Heltec WiFi LoRa 32 V3 using ESP32-S3
and SX1262. This replaces the incompatible classic-ESP32 rc.1 image.

What AUX_MQTT does

• Preserves the official TinyGS MQTT connection.
• Adds an independent MQTT client and ten-packet queue.
• Publishes every complete received-packet JSON envelope to a configurable
  topic on a separately configured broker.
• Keeps auxiliary broker failures from restarting the station, disconnecting
  Wi-Fi, or consuming packets from TinyGS's official queue.
• Stores the auxiliary broker, topic, and credentials in a separate ESP32 NVS
  namespace.

The firmware is consumer-neutral: no telemetry platform, broker address,
deployment topic, username, or password is embedded in the release.

Which file to use

For the local TinyGS firmware web page, upload:

tinygs-AUX_MQTT-ESP32-S3-aux-mqtt-v0.1.0-rc.2-ota.bin

Do not upload the recovery.bin file through the web page. It is a combined
USB recovery image for flashing at offset 0x0; it overwrites stored station
configuration.

Installation

1. Disable official automatic firmware updates before installing custom
   firmware.
2. Open the station's local firmware-update page.
3. Upload the *-ota.bin image without erasing flash.
4. After reboot, open Configure AUX_MQTT.
5. Enter a Mosquitto hostname or private-network address, port, publish topic,
   and broker credentials.
6. Enable Publish RX packets to AUX_MQTT and save.

The OTA path preserves the existing TinyGS Wi-Fi, radio, station, and official
service settings. AUX_MQTT settings are entered once after this first install.

Mosquitto must require authentication and ACLs, and an unencrypted MQTT
listener must be restricted to a trusted LAN or private tunnel by the host
firewall. Generic broker configuration is documented in doc/AUX_MQTT.md in
the source branch.

Validation

• 21 source-contract tests passed.
• High-severity static analysis found no defects.
• All five PlatformIO environments passed in GitHub Actions.
• The release image is ESP32-S3 chip ID 9 with valid image checksum and
  appended validation hash.
• OTA image size is 1,456,112 bytes with 313,360 bytes of slot headroom.

The station has not been flashed as part of publishing this release.