Menu Close

MeshCom versions

Latest MeshCom 4.0 MC Firmware 4.40a.11.14

Version 4.40a.11.14

1. Error Corrections

1:01 a.m. on the OLED display is running slow and jumping

  • Files: src/clock.cpp, src/clock_tick.h (new), src/display_clock_gate.h (new), src/loop_functions.cpp, src/esp32/esp32_main.cpp
  • Error: The time on the OLED ran 1 to 2 minutes slow and then jumped (field message T3 S3). Three possible causes:
    • The clock bar was redrawn only at 0, 15, 30, and 45 seconds.
    • Each beat counted the planned second instead of the actual elapsed time. Each slow loop cycle cost time.
    • With the ping set, the clock didn't run at all.
  • Change:
    • The clock bar is drawn every second on every page that includes it, including the track page. The page itself continues to be refreshed every 15 seconds. On the message page, the sender's header remains displayed.
    • Clock::CheckEvent() counts whole past seconds and carries over the remainder.
    • The clock timer is always running. Only a drawn full screen (Pong screen) suppresses the clock line as long as DisplayOffWait is running.
    • On the T114, the graphical GPS screen remains in Track mode; the clock bar does not overlay it.

1.2 Old {CET} beacons set the clock back

  • Files: src/cet_age.h, src/loop_functions.cpp
  • Error: A second server stream provides {CET}-Beacons that are 20 to 115 seconds old. The node reset its clock based on that and then reset it again with the next fresh beacon.
  • Change: One {CET}, which is more than 5 seconds behind the node clock, is ignored within 30 minutes after the last accepted one. Log: [CET];skip;back_s;<s>;since_s;<s>.

1.3 GPS without a fix overwrites the NTP time

  • File: src/gps_functions.cpp
  • Error: Without a GPS fix, two sources synchronized the clock: the loop, which retrieves data from NTP on each pass, and the “no fix” branch in WZ_GPS_Loop() from the GPS module's internal clock, which can be off by a second. The display flickered with the clock line updated every second (T-Beam after startup, e.g., :12 :13 :12).
  • Change: The branch without a fix leaves the clock alone as long as NTP is valid. Priority order: GPS with a fix, NTP, GPS without a fix.

1.4 The displayed time never runs a few seconds slow

  • Files: src/display_clock_gate.h, src/loop_functions.cpp
  • Error: GPS with a fix and NTP may differ by one second. When the fix comes and goes, the source changes, and the display jumps back one second.
  • Change: When the clock falls behind, the status bar (OLED clock bar, main bar, e-paper status bar) holds the last displayed second for up to 10 seconds until the clock catches up. A larger time shift (daylight saving time, actual correction) is displayed immediately. Only the display is held; the clock, logs, and frames retain the actual time.

1.5 Heltec V4: GNSS never worked

  • Files: variants/heltec_wifi_lora_32_V4/configuration.h, src/gps_functions.cpp, src/esp32/esp32_main.cpp, src/esp32/esp32_sleep.cpp
  • Error: RX and TX were swapped, the GNSS module was never turned on, and I2C was present on the GNSS PPS and Reset lines (41/42).
  • Change: Pins Based on the Meshtastic Method heltec_v4: RX 39, TX 38, Enable 34 (active LOW), Wake 40, Reset 42, PPS 41. I2C is routed to SDA 4 and SCL 3. Turning off the GPS powers down the module; in Deep Sleep mode, the Enable pin remains active. static_assert Confirm the assignment. V4R8 is not supported.
  • Not tested on hardware: We do not have a Heltec V4. Please let us know if --gps on provides a position.

1.6 T-Deck Pro: Incorrect Pins Copied from the T-Deck

  • File: variants/t_deck_pro/configuration.h
  • Error: TDECK_KEYBOARD_INT 46 is the LoRa-Enable on the Pro, TDECK_SDCARD_CS 39 is GPS_EN, TDECK_TOUCH_INT 16 is incorrect. Also, T-Deck copies that are incorrect on the Pro (TDECK_POWERON 10, TDECK_TFT_*, TDECK_ES7210_*).
  • Change: Keyboard IRQ 15, SD CS 48, Touch INT 12 to src/t-deck-pro/utilities.h. The incorrect copies have been removed; Pro-Build does not use them.
  • Not tested on hardware: We do not have a T-Deck Pro. Please let us know if the keyboard and touchscreen respond.

1.7 T-Deck Pro: The GPS screen freezes

  • Files: src/esp32/esp32_main.cpp, src/t-deck-pro/peri_gps.cpp
  • Error: bGPSON There's an error in the Pro at startup, which is why the Loop paused the GPS task every 3 seconds. Page 3 froze.
  • Change: No longer pauses from the loop. Page 3 starts and stops the task on its own.

