Christopher Van Hoose
3cbceb301e
Measured on hardware, a 9-tile cold open was 2598 ms. Four changes, in descending order of what they actually bought: - renderMapTiles repainted the whole screen after EVERY tile. On the immersive map each lv_refr_now also alpha-blends the transparent status and tab bars over the full panel: ~115 ms a call, nine times. That cost more than the SD reads and the JPEG decodes COMBINED (measured read=497ms decode=539ms other=1042ms). Throttle it to one paint per k_map_progressive_ms, first tile still immediate. Saves ~684 ms. This corrects the standing assumption that the remaining cold-open cost was the decode - it was not, and nobody had counted the compositing. - onMapTabActivated called bestAvailableZoom() unconditionally and then discarded the result whenever a zoom was persisted. Worse, with no GPS fix the centre stays 0,0, s_map_view_inited never latches, and the whole 17-level probe re-ran on EVERY open rather than just the first. Skip it when the answer cannot be used. Saves ~410 ms. - The "Loading map..." hint was set AFTER that probe, so the scan ran with the outgoing tab still frozen on the panel. Move it to the top, and skip the tab-slide for the map so the flush is not racing the animation. - tileExistsAt probed .png while the generic loader only ever opens .jpg, so the zoom guard advertised - and the auto-snap selected - levels that render blank. Mirror the loader. Also gate s_tile_fetch_dirty on the visible zoom, matching the rule the already-cached path above it already used: the 29-tile background prefetch pyramid was driving full grid re-renders for tiles that are never on screen. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: Christopher Van Hoose <cvhvisuals@icloud.com> (cherry picked from commit a14ab185c9e2f1a3c54ee285d486e1c2b7a05901)
A real touchscreen UI for your mesh radio. · open source · GPL-3.0
Touch-UI MeshCore companion-radio firmware for the LilyGo T-Deck / T-Deck Plus, Heltec V4 + TFT and eight other boards (ESP32-S3).
An LVGL touch UI — map, chat, contacts, channels, settings — split out of
meshcomod. The app depends on a
MeshCore fork via PlatformIO lib_deps.
Boards
See DEVICES.md for the full support matrix, install paths and per-board status.
- LilyGo T-Deck / T-Deck Plus — env
LilyGo_TDeck_companion_radio_touch(stable) - Heltec V4 + TFT + CHSC6x touch — env
heltec_v4_tft_companion_radio_usb_tcp_touch(stable) - Tanmatsu (ESP32-P4) — built from
tanmatsu/(ESP-IDF), ships via the Tanmatsu app store — sideload guide for running your own build - Elecrow ThinkNode M9 — env
ThinkNode_M9_companion_radio_touch(beta) — keyboard & d-pad guide - RAK WisMesh Tap V2 (RAK3312) — env
rak_tap_v2_companion_radio_touch(beta) - LilyGo T-Lora Pager — envs
tlora_pager_lr1121_companion_radio_touch/tlora_pager_sx1262_companion_radio_touch(beta) — keyboard shortcuts - Heltec V4-R8 + Expansion Kit V2 — env
heltec_v4_r8_tft_companion_radio_usb_tcp_touch(beta) - LilyGo T-Display P4 — built from
tdisplay_p4/(ESP-IDF); AMOLED by default,WADA_P4_LCD=1for the TFT-LCD SKU (beta) - Attaky Mesh Series — env
attaky_mesh_series_companion_radio_touch(beta)
Architecture
This repo holds only the app: the companion_radio glue, the ui-touch
LVGL UI, each board's glue/variants, and platformio.ini. The MeshCore
core is not vendored here — it's pulled as a library via lib_deps from the
ALLFATHER-BV/meshcomod monorepo
(the same repo as the non-touch firmware), pinned by a lean source-only core-*
git tag. The touch-app files this repo owns (TouchPrefsStore, WifiRuntimeStore,
the transports, …) are dropped from the lib via -DMC_VENDORED_TOUCH_APP so they
aren't compiled twice. The build is byte-identical to the original in-tree
meshcomod firmware.
Lua apps use the on-device SDK described in LUA_APPS.md. For WAV/MP3 playback, including a ready-to-sideload transport test app and exact SD and internal-storage paths, see AUDIO_PLAYBACK_TESTING.md.
Build
PlatformIO pulls the core fork and all libraries automatically:
pio run -e heltec_v4_tft_companion_radio_usb_tcp_touch # Heltec V4 TFT
pio run -e LilyGo_TDeck_companion_radio_touch # LilyGo T-Deck
# or just `pio run` to build both
Flash with the NVS-preserving 4-component chain (bootloader / partitions /
boot_app0 / firmware at 0x0 / 0x8000 / 0xe000 / 0x10000) so saved Wi-Fi
credentials survive — not a merged image, which 0xFF-pads and wipes NVS.
Contributing
Contributions are welcome — see CONTRIBUTING.md. One topic per PR; inbound contributions are accepted under the project's GPL-3.0 license.
License
GPL-3.0-or-later — see LICENSE. wadamesh is copyleft: anyone who distributes a build or a fork must also make their source available under the GPL. This keeps the UI open and concentrates community effort instead of fragmenting it into closed forks.
wadamesh incorporates and depends on MeshCore (MIT, © Scott Powell / rippleradios.com) and other third-party components — see NOTICE for the full list and their licenses. MeshCore-derived files keep their MIT notices; the combined work is distributed under the GPL (MIT is GPL-compatible). The MeshCore fork that wadamesh builds against stays MIT on purpose, so its Wi-Fi/BLE hooks remain upstreamable to MeshCore.