Skip to content

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

Pre-release
Pre-release

Choose a tag to compare

View all tags
@sundruid sundruid released this 13 Aug 02:49
· 0 commits to main since this release
aux-mqtt-v0.1.0-rc.2
This tag was signed with the committer’s verified signature.
sundruid Sundruid
SSH Key Fingerprint: 9SN+vGSHiDtW/6kyvi6HOIfD2jXM7jLQfZJVuN4t1XM
Verified
Learn about vigilant mode.
044fdf2
This commit was signed with the committer’s verified signature.
sundruid Sundruid
SSH Key Fingerprint: 9SN+vGSHiDtW/6kyvi6HOIfD2jXM7jLQfZJVuN4t1XM
Verified
Learn about vigilant mode.

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.

Assets 6
Loading