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
2.9 KiB
+++ 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; Enter 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 |
| GNSS | Switches the receiver on and off (see GNSS) |
| Pause GNSS for LoRa | Puts the receiver on standby while the radio listens (see LoRa Scanner) |
| Coordinates | Decimal degrees, or degrees, minutes and seconds |
| Wi-Fi | The page below |
| Check for updates | Once a day, see Updates |
| Firmware | The page described in 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. 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. 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.