XNODE puts the tactical picture on your wrist.
XNODE turns LilyGO field hardware into a companion for XTOC and XCOM: offline maps, synced tactical markers, pushed alerts, and fast Meshtastic SOS or CheckIn packets on the T-Watch S3, T-Watch Ultra, T-Deck Plus, and T-Deck Pro.
Why XNODE exists
Phones and tablets are powerful, but they are not always the fastest tool in a moving operation. XNODE gives the operator a wearable tactical surface: check the map, see TOC alerts, send a routine position check-in, or trigger a high-priority SOS without digging out another device.
Device-ready common operating picture
XTOC and XCOM can install the active raster map onto the device and sync overlay markers for team members, mesh nodes, CHECKINs, SITREPs, CONTACTs, TASKs, assets, routes, zones, and more.
Two-tap field reporting
The firmware can transmit clear XTOC packet text over the Meshtastic radio for Manual SOS and CheckIn flows, using the configured roster Unit ID and current device location.
Local-first by design
Maps and overlay data live on the device. Synced overlays persist in watch flash and reload when the tactical map opens or the watch reboots.
Real watch screens, not vaporware.
The current firmware builds for the T-Watch S3, T-Watch Ultra, T-Deck Plus, and T-Deck Pro. Across the supported targets, XNODE exposes its BLE bridge, installs a compact basemap, displays operational overlays, and keeps alerts visible on the device.

