mirror of
https://github.com/ByteWelder/Tactility.git
synced 2026-08-18 07:55:06 +00:00
6fb2bb736c
- RGB display driver added - display_driver API: - Added software-based display rotation for screens without hardware rotation support. - Improved display capability detection across supported display drivers. - lvgl_display driver: - Improved framebuffer handling for smoother, more reliable display updates. - Display gap and rotation behavior now adapts more accurately to hardware capabilities. - Migration Crowpanel 5" basic & advance to kernel drivers - Improve KernelDisplay app: brightness controls are hidden for displays that only support on/off operation - device.py now allows for (non-ambiguous) partial device IDs - TactilityKernel: Implement more tests
69 lines
2.4 KiB
C
69 lines
2.4 KiB
C
// SPDX-License-Identifier: Apache-2.0
|
|
#pragma once
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
|
|
#include <lvgl.h>
|
|
|
|
#include <tactility/device.h>
|
|
#include <tactility/error.h>
|
|
|
|
/**
|
|
* @brief Configuration for binding a kernel DisplayApi device to an lv_display_t.
|
|
*/
|
|
struct LvglDisplayConfig {
|
|
/**
|
|
* Number of horizontal lines per draw buffer. 0 means the full vertical resolution.
|
|
* Ignored when the device exposes its own frame buffer(s) (display_get_frame_buffer_count() > 0).
|
|
*/
|
|
uint16_t buffer_height;
|
|
|
|
/**
|
|
* Allocates a second draw buffer for double buffering.
|
|
* Ignored when the device exposes its own frame buffer(s).
|
|
*/
|
|
bool double_buffer;
|
|
|
|
/**
|
|
* Rotate LVGL_rendered content in software instead of calling display_swap_xy()/display_mirror()
|
|
* on the device. Use this for panels whose driver can't rotate in hardware (e.g. RGB/DPI panels).
|
|
* Allocates one extra buffer sized like the primary draw buffer.
|
|
*/
|
|
bool sw_rotate;
|
|
};
|
|
|
|
/**
|
|
* @brief Creates an lv_display_t bound to the given DISPLAY_TYPE device and registers a flush callback
|
|
* that draws through the device's DisplayApi.
|
|
*
|
|
* The device's swap_xy/mirror_x/mirror_y state at the time of this call (via display_get_swap_xy() etc.)
|
|
* is treated as the LV_DISPLAY_ROTATION_0 baseline; LVGL-driven rotation changes are applied relative to it.
|
|
*
|
|
* @warning Caller must hold the LVGL lock (see lvgl_lock() in lvgl_module.h) — call this from
|
|
* LvglModuleConfig.on_start, or after calling lvgl_lock() explicitly.
|
|
*
|
|
* @param[in] device a device of type DISPLAY_TYPE
|
|
* @param[in] config binding configuration
|
|
* @param[out] out_display the created display, valid only when ERROR_NONE is returned
|
|
* @retval ERROR_NONE on success
|
|
* @retval ERROR_INVALID_ARGUMENT if device, config or out_display is NULL, or device is not of type DISPLAY_TYPE
|
|
* @retval ERROR_NOT_SUPPORTED if the device's color format has no LVGL equivalent
|
|
* @retval ERROR_OUT_OF_MEMORY if buffer or lv_display_t allocation failed
|
|
*/
|
|
error_t lvgl_display_add(struct Device* device, const struct LvglDisplayConfig* config, lv_display_t** out_display);
|
|
|
|
/**
|
|
* @brief Removes a display previously created with lvgl_display_add(), freeing any buffers it owns.
|
|
* @warning Caller must hold the LVGL lock.
|
|
*/
|
|
void lvgl_display_remove(lv_display_t* display);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|