Public Access
twislaandClaude Opus 5.5
c68741cc46
There is no Debug Build any more (ADR 0010, issue #68, Q188 to Q195). The console and the test commands are compiled into every firmware. It listens only while Settings > Debug Console is on, which isn't the default; off, neither its task nor its 4 KB ring exists. The token is made by the device and shown on that page; a client proves it knows it by answering a challenge with an HMAC, so it never crosses the network, and five wrong answers close the console for a minute. DBG in the Status Bar while it listens. Over USB serial only: debug on, debug token <value>, debug token new. scripts/flash.sh --debug uses them to set a device up with the developer's token. scripts/rdbg.py takes the token from -t, $RORO_DEBUG_TOKEN or the file, answers the challenge, and fetches a release's ELF to decode a crash. Gone: the cardputer-adv-debug environment, RORO_DEBUG, the +debug version, scripts/debug_flags.py, update install ... force, and the rule that a Debug Build doesn't install releases. Old clients and old firmwares don't talk to each other. Against the builds it replaces: 30 KB more flash and 88 bytes more static RAM than the release, 4 KB less RAM than the Debug Build. 468 host tests. Checked on the device: off by default, login, the pause after wrong tokens, Safe Mode with the console, the setting surviving an update, debug off. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
44 lines
2.9 KiB
Markdown
44 lines
2.9 KiB
Markdown
+++
|
|
title = "Settings"
|
|
description = "The device's names, region, screen, sound, GNSS and Wi-Fi, and where firmware updates are found."
|
|
weight = 10
|
|
[extra]
|
|
tag = "Settings"
|
|
+++
|
|
|
|
Move with the arrows. On a toggle, a choice or a slider, left and right change the value; <kbd>Enter</kbd> opens a text field or a list of choices, or a page marked `>`. Back leaves.
|
|
|
|
| Setting | What it is |
|
|
|---|---|
|
|
| **Long name**, **Short name** | The names you gave in the first-start Setup (up to 39 bytes, and up to 4 characters) |
|
|
| **Region** | The regulatory region; EU868 |
|
|
| **Timezone** | For the clock and the dates in file names |
|
|
| **Brightness** | A slider |
|
|
| **Dim after**, **Screen off after** | Screen timeouts. Dimming must come before the screen turns off |
|
|
| **Sound & LED** | The beep and the flash on a [Toast](/guide/basics/) |
|
|
| **GNSS** | Switches the receiver on and off (see [GNSS](/guide/gnss/)) |
|
|
| **Pause GNSS for LoRa** | Puts the receiver on standby while the radio listens (see [LoRa Scanner](/guide/lora-scanner/)) |
|
|
| **Coordinates** | Decimal degrees, or degrees, minutes and seconds |
|
|
| **Wi-Fi** | The page below |
|
|
| **Check for updates** | Once a day, see [Updates](/guide/updates/) |
|
|
| **Firmware** | The page described in [Updates](/guide/updates/) |
|
|
| **Debug Console** | Off 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](/dev/debug/switch-it-on/). Leave it off if that means nothing to you |
|
|
| **About** | The 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. <kbd>Enter</kbd> 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. <kbd>Enter</kbd> on **Status** shows what is in use and where each value came from.
|