Device

The Device view is the default screen after connecting. It shows information about your companion device and provides actions for managing it.

Device Information

  • Node Name -- the name your device advertises to other nodes.
  • Board -- hardware model (e.g., "Heltec V3").
  • Firmware -- version and build date.
  • Public Key -- your device's 64-character hex public key (click the copy button to copy it).
  • Telemetry -- current telemetry data (battery, environment sensors). Click the refresh button to request an update from the device.
  • Location -- the device's current GPS/advertised position, or "Not set". If coordinates are available, a "Show on Map" button appears.

Battery and Storage

  • Battery -- percentage and voltage (mV) with a visual progress bar

The state of charge does not decrease linearly as the voltage drops; therefore, Meshy uses a piecewise linear function with breakpoints at 100%/4.2V, 90%/4.0V, 10%/3.6V, 5%/3.5V, and 0%/3.0V. The MeshCore firmware uses a purely linear function, so the SoC values on the companion device may differ from those in Meshy. The values from Meshy should be more accurate, but even so, they should be considered only as a rough guide.

  • Storage -- percentage and used/total flash storage (KB) with a progress bar

Radio Configuration

Displays the current radio parameters:

  • Frequency (MHz), Bandwidth (kHz), Spreading Factor, Coding Rate, TX Power (dBm).
  • Default Path Hash Size -- how many bytes are used per hop in path routing (1, 2, or 3 bytes).

These are read-only here. To change them, go to Settings.

Statistics

Detailed radio and packet statistics. Click Refresh Statistics at the bottom of the section to update:

  • Uptime -- time since last reboot.
  • Message Queue -- number of messages waiting to be sent.
  • Noise Floor -- indicates the level of interference. The lower the better, but absolute values depend on the device, antenna etc. Click the chart button to open a live monitoring dialog that plots noise floor readings over time (updated every 2 seconds, showing the last 2 minutes).
  • Last RSSI -- stands for Received Signal Strength Indicator. It is a measurement of the power level of a received radio signal. RSSI > -70 dBm indicates a good signal. RSSI < -80 dBm indicates a poor signal. Click the chart button to monitor RSSI over time.
  • Last SNR -- stands for Signal-to-Noise Ratio. It is a measure used in wireless communications and electronics to compare the level of a desired signal (e.g., data being transmitted) to the level of background noise (unwanted interference). Click the chart button to monitor SNR over time.
  • TX/RX Airtime -- cumulative time spent transmitting (TX) and receiving (RX).
  • Packets -- counts for received, transmitted, flood, direct, and errors since last reboot.

Device Actions

Available in the sidebar:

  • Send Advert -- expandable section for broadcasting your presence and sharing contact info:
    • Zero Hop -- local broadcast to nearby nodes only.
    • Flood Routed -- relayed through the entire mesh.
    • To Clipboard -- copies your contact as a meshcore://contact/add?... URL to the clipboard, which others can import.
    • Show QR Code -- displays a QR code containing your contact information for easy scanning by other users.
  • Trace Path -- test a route by sending a trace packet through a sequence of hops you specify. Opens a dialog where you can:
    • Enter path hashes manually as comma-separated hex identifiers (e.g., aa,bb,cc for 1-byte mode). An auto-complete popover suggests known repeaters and rooms (from both saved and discovered contacts) as you type, matching by name or hex hash.
    • Pick on Map -- open an interactive map and click on repeater markers to visually build the route (available when repeaters have known locations).
    • Run Trace -- sends the trace packet. A spinner and "Tracing..." status are shown while waiting for a response (30-second timeout).
    • Results -- on completion, shows a hop-by-hop breakdown with node names (or hex hashes for unknown nodes) and SNR values between each hop. SNR is color-coded: green for good signal (>= 0 dB), dim for moderate (>= -5 dB), and red for poor (< -5 dB). A summary line shows total hop count and round-trip time. Click Show on Map to visualize the traced route as a dashed polyline with numbered markers and SNR labels.
    • Trace Path supports 1-byte and 2-byte path hash modes. 3-byte mode is not supported.
  • Discover Nearby Nodes -- 30-second scan for nodes broadcasting zero-hop advertisements. Shows node name, type, and SNR. Unknown nodes can be added to your contacts directly from the results.
  • Rx Log -- view raw received packet log with hash deduplication. Shows packet hashes, SNR values, and timestamps. Useful for debugging and monitoring network activity.
  • Reboot Device -- restarts your companion device (requires confirmation).