屏幕配置

1. 新增一款屏驱动：
   • 复制模块文件 ``panel_dsi_xm91080.c``
   • 将新文件重命名为 ``panel_dsi_xxx.c`` (xxx 为屏驱 IC 型号)
2. 注册新驱动文件。

   • 修改 ``bsp\artinchip\drv\display\panel\Kconfig`` 文件，添加配置项，让新驱动在 menuconfig 界面可见。

     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')

3. 注册新 struct aic_panel 结构体：
   • 修改 panel_dsi_xxx.c 的 struct aic_panel 命名，重命名为 dsi_xxx
   • 在 panel_com.h 中 extern struct aic_panel dsi_xxx

     // panel_com.h
             extern struct aic_panel dsi_xxx;

   • 将 dsi_xxx 添加到 ``panel_com.c`` 文件的 panels[] 指针数组中

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

4. 设置屏幕时序和接口参数*。
   • 修改 ``struct display_timing`` 结构体，根据 LCD 屏幕规格书修改时序参数

     static struct display_timing xxx_timing = {
                 .pixelclock = 130000000,
                 .hactive = 1080,
                 .hfront_porch = 160,
                 .hback_porch = 160,
                 .hsync_len = 40,
                 .vactive = 1920,
                 .vfront_porch = 10,
                 .vback_porch = 20,
                 .vsync_len = 8,
             };

   • 修改 struct panel_dsi 结构体，根据 LCD 屏幕规格书修改显示接口参数

     struct panel_dsi dsi = {
                 .mode = DSI_MOD_VID_BURST,
                 .format = DSI_FMT_RGB888,
                 .lane_num = 4,
             };

   • 根据 PCB 原理图修改 MIPI-DSI 通道顺序和极性

     修改 bsp\artinchip\drv\display\disp_conf.h 文件下列宏定义

     使用硬件设计指南的推荐设计，不需要修改下列参数

     /**
             * MIPI-DSI options
             */
     
             /**
             * data lane assignments, default 0x3210
             *
             * default D3          D2          D1          D0
             *         PD26/PD27   PD24/PD25   PD20/PD21   PD18/PD19
             *
             * example 0x0123
             *         D0          D1          D2          D3
             *         PD26/PD27   PD24/PD25   PD20/PD21   PD18/PD19
             */
             #define LANE_ASSIGNMENTS 0x3210
     
             /**
             * data lane polarities, default 0b0000
             *
             * default PD26/PD27   PD24/PD25   PD19/PD20   PD17/PD18
             *         N/P         N/P         N/P         N/P
             *
             * example 0b1010
             *         PD26/PD27   PD24/PD25   PD19/PD20   PD17/PD18
             *         P/N         N/P         P/N         N/P
             *
             * LANE_POLARITIES 0b1010
             */
             #define LANE_POLARITIES  0b0000
     
             /**
             * data clk inverse, default 0
             *
             * default PD22/PD23
             *         N/P
             *
             * example 1
             *         PD23/PD22
             *         P/N
             */
             #define CLK_INVERSE      0

   注： 部分 MIPI 屏幕对 timing 时序较为敏感，时序不匹配可能会导致颜色异常，图像错位等显示问题。增大消隐区，更换 video mode 可以改善显示异常问题, 推荐使用 DSI_MOD_VID_BURST mode，显示异常时增大 hbp hfp
5. 添加初始化操作*。
   • 重新实现 struct aic_panel_funcs 结构体中的 prepare 或者 enable 接口，发送初始化命令

     static struct aic_panel_funcs st7701s_funcs = {
                 .disable = panel_default_disable,
                 .unprepare = panel_default_unprepare,
                 .prepare = panel_default_prepare,
                 .enable = panel_enable,
                 .register_callback = panel_register_callback,
             };

   • 根据板卡原理图添加 ``reset`` 或 ``power`` 控制引脚的逻辑

     如果不需要软件控制 reset 引脚，该步骤可省略

     #define RESET_PIN "PE.14"
             static struct gpio_desc reset_gpio;
     
             static void panel_gpio_init(void)
             {
                 panel_get_gpio(&reset_gpio, RESET_PIN);
     
                 panel_gpio_set_value(&reset_gpio, 1);
                 aic_delay_ms(120);
             }

