perf(P4): Scrollen ohne Nachlauf am Waveshare-Panel (1.6.27)

Ohne Doppelpufferung entsteht beim Scrollen jedes Bild komplett neu
(1280x676 in 24 Bit, per Software). Am stärksten fällt das beim Ausrollen
nach dem Loslassen auf: Dort bewegt sich das Bild weiter, ohne dass ein
Finger es führt, und jedes Stocken ist unmittelbar zu sehen.

LV_OBJ_FLAG_SCROLL_MOMENTUM ist für die scrollbaren Container deshalb
abgeschaltet - die Liste folgt nur noch dem Finger. Nur für WS_PANEL_7H;
die JC-Panels haben das Tempoproblem nicht und bleiben unverändert.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

P4_Display_Firmware/Changelog.txt

@@ -1,3 +1,32 @@
+Version 1.6.27:
+- Beim Waveshare-Panel rollen scrollbare Listen nach dem Loslassen nicht mehr aus, sondern
+  folgen nur dem Finger. Ohne Doppelpufferung entsteht beim Scrollen jedes Bild komplett
+  neu; am staerksten faellt das beim Ausrollen auf, wo sich das Bild ohne fuehrenden Finger
+  weiterbewegt und jedes Stocken unmittelbar sichtbar ist.
+- Die JC-Panels sind ausgenommen, ihr Bediengefuehl bleibt unveraendert.
+
+Version 1.6.26:
+- Fehlerbehebung: Beim Bildlauf blitzten blaue Zwischenbilder auf. Ursache war der zweite
+  Zeichenpuffer aus 1.6.25. Der Panel-Treiber lehnt eine Uebertragung ab, solange die
+  vorige noch laeuft; mit zwei Puffern schickt LVGL die naechste aber sofort los. Die
+  abgelehnte Uebertragung faellt ersatzlos aus, und der betroffene Bildbereich behaelt
+  seinen alten Inhalt.
+- Der zweite Zeichenpuffer ist deshalb wieder entfernt, die Herstellerdatei lvgl_port_v9.c
+  damit wieder unveraendert. Der eigentliche Gewinn beim Bildlauf bleibt erhalten: Der
+  Zwischenpuffer hat weiterhin volle Bildhoehe, ein Bildlauf braucht also einen Durchgang
+  statt sechs.
+
+Version 1.6.25:
+- Der Bildlauf war nach der Umstellung auf einen Bildspeicher sehr zaeh. Grund war der
+  Zwischenpuffer, in den LVGL zeichnet: Mit 120 Zeilen brauchte ein Bildlauf ueber die
+  ganze Seite sechs Durchgaenge, jeder mit eigener Uebertragung in den Bildspeicher.
+- Der Zwischenpuffer hat jetzt volle Bildhoehe - ein Durchgang statt sechs. Dazu kommt ein
+  zweiter Puffer, damit LVGL bereits den naechsten Bereich zeichnen kann, waehrend der
+  vorige noch uebertragen wird.
+- Kosten: 2 x 2,8 MB PSRAM zusaetzlich, bei 32 MB unkritisch. Am Startverhalten aendert
+  sich nichts: Diese Puffer sind Zeichenpuffer, keine Bildspeicher der Anzeige - es bleibt
+  bei EINEM Bildspeicher, und nur der war fuer den Startfehler verantwortlich.
+
 Version 1.6.24:
 - Ursache des unzuverlaessigen Starts gefunden und behoben: die Anzahl der Bildspeicher.
   Mit zwei Bildspeichern kam nach dem Einschalten kein Bild - der Hochlauf meldete

P4_Display_Firmware/pins_config.h

@@ -60,10 +60,17 @@
 // kurz eine Kante sichtbar werden - ein zuverlaessig startendes Display wiegt das auf.
 #if (JC_PANEL_TYPE == WS_PANEL_7H) && WS7_SINGLE_FB
 #define EXAMPLE_LVGL_PORT_AVOID_TEAR_ENABLE   0
