1 files changed, 30 insertions, 0 deletions
diff --git a/main/display.h b/main/display.h
new file mode 100644
index 0000000..58e71b7
--- /dev/null
+++ b/main/display.h
@@ -0,0 +1,30 @@
+#pragma once
+
+#include <stdbool.h>
+#include <stdint.h>
+
+#include "esp_err.h"
+
+// Initialize the panel-side MCU over I2C, then bring up the DSI link in
+// video (DPI) mode. Safe to call when the panel is not attached — returns
+// an error and lets the rest of the firmware keep running.
+esp_err_t display_init(void);
+
+bool      display_is_up(void);
+
+// 0–100, gamma-corrected to 0–255 on the panel-MCU PWM register.
+// brightness=0 is fully off (backlight enable line de-asserted).
+esp_err_t display_set_brightness(uint8_t brightness_0_100);
+
+// Sleep / wake hooks for the wake/sleep state machine (M6).
+// Sleep cuts backlight; wake restores last brightness.
+esp_err_t display_sleep(void);
+esp_err_t display_wake(void);
+
+// Paint a solid RGB565 color to the entire framebuffer + flush.
+// Used by M3 for the test pattern and by local_screens for the IP and
+// loading screens (M8).
+esp_err_t display_fill(uint16_t rgb565);
+
+// Show a deterministic test pattern (vertical color bars). M3 acceptance.
+esp_err_t display_test_pattern(void);