1.8 T-Deck: GPS page too large, DIR cut off

  • File: src/t-deck/lv_obj_functions.cpp
  • Error: The text in the "Position" tab wrapped, and "DIR" disappeared under "SEND POS."
  • Change: The tab no longer has any inner spacing; the text uses the table font (12 px, 9 lines in 196 × 163 px), and "SEND POS" is positioned to the right of the text. The style initialization lv_style_init(&tr_style) was missing and has been added.

1.9 T-Deck: The Wi-Fi and BLE icons indicate the status

  • File: src/t-deck/lv_obj_functions.cpp
  • Bug: The BLE icon was always grayed out and only appeared in color when a phone was connected; the Wi-Fi icon disappeared when Wi-Fi was turned off.
  • Change: Both icons follow a rule based on the theme colors and remain visible: white = connected (Wi-Fi connected or AP/phone connected), yellow = on but not connected (Wi-Fi searching / BLE advertising), gray = off. LVGL is only triggered when the color, text, or visibility changes.

2. Extensions

2.1 T-Deck: Theme Auto, Dark, or Light

  • Files: src/t-deck/tdeck_theme.cpp, src/t-deck/tdeck_theme.h, src/t-deck/tdeck_palette.h (all new), src/t-deck/lv_obj_functions.cpp, src/t-deck/tdeck_helpers.cpp, src/t-deck/tdeck_main.cpp, src/command_functions.cpp, src/meshcom_settings.h, src/settings_schema.h, src/esp32/esp32_flash.cpp
  • Change: Console --theme auto|dark|light, saved as node_tdtheme, checked during loading. All static pages use colors from the palette. Header icons, the lock icon when the keyboard is locked, the theme selector and brightness slider in Settings, and the logo at startup (mc_logo_img.c, mc_lock_img.c).

2.2 T-Deck: Readable Light Mode and Chat Font S, M, L

  • Files: src/t-deck/lv_obj_functions.cpp, src/t-deck/tdeck_palette.h, src/t-deck/tdeck_theme.cpp, src/command_functions.cpp, Settings
  • Change: In Light mode: black text, white bubbles with a 3-pixel border, separate fill colors, sent bubbles are green. Colors based on photos of the panel. Console --chatfont s|m|l (12, 14, 16 px), saved as node_tdchatf.

2.3 T-Deck: Setup tab with font size, theme, display, and brightness

  • Files: src/t-deck/lv_obj_functions.cpp, src/daylight.h, src/t-deck/tdeck_helpers.cpp, Settings
  • Change: Font size S, M, L; themes Auto, Light, Dark; and display modes Auto, Light, Dark as toggle switches, with the brightness slider below them. The "Dark" display mode is a fixed night mode (new setting node_blfnight), console --bl mode auto|day|night. Existing settings are displayed as before.

2.4 GPS Sky View on T-Deck, T-Deck Pro, and T114

  • Files: src/gps_skyplot.cpp, src/gps_skyplot.h (new), src/nrf52/t114_gps_page.cpp, src/nrf52/t114_gps_page.h, src/gps_functions.cpp, src/t-deck/tdeck_gps_sky.cpp (new), src/t-deck-pro/tdeck_pro_gps_sky.cpp (new), src/t-deck-pro/ui_deckpro.cpp
  • Change: GSV parser, freshness, SNR levels, projection, and AGE format are all located in gps_skyplot.cpp. The T114 page uses it and displays AGE -- No fix. T-Deck: Position tab with SKY/TEXT switch. T-Deck Pro: Page 3.
  • Not tested on hardware: T-Deck Pro.

