sapient 1b95b36530 docs: v0.2 architecture with scoped feature set and 7-phase plan
LVGL UI, 350 contacts / 40 channels, HybridMessageStore (RAM+LittleFS),
journaled writes, full routing stack (flood, variable path hash, path
discovery, repeater admin, active discovery), notification sounds. Serial
companion for meshcore-cli compat. OTA/WiFi/deep sleep/BLE architected
but disabled for v1. 7 development phases from HAL bringup through
integration testing. Existing code reconciliation mapped out.
2026-03-30 03:42:07 -07:00

MESHTANIC

Open-source MeshCore firmware for the LilyGo T-Deck Plus.

Replaces the proprietary Ripple/MeshOS firmware with a clean-room implementation that speaks the MeshCore protocol natively. Interoperates with existing MeshCore nodes (Heltec V3, Ripple devices). No premium gates, no license tiers, no registration locks.

Status

v0.1.0 — Project scaffold. Hardware bringup in progress.

Hardware

Component Chip Interface
SoC ESP32-S3FN16R8 240MHz dual-core, 16MB flash, 8MB PSRAM
LoRa SX1262 SPI
Display ST7789 320x240 SPI
Keyboard ESP32-C3 I2C (0x55)
GPS u-blox UART
Speaker MAX98357A I2S
Mic ES7210 I2S

What This Is

  • Open-source firmware for T-Deck hardware
  • Speaks MeshCore wire protocol (compatible with Ripple/MeshOS nodes on the mesh)
  • Has its own UI
  • Clean-room implementation from meshcore-cli (MIT)

What This Is Not

  • Not a Meshtastic fork (different protocol)
  • Not a binary patch of MeshOS
  • Not an emulator of proprietary firmware

Building

Requires PlatformIO.

pio run -e meshtanic-tdeck
pio run -t upload
pio device monitor

Development Phases

  1. Hardware Bringup — Boot, peripherals, display, keyboard, radio init
  2. Radio + Basic Mesh — LoRa TX/RX, packet codec, advertisements
  3. MeshCore Protocol — Encryption, channels, contacts, routing
  4. Companion Interface — Serial/BLE compatibility with meshcore-cli
  5. UI — On-device chat, contacts, channels, settings
  6. Polish — GPS sharing, telemetry, OTA, power management

Protocol Reference

Primary source: meshcore-cli Python library (MIT). Secondary: meshcore-open Flutter client (MIT).

License

MIT

Description
Open-source MeshCore firmware for LilyGo T-Deck Plus
Readme MIT 9.7 MiB
Languages
C 99.9%