-// Zwischenpuffer fuer das Zeichnen: 120 Zeilen im PSRAM (rund 460 KB). Der interne
-// Speicher ist zu knapp, dort passt er nicht.
+// Zwischenpuffer fuer das Zeichnen. Volle Bildhoehe, damit ein Bildlauf in EINEM Durchgang
+// gezeichnet und uebertragen wird. Mit 120 Zeilen waren es sechs Durchgaenge samt sechs
+// Uebertragungen - das war der Grund fuer den zaehen Bildlauf. Kostet 2,8 MB PSRAM.
+//
+// Bewusst nur EIN Zeichenpuffer: Ein zweiter wuerde LVGL erlauben, schon den naechsten
+// Bereich zu zeichnen, waehrend der vorige uebertragen wird. Der Panel-Treiber lehnt eine
+// Uebertragung aber ab, solange die vorige laeuft (ESP_ERR_INVALID_STATE) - der betroffene
+// Bildbereich wird dann gar nicht geschrieben und behaelt seinen alten Inhalt. Sichtbar
+// war das als blaue Zwischenbilder beim Bildlauf.
 #define CONFIG_EXAMPLE_LVGL_PORT_BUF_PSRAM    1
-#define CONFIG_EXAMPLE_LVGL_PORT_BUF_HEIGHT   120
+#define CONFIG_EXAMPLE_LVGL_PORT_BUF_HEIGHT   LCD_V_RES
 #else
 #define EXAMPLE_LVGL_PORT_AVOID_TEAR_ENABLE   1
 #endif

P4_Display_Firmware/ui.cpp

@@ -449,6 +449,24 @@ static void add_save_button(lv_obj_t* parent, const char* txt, lv_event_cb_t cb)
     lv_obj_add_event_cb(b, cb, LV_EVENT_CLICKED, nullptr);
 }
 // Eine Seite (Vollflaeche im Content-Bereich, scrollbar, Spalten-Layout)
+// Nachlauf beim Scrollen abschalten.
+//
+// Ohne Doppelpufferung entsteht beim Scrollen jedes Bild komplett neu - 1280x676 Pixel in
+// 24 Bit, per Software. Am staerksten faellt das beim Ausrollen nach dem Loslassen auf:
+// Dort bewegt sich das Bild weiter, ohne dass ein Finger es fuehrt, und jedes Stocken ist
+// unmittelbar zu sehen. Folgt die Liste dagegen nur dem Finger, entstehen weniger Bilder,
+// und die verbleibenden fallen kaum auf.
+//
+// Nur fuer das Waveshare-Panel: Die JC-Panels haben das Tempoproblem nicht, ihr
+// Bediengefuehl soll unveraendert bleiben.
+static void scroll_ohne_nachlauf(lv_obj_t* o) {
+#if JC_PANEL_TYPE == WS_PANEL_7H
+    lv_obj_clear_flag(o, LV_OBJ_FLAG_SCROLL_MOMENTUM);
+#else
+    (void)o;
+#endif
+}
+
 static lv_obj_t* make_page(lv_obj_t* parent) {
     lv_obj_t* p = lv_obj_create(parent);
     lv_obj_set_size(p, LV_PCT(100), LV_PCT(100));
@@ -462,6 +480,7 @@ static lv_obj_t* make_page(lv_obj_t* parent) {
     lv_obj_set_style_pad_all(p, 8, 0);
     lv_obj_set_style_pad_row(p, 6, 0);
     lv_obj_set_flex_flow(p, LV_FLEX_FLOW_COLUMN);
+    scroll_ohne_nachlauf(p);
     return p;
 }
 
@@ -2304,6 +2323,7 @@ static void build_cleaning_screen() {
     lv_obj_set_style_pad_all(g_clnCfg, 0, 0); lv_obj_set_style_pad_row(g_clnCfg, 8, 0);
     lv_obj_set_flex_flow(g_clnCfg, LV_FLEX_FLOW_COLUMN);
     lv_obj_set_scroll_dir(g_clnCfg, LV_DIR_VER);
+    scroll_ohne_nachlauf(g_clnCfg);
     lv_obj_set_scrollbar_mode(g_clnCfg, LV_SCROLLBAR_MODE_AUTO);
 
     lv_obj_t* hint = lv_label_create(g_clnCfg);
@@ -3289,6 +3309,7 @@ void ui_init(ProtocolClient* client) {
     lv_obj_set_style_pad_row(menu, 6, 0);
     lv_obj_set_flex_flow(menu, LV_FLEX_FLOW_COLUMN);
     lv_obj_set_scroll_dir(menu, LV_DIR_VER);                       // bei vielen Eintraegen vertikal scrollbar
+    scroll_ohne_nachlauf(menu);
     lv_obj_set_scrollbar_mode(menu, LV_SCROLLBAR_MODE_AUTO);
     for (int i = 0; i < PG_COUNT; i++) {
         lv_obj_t* mb = th_button(menu, PAGE_NAMES[i], COL_CARD, COL_TEXT);