User guide · Settings

Settings

The device's names, region, screen, sound, GNSS, Wi-Fi and VPN, and where firmware updates are found.

Settings, in five groups: This device, Display, GNSS and radio, Network and System
Settings
Settings, Display: Brightness 100 percent, Dim after 30 s, Screen off after 1 min, Theme roro9stack, Light or dark: Dark, Launcher: Grid
Settings, Display

Settings opens on five groups. Enter opens a group, and Back returns to the groups; Back from the groups leaves Settings.

Inside a group, move with the arrows. On a toggle, a choice or a slider, left and right change the value; Enter opens a text field or a list of choices, or a page marked >.

This device

SettingWhat it is
Long name, Short nameThe names you gave in the first-start Setup (up to 39 bytes, and up to 4 characters)
RegionThe regulatory region; EU868
TimezoneFor the clock and the dates in file names
Sound & LEDThe beep and the flash on a Toast

Display

SettingWhat it is
BrightnessA slider
Dim after, Screen off afterScreen timeouts. Dimming must come before the screen turns off
ThemeThe colours of every screen: roro9stack (the website's), Catppuccin, Dracula, Nord, ANSI terminal, Gruvbox or Solarized
Light or darkWhich side of the theme: every one has both
LauncherThe home screen as a Grid of icons or a List of names (see The basics)

GNSS and radio

SettingWhat it is
GNSSSwitches the receiver on and off (see GNSS)
Pause GNSS for LoRaPuts the receiver on standby while the radio listens (see LoRa Scanner)
MeshOff, Listening (the default: it hears the mesh in the background, and transmits nothing) or Sending (it also sends; needs the Region confirmed). See Mesh
Mesh soundSilent (the default): a mesh message shows as a Notification without the tone or the LED. On: like any other
Mesh positionWhat the device's adverts give of where it is: Not sent (the default), Exact, or Rounded to about 1 km
CoordinatesDecimal degrees, or degrees, minutes and seconds
Probe MACsWhether the Wi-Fi Tools' logs of probe requests keep the addresses as they are (Raw) or Pseudonymised

Network

SettingWhat it is
Wi-FiThe page below
VPNA WireGuard tunnel: its switch, "Start with Wi-Fi", and importing its configuration from the card. See VPN
BluetoothFor the MeshCore app on a phone: the switch (on takes a restart), the paired phone, and forgetting it. See Bluetooth

System

SettingWhat it is
Check for updatesOnce a day, see Updates
Install updatesWhen asked (the default), or By itself: a newer release is installed in a quiet moment, after a question that answers itself in 30 seconds. See Updates
FirmwareThe page described in Updates
Debug ConsoleOff unless you switch it on. It lets a PC on the same network read the device's console and drive it, with a token shown on this page: see the developer docs. Leave it off if that means nothing to you
AboutThe firmware version, the node number, battery, memory, uptime, clock and licence

Wi-Fi

Wi-Fi on its own page switches the radio on and off. The page also has:

  • Status: whether it is searching, joining, or connected, and to what.
  • Add a network: scans, lets you pick one, and asks for the password (leave it empty for an open network). Add a hidden network asks for the name first.
  • DNS and NTP: see below.
  • Your saved networks. The device joins one on its own whenever it is in range, the strongest first. Enter on a network opens its page.

An address by hand

A network normally gives the device its address by itself (DHCP, Automatic). On a network without DHCP, open its page and set IP address to Fixed: then it takes an address, a prefix (24 is 255.255.255.0) and an optional gateway. Switching to Fixed starts from what the network is giving the device at that moment, and the setting is checked and applied when you leave the page. IPv4 only. Forget this network is on the same page.

DNS and NTP

Two DNS servers (9.9.9.9 and 1.1.1.1 by default), used on Fixed networks, or on every network if Always use my DNS is on; and two NTP servers (pool.ntp.org and time.cloudflare.com), used after any that the network's DHCP offers. Enter on Status shows what is in use and where each value came from.

The keys, as the device lists them

What Fn + h shows on these screens. These tables are generated from the firmware's own lists, so they are always the current ones.

Settings, VPN

Enterswitch, import, forget
; .up, down

Settings

; .up, down
Enteropen the group or the page, or edit
, /change a switch or a slider
`back to the groups

Settings, a choice

; .up, down
Enterchoose it

Settings, Wi-Fi

; .up, down
Enteropen, or change
, /switch Wi-Fi on or off

Settings, DNS and NTP

; .up, down
Enteredit
, /Always use my DNS: on, off

Settings, a saved network

; .up, down
Enteredit, or forget
, /Automatic or Fixed

Settings, the Wi-Fi status

Enterback

Settings, adding a network

; .up, down
Enterchoose this network

Settings, a hidden network's name

Enternext: the password
`cancel
Deldelete backwards
Fn , /move the cursor

Settings, Debug Console

; .up, down
Enterswitch, or open
, /switch the console on or off

Themes

A theme changes the colours and nothing else: the fonts and the layout stay. It applies at once, to every App, and is kept across restarts.

The screen shows 256 colours, so a theme here is the nearest the screen can do to the palette it is named after, not an exact copy: pale backgrounds turn white or cream, and dark ones turn a deep blue or olive. Each theme is checked for contrast after that rounding.

Three things keep their own colours whatever the theme: the SSH terminal (the 16 colours a remote program asks for), the Sweep's waterfall (its colours are a scale of signal strength), and pictures.