mirror of
https://github.com/ByteWelder/Tactility.git
synced 2026-10-17 10:55:06 +00:00
65ee223876
- CL-32 features added: - Hardware revision detection - v0.3 and v0.4 keyboard - v0.4 power supply - Inlined epd library (was a module) and made changes to the device definition (don't do full update after 5 small updates) - Statusbar: add support for inverted colors - e-paper driver improvements and warning fixes - Implemented gpio_controller_get_level() - Keyboard support improvements (unicode for tca drivers)
112 lines
2.9 KiB
C
112 lines
2.9 KiB
C
#ifndef _EPAPER_LVGL_H_
|
|
#define _EPAPER_LVGL_H_
|
|
|
|
#include "epaper.h"
|
|
#include "lvgl.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief LVGL e-paper port configuration
|
|
*/
|
|
typedef struct {
|
|
epd_handle_t epd; // E-paper handle (required)
|
|
epd_update_mode_t update_mode; // Default update mode
|
|
epd_dither_mode_t dither_mode; // Dithering algorithm
|
|
bool use_partial_refresh; // Enable partial refresh optimization
|
|
uint32_t partial_threshold; // Min dirty area (pixels) for partial refresh
|
|
} epd_lvgl_config_t;
|
|
|
|
#define EPD_LVGL_CONFIG_DEFAULT() { \
|
|
.epd = NULL, \
|
|
.update_mode = EPD_UPDATE_FULL, \
|
|
.dither_mode = EPD_DITHER_NONE, \
|
|
.use_partial_refresh = false, \
|
|
.partial_threshold = 1000, \
|
|
}
|
|
|
|
/**
|
|
* @brief Initialize LVGL display driver for e-paper
|
|
*
|
|
* @param config LVGL port configuration
|
|
* @return lv_display_t* LVGL display object, NULL on failure
|
|
*
|
|
* Example:
|
|
* @code
|
|
* epd_config_t epd_cfg = EPD_CONFIG_DEFAULT();
|
|
* epd_handle_t epd;
|
|
* epd_init(&epd_cfg, &epd);
|
|
*
|
|
* epd_lvgl_config_t lvgl_cfg = EPD_LVGL_CONFIG_DEFAULT();
|
|
* lvgl_cfg.epd = epd;
|
|
* lvgl_cfg.use_partial_refresh = true;
|
|
*
|
|
* lv_display_t *disp = epd_lvgl_init(&lvgl_cfg);
|
|
* @endcode
|
|
*/
|
|
lv_display_t* epd_lvgl_init(const epd_lvgl_config_t *config);
|
|
|
|
/**
|
|
* @brief Deinitialize LVGL e-paper driver
|
|
*/
|
|
void epd_lvgl_deinit(lv_display_t *disp);
|
|
|
|
/**
|
|
* @brief Set update mode for next refresh
|
|
* @param disp LVGL display
|
|
* @param mode EPD_UPDATE_FULL, EPD_UPDATE_FAST, EPD_UPDATE_PARTIAL
|
|
*/
|
|
void epd_lvgl_set_update_mode(lv_display_t *disp, epd_update_mode_t mode);
|
|
|
|
/**
|
|
* @brief Force full refresh on next update
|
|
* Call this periodically (e.g., every 10 partial updates) to prevent ghosting
|
|
*/
|
|
void epd_lvgl_force_full_refresh(lv_display_t *disp);
|
|
|
|
/**
|
|
* @brief Manually trigger display refresh
|
|
* Use when lv_refr_now() doesn't work as expected
|
|
*/
|
|
void epd_lvgl_refresh(lv_display_t *disp);
|
|
|
|
/**
|
|
* @brief Get e-paper handle from display
|
|
*/
|
|
epd_handle_t epd_lvgl_get_epd(lv_display_t *disp);
|
|
|
|
/**
|
|
* @brief Set dithering mode
|
|
* @param disp LVGL display
|
|
* @param mode EPD_DITHER_NONE, EPD_DITHER_FLOYD_STEINBERG
|
|
*
|
|
* Floyd-Steinberg dithering provides better image quality for photos/gradients
|
|
* but requires additional memory (width * height * 3 bytes for RGB buffer)
|
|
*/
|
|
void epd_lvgl_set_dither_mode(lv_display_t *disp, epd_dither_mode_t mode);
|
|
|
|
/**
|
|
* @brief Convert RGB888 to nearest e-paper color
|
|
* @param r Red component (0-255)
|
|
* @param g Green component (0-255)
|
|
* @param b Blue component (0-255)
|
|
* @param mode Color mode of the panel
|
|
* @return Nearest EPD_PIXEL_xxx value
|
|
*/
|
|
uint8_t epd_rgb_to_epaper_color(uint8_t r, uint8_t g, uint8_t b, epd_color_mode_t mode);
|
|
|
|
/**
|
|
* @brief Create LVGL color from e-paper palette
|
|
* @param epaper_color EPD_PIXEL_xxx value
|
|
* @return lv_color_t LVGL color value
|
|
*/
|
|
lv_color_t epd_epaper_to_lv_color(uint8_t epaper_color);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // _EPAPER_LVGL_H_
|