// 1. 设置设备属性
kd_mpi_vicap_set_dev_attr(dev_num, dev_attr);

// 2. 设置通道属性  
kd_mpi_vicap_set_chn_attr(dev_num, chn_num, chn_attr);

// 3. 初始化VICAP
kd_mpi_vicap_init(dev_num);

// 4. 启动数据流
kd_mpi_vicap_start_stream(dev_num);

// 5. 捕获图像帧
kd_mpi_vicap_dump_frame(dev_num, chn_num, VICAP_DUMP_YUV, &dump_info, 1000);

// 核心API函数
k_s32 kd_mpi_vicap_set_dev_attr(k_vicap_dev dev_num, k_vicap_dev_attr dev_attr);
k_s32 kd_mpi_vicap_set_chn_attr(k_vicap_dev dev_num, k_vicap_chn chn_num, k_vicap_chn_attr chn_attr);
k_s32 kd_mpi_vicap_init(k_vicap_dev dev_num);
k_s32 kd_mpi_vicap_start_stream(k_vicap_dev dev_num);
k_s32 kd_mpi_vicap_dump_frame(k_vicap_dev dev_num, k_vicap_chn chn_num, k_vicap_dump_format foramt,
                              k_video_frame_info *vf_info, k_u32 milli_sec);

// CSI编号
typedef enum {
    VICAP_CSI0 = 1,
    VICAP_CSI1 = 2,
    VICAP_CSI2 = 3,
} k_vicap_csi_num;

// MIPI Lane数量
typedef enum {
    VICAP_MIPI_1LANE = 0,  // 1通道
    VICAP_MIPI_2LANE = 1,  // 2通道 (GC2093使用)
    VICAP_MIPI_4LANE = 3,  // 4通道
} k_vicap_mipi_lanes;

// MIPI PHY时钟频率
typedef enum {
    VICAP_MIPI_PHY_800M  = 1,  // 800Mbps
    VICAP_MIPI_PHY_1200M = 2,  // 1200Mbps
    VICAP_MIPI_PHY_1600M = 3,  // 1600Mbps
} k_vicap_mipi_phy_freq;

// 支持的数据类型
typedef enum {
    VICAP_CSI_DATA_TYPE_RAW8   = 0x2A,  // RAW8
    VICAP_CSI_DATA_TYPE_RAW10  = 0x2B,  // RAW10 (GC2093使用)
    VICAP_CSI_DATA_TYPE_RAW12  = 0x2C,  // RAW12
    VICAP_CSI_DATA_TYPE_RAW16  = 0x2E,  // RAW16
    VICAP_CSI_DATA_TYPE_YUV422_8 = 0x1E, // YUV422
} k_vicap_csi_data_type;

static k_sensor_mode gc2093_mode_info[] = {
    {
        .sensor_type = GC2093_MIPI_CSI2_1920X1080_30FPS_10BIT_LINEAR,
        .size = {
            .width = 1920,
            .height = 1080,
        },
        .fps = 30000,
        .hdr_mode = SENSOR_MODE_LINEAR,
        .bit_width = 10,
        .mipi_info = {
            .csi_id = 0,           // CSI0接口
            .mipi_lanes = 2,      // 2 Lane
            .data_type = 0x2B,    // RAW10
        },
    },
};

typedef struct {
    k_vicap_window acq_win;           // 采集窗口
    k_vicap_work_mode mode;          // 工作模式
    k_vicap_input_type input_type;   // 输入类型
    k_vicap_image_pattern image_pat; // Bayer格式
    k_vicap_isp_pipe_ctrl pipe_ctrl; // ISP管道控制
    k_vicap_sensor_info sensor_info; // Sensor信息
} k_vicap_dev_attr;

typedef struct {
    const char *sensor_name;
    const char *database_name;
    k_u16 width;                      // 1920
    k_u16 height;                     // 1080
    k_vicap_csi_num csi_num;          // CSI0
    k_vicap_mipi_lanes mipi_lanes;   // 2 Lane
    k_vicap_mipi_phy_freq phy_freq;   // PHY频率
    k_vicap_csi_data_type data_type; // RAW10
    k_u16 fps;                        // 30fps
} k_vicap_sensor_info;

typedef struct {
    k_isp_module_cfg ae;      // 自动曝光
    k_isp_module_cfg awb;    // 自动白平衡
    k_isp_module_cfg af;      // 自动对焦
    k_isp_module_cfg wb;     // 白平衡
    k_isp_module_cfg wdr;    // 宽动态范围
    k_isp_module_cfg hdr;    // HDR处理
    k_isp_module_cfg dnr2;   // 2D降噪
    k_isp_module_cfg dnr3;   // 3D降噪
    k_isp_module_cfg bls;    // 黑电平校正
    k_isp_module_cfg cac;    // 色差校正
    k_isp_module_cfg cnr;    // 色度降噪
    k_isp_module_cfg lsc;    // 镜头阴影校正
    k_isp_module_cfg rgbir;  // RGB-IR处理
    k_isp_module_cfg ee;     // 边缘增强
    k_isp_module_cfg gc;     // gamma校正
    k_isp_module_cfg ge;     // 灰度扩展
    k_isp_module_cfg gtm;    // Gamma曲线
    k_isp_module_cfg ynr;    // 亮度降噪
    k_isp_module_cfg lut3d;  // 3D查找表
    k_isp_module_cfg ccm;    // 色彩矩阵
} k_isp_submodule_cfg;

