next iteration on display, still some artifacting issues, and ux with buttons states and updating

main/drivers/display/display_rgb.h

@@ -9,9 +9,22 @@
 #define DISPLAY_H_RES 800
 #define DISPLAY_V_RES 480
 
-/* Requires lv_init() to have already run -- call lvgl_port_init() first.
- * Backlight is NOT owned here on the Advance; see drivers/backlight. */
-esp_err_t display_init(void);
+/*
+ * Two-phase bring-up, and the order is load-bearing:
+ *
+ *   display_alloc()  -- BEFORE wifi_init_sta(). Grabs the framebuffers and
+ *                       the two contiguous bounce buffers while the internal
+ *                       heap is still unfragmented; WiFi's RX buffer churn
+ *                       destroys the needed contiguity within seconds.
+ *                       The panel is not scanning after this.
+ *   display_start()  -- AFTER WiFi (all flash writes done) and after
+ *                       lvgl_port_init(). Starts scan-out and registers the
+ *                       display with LVGL.
+ *
+ * Backlight is NOT owned here on the Advance; see drivers/backlight.
+ */
+esp_err_t display_alloc(void);
+esp_err_t display_start(void);
 
 lv_display_t *display_get_default(void);