Your field status at a glance
The Field Chronometer puts the clock and full date front and center, with battery and charging in the top bar and wireless status close by. Open Messages directly from home when its unread-message shortcut appears. Moon information appears on supported devices, and configured sensors can provide temperature and humidity.
The Mission Teal dark background continues through the launchers, settings and app screens. Color screens retain the light theme; T-Deck Pro uses a high-contrast monochrome layout.
Swipe left or right through Home, Apps, Setup and Notes. Page indicators show the occupied menu pages; tap an icon card or its caption to open a tool. Tool pages also move left/right, while lists and maps retain their normal scrolling and panning. Tap the top status bar for quick settings.
Icon colors group communications, navigation, power, alerts and system tools; they do not indicate connection or delivery status. Menu images are native firmware renderings with representative tool selections, without the global status bar. Page counts depend on installed tools.
Mesh Chat on handhelds and watches
Read incoming and outgoing channel messages, keep a draft for each channel, and compose from the conversation. Swipe left or right between CHAT and RADIO; scroll vertically through messages.
T-Deck Plus uses its physical keyboard. Both watches and the monochrome Pro use a separate full-screen text editor. The composer accepts up to 80 characters. The most recent 24 texts across channels stay in RAM until restart. SEND broadcasts to the selected channel; local TX completion is not proof of recipient delivery.
These are renderings of the actual firmware interface with illustrative example messages, without the global status bar. EXAMPLES starts on for first use; turn it off for live chat. PREVIEW never transmits and the saved choice is remembered. Native interaction tests cover all four layouts; physical watch operation and over-the-air delivery are separate checks.
T-Watch Ultra screens
The Field Chronometer home presents time, full date, power and wireless status at a glance. The home image is a firmware screen rendering with illustrative readings. The GPS and map photos show the related watch tools.
Mission Teal home with readable time, date and device status. Firmware rendering with illustrative readings; open the image for full size.
Receiver, UART, NMEA, fix, and satellite status on hardware.
Tactical map with current GPS position and synced overlay markers.
Installed basemap, overlay symbols, and visible GPS state on the watch.
XNODE on T-Deck Plus
The T-Deck Plus brings the Field Chronometer and XNODE tools to a larger 320×240 display. The physical keyboard and wider screen keep the core map, mesh, alert, GPS, SOS, and CheckIn workflows while making message entry, diagnostics, and the live tactical picture easier to use in the field.
Actual screen captured over USB from the flashed T-Deck Plus, with clock, date, battery, wireless status and moon information. Open the image for full size.
The T-Deck map now fills the larger workflow: synced XTOC/XCOM markers, readable controls, and a much better field view than the watch screen.
Colored controls for display, Wi-Fi, Bluetooth, time, battery and sound, with a page indicator.
Actual Mesh Chat screen captured over USB from the flashed T-Deck Plus. Examples ON supplies the illustrative conversation; this is not a radio-delivery claim.
Fast CHECKIN/LOC packet flow with current position.
XNODE running on T-Deck Pro
The T-Deck Pro pairs the monochrome Field Chronometer with XNODE tools on its portrait e-paper display. The home, Apps and Mesh Chat images are firmware renderings. Mesh composing uses the full-screen on-screen editor.
Supported T-Deck hardware
T-Deck support is built and tested as part of the same repository as the active watch firmware. Each handheld has its own board definition, hardware path, and Launcher-ready firmware output.
T-Deck Plus
- 320×240 LCD interface with touch and a physical I2C keyboard.
- GPS defaults on for map position and GPS time sync, with readable receiver diagnostics.
- Onboard SX1262 LoRa, SD, battery monitoring, and the shared BLE/XTOC/XCOM workflow.
- Display timeout keeps touch, keyboard, and LVGL responsive while GPS remains available.
- Built and flashed on attached hardware; broader field validation is still ongoing.
T-Deck Pro
- Portrait 240×320 e-paper interface with a dedicated local Pro hardware layer.
- HYN touch, tap and swipe navigation, plus TCA8418 physical keyboard input.
- DRV2605 haptic feedback, battery gauge reads, GPS, and the core launcher/map/message/mesh/alert flows.
- Full e-paper first paint with readable black-on-white status and main-screen styling.
- Built, flashed, and verified for boot, touch, and display; e-paper refresh is slower than LCD or AMOLED.
t-watch-ultra, t-watch2020-v3-s3, tdeck-plus, and tdeck-pro. Hardware-specific release filenames help prevent cross-flashing the wrong board.
Built for the X Suite workflow
XNODE is not another disconnected gadget. It is the wearable edge of the X Suite: XTOC drives the command picture, XCOM supports field communications, and XNODE carries the essentials on the operator’s wrist.
What XNODE does in the field
Tactical map on device flash
- Installs the active XTOC/XCOM raster basemap into SPIFFS.
- Persists center, zoom, and projection metadata.
- Scales the installed image while keeping markers aligned.
- Supports panning, zoom controls, and recenter behavior.
Overlay sync that survives reboot
- Stores synced markers in
/spiffs/osmmap/overlays.jsonl. - Reloads overlays when the map opens or the watch restarts.
- Uses transactional replacement so partial syncs do not wipe the live picture.
- Keeps up to 96 overlay marker slots on the device.
SOS over mesh
- Creates a clear XTOC
SITREPpacket. - Uses the device Unit ID, SOS destination, priority
P1, statusHELP, and current lat/lon. - Sends over the onboard Meshtastic service on the active channel.
Routine CheckIn
- Creates a clear XTOC
CHECKIN/LOCpacket. - Reports Unit ID,
OKstatus, current lat/lon, and timestamp. - Gives operators a fast accountability signal without opening a phone or tablet.
Source, build, and ecosystem links
GitHub source
Firmware source, board config, PlatformIO environments, hardware photos, and current implementation notes.
Key code areas
BLE bridge | watch map app | support tools
Useful for developers who want to audit how maps, overlays, and packet shortcuts are wired.
Hardware targets
LILYGO T-Watch S3 hardware listing
T-Watch S3 and Ultra targets, T-Deck Plus with its larger LCD, keyboard, GPS, SD, and SX1262 path, plus the portrait e-paper T-Deck Pro with touch, keyboard, haptics, battery gauge, and GPS support.
Complete the stack
XTOC
Command-center software for SITREPs, TASKs, CHECKIN/LOC, map overlays, zones, SATCOM, ATAK/KML/CoT workflows, and packet-based field coordination.
XCOM
Offline-first radio and mapping toolkit with packet workflows, repeaters, mesh, Reticulum, APRS/D-STAR, field maps, and XNODE watch integration.
XCORE + XINTEL
Add a local AI analyst and a radio-intel watch layer for teams that need monitoring, summaries, anomaly scans, and operational escalation.
Operational note
XNODE is a firmware project for compact LilyGO field hardware and a companion workflow for the X Suite. The current flash-map mode is intentionally compact: one installed raster basemap with synced overlays, not a full multi-tile slippy map engine. That tradeoff keeps the workflow useful inside tight flash, RAM, battery, and screen constraints.
FAQ
Does XNODE replace XTOC or XCOM?
No. XNODE is the wearable edge. XTOC and XCOM remain the larger planning, mapping, packet, and radio workflow tools.
Does XNODE work offline?
The device can display the installed basemap and persisted overlays from flash. Syncing new maps, markers, unit settings, and pushed alerts happens through the companion XTOC/XCOM bridge.
Does the SOS button send through the phone?
No. Manual SOS builds a clear XTOC SITREP packet and hands it to the watch Meshtastic service for transmission on the active mesh channel.
Is it open source?
The active firmware source is published at github.com/MKme/xnode.