// 基础API
k_s32 kd_mpi_isp_set_dev_attr(k_isp_dev dev_num, k_isp_dev_attr dev_attr);
k_s32 kd_mpi_isp_set_chn_attr(k_isp_dev dev_num, k_isp_chn chn_num, k_isp_chn_attr chn_attr);
k_s32 kd_mpi_isp_init(k_isp_dev dev_num);
k_s32 kd_mpi_isp_deinit(k_isp_dev dev_num);

// 连接管理
k_s32 kd_mpi_isp_connect(k_isp_dev dev_num);     // 连接Sensor
k_s32 kd_mpi_isp_disconnect(k_isp_dev dev_num);   // 断开连接

// 3A库注册
k_s32 kd_mpi_isp_register_3alib(k_isp_dev dev_num, 
                                  void *usr_awb_lib, 
                                  void *usr_ae_lib, 
                                  void *usr_af_lib);
k_s32 kd_mpi_isp_unregister_3alib(k_isp_dev dev_num);

// 图像输出
k_s32 kd_mpi_isp_start_stream(k_isp_dev dev_num);
k_s32 kd_mpi_isp_stop_stream(k_isp_dev dev_num);
k_s32 kd_mpi_isp_dump_frame(k_isp_dev dev_num, k_isp_chn chn_num, ...);
k_s32 kd_mpi_isp_dump_release(k_isp_dev dev_num, k_isp_chn chn_num, ...);

// AE ROI配置
k_s32 kd_mpi_isp_ae_set_roi(k_isp_dev dev_num, k_isp_ae_roi *roi);
k_s32 kd_mpi_isp_ae_get_roi(k_isp_dev dev_num, k_isp_ae_roi *roi);

typedef union {
    struct {
        k_u32 ae_enable : 1;      // 自动曝光
        k_u32 af_enable : 1;      // 自动对焦
        k_u32 ahdr_enable : 1;    // HDR
        k_u32 awb_enable : 1;    // 自动白平衡
        k_u32 ccm_enable : 1;    // 色彩矩阵
        k_u32 compress_enable : 1;// 压缩
        k_u32 cnr_enable : 1;   // 色度降噪
        k_u32 ynr_enable : 1;   // 亮度降噪
        k_u32 dnr3_enable : 1;   // 3D降噪
        k_u32 dnr2_enable : 1;   // 2D降噪
        k_u32 wdr_enable : 1;    // 宽动态
        k_u32 lsc_enable : 1;    // 镜头阴影校正
        k_u32 lut3d_enable : 1;  // 3D LUT
        // ... 更多位字段
    } bits;
    k_u32 data;
} k_vicap_isp_pipe_ctrl;

typedef struct {
    k_vicap_window acq_win;           // 采集窗口
    k_vicap_work_mode mode;           // 工作模式
    k_vicap_isp_pipe_ctrl pipe_ctrl; // ISP管道控制 ⚠️
    k_isp_submodule_cfg module_cfg;  // ISP子模块配置 ⚠️
    k_isp_work_mode work_mode;        // ISP工作模式
    k_isp_input_type input_type;      // 输入类型
    k_sensor_mode sensor_mode;       // Sensor模式
} k_isp_dev_attr;

struct csi2rx_priv {
    void __iomem *base;              // 寄存器基地址
    struct clk *sys_clk;              // 系统时钟
    struct clk *p_clk;                // 像素时钟
    struct clk *pixel_clk[4];        // 每个Lane的时钟
    struct phy *dphy;                 // D-PHY物理层
    u8 lanes[4];                      // Lane映射
    u8 num_lanes;                    // Lane数量
};

struct cal_dev {
    void __iomem *base;                        // 寄存器基地址
    struct cal_camerarx *phy[CAL_NUM_CSI2_PORTS];  // 2个CSI2 PHY
    struct cal_ctx *ctx[CAL_NUM_CONTEXT];     // 2个捕获上下文
};

struct cal_camerarx {
    void __iomem *base;              // PHY寄存器
    struct cal_dev *cal;             // 父设备
    unsigned int instance;            // PHY实例
};

struct cal_ctx {
    struct cal_dev *cal;             // 父设备
    struct cal_camerarx *phy;        // 关联的PHY
    unsigned int cport;               // CSI端口
};

// CSI2协议控制寄存器
#define CAL_CSI2_PPI_CTRL(m)           (0x200 + (m) * 0x100)

// Lane配置寄存器
#define CAL_CSI2_COMPLEXIO_CFG(m)      (0x208 + (m) * 0x100)
#define CAL_CSI2_COMPLEXIO_PHY_CFG(m)  (0x20C + (m) * 0x100)

// 虚拟通道上下文寄存器
#define CAL_CSI2_CTX0(m)               (0x300 + (m) * 0x20)
#define CAL_CSI2_CTX1(m)               (0x304 + (m) * 0x20)

// DMA写入寄存器
#define CAL_WR_DMA_CTRL                0x400
#define CAL_WR_DMA_ADDR                0x404
#define CAL_WR_DMA_OFST                0x408
#define CAL_WR_DMA_XSIZE               0x40C
#define CAL_WR_DMA_YSIZE               0x410