/*
 * Copyright (c) 2025, LISTENAI
 *
 * SPDX-License-Identifier: Apache-2.0
 */

#pragma once

#include "lisa_display.h"
#include <lisa_semaphore.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct lisa_display_panel {
    /* --- 关联的总线设备 --- */
    lisa_device_t *bus_dev;      /**< 数据总线设备（用于像素传输）*/
    lisa_device_t *cmd_bus_dev;  /**< 命令总线设备（可选，NULL 表示与数据总线共用）*/

    /* --- 硬件引脚 --- */
    lisa_device_t *rst_gpio;
    uint32_t rst_pin;

    /* --- 背光控制 --- */
    lisa_display_backlight_t backlight;

    /* --- 显示能力与状态 --- */
    lisa_display_capabilities_t caps;

    /* --- 驱动设备 --- */
    lisa_device_t *panel_dev;

    /* --- 私有数据 --- */
    void *priv_data;

} lisa_display_panel_t;

typedef struct {
    uint16_t panel_w;
    uint16_t panel_h;
    uint16_t x;
    uint16_t y;
    uint16_t w;
    uint16_t h;
    uint16_t x_offset;
    uint16_t y_offset;
} lisa_display_panel_mem_area_t;

typedef uint8_t lisa_mem_coord_t[4];
/**
 * @brief Panel 驱动接口 API 结构体
 *
 * 每个屏幕芯片驱动（第2层）都必须实现该接口。
 */
typedef struct lisa_display_panel_driver {
    int (*init)(lisa_display_panel_t *panel);

    int (*get_capabilities)(lisa_display_panel_t *panel, lisa_display_capabilities_t *caps);

    int (*write)(lisa_display_panel_t *panel, uint16_t x, uint16_t y,
                 const lisa_display_buffer_desc_t *desc, const void *buf);

    int (*blanking_on)(lisa_display_panel_t *panel);
    int (*blanking_off)(lisa_display_panel_t *panel);

    int (*set_brightness)(lisa_display_panel_t *panel, uint8_t brightness);

    int (*set_orientation)(lisa_display_panel_t *panel, lisa_display_orientation_t orientation);

} lisa_display_panel_driver_t;

/**
 * @brief Panel 公共层：发送命令和关联的数据
 *
 * @param panel Panel实例
 * @param cmd 要发送的命令字节
 * @param cmd_bits 命令位数
 * @param data 指向数据的指针
 * @param len 数据长度
 * @return 0 成功, <0 失败
 */
int panel_write_cmd_data(lisa_display_panel_t *panel, int cmd, uint8_t cmd_bits, const void *data, size_t len);
/**
 * @brief Panel 公共层：绘制位图
 *
 * @param panel Panel实例
 * @param cmd 命令
 * @param cmd_bits 命令位数
 * @param x x坐标
 * @param y y坐标
 * @param w 宽度
 * @param h 高度
 * @param pixels 位图数据
 * @return 0 成功, <0 失败
 */
int panel_draw_pixels(lisa_display_panel_t *panel, uint32_t cmd, uint16_t cmd_bits, uint16_t x, uint16_t y, uint16_t w, uint16_t h, const void *pixels);
/**
 * @brief Panel 公共层：设置背光亮度
 *
 * @param backlight 背光实例
 * @param brightness 亮度值
 * @return 0 成功, <0 失败
 */
int panel_set_backlight_brightness(lisa_display_backlight_t *backlight, uint8_t brightness);

int panel_rotate_init(void);

void panel_reset_pin_set(lisa_display_panel_t *panel, uint8_t level);

void panel_set_mem_area(lisa_display_panel_t *panel, lisa_display_panel_mem_area_t *area, lisa_mem_coord_t x, lisa_mem_coord_t y);

#ifdef __cplusplus
}
#endif