HaloKeymind/CHANGELOG.md

MeshCore Observer — Changelog

Changes to the MQTT observer / bridge work that powers the firmware offered on observer.gessaman.com. Newest changes are at the top.

Legend: New = new capability · Fix = bug fix · Improvement = enhancement to existing behavior · Internal = refactor / under-the-hood · Docs = documentation · Build / CI = build system & automation. ⬆ Upstream sync marks a merge of the upstream MeshCore dev branch, which generally pulls in a new MeshCore software version.

August 2026

• New — Analytics dashboard on the Heltec V4 R8 Expansion Kit V2 TFT: 20-minute rolling RF activity with a packets-per-minute graph, on a dark padded layout that repaints only the rows that changed _2026-08-28
• New — display.timeout (blank after N seconds, 0 = always on) and display.flip (rotate 180 degrees), both applied live _2026-08-28
• New — Tap the Expansion Kit V2 panel or press USER to blank/wake the display; hold USER 3 s to power off _2026-08-28
• Fix — Power-off on the V4 R8 armed an RF wake, so a node in live traffic rebooted seconds after showing "Turning OFF" _2026-08-28
• Fix — The V4 R8 TFT could not be woken once blanked, because waking re-ran a full panel init that also reset the touch controller _2026-08-28
• New · platformio — MQTT observer repeater and room-server configs for Heltec V4 R8 (OLED and TFT) _2026-08-20

June 2026

• New — AlertReporter integration in MyMesh for Room Server _{2026-06-17 · 985fda13}
• Improvement — Cumulative packet statistics (packets_sent / packets_received) added to the status message _{2026-06-16 · 8bf590b1}
• Improvement — Packet path now published as an array of lowercase hex hop tokens _{2026-06-16 · e80a5ded}
• CI — Sync documentation files to the flasher site from the build workflow _{2026-06-16 · 0844eee1}
• CI — Reworked the GitHub Actions workflow for rolling releases _{2026-06-08 · 8fa38707}
• New — Radio Watchdog feature for the MQTT observer _{2026-06-08 · 002e8d4a}
• Improvement — Firmware build-date format and UTC timestamps (always emit +00:00) _{2026-06-06 · b45373a3}
• CI — Build observer firmwares across 14 shards (up from 4) _{2026-06-06 · c29ede05}
• CI — Cache PlatformIO toolchains in CI _{2026-06-06 · 6723776f}
• CI — Automated firmware builds via GitHub Actions _{2026-06-06 · 981ed246}
• ⬆ Upstream sync — Synced with upstream MeshCore dev (brings MeshCore v1.16.0) _{2026-06-06 · dcc8f826}

May 2026

• New — NZ Analyzer MQTT preset _{2026-05-25 · c0c845f5}
• Internal — Region definition helpers; docs refresh _{2026-05-21 · 1296aa77}
• Docs — Clarified WiFi configuration instructions (password optional for open networks) _{2026-05-21 · 38568eb1}
• Improvement — Alert PSK access now restricted by sender timestamp _{2026-05-17 · f717d673}
• Docs — Trimmed the fault-alert section in the implementation guide _{2026-05-17 · c41805d0}
• Change — Renamed CLI command region bulk → region def _{2026-05-16 · f3c6c348}
• Internal — Timestamp handling in MQTTMessageBuilder _{2026-05-15 · 5a004f37}
• New — T-LoRa V2.1–1.6 observer configurations _{2026-05-13 · 3cde9c10}
• Fix · mqtt — Hardened the T-LoRa MQTT observer and trimmed MQTT task stack usage _{2026-05-13 · daf9ee47}
• Internal — Alert PSK handling is now hex-only _{2026-05-12 · a8668840}
• Improvement — Alert PSK accepts both base64 and hex _{2026-05-12 · a865d0a3}
• New · cli — Bulk region hierarchy command _{2026-05-12 · 19f95001}
• Improvement — Path hash size included in AlertReporter flood messages _{2026-05-11 · 6a3ed5d4}
• New — T-Beam 1W observer support and partition handling _{2026-05-11 · fc99d6b3}
• Improvement — Fault alerts gained region-based scoping and banned channels _{2026-05-11 · 16dc49fa}
• New — Fault alerts for WiFi and MQTT disconnections _{2026-05-10 · 80355f32}
• New — ColoradoMesh MQTT preset _{2026-05-10 · 08847342}
• New — MQTT origin handling and a string utility _{2026-05-09 · b9f478c9}
• Improvement — Repeat status included in the MQTT status message _{2026-05-09 · 303cf8c2}
• Internal — MQTT origin now uses effective-origin logic _{2026-05-09 · ff031f48}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-05-09 · b37db668}
• New · mqtt — T-LoRa V2.1-1.6 observer environments _{2026-05-02 · 78e1500a}

