Public Access
mangavalkandClaude Opus 5.5
490cefc360
- net/ha_api: the HTTP requests run in a FreeRTOS task on core 0; loop()
only hands over copies through queues. The web UI's test button polls.
No more 3-4 s loop() stalls once a minute; timeout raised to 5 s.
- Progress bar page element (page format 4, v3 pages are converted)
- Plex user setting (settings v6): {plex_user} in entity ids
- Plex page (examples): watchers, play/pause icon, title, progress
- Bitmaps cached in RAM: a LittleFS read took ~100 ms on every render
and web preview; long JSON lists sent in 2 KB pieces
- Backup includes the refresh settings and the Plex user
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
105 lines
4.0 KiB
C
105 lines
4.0 KiB
C
#pragma once
|
|
|
|
#include <stdint.h>
|
|
|
|
#include "logic/builtin_pages.h"
|
|
#include "logic/page.h"
|
|
|
|
// Everything that can be changed in the web UI. Stored in NVS (system/settings_store),
|
|
// the defaults are the original behaviour. Pure logic, tested in test/test_esp32.
|
|
//
|
|
// Times are minutes since midnight (8:00 = 480).
|
|
|
|
struct ScheduleSettings
|
|
{
|
|
bool enabled = true; // false: the display is always on
|
|
uint16_t day_start = 8 * 60; // display on from
|
|
uint16_t late_start = 22 * 60; // from here only at the quarter hours (see quarter_hours)
|
|
bool quarter_hours = true; // false: on all the time until night_start
|
|
uint16_t night_start = 23 * 60 + 31; // display off from (up to 24:00 = never)
|
|
};
|
|
|
|
struct ClockSettings
|
|
{
|
|
bool no_wifi_screen = true; // "No WiFi" instead of a dynamic page when WiFi is down
|
|
};
|
|
|
|
struct HomeAssistantSettings
|
|
{
|
|
bool enabled = true;
|
|
char host[64] = ""; // empty: BROKER_ADDR from secrets.h
|
|
uint16_t port = 1883;
|
|
char user[32] = "";
|
|
char password[64] = "";
|
|
// Values for the dynamic pages, read over Home Assistant's REST API (net/ha_api)
|
|
char api_url[96] = ""; // empty: http://<MQTT broker>:8123
|
|
char token[256] = ""; // long-lived access token (HA user profile, Security)
|
|
};
|
|
|
|
// How the Nano drives the dots (besides the flip time). Sent to the Nano, which keeps
|
|
// them in its EEPROM. The defaults match the Nano's (src/nano/config.h).
|
|
const uint8_t DRIVE_EFFECT_INSTANT = 0; // numbers: RefreshEffect in lib/BROSE9323/dot_sequence.h
|
|
const uint8_t DRIVE_EFFECT_PUSH = 8;
|
|
const uint8_t DRIVE_EFFECT_RANDOM = 9;
|
|
const uint8_t DRIVE_EFFECT_COUNT = 10;
|
|
// Pushing flips many dots per column step, so it can take much longer than effect_time
|
|
const uint32_t DRIVE_PUSH_EXTRA_TIME = 20000;
|
|
|
|
struct DriveSettings
|
|
{
|
|
uint16_t flip_gap = 200; // pause after each pulse in us (0-5000)
|
|
uint8_t pulses = 2; // pulses for each changed dot (1-3)
|
|
uint8_t effect = DRIVE_EFFECT_INSTANT;
|
|
uint16_t effect_time = 1500; // ms (100-10000)
|
|
bool effect_small_only = false; // big changes (a new page) appear instantly
|
|
};
|
|
|
|
// Full redraws that fix the picture, in minutes (0 = never)
|
|
const uint16_t REFRESH_MINUTES_MAX = 1440;
|
|
struct RefreshSettings
|
|
{
|
|
// The Nano flips every dot once more (fixes dots that didn't flip). Sent to the Nano,
|
|
// which keeps it in its EEPROM (I command, default there: 2).
|
|
uint16_t dots = 2;
|
|
// The ESP32 sends the whole image again (fixes a wrong image on the Nano, e.g. after
|
|
// lost bytes). Only the dots that differ flip, so a correct image doesn't change.
|
|
uint16_t image = 10;
|
|
};
|
|
|
|
// What is shown during the day: the name of a dynamic page (logic/page.h) or a bitmap.
|
|
// Both share one namespace. When it is gone, the built-in Clock page is shown.
|
|
#define DEFAULT_PAGE BUILTIN_PAGE_CLOCK
|
|
// What is left on the dots when the display switches off: empty = blank, or a bitmap name
|
|
#define OFF_PAGE_BLANK ""
|
|
|
|
struct Settings
|
|
{
|
|
char page[PAGE_NAME_SIZE] = DEFAULT_PAGE;
|
|
ScheduleSettings schedule;
|
|
ClockSettings clock;
|
|
HomeAssistantSettings home_assistant;
|
|
uint16_t flip_time = 225; // flip pulse length in us, sent to the Nano
|
|
bool status_led = true;
|
|
char off_page[PAGE_NAME_SIZE] = OFF_PAGE_BLANK;
|
|
DriveSettings drive;
|
|
RefreshSettings refresh;
|
|
// Plex user name for {plex_user} in entity ids (Tautulli's sensors of that user)
|
|
char plex_user[PLEX_USER_SIZE] = "";
|
|
// New fields go here, at the end (see system/settings_store.cpp)
|
|
};
|
|
|
|
// How long a new frame can take to appear on the dots in ms (0 when instant)
|
|
uint32_t effectTime(const DriveSettings &drive);
|
|
|
|
const uint16_t MINUTES_PER_DAY = 24 * 60;
|
|
const uint16_t SETTINGS_FLIP_TIME_MIN = 50;
|
|
const uint16_t SETTINGS_FLIP_TIME_MAX = 2000;
|
|
|
|
// Checks the values. Returns nullptr when they are fine, otherwise a message for the user.
|
|
const char *validateSettings(const Settings &settings);
|
|
|
|
// "HH:MM" (00:00 - 24:00) <-> minutes since midnight
|
|
bool parseTime(const char *text, uint16_t &minutes);
|
|
// out must hold 6 characters
|
|
void formatTime(uint16_t minutes, char *out);
|