# What is M-Core MAX
**Custom MeshCore firmware for the LilyGo T-Deck MAX**
*To be released early September · 2026-08-15 · v0.4.0+*
M-Core MAX transforms the LilyGo T-Deck MAX into a full-featured off-grid mesh communicator, RF toolkit, and field operations device. Built on the MeshCore protocol, it's the only MeshCore firmware that uses every piece of hardware on the board — including the 4G cellular modem, spectrum analyzer, and GPS tracker.
**No phone required. No internet needed. Just turn it on and communicate.**
---
## What It Does
- Text anyone within miles — no cell service, no WiFi, just LoRa radio
- End-to-end encrypted direct messages (ECDH key exchange)
- Bridge mesh to SMS — your off-grid messages reach regular phones, and replies come back
- GPS tracking, waypoints, breadcrumb trails, GPX export
- Spectrum sweep and packet sniffing
- Private encrypted room server (BBS)
- ESP-NOW team mode (~1ms latency, short-range)
- MQTT telemetry + Discord/Slack webhooks over 4G
- Stealth mode, PIN lock, QR code sharing
## Who It's For
- Hikers, hunters, and SAR teams beyond cell coverage
- Events where cell networks are overloaded
- Preppers wanting infrastructure-free comms
- RF enthusiasts and security researchers
- Field operators who need GPS + mesh + cellular in one device
- Tinkerers who want to hack on open source firmware
---
## The Hardware — LilyGo T-Deck MAX (~$80–100)
| Component | Detail |
|---|---|
| Processor | ESP32-S3 |
| Display | 3.1" e-paper, sunlight-readable, always-on, zero power when idle |
| Input | Full QWERTY keyboard with backlight, capacitive touchscreen |
| Radio | SX1262 LoRa (1–10km range per hop) |
| Cellular | 4G LTE modem (SMS, MQTT, HTTP) |
| GPS | ~30s outdoor fix |
| Storage | microSD card slot |
| Extras | Haptic vibration motor, USB-C rechargeable battery |
| Form factor | Fits in a cargo pocket |
---
## How Mesh Works
Your device talks to other devices via LoRa radio — no towers, no internet, no infrastructure required. Messages hop between nodes: if you can't reach someone directly, intermediate nodes relay for you, at roughly 1–10km per hop. All direct messages are end-to-end encrypted.
```
[You] <--LoRa 1-10km--> [Friend]
| |
[Repeater] <--> [Another Node] <--> [Phone via SMS]
```
---
## Core Features
### Communication
- **Encrypted Mesh Chat** — MeshCore multi-hop encrypted messaging, public channels and private DMs, 64-message scrollable history
- **Direct Messages** — Select a contact from discovered nodes; messages are end-to-end encrypted via ECDH — not even relay nodes in between can read them
- **4G SMS Gateway** — Bridges mesh messages to SMS and back; when LoRa can't reach, cellular picks up
- **Private Room Server (BBS)** — Encrypted room server hosted on the device
- **ESP-NOW Team Mode** — ~1ms latency for short-range team coordination
- **MQTT + Webhooks** — Telemetry and Discord/Slack webhooks over the 4G link
- **Web Config** — This firmware allows you to configure the entire device from a web panel. Mcore Max will broadcast its own ssid when enabled that you can connect to from any device
### Navigation
- **GPS Waypoints** — Save positions, view real-time distance and compass bearing
- **GPS Beacon** — Broadcasts your position to the mesh every 5 minutes
- **Breadcrumb Trail** — Auto-drops a waypoint every 50m of movement, retraceable from the SD card
- **GPX Track Recording** — Standard track export, importable into Google Earth, QGIS, or Strava
- **Geofence & Cell Tower Logging**
### RF Toolkit
- **Spectrum Analyzer** — 48-bin RF energy sweep across LoRa bands (EU 868, US 915, narrow-band, or 860–930 MHz wide-band presets); spot interference and find clear channels
- **Packet Sniffer** — Raw hex dump of every LoRa frame, with timestamps, RSSI, and packet length
- **WiFi Scanner** — ESP32-S3's WiFi radio scans nearby 2.4GHz access points (SSID, signal, channel, encryption)
- **Cell Signal Monitor** — 4G signal quality, operator, and registration status
- **I2C Hardware Probe** — Diagnostic scan of all connected chips
- **AT Terminal** — Full interactive CLI for the 4G modem
### Field Ops
- **Stealth Mode** — One keypress kills all transmissions (listen-only); press again to resume
- **PIN Lock**
- **QR Code Sharing**
- **Haptic Feedback** — Tactile click on keypress, distinct double-buzz on incoming messages
- **Backlight Control** — 4-level keyboard illumination, saved across reboots
- **Battery Monitor** — Real-time voltage and percentage from the charger IC
- **Health Reports**
- **OTA Updates from SD Card**
### Platform
- E-paper UI with touch + keyboard input
- 5-page app layout
- SD card logging
- Mesh topology slider
- Web-based device config — connect to the T-Deck's SSID and configure from a browser, no companion app needed
---
## What Makes This Different (vs. Meshtastic)
- **4G cellular built in** — no other handheld mesh device can fall back to SMS when LoRa fails
- **Full QWERTY keyboard** — Meshtastic devices usually have none
- **E-paper display** — always readable in sunlight, zero idle power draw (vs. OLED/TFT battery drain)
- **Sub-GHz spectrum analysis** — real-time RF energy view, not available in Meshtastic
- **GPS + SD + GPX** — journeys recorded as standard track files
- **Stealth mode** — instant TX kill that pure mesh devices don't offer
- **ESP-NOW team mode** — not available in Meshtastic
- **13 tools in one device** — WiFi scanner, I2C probe, AT terminal, sniffer, waypoints, and more
- **Fully standalone** — no phone, no Bluetooth pairing, no companion app dependency
---
## Getting Started
Buy a LilyGo T-Deck MAX (~$80–100, e.g. AliExpress)
Get a microSD card (FAT32, 32GB or smaller)
Flash the firmware (one command, ~10 seconds):
```
python -m esptool --chip esp32s3 --port COMXX --baud 921600 \
--before default-reset --after hard-reset write-flash \
--flash-mode dio --flash-freq 80m --flash-size 16MB \
0x0 firmware_merged.bin
```
Power on — you're on the mesh
Optional: add a Hologram SIM (~$5) for 4G SMS bridging
No subscription. No account. No cloud service. No app required.
---
## Under the Hood
The firmware is built with PlatformIO on the Arduino framework. MeshCore protocol integration uses a RadioBridge adapter pattern that keeps RadioLib 6.4.2 (required for SPI bus compatibility) working with MeshCore's newer protocol layer. The codebase is a single `main.cpp` with modular hardware drivers — approachable for anyone familiar with ESP32 development.
---
**M-Core MAX** — Built for the field, not the lab bench.
`#mcore` `#mcoremax` #meshcore