屏适配指南

屏配置方式

Board options  --->
    Graphics Support  --->
        Graphics support
            [*] Display Support
                select Display interface (Display LVDS interface)  --->
                LVDS interface options  --->
                Display Panels  --->
                    ArtInChip Panel Drivers (ArtInChip simple panel)  --->
                    display timing of simple panel  --->

屏驱动适配

本节介绍如何适配一款 LCD 屏幕。LCD 屏驱动，即 panel，本质上是一个回调函数和屏参的集合。新屏适配实际上是重新实现一个 structaic_panel 结构体。

在 bsp/artinchip/drv/display/panel/ 源码目录下，根据屏接口选择一个模板，并在模版的基础上进行修改。

• MIPI-DSI 接口可参考 panel_dsi_xm91080.c

• MIPI-DBI 接口可参考 panel_dbi_ili9486l.c

新屏驱动适配 的详细流程如下所示，以 MIPI-DSI 接口为例：

1. 拷贝一份模板文件，命名为 panel_dsi_xxx.c，将新文件添加进 Kconifg 和 SConscript 文件中。

   // bsp/artinchip/drv/display/panel/Kconfig
   config AIC_PANEL_DSI_XXX
       bool "ArtInChip MIPI DSI xxx panel"
       depends on AIC_DISP_MIPI_DSI
   
   // bsp/artinchip/SConscript
   if GetDepend('AIC_PANEL_DSI_XXX'):
       src += Glob('drv/display/panel/panel_dsi_xxx.c')

2. 修改 struct aic_panel 的命名，并将其注册到系统中。
   1. 将 struct aic_panel 添加到 panel_com.c 文件的 panels[] 指针数组中

      //panel_com.c
      static struct aic_panel *panels[] = {
      ...
      #ifdef AIC_PANEL_DSI_XXX
          &dsi_xxx,
      #endif
      };

   2. 在 panel_com.h 文件中 extern struct aic_panel。

      //panel_com.h
      extern struct aic_panel dsi_xxx;

3. 修改 struct display_timing 结构体，并修改时序参数。
   注： 关于 LCD 时序参数，可查看用户手册 > 多媒体 > LCD 章节。
4. 重新实现 aic_panel_funcs 结构体中的 prepare 或者 enable 接口，添加初始化操作。
   • 对于 MIPI-DSI 接口屏幕

     1. 在发送 init_sequence 前需要调用 panel_mipi_send_perpare() 进入 LP 模式发送命令，确保命令准确发送。

     2. 在发送完 init_sequence 后需要调用 panel_mipi_setup_realmode() 配置正确的 MIPI 模式。

     3. panel_dsi.c 为 MIPI-DSI 的 init_sequence 封装了两个接口：

        • panel_dsi_dcs_send_seq()：发送 DCS 命令

        • panel_dsi_generic_send_seq()：发送 Generic 命令

        提示：

        MIPI-DSI Command 有两种 Data Type: DCS 和 Generic

        • DCS (Display Command Set)，MIPI 协议定义的一个专门用于显示的命令集，使用广泛

        • Generic，屏厂根据 MIPI 协议进行定制

   • 对于 MIPI-DBI 接口屏幕

     • panel_dbi.c 为 MIPI-DBI 的 init_sequence 封装了 enable 接口 panel_dbi_default_enable()

数据结构

struct aic_panel {
    const char *name;
    struct aic_panel_funcs *funcs;
    struct aic_panel_callbacks callbacks;
    const struct display_timing *timings;

    union {
        struct panel_rgb  *rgb;
        struct panel_lvds *lvds;
        struct panel_dsi  *dsi;
    };

    int connector_type;
};

/* Each panel driver should define the follow functions. */
struct aic_panel_funcs {
    int (*prepare)(void);
    int (*enable)(struct aic_panel *panel);
    int (*disable)(struct aic_panel *panel);
    int (*unprepare)(void);
    int (*register_callback)(struct aic_panel *panel,
                struct aic_panel_callbacks *pcallback);
};

struct aic_panel_callbacks {
    int (*di_enable)(void);
    int (*di_disable)(void);
    int (*di_send_cmd)(u32 dt, u32 vc, const u8 *data, u32 len);
    int (*di_set_videomode)(const struct display_timing *timings, int enable);
    int (*timing_enable)(void);
    int (*timing_disable)(void);
};

struct panel_rgb {
    unsigned int mode;
    unsigned int format;
    unsigned int clock_phase;
    unsigned int data_order;
    unsigned int data_mirror;
};

struct panel_lvds {
    enum lvds_mode mode;
    enum lvds_link_mode link_mode;
};

struct panel_dsi {
    enum dsi_mode mode;
    enum dsi_format format;
    unsigned int lane_num;
};

struct panel_dbi_commands {
    const u8 *buf;
    size_t len;
};

struct spi_cfg {
    unsigned int qspi_mode;
    unsigned int vbp_num;
    unsigned int code1_cfg;
    unsigned int code[3];
};

struct panel_dbi {
    unsigned int type;
    unsigned int format;
    unsigned int first_line;
    unsigned int other_line;
    struct panel_dbi_commands commands;
    struct spi_cfg *spi;
};

函数接口