mirror of
https://github.com/MarekZegare4/MeshCore-Solo.git
synced 2026-07-26 14:58:12 +00:00
87bdc5cb9f
Old saves (without sentinel) load unchanged — rd() lambda zero-inits anything not on disk. New saves append a 4-byte sentinel that encodes the schema revision; the low byte is bumped on every layout change in loadPrefsInt/savePrefs. Mismatch on load logs a warning and continues with defaults; the next savePrefs writes the current sentinel so the file self-heals. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
138 lines
7.2 KiB
C++
138 lines
7.2 KiB
C++
#pragma once
|
||
#include <cstdint>
|
||
#include <stdio.h>
|
||
|
||
#define TELEM_MODE_DENY 0
|
||
#define TELEM_MODE_ALLOW_FLAGS 1 // use contact.flags
|
||
#define TELEM_MODE_ALLOW_ALL 2
|
||
|
||
#define ADVERT_LOC_NONE 0
|
||
#define ADVERT_LOC_SHARE 1
|
||
|
||
struct NodePrefs { // persisted to file
|
||
float airtime_factor;
|
||
char node_name[32];
|
||
float freq;
|
||
uint8_t sf;
|
||
uint8_t cr;
|
||
uint8_t multi_acks;
|
||
uint8_t manual_add_contacts;
|
||
float bw;
|
||
int8_t tx_power_dbm;
|
||
uint8_t telemetry_mode_base;
|
||
uint8_t telemetry_mode_loc;
|
||
uint8_t telemetry_mode_env;
|
||
float rx_delay_base;
|
||
uint32_t ble_pin;
|
||
uint8_t advert_loc_policy;
|
||
uint8_t buzzer_quiet;
|
||
uint8_t buzzer_volume; // 0=min..4=max, default 4
|
||
uint8_t gps_enabled; // GPS enabled flag (0=disabled, 1=enabled)
|
||
uint32_t gps_interval; // GPS read interval in seconds
|
||
uint8_t autoadd_config; // bitmask for auto-add contacts config
|
||
uint8_t rx_boosted_gain; // SX126x RX boosted gain mode (0=power saving, 1=boosted)
|
||
uint8_t client_repeat;
|
||
uint8_t path_hash_mode; // which path mode to use when sending
|
||
uint8_t autoadd_max_hops; // 0 = no limit, 1 = direct (0 hops), N = up to N-1 hops (max 64)
|
||
char default_scope_name[31];
|
||
uint8_t default_scope_key[16];
|
||
uint8_t display_brightness; // 0=min..4=max, default 2 (medium)
|
||
uint16_t auto_off_secs; // display auto-off: 0=never, else seconds (default 15)
|
||
uint8_t auto_lock; // 0=disabled, 1=lock screen when display turns off
|
||
int8_t tz_offset_hours; // timezone offset from UTC, -12..+14 (default 0)
|
||
uint16_t low_batt_mv; // auto-shutdown threshold: 0=disabled, 3000-3500 mV
|
||
uint8_t batt_display_mode; // 0=icon, 1=percent, 2=voltage
|
||
char custom_msgs[10][140]; // user-defined quick messages (supports {loc}, {time})
|
||
uint64_t ch_notif_override; // bitmask: bit i = channel i has explicit notification setting
|
||
uint64_t ch_notif_muted; // bitmask: bit i = channel i muted (only if override bit set)
|
||
uint8_t dm_show_all; // 0=favourites only (default), 1=all chat contacts
|
||
uint8_t room_fav_only; // 0=all room servers (default), 1=favourites only
|
||
uint8_t ringtone_bpm_idx; // index into {60,90,120,150,180}
|
||
uint8_t ringtone_len; // number of notes in custom ringtone (0 = use default)
|
||
uint8_t ringtone_notes[32]; // packed: bits0-2=pitch, bits3-4=octave-4, bits5-6=dur_idx
|
||
uint16_t home_pages_mask; // bitmask of visible home pages (bit0=Clock..bit8=Shutdown); 0=all visible
|
||
uint8_t bot_enabled; // 0=disabled, 1=DM bot active (responds to all DMs)
|
||
uint8_t bot_channel_enabled; // 0=disabled, 1=channel bot active for bot_channel_idx
|
||
uint8_t bot_channel_idx; // channel index for channel bot
|
||
char bot_trigger[64]; // trigger phrase (case-insensitive contains match)
|
||
char bot_reply_dm[140]; // auto-reply text for DM
|
||
char bot_reply_ch[140]; // auto-reply text for channel
|
||
uint8_t clock_hide_seconds; // 0=show HH:MM:SS/refresh 1s (default), 1=hide/refresh 60s
|
||
uint8_t clock_12h; // 0=24h (default), 1=12h with AM/PM
|
||
uint8_t buzzer_auto; // 0=manual (default), 1=auto-mute when BT connected
|
||
struct DmNotifEntry { uint8_t prefix[4]; uint8_t state; }; // state: 0=default,1=muted,2=force-on
|
||
static const int DM_NOTIF_TABLE_MAX = 16;
|
||
DmNotifEntry dm_notif[DM_NOTIF_TABLE_MAX]; // 16*5 = 80 bytes
|
||
uint8_t dashboard_fields[3]; // 0=None,1=Batt,2=Temp,3=Hum,4=Pres,5=GPS,6=Alt,7=Lux,8=CO2,9=Nodes
|
||
uint32_t advert_auto_interval_sec; // periodic 0-hop advert with GPS: 0=off, else seconds
|
||
// Second melody slot (same packing as ringtone_*)
|
||
uint8_t ringtone2_bpm_idx;
|
||
uint8_t ringtone2_len;
|
||
uint8_t ringtone2_notes[32];
|
||
// Global melody for notifications: 0=built-in, 1=melody1, 2=melody2
|
||
uint8_t notif_melody_dm;
|
||
uint8_t notif_melody_ch;
|
||
// Per-channel melody override (2 bitmasks, 1 bit per channel)
|
||
uint64_t ch_notif_melody_set; // bit i = channel i has explicit melody
|
||
uint64_t ch_notif_melody_2; // bit i = use melody 2 (else melody 1, when set bit is set)
|
||
// Per-DM melody table
|
||
struct DmMelodyEntry { uint8_t prefix[4]; uint8_t slot; }; // slot: 0=global,1=melody1,2=melody2
|
||
static const int DM_MELODY_TABLE_MAX = 16;
|
||
DmMelodyEntry dm_melody[DM_MELODY_TABLE_MAX];
|
||
uint8_t use_lemon_font; // 0=default Adafruit font, 1=Lemon font (Unicode, pixel-accurate wrap)
|
||
uint8_t display_rotation; // 0-3; only used on e-ink displays
|
||
// Home screen page order: each byte = bit-index+1 (see HP_* bit positions + 9=Settings, 10=Messages).
|
||
// 0 = end of list. Validity gated by page_order_set magic (see below) — not by entry value range,
|
||
// so a junk byte in 1..11 cannot trigger custom-order mode.
|
||
uint8_t page_order[11];
|
||
uint8_t joystick_rotation; // 0-3 steps CW; independent of display_rotation
|
||
uint8_t eink_full_refresh_every; // index into {0,5,10,20,30}: full refresh every N partials (0=off)
|
||
uint8_t page_order_set; // 0xA5 = page_order is user-configured; anything else = use default
|
||
static const uint8_t PAGE_ORDER_MAGIC = 0xA5;
|
||
|
||
// Tail sentinel written at the end of /new_prefs. Bump the low byte when
|
||
// adding/removing/reordering fields in DataStore::savePrefs/loadPrefsInt so
|
||
// older saves are detected on load and skipped (zero-init defaults kept).
|
||
// High 24 bits identify the file format; low byte is the schema revision.
|
||
static const uint32_t SCHEMA_SENTINEL = 0xC0DE0001;
|
||
|
||
// Bitmasks for home_pages_mask (bit=1 → page visible; 0 field = all visible).
|
||
static const uint16_t HP_CLOCK = 1 << 0;
|
||
static const uint16_t HP_RECENT = 1 << 1;
|
||
static const uint16_t HP_RADIO = 1 << 2;
|
||
static const uint16_t HP_BLUETOOTH = 1 << 3;
|
||
static const uint16_t HP_ADVERT = 1 << 4;
|
||
static const uint16_t HP_GPS = 1 << 5;
|
||
static const uint16_t HP_SENSORS = 1 << 6;
|
||
static const uint16_t HP_TOOLS = 1 << 7;
|
||
static const uint16_t HP_SHUTDOWN = 1 << 8;
|
||
static const uint16_t HP_ALL = 0x01FF;
|
||
|
||
// Label for home page by bit-index (0–10); returns "" for out-of-range.
|
||
static const char* homePageLabel(uint8_t bit) {
|
||
static const char* labels[] = {
|
||
"Clock", "Recent", "Radio", "Bluetooth", "Advert",
|
||
"GPS", "Sensors", "Tools", "Shutdown", "Settings", "Messages"
|
||
};
|
||
return (bit < 11) ? labels[bit] : "";
|
||
}
|
||
|
||
static void buildRTTTLString(const uint8_t* notes, uint8_t len, uint8_t bpm_idx,
|
||
char* buf, int size) {
|
||
static const uint16_t BPM_OPTS[] = { 60, 90, 120, 150, 180 };
|
||
static const uint8_t DUR_VALS[] = { 4, 8, 16, 32 };
|
||
static const char PITCHES[] = { 'p', 'c', 'd', 'e', 'f', 'g', 'a', 'b' };
|
||
if (len == 0) { buf[0] = '\0'; return; }
|
||
uint16_t bpm = BPM_OPTS[bpm_idx < 5 ? bpm_idx : 2];
|
||
int pos = snprintf(buf, size, "Ring:d=8,o=5,b=%u:", bpm);
|
||
for (int i = 0; i < len && pos < size - 8; i++) {
|
||
if (i > 0 && pos < size - 1) buf[pos++] = ',';
|
||
uint8_t pitch = notes[i] & 0x07;
|
||
uint8_t octave = ((notes[i] >> 3) & 0x03) + 4;
|
||
uint8_t dur_val = DUR_VALS[(notes[i] >> 5) & 0x03];
|
||
if (pitch == 0) pos += snprintf(buf + pos, size - pos, "%dp", dur_val);
|
||
else pos += snprintf(buf + pos, size - pos, "%d%c%d", dur_val, PITCHES[pitch], octave);
|
||
}
|
||
if (pos < size) buf[pos] = '\0';
|
||
}
|
||
}; |