April 2026

• Fix · mqtt — Corrected ColoradoMesh preset details _{2026-04-30 · 9f8f2d05}
• New · platformio — PSRAM support for the TBeam Supreme SX1262 variant _{2026-04-28 · 0b05aede}
• New · mqtt — ColoradoMesh preset _{2026-04-28 · 457edf69}
• Fix · mqtt — Added missing MQTTBridge error codes _{2026-04-27 · 5a5e5373}
• New · mqtt — EastIdahoMesh preset and richer CLI preset listing _{2026-04-25 · 753eb72f}
• Fix · mqtt — Removed errant clearLastWill from PsychicMqttClient _{2026-04-25 · 32449e62}
• Fix · mqtt — Restored origin field position in packet messages _{2026-04-25 · 673361b6}
• Internal · mqtt — Reorganized packet message structure _{2026-04-25 · 8be27e4e}
• Internal · mqtt — Default TX packet settings and documentation _{2026-04-25 · bfcf0176}
• New · platformio — MQTT observer configs for the Heltec V4 expansion kit _{2026-04-24 · 0a4f002f}
• New · cli — Radio watchdog command _{2026-04-24 · 7b21be3e}
• Internal · mqtt — Standardized MQTT preset formatting _{2026-04-24 · 6211885c}
• Internal · heltec_tracker_v2 — Aligned FEM with meshcore-dev KCT8103L _{2026-04-24 · 0d280257}
• New · heltec_tracker_v2 — Restored LoRaFEMControl for GC1109 _{2026-04-24 · 255fce7f}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-04-24 · c1989d6f}
• New · mqtt — chimesh and meshat.se presets _{2026-04-24 · ee4e39bc}
• Fix · mqtt — Restored legacy outbox behavior for QoS0 async publishes _{2026-04-23 · 70722a58}
• Fix · mqtt — Config marked dirty on setter calls; applied on connect/reconnect _{2026-04-23 · bb67b04e}
• Improvement · mqtt — Better QoS handling and retry logic _{2026-04-23 · 7d0c5bce}
• Internal · mqtt — Removed legacy mqtt.server/port/username/password CLI _{2026-04-21 · cfec3a5b}
• Fix · mqtt — Legacy CLI aligned with slot prefs; restored isConfigValid _{2026-04-21 · ac2662c5}
• Internal — PsychicMqttClient memory management; fixed-size callback arrays (v0.2.2) _{2026-04-21 · e9ff1ae0}
• Improvement — MQTTBridge memory management, deferred logging, and QoS on publish _{2026-04-19 · 1ff9437f}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-04-19 · 563d9a7d}
• Build — Disabled MQTT debug config for heltec_v4 builds _{2026-04-17 · 0ed29cb7}
• Change — gitignore generated cert files; meshmapper timeout reset to 0 _{2026-04-17 · ab121708}
• Change — MeshMapper preset update; removed generated cert files _{2026-04-17 · 074ac3e7}
• Improvement — Critical heap monitoring and deferred TLS; hard restart on prolonged low memory _{2026-04-17 · f4a4fd7c}
• Internal — Inline StaticJsonDocument allocations to reduce heap fragmentation _{2026-04-16 · ab6685a1}
• New — nashmesh preset _{2026-04-14 · 13fbcd91}
• Internal — MQTTMessageBuilder takes an external JsonDocument to cut stack usage _{2026-04-14 · ff2df2b7}
• Internal — Removed the raw-data mutex in favor of core-specific staging _{2026-04-14 · 0c190dac}
• Improvement — Radio watchdog avoids false alarms in quiet meshes _{2026-04-14 · 961f8293}
• New — Radio diagnostics in MyMesh and CommonCLI _{2026-04-10 · 7e4f75c9}
• Improvement — Internal heap stats in status messages _{2026-04-06 · 74e45a79}
• New — TennMesh preset (fixed username/password auth) _{2026-04-05 · 3b46e9ee}
• Docs — Single set radio command in the guide _{2026-04-04 · 1c524a93}
• Internal — RX/TX packet logging controlled by MQTT settings (mqtt_rx_enabled pref) _{2026-04-04 · 47b632aa}
• Improvement — Runtime-configurable MQTT slot limits based on PSRAM _{2026-04-04 · 258a0d72}
• Improvement — Disconnect count/time diagnostics; per-variant WiFi TX power _{2026-04-02 · f0962eff}

