mirror of https://github.com/ALLFATHER-BV/wadamesh.git synced 2026-10-16 01:40:08 +00:00

Files

T

Kaj SchittecatandClaude Opus 4.8 2316439b71 docs: reflect the executed split

- WADAMESH_SPLIT_PLAN.md: status planning -> executed (both boards green from the
  published fork; T-Deck flash-verified on hardware); record what's done + the
  remaining non-blocking phases (minimize fork, re-home release pipeline).
- README: drop the "early scaffold" note; add Architecture (core via lib_deps,
  not vendored) + Build/flash instructions for both envs.
- NOTICE: add the bundled/vendored deps (ed25519, AsyncElegantOTA, TFT_eSPI,
  Adafruit GFX/ST7789, chsc6x).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Kaj Schittecat <kaj@schittecat.com>

2026-06-13 00:14:34 +02:00

2.4 KiB

Raw Blame History

wadamesh

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 fork ALLFATHER-BV/MeshCore (a clean fork of meshcore-dev/MeshCore), pinned by git tag. 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.

2.4 KiB Raw Blame History