Flashing firmware

Install Ratspeak Handheld on T-Deck Plus, T-Pager, Cardputer Adv or ThinkNode M9. Firmware is available from the download page and GitHub releases.

Before flashing

Installing a firmware ZIP resets internal storage. Back up your device and SD card if you want to keep your identity, messages or settings. A full backup restores the previous installation; it does not transfer that data into a new one. See backup instructions below.

Attach a suitable LoRa antenna before powering the radio. Transmitting without one can damage it.

Choose a package

• Full includes Standalone and RNode, with a launcher to choose between them.
• Standalone is the on-device messenger, using LoRa or WiFi.
• RNode turns the handheld into a radio for a Reticulum client over USB or BLE.

T-Deck, T-Pager and Cardputer offer all three packages. M9 offers Standalone; RNode support is coming soon. Download the ZIP for your device:

Device	Example download
T-Deck Plus	tdeck-full.zip
T-Pager	pager-standalone.zip
Cardputer Adv	cardputer-rnode.zip
ThinkNode M9	m9-standalone.zip

The separate .bin downloads contain only the application. They require a compatible launcher or the correct application slot and partition layout. Use the ZIP for a complete installation.

Web flasher

Use Chrome or Edge on a computer, with a USB data cable.

1. Open the download page, select your device, then Flash in browser.
2. Check the package and version. M9 supports Standalone only.
3. Connect the device and choose Select USB Device. If it does not connect, try download mode.
4. Select Flash Ratspeak and confirm the device and erase notice. Keep USB connected until flashing finishes, then restart the device if needed.

To use a ZIP you already downloaded or built, choose Flash under Build your own and upload it.

ThinkNode M9

To install M9 firmware from a terminal, download m9-standalone.zip and extract it into an empty directory. Use the factory image inside the ZIP; the separate application download has the same filename but cannot be installed at this address.

Install esptool with python3 -m pip install esptool==5.2.0. Back up any data you want to keep, then connect USB with the power switch on. Close any serial monitor, replace PORT with the M9's serial port, and run these commands from the extracted folder:

python3 -m esptool --chip esp32s3 --port PORT --baud 115200 erase-flash
python3 -m esptool --chip esp32s3 --port PORT --baud 115200 write-flash 0x0 m9-standalone.bin

Leave power connected until writing and verification finish. If no serial port appears, check the cable and your WCH driver.

Backups

Back up an existing handheld

1. Switch off the device and copy its SD card to your computer, if fitted.
2. Install esptool: python3 -m pip install esptool==5.2.0.
3. Connect the device in download mode. Close the web flasher and any serial monitor. Replace PORT with its serial port and use a new backup filename for each device:

python3 -m esptool --chip esp32s3 --port PORT --after no-reset read-flash 0 ALL handheld-backup.bin
python3 -m esptool --chip esp32s3 --port PORT --after no-reset verify-flash 0 handheld-backup.bin

Both commands must succeed. Check the backup size before proceeding:

Device	Backup size
T-Deck Plus, T-Pager, ThinkNode M9	16,777,216 bytes (16 MB)
Cardputer Adv	8,388,608 bytes (8 MB)

Keep the backup and SD copy private: they contain identity keys and may contain WiFi passwords. Keep the original SD card aside during a fresh installation.

Keep an existing identity

If you have your identity's 64-byte private key file, T-Deck, T-Pager and M9 can import it from an SD card:

Device	File path on SD
T-Deck Plus	/ratdeck/identity/import.identity
T-Pager	/ratpager/identity/import.identity
ThinkNode M9	/m9/identity/import.identity

Insert the card, open Settings → Identity & Device → Import Identity, then select the imported Identity Slot. The device restarts with that identity. Check its address and remove the key file from the card.

Importing an identity does not restore messages, contacts or settings. There is no identity-export menu, and a contact QR does not contain the private key. Cardputer does not have this import menu; use a full backup to recover its existing installation.

Return to your backup

Connect the same device in download mode and write back its full backup:

python3 -m esptool --chip esp32s3 --port PORT --after no-reset write-flash 0 handheld-backup.bin
python3 -m esptool --chip esp32s3 --port PORT --after no-reset verify-flash 0 handheld-backup.bin

After both commands succeed, switch off, restore the matching SD copy and restart. This replaces the current installation with the saved firmware and data.

Recovery (download mode)

• T-Deck Plus: connect USB with the main power off. Hold the trackball button, switch the power on, then release the button after a few seconds.
• T-Pager: hold BOOT, tap RST, then release BOOT when the computer detects the device. PWR is the separate power button.
• Cardputer Adv: switch the side power off, hold G0 while connecting USB, then release it.
• ThinkNode M9: leave the power switch on and USB connected. Esptool enters download mode automatically; use --baud 115200.

The screen may stay black in download mode. Entering it does not erase data.

After installation

A Full installation opens the launcher; single-mode packages start directly. In Standalone, complete the name and timezone setup, check the radio settings, and send a message to a reachable peer.

If startup fails, note the error and collect a serial log at 115200 baud before reflashing. See Handheld recovery for interrupted resets or storage problems.

Build from source

Follow the build instructions for your device. Packaged ZIPs are written to dist/.

Legacy firmware

Earlier builds remain in rsDeck, rsPager and rsCardputer. Use their own installation instructions; their firmware and partition layouts differ from Ratspeak Handheld.

RNode (rnodeconf)

For boards supported by upstream RNode firmware, such as Heltec or T-Beam, install Reticulum and run its installer:

python3 -m pip install rns
rnodeconf --autoinstall

Follow the prompts to select and install firmware. To inspect or update an existing RNode, replace PORT with its serial port:

rnodeconf PORT --info
rnodeconf PORT --update

For Ratspeak Handheld, use the device's RNode or Full package above.