Semi working profiles and longer macros

2026-04-13 21:42:02 +02:00
parent 7169d3bbba
commit 098a166a9f
9 changed files with 257 additions and 108 deletions
@@ -57,3 +57,31 @@ für Step 0–3:
 ```

 Die Makro-Tabelle liegt nach `setup()` im RAM (`m_macros` in CMainController). Kein NVM-Zugriff während der Ausführung.
+
+---
+
+## Geplante Erweiterung: 8 Steps (NVM v3)
+
+### Motivation
+
+4 Steps reichen für einfache Shortcuts, aber nicht für Excel-Ribbon-Navigation oder andere Sequenzen mit 5+ Tasten. Mit dem NVM-v3-Umbau (siehe [06_nvm_config.md](06_nvm_config.md)) stehen zwei vollständige Rows für die Makro-Tabelle zur Verfügung.
+
+### Neues Layout
+
+```cpp
+#define MACRO_SLOTS      32
+#define MACRO_MAX_STEPS   8   // war: 4
+
+struct __attribute__((packed)) SMacroTable {
+    SMacroStep steps[32][8];  // 32 × 8 × 2 = 512 Bytes = 2 NVM-Rows
+};
+```
+
+### Neuer NVM-Speicherort
+
+| Row | Adresse | Inhalt |
+|---|---|---|
+| Macro Row 0 | `0x1FB00` | SMacroTable Bytes 0–255 |
+| Macro Row 1 | `0x1FC00` | SMacroTable Bytes 256–511 |
+
+`macro_config_save` muss entsprechend beide Rows löschen und 8 Pages schreiben (statt bisher 4).
@@ -66,3 +66,65 @@ SAMD21 NVM: Row = 256 B = 4 Pages à 64 B. Schreiben erfordert:
 > `NVMCTRL->ADDR.reg = addr / 2` – NVMCTRL erwartet Wort-Adresse (16-Bit-Worte), nicht Byte-Adresse.

 > **Aligned-Buffer-Pflicht**: `nvm_write_page` castet `data` zu `const uint32_t*`. Der Puffer muss `__attribute__((aligned(4)))` sein. Packed Structs sind nicht garantiert aligned → immer via lokalen `uint8_t buf[256] __attribute__((aligned(4)))` + `memcpy` übergeben.
+
+---
+
+## Geplante Erweiterung: NVM v3
+
+### Motivation
+
+Das bisherige Layout (2 Rows, 512 B) stößt an mehrere Grenzen:
+
+- **Makro-Steps zu kurz** — 4 Steps reichen für komplexe Shortcuts (z.B. Excel-Ribbon-Navigation: Alt → Buchstabe → Buchstabe → ...) nicht aus. Ziel: 8 Steps.
+- **Keine Profile** — Eine einzige Config erlaubt keine Umschaltung zwischen Layouts (z.B. Coding vs. Tabellenkalkulation). Ziel: 3 unabhängige Profile.
+- **Keine Helligkeitssteuerung** — Weder global noch pro LED einstellbar. Beide Ebenen sollen konfigurierbar werden.
+- **Encoder-Sensitivity** — Schrittweite pro Encoder soll konfigurierbar sein.
+
+Das bisherige Layout hat außerdem Config und Macros in denselben Adressbereich gemischt (`0x1FE00` Config, `0x1FF00` Macros). Das neue Layout trennt beide Bereiche sauber.
+
+### Neues Flash-Layout (5 Rows, 0x1FB00–0x1FFFF)
+
+| Row | Adresse | Größe | Inhalt |
+|---|---|---|---|
+| Macro Row 0 | `0x1FB00` | 256 B | SMacroTable (Bytes 0–255) |
+| Macro Row 1 | `0x1FC00` | 256 B | SMacroTable (Bytes 256–511) |
+| Config Row 0 | `0x1FD00` | 256 B | Globaler Header + Profil 0 (Bytes 0–255) |
+| Config Row 1 | `0x1FE00` | 256 B | Profil 0 (Rest) + Profil 1 (Bytes 256–511) |
+| Config Row 2 | `0x1FF00` | 256 B | Profil 1 (Rest) + Profil 2 + Reserve (Bytes 512–767) |
+
+Macros und Config liegen in vollständig getrennten, jeweils zusammenhängenden Row-Blöcken.
+
+### Config-Inhalt (768 B, davon 740 B genutzt, 28 B Reserve)
+
+**Globaler Header (32 B, Offset 0):**
+
+| Offset | Größe | Feld |
+|---|---|---|
+| 0 | 4 | `magic` = `0x56503203` ('VP2\x03') |
+| 4 | 1 | `version` = 3 |
+| 5 | 2 | `crc` – CRC16-CCITT über alle Nutzdaten (ab Byte 7) |
+| 7 | 1 | `active_profile` (0–2) |
+| 8 | 1 | `global_brightness` (0–255) |
+| 9 | 4 | `enc_sensitivity[4]` (1 B pro Encoder) |
+| 13 | 19 | Reserve |
+
+**Pro Profil (236 B, Offset `32 + idx × 236`):**
+
+| Offset | Größe | Feld |
+|---|---|---|
+| 0 | 60 | `mx_actions[20]` – 20 × 3 B SAction |
+| 60 | 36 | `enc_actions[4][3]` – 12 × 3 B SAction |
+| 96 | 20 | `led_r[20]` |
+| 116 | 20 | `led_g[20]` |
+| 136 | 20 | `led_b[20]` |
+| 156 | 20 | `led_brightness[20]` ← neu |
+| 176 | 20 | `led_anim[20]` |
+| 196 | 40 | `led_period_ms[20]` |
+
+### Makro-Tabelle (512 B)
+
+32 Slots × **8 Steps** × 2 B = 512 B. Gegenüber v2 doppelt so viele Steps (4 → 8), Slot-Anzahl und Struktur bleiben gleich. Siehe [04_macro_system.md](04_macro_system.md).
+
+### Migration von v2
+
+Beim Laden: wenn `magic` oder `version` nicht zu v3 passen, werden Defaults geladen (kein Migrations-Pfad von v2 → v3, da das Layout inkompatibel ist). Eine einmalige Neukonfiguration nach dem Firmware-Update ist nötig.