Tesso M Costa
f59d9f4b23
Mirrors the T-Deck's spacebar-lock/trackball-unlock experience for the pager. Unlike the T-Deck's keyboard, the TCA8418 here reports real press/release, so this is a genuine hold (with a live-filling "Locking…" progress popup) rather than the T-Deck's tap+countdown workaround. Backspace was chosen for unlock over the rotary encoder: its raw held-state stays readable via PagerKeyboard's own poll loop regardless of screen power state, while the encoder's poller currently exits early whenever the screen is off. Fixes three existing bypasses that would otherwise make the new lock pointless -- on this board, a plain encoder turn, a BOOT-button press, or any ordinary keypress all unconditionally called wakeScreen() (which clears the manual-lock flag) with no hold requirement, so anything at all would instantly unlock a "locked" screen. Each now checks isManualLock() first; only the deliberate Backspace hold clears it. The BOOT-button fix is scoped to TLORA_PAGER specifically, since that same code path is shared with the Heltec V4, which has no keyboard and relies on BOOT as its only lock/unlock control. Also updates the two user-facing "how to unlock" hint strings (the Settings lock-on-screen-off toggle, and the T-Deck-style lock overlay text, the latter currently dead code on this board since that overlay is never built here) so they don't keep pointing at a trackball this board doesn't have. Signed-off-by: Tesso M Costa <tesso.martins@gmail.com>
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 and Heltec V4 + TFT (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
- LilyGo T-Deck / T-Deck Plus — env
LilyGo_TDeck_companion_radio_touch - Heltec V4 + TFT + CHSC6x touch — env
heltec_v4_tft_companion_radio_usb_tcp_touch
Architecture
This repo holds only the app: the companion_radio glue, the ui-touch
LVGL UI, the two boards' 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.
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.