6. 配置屏幕引脚功能。

   在 pinmux.c 文件中添加屏幕引脚

   以 demo128-nand 工程为例，在 target/d21x/demo128-nand/pinmux.c 中配置屏幕引脚

   • 添加 reset 等控制引脚，配置功能 1

     如果不需要软件控制 reset 引脚，该步骤可省略

     #ifdef AIC_DISP_MIPI_DSI
                 ...
                 {1, PIN_PULL_DIS, 3, "PE.14"},  // reset gpio
             #endif

   • 添加 MIPI-DSI 信号引脚，配置功能 4

     #ifdef AIC_DISP_MIPI_DSI // MIPI DSI 只有一组 pinmux 配置，根据使用的通道数量和原理图接线进行修改
                 {4, PIN_PULL_DIS, 3, "PD.18"},
                 {4, PIN_PULL_DIS, 3, "PD.19"},
                 {4, PIN_PULL_DIS, 3, "PD.20"},
                 {4, PIN_PULL_DIS, 3, "PD.21"},
                 {4, PIN_PULL_DIS, 3, "PD.22"},
                 {4, PIN_PULL_DIS, 3, "PD.23"},
                 {4, PIN_PULL_DIS, 3, "PD.24"},
                 {4, PIN_PULL_DIS, 3, "PD.25"},
                 {4, PIN_PULL_DIS, 3, "PD.26"},
                 {4, PIN_PULL_DIS, 3, "PD.27"},
             #endif

7. 使能新建的 panel 驱动

   在 Luban-Lite 根目录下执行 me，进入 menuconfig 的功能配置界面。

   • 配置显示接口：

     Board options  --->
                 [*] Using Display Engine (DE)
                     Display Parameter  --->
                         select Display interface (Display MIPI-DSI interface)  --->

   • 选择新建的 ArtInChip MIPI DSI panel 驱动：

     Board options  --->
                 [*] Using Display Engine (DE)
                     Display Parameter  --->
                         Display Panels  --->
                             ArtInChip Panel Drivers (ArtInChip MIPI DSI XXX panel)  --->

1. 新增一款屏驱动。

   根据屏幕的接口类型 （Type B: I8080 或 Type C: SPI），从现有的参考文件中复制代码。

   • Type B I8080 接口可参考：panel_dbi_st7789.c
   • Type C SPI 接口可参考：panel_dbi_st7789t3.c

2. 将新文件重命名为 panel_dbi_xxx.c，其中 xxx 为屏驱 IC 型号。

   例如，屏驱 IC 型号为 st77903，则新文件名称为 panel_dbi_st77903.c。以下均以 st77903 屏驱 IC 型号为例。

