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
43 lines
1.3 KiB
C++
43 lines
1.3 KiB
C++
#pragma once
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "settings.h"
|
|
|
|
namespace roro {
|
|
|
|
// What the Settings App lists: one row per user-facing setting (plus sub-pages), with readable
|
|
// values, choice lists and validation messages. Rendering and navigation live in the App.
|
|
class SettingsMenu {
|
|
public:
|
|
enum class Row { LongName, ShortName, Region, Timezone, Brightness, DimTimeout, OffTimeout, Sound, Gnss, GnssQuiet, Coordinates, ProbeMacs, Wifi, CheckUpdates, Firmware, DebugConsole, About };
|
|
enum class Kind { Text, Choice, Toggle, Slider, Page };
|
|
|
|
explicit SettingsMenu(Settings& settings) : settings_(settings) {}
|
|
|
|
int count() const;
|
|
Row row(int i) const;
|
|
Kind kind(int i) const;
|
|
std::string label(int i) const;
|
|
std::string value(int i) const;
|
|
|
|
// Choice rows
|
|
std::vector<std::string> choices(int i) const;
|
|
int currentChoice(int i) const; // -1 if the current value isn't one of the choices
|
|
std::string choose(int i, int choice); // empty on success, otherwise why it was refused
|
|
|
|
// Toggle and Slider rows
|
|
void toggle(int i);
|
|
void adjust(int i, int direction);
|
|
|
|
// Text rows
|
|
int maxBytes(int i) const;
|
|
std::string setText(int i, const std::string& text); // empty on success, otherwise why
|
|
|
|
private:
|
|
Settings& settings_;
|
|
};
|
|
|
|
} // namespace roro
|