March 2026

• Improvement — Pre-allocated status JSON buffer in PSRAM; non-blocking NTP refresh _{2026-03-31 · cf4ec3f6}
• New — WiFi disconnect diagnostics _{2026-03-31 · 0e82271e}
• Fix — Audience command parsing handles the 9-character prefix _{2026-03-30 · a4324a83}
• New — JWT audience configuration for custom slots _{2026-03-30 · 1263e71d}
• Improvement — Partition-table guidance, merged-firmware flashing, embedded CA bundle _{2026-03-30 · da775bb2}
• Docs — Removed obsolete MQTT design docs _{2026-03-28 · 384b80fc}
• Docs — README links to the MQTT Implementation Guide _{2026-03-28 · ff49d28f}
• New — Optional SNMP monitoring; concurrent MQTT slots 3 → 5 _{2026-03-28 · 202acacf}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-03-28 · cc17c6b7}
• New — meshomatic preset; disable slots with no server configured _{2026-03-27 · 3eacf56e}
• Improvement — Pre-allocated JSON publish buffer in PSRAM _{2026-03-26 · 47dd2182}
• New — reconnect() added to PsychicMqttClient _{2026-03-25 · 1b5884bd}
• Improvement — Lightweight JWT reconnect (token refresh without full teardown) _{2026-03-25 · af52a989}
• Internal — Full teardown/setup for JWT slots on reconnect _{2026-03-24 · e29c3d96}
• Internal — Standardized MQTT slot log format _{2026-03-24 · 2bbca206}
• New — cascadiamesh preset; keepalive configuration _{2026-03-24 · eaf5fcbc}
• Improvement — Re-create JWT tokens when NTP reveals stale time _{2026-03-24 · 1c98d1c6}
• Internal — Serial-availability checks before logging; circuit-breaker reconnect logic _{2026-03-23 · 4a60f166}
• New — MeshRank preset (token auth, custom topic templates) _{2026-03-22 · 95874f0c}
• Fix — Dynamic MQTTBridge allocation to avoid an ESP32 static-init crash _{2026-03-21 · c67fb12b}
• Build — Build script: cached project config, artifact handling, ESP32 binary merge _{2026-03-21 · bf8a3a7a}
• Improvement — Active connection slots limited by available memory (PSRAM-aware) _{2026-03-20 · 542f8a31}
• New — Up to 3 configurable connection slots with built-in presets (LetsMesh US/EU, MeshMapper) _{2026-03-20 · b43e9618}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-03-20 · abe6e046}
• Change — Stopped enabling MQTT analyzer servers by default in the example sketches _{2026-03-07 · 304719e8}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-03-06 · db8b4419}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-03-04 · 56ac85fa}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-03-03 · dcbbe5a6}

February 2026

