Public Access
Fn+h on any screen, text fields included, and ? outside Text Entry, open a panel over the content area: the screen's own keys, then the ones that work everywhere. Every App declares its keys for the state it is in (pages, viewers, dialogs and text fields answer for themselves); the App manager opens the panel and takes every key while it is open. About 30 hint lines are gone, from every App. What stays on a screen is state. The first-start Setup keeps its hints and teaches the key; a device set up before gets one Toast, once. The guide and the FAQ open with it. `key help` over the consoles. 476 host tests (8 new). Checked on the device with key help and screenshots: the Launcher, all nine Apps and several of their states. 8.5 KB of flash and 40 bytes of static RAM. Decisions Q196 to Q203 in docs/milestones/U1.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
121 lines
5.0 KiB
C++
121 lines
5.0 KiB
C++
#include "setup_app.h"
|
|
|
|
#include "platform/identity.h"
|
|
#include "ui/fonts.h"
|
|
#include "ui/widgets.h"
|
|
|
|
namespace roro {
|
|
|
|
using Step = SetupWizard::Step;
|
|
|
|
SetupApp::SetupApp(Settings& settings, AppManager& apps)
|
|
: apps_(apps), wizard_(settings, identity::defaultLongName(), identity::defaultShortName()) {}
|
|
|
|
bool SetupApp::onKey(const KeyEvent& e) {
|
|
requestRedraw();
|
|
bool choosing = wizard_.choiceCount() > 0;
|
|
bool typing = wizard_.step() == Step::LongName || wizard_.step() == Step::ShortName;
|
|
switch (e.key) {
|
|
case Key::Select:
|
|
if (choosing) wizard_.selectChoice(choices_.selected());
|
|
if (wizard_.next()) {
|
|
if (wizard_.finished()) {
|
|
apps_.endModal();
|
|
return true;
|
|
}
|
|
choices_.setCount(wizard_.choiceCount());
|
|
if (wizard_.choiceCount()) choices_.select(wizard_.selectedChoice());
|
|
}
|
|
break;
|
|
case Key::Back:
|
|
case Key::Home:
|
|
wizard_.back();
|
|
choices_.setCount(wizard_.choiceCount());
|
|
if (wizard_.choiceCount()) choices_.select(wizard_.selectedChoice());
|
|
break;
|
|
case Key::Up: if (choosing) choices_.up(); break;
|
|
case Key::Down: if (choosing) choices_.down(); break;
|
|
case Key::Left: if (typing) wizard_.editor().left(); break;
|
|
case Key::Right: if (typing) wizard_.editor().right(); break;
|
|
case Key::Delete: if (typing) wizard_.editor().backspace(); break;
|
|
case Key::Char: if (typing) wizard_.editor().insert(e.ch); break;
|
|
default: break;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
void SetupApp::help(std::vector<KeyHelp>& out) const {
|
|
switch (wizard_.step()) {
|
|
case Step::LongName:
|
|
case Step::ShortName: help::textEntry(out, "next step"); break;
|
|
case Step::Region:
|
|
case Step::Timezone:
|
|
help::list(out, "choose it, next step");
|
|
out.push_back({"`", "the step before"});
|
|
break;
|
|
default:
|
|
out.push_back({"Enter", "continue"});
|
|
out.push_back({"`", "the step before"});
|
|
break;
|
|
}
|
|
}
|
|
|
|
// The one place that names keys on the screen (Q200): someone in their first minute doesn't know
|
|
// the help key yet, and this is where they learn it.
|
|
void SetupApp::draw(Canvas& c) {
|
|
const auto& area = theme::kContent;
|
|
auto heading = [&](const char* text) {
|
|
c.setFont(&fonts::bold);
|
|
c.setTextColor(theme::kAccent);
|
|
c.drawString(text, 4, area.y + 3);
|
|
c.setFont(&fonts::body);
|
|
};
|
|
auto note = [&](const std::string& text, int y, uint16_t color = theme::kMuted) {
|
|
auto lines = wrapText(text, area.w - 8, widgets::bodyMeasure(c));
|
|
c.setTextColor(color);
|
|
for (size_t i = 0; i < lines.size(); i++) c.drawString(lines[i].c_str(), 4, y + i * theme::kLineHeight);
|
|
};
|
|
|
|
switch (wizard_.step()) {
|
|
case Step::Welcome:
|
|
heading("Welcome to roro9stack");
|
|
note("Let's set up this device: your names on the mesh, your radio region and your timezone.",
|
|
area.y + 22, theme::kText);
|
|
note("One key to know: Fn + h lists the keys of the screen you're on.", area.y + 22 + 4 * theme::kLineHeight, theme::kAccent);
|
|
note("Enter: continue", area.y + area.h - 14);
|
|
break;
|
|
case Step::LongName:
|
|
heading("Long name (1/4)");
|
|
note("Shown to other mesh users. Up to 39 bytes.", area.y + 20);
|
|
widgets::lineEditor(c, wizard_.editor(), {4, area.y + 50, area.w - 8, 0});
|
|
break;
|
|
case Step::ShortName:
|
|
heading("Short name (2/4)");
|
|
note("Up to 4 characters, shown where space is tight.", area.y + 20);
|
|
widgets::lineEditor(c, wizard_.editor(), {4, area.y + 50, area.w - 8, 0});
|
|
break;
|
|
case Step::Region:
|
|
heading("Radio region (3/4)");
|
|
note("The radio only transmits once you confirm your region.", area.y + 18);
|
|
widgets::list(c, choices_, {0, area.y + 48, area.w, 4 * theme::kLineHeight},
|
|
[this](int i) { return wizard_.choiceLabel(i); });
|
|
note("Enter: I confirm I'm in this region", area.y + area.h - 14);
|
|
break;
|
|
case Step::Timezone:
|
|
heading("Timezone (4/4)");
|
|
widgets::list(c, choices_, {0, area.y + 20, area.w, 4 * theme::kLineHeight},
|
|
[this](int i) { return wizard_.choiceLabel(i); });
|
|
break;
|
|
case Step::Done:
|
|
heading("All set. One key to remember:");
|
|
note("Fn + h, on any screen, lists the keys that work there. No screen names its keys: that key does. Try it now.",
|
|
area.y + 22, theme::kAccent);
|
|
note("The rest can be changed later in Settings.", area.y + 22 + 4 * theme::kLineHeight, theme::kText);
|
|
note("Enter: start `: go back", area.y + area.h - 14);
|
|
break;
|
|
}
|
|
if (!wizard_.error().empty()) note(wizard_.error(), area.y + area.h - 14, theme::kWarning);
|
|
}
|
|
|
|
} // namespace roro
|