Ratspeak for T-Deck Plus
The T-Deck Plus is supported by Ratspeak Handheld, the shared successor to rsDeck, rsPager, and rsCardputer. This page describes Ratspeak Handheld 2.3.5 beta. The full image boots a small launcher that can start either mode:
- Standalone — on-device Reticulum/LXMF messaging over LoRa, with local identity, contacts, messages, radio settings, Wi-Fi options, GPS time sync, and SD-card storage support.
- RNode — a host-controlled RNode-style radio for Ratspeak, Sideband, or another Reticulum client over BLE or USB serial.
For the smaller modular handheld, see Cardputer Adv. Both speak Reticulum/LXMF and can exchange messages when their radio settings and reachable paths match.
Hardware
The LilyGO T-Deck Plus has an ESP32-S3, 320×240 display, QWERTY keyboard, trackball, integrated LoRa radio, battery, and GPS. Choose hardware and an antenna suited to the frequency band you will use. An SD card is optional for normal messaging.
Get the firmware on your device
Use tdeck-full.bin from
Ratspeak Handheld releases
for a fresh installation. The advanced flasher
accepts the complete .bin on its Upload tab. For an automatic download, use
Flash in browser on the download page
and check that the installer shows Ratspeak Handheld.
Back up your identity and data first. Compatible web flasher updates keep identity, messages and settings; a factory installation clears internal storage after you accept the flasher's backup notice. See the backup instructions before replacing an existing installation.
If you'd rather build from source, see the bottom of this page. For recovery mode, serial verification, and post-flash checks, see Flashing Firmware.
Modes
Use the full image to switch modes on-device. Choose Standalone for messaging
on the T-Deck, or RNode to connect it to a host client. Standalone-only and
RNode-only packages install a single mode: tdeck-full.bin,
tdeck-standalone.bin and tdeck-rnode.bin are complete images for the web
flasher or esptool. For
bmorcelli's Launcher, use
tdeck-standalone-launcher.bin. Follow the linked guide for Launcher storage limits and backup precautions before changing partitions.
First boot
On a fresh installation, Standalone mode creates a Reticulum identity and asks
for a display name and timezone. Share your Ratspeak contact QR to include your
name, address, identity, and public key. Legacy shows the lxma:// address-and-key
QR that Columba, MeshChatX, and other LXMF apps scan.
What you can do on it
Five tabs along the bottom, navigated with touch or the trackball:
- Home — identity and device controls. Select Announce to advertise your identity to reachable peers.
- Chats — your inbox. Open a thread to read or reply.
- Contacts — saved peers. Select a contact to open its chat.
- Peers — discovered messaging peers. Open one to Save Contact or Message.
- Settings — radio config, network mode, region, and device options.
To remove a saved contact, focus it with the trackball, hold the trackball button, then press Enter to confirm. Backspace keeps the contact.
For a custom frequency, open Settings → Device → Developer Radio Controls, then hold the trackball button as prompted to unlock the custom fields. Return to Settings → LoRa → Frequency. Use A/D (or left/right) to choose a digit and the trackball up/down to tune it. Press Enter to save; hold the trackball button or use the visible cancel control to discard the edit. Comma/slash also move between digits while editing.
The handheld guide explains saved drafts, delivery states, long-message/history navigation and storage recovery.
LoRa presets
New and reset radio settings use Medium Fast. Saved presets are retained. Match the frequency and preset with the peers you want to reach; a shared preset name alone does not establish a connection. Radio controls are in Settings.
Europe (EU868) uses 868.000 MHz (868000000 Hz). With Medium Fast, use
250 kHz bandwidth, SF9, coding rate 4/5 (5), 17 dBm TX power and an
18-symbol preamble. The link preset does not change frequency. For all regional
frequencies and saved-setting behavior, see the
handheld radio settings.
For the full preset table and tuning guidance, see LoRa Radio Interfaces.
Regions
Choose a radio region supported by your hardware and permitted where you use it. A timezone setting does not change the radio's hardware band or automatically select a legal frequency. Check the region and frequency before transmitting, and keep transmit power and duty cycle within local limits; presets do not limit either.
Wi-Fi bridging
Choose Client or Hotspot in Settings; the two modes are mutually exclusive.
Client joins an existing Wi-Fi network. Configure a TCP peer to reach a remote Reticulum network; no public server is selected automatically.
Hotspot creates a local Wi-Fi network with a Reticulum TCP bridge for a nearby host client. It provides a path through the handheld's radio, not an Internet connection for the connected computer.
Build from source
Use the shared build instructions
with DEVICE=tdeck. The Reticulum/LXMF core is Rust; normal builds use the
included libraries, with C++ hardware and user-interface code.
Legacy rsDeck
Older microReticulum-based releases and their source remain in
ratspeak/rsDeck. Current unified images use the tdeck- prefix; the rsdeck- names belong to
older releases. Check the repository and version before choosing an image, and
do not assume their partition layouts are interchangeable.
License
The standalone firmware and launcher are under the Reticulum License, as is the bundled protocol core, a port of Mark Qvist's Reticulum and LXMF that carries his copyright (see Licenses). Voice memos use rsLXST under Mark Qvist's separate LXST license, so images that include them are non-commercial. Bundled RNode firmware retains its GPLv3 license. See the repository's third-party notices.