3. 注册新驱动文件。
   • 修改 bsp/artinchip/drv/display/panel/Kconfig 文件，添加配置项，让新驱动在 menuconfig 界面可见：

     config AIC_PANEL_DBI_ST77903
                 bool "ArtInChip MIPI DBI ST77903 panel"
                 depends on AIC_DISP_MIPI_DBI

   • 修改 bsp/artinchip/SConscript 文件，添加编译规则：

     if GetDepend('AIC_PANEL_DBI_ST77903):
                 src += Glob('drv/display/panel/panel_dbi_st77903.c')

4. 注册新 struct aic_panel 结构体。
   • 修改 panel_dbi_st77903.c 的 struct aic_panel 命名，重命名为 dbi_st77903。
   • 在 panel_com.h 中添加 extern struct aic_panel dbi_st77903：

     // panel_com.h
             extern struct aic_panel dbi_xxx;

   • 将 dbi_st77903 添加到 panel_com.c 文件的 panels[] 指针数组中：

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

5. 设置屏幕时序和接口参数。
   • 修改 struct display_timing 结构体，根据 LCD 屏幕规格书修改时序参数。

     static struct display_timing st77903_timing = {
                 .pixelclock = 130000000,
                 .hactive = 1080,
                 .hfront_porch = 160,
                 .hback_porch = 160,
                 .hsync_len = 40,
                 .vactive = 1920,
                 .vfront_porch = 10,
                 .vback_porch = 20,
                 .vsync_len = 8,
             };

   • 修改 struct panel_dbi 结构体，根据 LCD 屏幕规格书修改显示接口类型并添加初始化命令。

     static struct panel_dbi dbi = {
                 .type = SPI,
                 .format = SPI_4LINE_RGB565,
                 .commands = {
                     .buf = st7789t3_commands,
                     .len = ARRAY_SIZE(st7789t3_commands),
                 }
             };

6. 在 pinmux.c 文件中添加屏幕引脚，配置屏幕引脚功能。
   以 demo128-nand 工程为例，在 target/d21x/demo128-nand/pinmux.c 中配置屏幕引脚，根据芯片型号和接口参数添加 MIPI-DBI 信号引脚，配置功能 2：

   #ifdef AIC_PANEL_DBI_XXX
               {2, PIN_PULL_DIS, 3, "PD.16"},
               {2, PIN_PULL_DIS, 3, "PD.17"},
               {2, PIN_PULL_DIS, 3, "PD.18"},
               {2, PIN_PULL_DIS, 3, "PD.19"},
               {2, PIN_PULL_DIS, 3, "PD.20"},
               {2, PIN_PULL_DIS, 3, "PD.21"},
               {2, PIN_PULL_DIS, 3, "PD.22"},
               {2, PIN_PULL_DIS, 3, "PD.23"},
               {2, PIN_PULL_DIS, 3, "PD.24"},
               {2, PIN_PULL_DIS, 3, "PD.25"},
               {2, PIN_PULL_DIS, 3, "PD.26"},
               {2, PIN_PULL_DIS, 3, "PD.27"},
           #endif

   • Type B I8080 引脚定义如下：
     
     

     

     
     
   • Type C SPI 引脚定义如下：
     
     
     
     
7. 使能新建的 panel 驱动。

   在 Luban-Lite 根目录下执行 me，进入 menuconfig 的功能配置界面。

   • 选择显示接口类型 Display MIPI-DBI interface：

     Board options  --->
                 [*] Using Display Engine (DE)
                     Display Parameter  --->
                         select Display interface (Display MIPI-DBI interface)  --->

   • 选择新建的 ArtInChip MIPI DBI panel 驱动，即 ArtInChip MIPI DBI st77903 panel：

     Board options  --->
                 [*] Using Display Engine (DE)
                     Display Parameter  --->
                             Display Panels  --->
                                 ArtInChip Panel Drivers (ArtInChip MIPI DBI st77903 panel)  --->

• GPIO 控制背光：如果没有调节背光亮度需求，仅仅是亮或黑屏。

  打开 menuconfig 配置界面，选择 GPIO 方式控制背光，以字符串的形式指定 GPIO 引脚，背光 GPIO 引脚默认高电平有效。

  Board options  --->
      [*] Using Display Engine (DE)
          Display Parameter  --->
              panel backlight control (gpio)  --->
          (PE.19) panel backlight enable pin
          [ ] panel backlight enable pin low active

• PWM 控制背光：如果有调节背光亮度的需求。
  1. 打开 menuconfig 配置界面。，
  2. 使能 PWM，选择 PWM 方式控制背光。

     Board options  --->
         [*] Using PWM3

  3. 配置 PWM-BACKLIGHT 的通道和默认占空比 [0, 100]

     Board options  --->
         [*] Using Display Engine (DE)
             Display Parameter  --->
                 panel backlight control (pwm)  --->
             (3) pwm backlight channel
             (80)default brightness level

  4. 如果需要修改 PWM-BACKLIGHT 频率，如下：

     部分 PWM 频点可能会导致啸叫，修改源码 bsp/artinchip/drv/display/panel/panel_com.c

     void panel_backlight_enable(struct aic_panel *panel, u32 ms)
             {
                 ...
                 // 默认 1KHz
                 /* pwm frequency: 1KHz = 1000000ns */
                 rt_pwm_set(pwm_dev, AIC_PWM_BACKLIGHT_CHANNEL,
                         1000000, 10000 * AIC_PWM_BRIGHTNESS_LEVEL);
             }

[I] aic_find_panel()106 find panel driver : panel-lvds
    [I] aicfb_probe()1037 fb0 allocated at 0x41000040

1. 出现 failed to find panel component 打印信息：
   • 未注册 panel，按 BringUp 流程检查遗漏步骤。
2. 出现 alloc frame buffer failed 错误打印信息：
   • 当前内存不足，申请 Framebuffer 失败。
   • 更换 Framebuffer format, 使用 RGB565 格式。
   • 使用大容量封装型号。