2.5 DHT22 on the 1-Wire pin

  • Files: src/onewire_functions.cpp, src/settings_sanitize.cpp, src/settings_sanitize.h, src/command_functions.cpp, src/meshcom_settings.h, src/settings_schema.h, src/esp32/esp32_flash.cpp, src/nrf52/nrf52_flash.cpp
  • Errors so far: Only DHT11 was read. The type was hard-coded, and the objects with the specified pin were block-local and reached begin() never.
  • Change: New Setting node_dht (11 or 22, default 11), console --dht 11|22, Ad in --info. Other values are rejected and set to 11 upon loading. The DHT object is created after the settings are loaded using the pin from --owgpio.
  • Behavioral changes for DHT11: The sensor now uses the one provided with --owgpio the set pin, not the one that was compiled in.
  • Not tested on hardware: We don't have a DHT22.

  • Version 4.40a

    • New: Store-and-Forward (mailbox node) for direct messages; available only on ESP32-S3 and nRF52840; disabled by default.
    • New: Neighborhood Matrix (NBR). It replaces the previous MHeard list and path table as the data source for
      --mheard, --path, Web, BLE, and T-Deck. That is the biggest visible change (Section 3).
    • New: 19 serial/USB commands, abbreviations, table-driven toggle handling.
    • Fixed: Bugs in BLE, Ethernet, TX-Ring, Web, and Display (see the “Fixed Bugs” section).
    • Cleanup: Moved settings, counters, BLE and UDP paths into separate modules; removed unused fonts, platform stubs, and
      commented-out test code.

  • Version 4.35v.09.30

    • FIX
      • RAK/WISBOCK Module only
      • The new download server in HAMNET and INTERNET had no or incorrect IP addresses entered for gateway connection.

  • Version 4.35v

    • UPDATE
    • FIX issue #1174
      • WIDE1-1 path for track-bake for LoRa-APRS
    • FIX issue #1178
      • Decode WebUI Parameters as UTF-8
    • FIX issue #1176
      • A relay ACK for a repeat stops it and reaches the app
    • FIX issue #1175
      • Position: A one-shot sends the node position unless TRACK has a point

  • Version 4.35u

    • UPDATE
      • Repeats (up to 3 times) for text messages sent to direct call signs that have not been acknowledged.
      • Exchange of text messages to direct call signs (DM) between country servers. Currently: OE/EU, DL, IT
      • Note: This UPDATE is available starting with version v4.35u

    • FIX issue #1157
      • Stack Overflow in the ESP32 Loop Task (External UDP)
      • --mesh off on Via trails
      • Empty destination IP in the external UDP boot line
      • DHCP Hostname from the Call Sign
      • RAM: Byte Rings Instead of Slots and Minor Changes
    • FIX #issue 1150
      • setlat/setlon on the nRF52 incorrectly reported "Value could not be set"

  • Version 4.35t.09.24

    • UPDATE
      • Web GUI: The “Voltage” button sends --volt on|off #1153

        • File src/web_functions/web_setup.cpp, Function webSetup_setParam(), Block paramName.equals("volt").
        • So far, two branches: at on the naked --volt sent, at off the naked --proz.
        • Now a branch: snprintf(message_text, sizeof(message_text), "--volt %s", setupData->paramValue.c_str()),
          so --volt on or --volt off with the switch value, just like the other switches
          (--gps %s, --ina226 %s, …) are already doing.
        • The return code check works the same way as before bDisplayVolt with the requested value.
      • Validation Check for the Maximum Battery Voltage (node_maxv) when loading settings #1152

      • KISS/TCP Interface for Standard Packet Radio Software (ESP32) #1151


  • Version 4.35t.09.20

    • UPDATE
      • Web Server – WisBlock RA4631
        • Before the fix, the input of setlon, the image didn't appear in the field simply because it wasn't clicked.
        • setalt is not affected; there, they use toInt() compared
      • Callsign check with SSID-1 and SSID-01
        • -01 and -1 were conducted as two separate sessions.
        • However, the SSID is a number (a four-bit field in AX.25); both
          notations refer to the same station, and the canonical form is the one without a leading zero.
      • The hop counter has overflowed to 15 for group/broadcast frames without using an app
      • BLE: Empty node settings in the app after extended runtime

        • After running for a few hours, the node no longer provided a configuration during the BLE connection:
          The app shows xx, QRG 0 MHz, 0 dBm, clear Wi-Fi channels.
          Reloading the app doesn't help; rebooting the node fixes it immediately.
        • was corrected in the FW

  • Version 4.35t.09.13

    • UPDATE
      •  T-DECK Plus
        • Sound on/off and/or --mute on/off have no effect in any 4.35t image
          Please install this update


  • Version 4.35t.09.12

    • UPDATE
      • HELTEC V3, RAK4631, Wireless Paper, VisionMaster E213

        • Long-Press-Deepsleep: First release the button, then configure it as a wake source

      • T-DECK Plus
        • Keyboard backlighting when Keylock is enabled

      • T-Beam Supreme
        • u8g2 display module without I2C pins, bus clock 100 kHz

      • Other hardware modules are not affected

  • Version 4.35t

    • UPDATE
      • T-DECK, T-DECK-PLUS: Improved boat loading time
      • deepsleep It really works on every board (Issue #962)

      • ACK frames sent to the telephone carry the call sign of the acknowledging station

      • Back Pressure: Echo Protection (BP-11)

      • Web GUI

      • Altitude: Barometer Reference, GPS Filter, Fusion (GPS-05b/07/08/09)

      • MCP23017 Port A goes haywire: /D= (Issue #1076)

      • EXTUDP tele For relayed nodes: qfe features the print (TLM-04)

      • Text Filter: Single-byte umlauts are preserved (CHR-03)

      • TX Performance After a Flash Reset (Issue #1132)

      • ESP32-S3 Native USB (CDC-01/CDC-02)

      • Bench instrumentation is no longer included in the standard build (INS-01)

      • Additional corrections

        • src/loop_functions.cpp: T-Beam Supreme (BOARD_TBEAM_V3) OLED on U8G2_..._F_HW_I2C With full-frame buffer (Wire, pins 17/18). Software I2C with a 1-page buffer took ~570 ms per image on the main loop (field measurement, 4x/min). Not verified on Supreme hardware.
        • src/adc_functions.cpp, src/loop_functions.cpp (initAnalogPin()), src/command_functions.cpp (--info): with --analog on and Pin 99 was active analogReadRaw(99) every 2 ms, and the Core logged Pin 99 is not ADC pin! hundreds of times per second. Measurement pauses at pin 99; a line during boot specifies the board default.
        • T-Deck: src/t-deck/tdeck_main.cpp (mouse_read()) — The trackball button now sends a pulse only on the rising edge (previously, two LVGL clicks per press; the drawer would open and close). src/t-deck/event_functions.cpp — Switch the Send/Save handler to the Message tab without an animation (tapping a second time during the scroll animation caused the image to freeze halfway); tabview_event_cb() discards the duplicate item that popped up from the tab bar VALUE_CHANGED. src/t-deck/tdeck_sdmap.{h,cpp} - sdmap_refresh() skips a layout whose set/zoom/center/viewport matches the last one, and gets a why-Parameter for the log; this causes the SD card to be assembled once instead of twice when switching tabs (718 ms instead of 1337 ms loop gap).
        • Track Alert (TRK-01): new src/track_warning.h; --track on (command_functions.cpp), the boat with the flag raised (esp32_main.cpp, nrf52_main.cpp) and the Web Switch (web_functions.cpp) state the price: degraded MeshCom RX performance, packetloss likely. No interference with the beacon cadence.
        • src/configuration_global.h: FLASH_VERSION 20260909 (for informational purposes only, FLASH_STRUCT_VERSION (unchanged).

  • Version 4.35s

    • UPDATE
      • T-Deck Plus Improvements
        • GPS Improvements – Kalman Filter
        • Keyboard Character repeat when held down – #1127
        • General stability improvements
    • NEW
      • New Country: Poland PL (Frequencies) – #1078

      • New command –setlog on/off – #1075

    • FIX
      • Extend the PATH buffer to display all 5 hops
      • ADC polarity probe detects a tightly fitted voltage divider (Wireless Stick V3) – #1124

      • ADC_MULTIPLIER for the Wireless Stick V3 corrected (4.9245 → 4.13) – #1119

      • QRS function only activates after the third message with a ring depth >= 5 – #1122

      • BME280 Support on LilyGo T-Echo– #1089

      • RAK/WSBLOCK GPS TRACK MODE – #1080

    • Preparing for MeshCom 5
      • Expanded logging of frames to save TX time in the future.
      • Status Messages for the Send Buffer
        • The node notifies the sender when its send buffer is full. The notifications come from the node's own call sign and appear only locally: in the app, in the web GUI, on the serial console, or in the EXTUDP program—depending on how the message was entered—and in the same chat where it was typed. They are never transmitted over the radio.
          • QRS - slow down, TX buffer is filling: The buffer is filling up. Messages are still being accepted, so please send them more slowly.
          • QRT - stopping to accept new messages, TX buffer full: The buffer is full. New messages from this host will be rejected from now on; relays, ACKs, and beacons will continue to function.
          • QTA - message discarded, TX buffer full: A message that had already been accepted had to be removed from the buffer.
          • QRV - ready again, TX buffer clear: The buffer is empty again; transmission can resume as normal. This only happens if something was previously rejected or discarded.
          • QRT NOT SENT - <Text> and QTA NOT SENT - <Text>: Receipt for a single message that was not sent.
        • Your own text appears below it so that it's clear which message is being referred to and can be resent as soon as QRV was there.
        • Each status message is sent only once per episode; acknowledgments are sent for each lost message.
        • According to QRV The cycle starts over.

  • Version 4.35p.08.27
    • UPDATE
      • T-DECK & T-DECK Plus
        • After the first startup, set the map to the position saved on the flash drive, even without GPS
        • "+"/"-" map icons have been moved off the map