• ⬆ Upstream sync — Synced with upstream MeshCore dev (Packet.cpp fix) _{2026-02-26 · 8b359452}
• Internal — Multibyte path handling in Packet / MQTTMessageBuilder _{2026-02-25 · c8e220b1}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-02-25 · 51e9907f}
• Change — Removed an unused preprocessor directive in MyMesh _{2026-02-25 · ee1a9b4a}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-02-24 · 397a48fc}
• Improvement — Keepalive set to 45s to hold WebSocket connections through Cloudflare _{2026-02-16 · 2d4b7a64}
• Build — heltec_v4 uses the heltec_v4_oled config for observer / room-server _{2026-02-16 · 88ce0d33}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-02-15 · e89cbee8}
• Improvement — Simplified KISS noise-floor sampling _{2026-02-07 · 776131e2}
• Fix · kiss_modem — Improved RX delivery and noise-floor sampling _{2026-02-06 · f445b5ac}
• Improvement — Better NTP synchronization in MQTTBridge _{2026-02-06 · ba4243b5}
• Improvement — WiFi management and fragmentation recovery _{2026-02-04 · 26aaace9}
• New — PSRAM-backed memory management in MQTTBridge _{2026-02-04 · 1d0d33f9}
• New — PSRAM diagnostics at MQTTBridge init _{2026-02-04 · abcfe609}
• Build — mbedTLS configuration tuned across variants _{2026-02-04 · 21158e1f}
• Fix · kiss — Periodic noise-floor calibration and AGC reset _{2026-02-03 · 0fb57033}
• Fix — Memory use and status reporting in the MQTT bridge _{2026-02-02 · 498566e6}

January 2026

• Internal — Clarified packet ownership / memory management in MQTTBridge _{2026-01-31 · f91b715e}
• New — recv_errors in the CMD_GET_STATS packets response _{2026-01-29 · 019bbf74}
• New — Receive-error tracking in Dispatcher and the message builder _{2026-01-29 · ee577314}
• Fix — Display header include for heltec_v4 when DISPLAY_CLASS is set directly _{2026-01-27 · bb27cded}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-01-27 · d96c900f}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-01-26 · 2a84e58b}
• Improvement — MQTTBridge memory usage and NTP handling _{2026-01-24 · 9e1ce23e}
• Improvement — MQTTBridge status handling and publish logic _{2026-01-23 · c67c3295}
• Internal — MQTTBridge connection handling for stability / responsiveness _{2026-01-22 · c055228c}
• ⬆ Upstream sync — Synced with upstream MeshCore dev _{2026-01-21 · 39ba020f}
• Internal — MQTTBridge moved onto a FreeRTOS task for responsiveness _{2026-01-21 · ed27ebd0}
• New — Configurable WiFi power-save mode preference _{2026-01-18 · 56f98997}
• Internal — HeltecTrackerV2 / HeltecV4 init for GC1109 FEM _{2026-01-13 · 3eaca31f}
• Docs — Owner configuration commands documented _{2026-01-12 · 58cdd60c}
• Internal — Advert timer type consistency in MyMesh / SensorMesh _{2026-01-08 · ffa2a1ec}
• New — Device metadata setup at bridge init / restart _{2026-01-03 · 2bd61c13}
• Internal — Config validation allows optional username / password _{2026-01-03 · d1093b43}
• Internal — JWTHelper / MQTTBridge efficiency cleanup _{2026-01-02 · e754317c}
• Fix — MQTT connection stability and CLI responsiveness _{2026-01-02 · 98f176c7}
• New — Neighbour-info sorting; MQTTBridge memory tuning _{2026-01-01 · 2185523d}

December 2025

• Docs — WiFi power-save configuration documented _{2025-12-30 · 915f8b8e}
• Internal — loadPrefs handles fresh installs and upgrades; migrates old prefs _{2025-12-30 · 8fa99611}
• Improvement — Loop prioritizes radio RX for responsiveness _{2025-12-29 · 617e3b17}
• Internal — Defer broker connect until WiFi + NTP ready; socket error logging _{2025-12-17 · 5d4f1e4c}
• Improvement — Event-driven WiFi diagnostics and faster reconnect _{2025-12-12 · f7f1f838}
• New — WiFi power-save mode configuration (none / min / max) _{2025-12-08 · 34c8bea7}
• Fix — LPS22HB pressure now reported in hPa (was kPa) _{2025-12-08 · b91b854a}
• New — WiFi TX power configuration (default 11 dBm) _{2025-12-07 · b82d7e43}
• New — Default bridge settings for fresh installs; JSON reuse to avoid fragmentation _{2025-12-07 · 0b7c0888}
• Improvement — MQTT debug macros check Serial to prevent hangs _{2025-12-06 · 3589043b}
• Change — Removed redundant settings writes in savePrefs _{2025-12-04 · 03d519f8}
• Build — Source filter for the Xiao S3 WIO variant _{2025-12-01 · 4f548ffc}

