Repeater and Room Management

Repeaters and room servers can be managed remotely through the management interface.

Logging In

  1. Click a repeater or room contact in the contact list, or open their detail dialog and click Room Management or Repeater Management.
  2. Enter the device password. Optionally check "Save password" to remember it for future sessions.
  3. Meshy sends a login command and waits up to 15 seconds for a response.

Once logged in, the management interface opens with tabs for Status, CLI, Neighbors, Access Control (ACL), Regions, and Settings.

Status

Shows real-time operating data from the remote node:

  • Clock -- the repeater's current time. If the time is off by more than 5 minutes, a drift warning appears with a Sync button (admin only, only when the repeater clock is behind). If the clock is ahead, a Reset button appears instead (firmware rejects setting time backwards).
  • System -- battery (% and mV), uptime, message queue length, error events.
  • Radio -- last RSSI, last SNR, noise floor, TX/RX airtime, channel utilization, duty cycle.
  • Packets -- sent/received counts, receive errors, flood/direct breakdown, duplicate counts.

Click Refresh to request updated status (15-second timeout).

CLI Commands

An interactive command-line interface for the remote node:

  • Quick command buttons -- get name, get radio, get tx, ver, neighbors, advert, clock.
  • Command input -- type any CLI command and press Enter or click Send.
  • Output area -- displays command responses in a monospace text area.

Commands are sent as CLI data frames to the remote node.

Neighbors

Lists other nodes heard via zero-hop advertisements:

  • Each entry shows the node name (or key prefix), public key, time since last heard, and SNR.
  • Neighbors are fetched via binary requests.
  • Refresh button reloads the neighbor list. A Load More button fetches additional entries.
  • A Map button shows neighbors with known locations on the map.

Access Control (ACL)

Manage the repeater's access control list:

  • View allowed/blocked nodes by public key.
  • Add or remove entries.
  • ACL is fetched via binary requests.
  • Changes are sent back to the repeater for enforcement.

Regions

Query and configure available regions on the repeater:

  • Regions and the default scope are fetched via CLI commands (region, region default).
  • Shows region names. Regions can be added or removed.
  • Default Scope sets which region scopes all flood packets by default.
  • Click Apply to send region changes to the repeater.

Settings

Fetch and modify remote node configuration, organized into sections:

  • Basic -- device name, repeat mode. Admin and guest passwords can be changed separately.
  • Location -- latitude and longitude.
  • Radio -- frequency, bandwidth, spreading factor, coding rate, TX power.
  • Advert -- advertisement interval, flood advertisement interval.
  • Telemetry -- request current telemetry data from the repeater.
  • Danger Zone -- reboot the remote node (requires confirmation).

Each section has its own Fetch and Save buttons. Settings are fetched and saved via CLI commands (e.g., get name, set name, get radio, set radio).