Skip to content

Repeater & Room Server CLI Reference

ripplebiz edited this page Aug 29, 2025 · 22 revisions

You can configure both Repeater and Room Server devices either via Serial (and terminal app/putty/Serial Monitor), or via the T-Deck CLI screen.

Serial-only commands:

set freq {frequency}

example: set freq 915.8

time {epoch-secs}

example: time 1738242833

erase

Completely erases the device's local file system.

log

Show complete packet log contents.

Commands via Serial or Remote

advert

Sends an advertisement packet

reboot

Reboots the device. (note, you'll prob get 'Timeout' which is normal)

clock

Displays current time per device's clock.

password {new-password}

Sets a new admin password for the device.

set af {air-time-factor}

Sets the air-time-factor.

set tx {tx-power-dbm}

Sets LoRa transmit power in dBm. (reboot to apply)

set repeat {on|off}

Enables or disables the repeater role for this node.

set allow.read.only {on|off}

(Room server) If 'on', then login in blank password will be allowed, but cannot Post to room. (just read only)

set flood.max {max-hops}

Sets the maximum number of hops of inbound flood packet (if >= max, packet is not forwarded)

set int.thresh {db}

Sets the Interference Threshold (in DB). Default is 14. Set to 0 to disable channel interference detection.

set agc.reset.interval {seconds}

Sets the interval to reset the Auto Gain Controller. Set to 0 to disable.

set multi.acks {0|1}

Enables or disables the 'double ACKs' feature.

set advert.interval {minutes}

Sets the timer interval in minutes to send a local (zero-hop) advertisement packet. Set to 0 to disable.

set flood.advert.interval {hours}

Sets the timer interval in hours to send a flood advertisement packet. Set to 0 to disable.

set guest.password {guess-password}

Sets/updates the guest password. (for repeaters, guest logins can send the 'Get Stats' request)

set name {name}

Sets the advertisement name.

set lat {latitude}

Sets the advertisement map latitude. (decimal degrees)

set lon {longitude}

Sets the advertisement map longitude. (decimal degrees)

set radio {freq},{bw},{sf},{cr}

Sets completely new radio params, and saves to preferences. Requires a "reboot" command to apply.

log start

Starts packet logging to file system.

log stop

Stops packet logging to file system.

log erase

Erases the packet logs from file system.

ver

Shows the device version and firmware build date.

neighbors

(Repeater only) Shows a list of other repeater nodes heard via zero-hop adverts. Each line is {id-prefix-hex}:{timestamp}:{snr-times-4}

neighbor.remove {pubkey-prefix}

(Repeater only) Removes first matching entry (by pubkey prefix (hex)), from neighbors list.

clear stats

Resets various stats counters to zero.

tempradio {freq},{bw},{sf},{cr},{minutes}

Sets temporary radio params for the given number of {minutes}, reverting to original radio params afterward. (does NOT save to preferences).

Commands only via T-Deck

clock sync

Syncs device's clock with T-Deck's clock

Clone this wiki locally