Repeater & Room Server CLI Reference

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.

get acl

Show list of authorised nodes in the Access Control List.

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.

set rxdelay {base}

Sets (experimental) base (must be > 1 for effect) for applying slight delay to received packets, based on signal strength/score. Set to 0 to disable.

set txdelay {factor}

Sets a factor multiplied with time-on-air for a flood-mode packet and with a randomized slot system, to delay its forwarding. (to decrease likelihood of collisions)

set direct.txdelay {factor}

Same as txdelay, but for applying a random delay to the forwarding of direct-mode packets.

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).

setperm {pubkey-hex} {permissions}

Modifies the ACL. Removes matching entry (by pubkey prefix) if 'permissions' is zero. Adds new entry if pubkey-hex is full length and is not currently in ACL. Updates entry by matching pubkey prefix. Permission bits vary per firmware role, but low 2 bits are: 0 (Guest), 1 (Read only), 2 (Read write), 3 (Admin)

Commands only via T-Deck

clock sync

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