WadaMesh firmware for the Attaky Mesh series

Attaky home  ·  Discord

This repository is a fork of WadaMesh, last modified by Attaky on 2026-07-16 from upstream beta_45, to add support for the Attaky Mesh series of off-grid LoRa devices. Inherits WadaMesh's GPL-3.0-or-later license.

Attaky Mesh series

Off-grid LoRa mesh communication with a touchscreen interface. This fork supports the following Attaky bundles:

• Mesh Pocket 1.0
• Mesh Deck 1.0 (pocket form with an integrated keyboard)
• Mesh Station 1.0

What this fork adds on top of WadaMesh

• Attaky Core 1.0 build target — the attaky_mesh_series PlatformIO environment
• Integrated display and touch support — a landscape touchscreen interface
• LoRa and GPS support — off-grid communication and positioning
• Battery telemetry — device voltage reporting
• Hardware keyboard support — optional Attaky keyboard module support while retaining the on-screen keyboard

Upstream WadaMesh features and its other board targets are unchanged.

Build & flash

Install PlatformIO, then build or upload the Attaky environment:

pio run -e attaky_mesh_series
pio run -e attaky_mesh_series -t upload --upload-port <port>

Support

• Attaky Mesh series / this fork — Attaky Discord
• WadaMesh upstream firmware — file at ALLFATHER-BV/wadamesh

---

↓ Upstream WadaMesh README ↓

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

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
• Elecrow ThinkNode M9 — env ThinkNode_M9_companion_radio_touch (beta)
• RAK WisMesh Tap V2 (RAK3312) — env rak_tap_v2_companion_radio_touch (beta)

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.