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.

set bridge.enabled {on|off}

Enable/Disable bridge.

set bridge.delay {0-10000}

Set delay before retransmitting packets.

set bridge.source {rx|tx}

Choose wether the bridge will retransmit received packets or transmitted packets.

set bridge.baud {speed}

Set serial link baudrate for rs232 bridges.

set bridge.secret {shared-secret}

Set bridge secret for espnow bridges.

get bridge.type

Gets bridge type none, rs232, espnow

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)

GPS management

gps command has been introduced to manage location related topics.

gps

Gives status of gps. When gps is off, it replies only off, if on it replies with on, {status}, {fix}, {sat count}

gps {on|off}

Toggles gps power state.

gps sync

Syncs node time with gps clock.

gps setloc

Sets node's position to gps coordinates and save preferences.

gps advert

Gives location advert configuration of the node:

• none: don't include location in adverts
• share: share gps location (from SensorManager)
• prefs: advert the location stored in preferences

gps advert {none|share|prefs}

Sets location advert configuration.

Commands only via T-Deck

clock sync

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