main/display.h


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
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);