November 2025

• New — adc_multiplier added to NodePrefs _{2025-11-23 · 8fbdc98a}
• Change — IATA codes uppercased for consistency _{2025-11-23 · 5cadf3d9}
• Change — CMD_GET_STATS split into core / radio / packet sub-types _{2025-11-17 · a3c9a073}
• New — IP address shown for MQTT bridge devices in UITask _{2025-11-16 · 6b0c0e93}
• New — T-Beam ESP32 support; error log when source = tx but TX logging is off _{2025-11-16 · 3c7ac9d1}
• Build — MQTT_DEBUG enabled for several build configs _{2025-11-16 · 3726c472}
• New — MQTT observer support for Room Servers _{2025-11-15 · 0cd0c36a}
• Change — Switched MQTT configs to observer mode across variants _{2025-11-13 · 304a32db}
• Internal — Client version string generation _{2025-11-13 · aa242e78}
• Improvement — WiFi power-save + reduced TX power to limit LoRa interference; retry fix when no brokers connected _{2025-11-10 · bafa5426}
• Internal — Statistics use binary frames instead of JSON _{2025-11-09 · 80d6dd43}
• New — IATA validation blocks publishing without an IATA code _{2025-11-08 · 25d40f02}
• Fix — Restored status-publish retry delay to prevent server spam _{2025-11-08 · 9e06fffc}
• New — Added missing token-expiration / reconnection member variables _{2025-11-08 · 453c4184}
• Change — Removed WiFi credentials from platformio.ini (use CLI / build flags) _{2025-11-08 · 921c6112}
• Internal — MQTT preferences handling in CommonCLI _{2025-11-08 · 5a816be8}
• Internal — formatStatsReply uses the new member variables _{2025-11-08 · c9aa536c}
• Build — Explicit paulstoffregen/Time dependency to fix PIO compile _{2025-11-07 · 72ca50b9}
• Build — Dropped the CayenneLPP patch script; updated ArduinoJson _{2025-11-07 · fef9225b}
• Fix — Timezone command parsing lengths corrected _{2025-11-07 · b89ceeea}
• New — Statistics commands and response handling in MyMesh _{2025-11-07 · df4dab85}
• New — MQTT email support in CommonCLI / JWTHelper _{2025-11-06 · 1ed18f9e}
• New — MQTT owner public-key support _{2025-11-06 · e5dbd56b}
• Improvement — Status reporting and stats collection _{2025-11-01 · e4ff06cb}

October 2025

• Improvement — MQTTBridge logging and connection handling _{2025-10-31 · 7df28557}
• Improvement — Packet handling and memory management in MQTTMessageBuilder / MQTTBridge _{2025-10-31 · eee02025}
• New — Memory monitoring and queue-size reporting _{2025-10-29 · e77beff0}
• Internal — In-place base64url encoding; cleanup frees queued packets / timezone objects _{2025-10-27 · 1219668f}
• Change — Defer MQTT connect until WiFi credentials are valid (requires reboot) _{2025-10-27 · 3851a84b}
• Improvement — Dynamic build date and client versioning _{2025-10-26 · c23663da}
• New — CLI config for mqtt.server / username / password / port _{2025-10-26 · eab70c3c}
• New — Let's Mesh Analyzer integration _{2025-10-26 · a6453556}
• New — Station G2 repeater bridge build target; docs _{2025-10-26 · f6a77d2f}
• New — Timezone handling; raw-data packet output with proper hashes / timestamps _{2025-10-25 · 787af7b0}
• New — Timezone support in the MQTT Bridge and CLI _{2025-10-25 · 26c4b970}
• New — Initial MQTT Bridge implementation with WiFi CLI configuration _{2025-10-25 · efc15eb6}