配置屏参

配置屏参 1. 屏参配置文件介绍¶ 屏参配置文件在alkaid中的路径为project/board/ini/misc/config.ini

系统启动过程中会去解析屏参配置文件，然后将不同屏参保存到系统中，给显示模块使用。

显示模块会根据用户调用API的参数设定向系统获取所需屏参。

屏参配置文件由section、variable name组成：

section：

文件中"[]"中的字段。

variable name：

文件中"="左边的字段，右边是给variable name赋的值。

section是唯一的，不允许有同名，但是variable name允许。如上图，section DACOUT_576I只能有一个，但是m_pPanelName可以在不同的section中。系统根据不同的section区分variable name，然后添加不同的屏参。

variable name的字段为系统预先定义，在添加新的屏参时，只能填写系统中现有的，新增或者修改时请告知owner，否则系统无法识别。如m_pPanelName，在新增屏参时只能使用m_pPanelName定义新的panel name。

variable name赋值示例如下：

2. 新增屏参¶ 新屏参定义section name不能和现有section name相同

将新屏参的section name追加到ROOT section的m_pnlList变量中（不同接口的LCD section只能存在一个，比如m_pnlList中已经存在一个TTL的panel section name，那么如果想要添加新的TTL，只能删除掉之前存在的section）

将新的屏参添加到新的section中，如下：

[SAT070AT50H18BH]

m_pPanelName = "SAT070AT50H18BH_1024x600";

m_bPanelDither = 0;

m_ePanelLinkType = 0; #0:ttl 1:lvds 11:mipi

m_bPanelInvDCLK = 0;

m_bPanelInvDE = 0;

m_bPanelInvHSync = 0;

m_bPanelInvVSync = 0;

m_wPanelHSyncWidth = 48;

m_wPanelHSyncBackPorch = 46;

m_wPanelVSyncWidth = 4;

m_wPanelVBackPorch = 23;

m_wPanelHStart = 98;

m_wPanelVStart = 27;

m_wPanelWidth = 1024;

m_wPanelHeight = 600;

m_wPanelHTotal = 1344;

m_wPanelVTotal = 635;

m_wPanelDCLK = 51;

m_wSpreadSpectrumStep = 0;

m_wSpreadSpectrumSpan = 0;

m_eOutputFormatBitMode = 2; #0:10bit 1:6bit 2:8bit 3:565bit

m_ucPanelSwapChnR = 3;

m_ucPanelSwapChnG = 2;

m_ucPanelSwapChnB = 1;

m_ucPanelSwapRgbML = 1;

3. 屏参参数说明¶ 参数 描述 m_pPanelName panel name m_bPanelDither 1:enable Dither 0:disable Dither m_ePanelLinkType 接口类型 TTL :0 MIPI_DSI :10 m_bPanelInvDCLK Pixel clk极性反转 m_bPanelInvDE DE极性反转 m_bPanelInvHSync Hsync极性反转 m_bPanelInvVSync Vsync极性反转 m_wPanelHSyncWidth 行同步信号脉宽 m_wPanelHSyncBackPorch 行同步信号后肩 m_wPanelVSyncWidth 场同步信号脉宽 m_wPanelVBackPorch 场同步信号后肩 m_wPanelHStart m_wPanelHSyncWidth+m_wPanelHSyncBackPorch m_wPanelVStart m_wPanelVSyncWidth+ m_wPanelVBackPorch m_wPanelWidth 行有效像素点数 m_wPanelHeight 场有效行数 m_wPanelHTotal m_wPanelWidth+m_wPanelHSyncWidth+m_wPanelHSyncBackPorch+HsyncFrontPorch m_wPanelVTotal m_wPanelHeight+m_wPanelVSyncWidth+ m_wPanelVBackPorch+VsyncFrontPorch m_wPanelDCLK m_wPanelHTotal*m_wPanelVTotal*fps（IP内部使用clk） m_wSpreadSpectrumFreq 时钟延展幅度调制（详见展频计算） m_wSpreadSpectrumRatio 时钟延展频率调制（详见展频计算） m_eOutputFormatBitMode 10BIT :0 6BIT :1 8BIT :2 565BIT :3 m_ucPanelSwapChnR Swap Channel R 0:default 1:select R 2:select G 3:select B m_ucPanelSwapChnG Swap Channel G 0:default1:select R 2:select G 3:select B m_ucPanelSwapChnB Swap Channel B 0:default 1:select R 2:select G 3:select B m_ucPanelSwapRgbML Swap Rgb MSB/LSB 0:disable M/L swap 1:enable M/L swap 如果是MIPI panel，还需要对MIPI DSI进行配置。

MIPI DSI参数说明：

参数 描述 m_wHsTrail Default: 5 m_wHsPrpr Default: 3 m_wHsZero Default: 5 m_wClkHsPrpr Default: 10 m_wClkHsExit Default: 14 m_wClkTrail Default: 3 m_wClkZero Default: 12 m_wClkHsPost Default: 10 m_wDaHsExit Default: 5 m_wContDet Default:0 m_wLpx Default:16 m_wTaGet Default:26 m_wTaSure Default:24 m_wTaGo Default:50 m_wHactive Follow 屏参设定 m_wHpw Follow 屏参设定 m_wHbp Follow 屏参设定 m_wHfp Follow 屏参设定 m_wVactive Follow 屏参设定 m_wVpw Follow 屏参设定 m_wVbp Follow 屏参设定 m_wVfp Follow 屏参设定 m_wBllp 0 m_wFps Default:60 m_eLaneNum one lane :1 two lane :2 three lane :3 four lane :4 m_eFormat RGB565 :0 RGB666 :1 LOOSELY_RGB666 :2 RGB888 :3 m_eCtrlMode CMD_MODE :0 SYNC_PULSE :1 SYNC_EVENT :2 BURST_MODE :3 m_ucClkLane Clk lane selection(default:2) 0:select chn0 1:select chn1 2:select chn2 3:select chn3 4:select chn4 m_ucDataLane0 data lane0 selection(default:4) 0:select chn0 1:select chn1 2:select chn2 3:select chn3 4:select chn4 m_ucDataLane1 data lane1 selection(default:3) 0:select chn0 1:select chn1 2:select chn2 3:select chn3 4:select chn4 m_ucDataLane2 data lane2 selection(default:1) 0:select chn0 1:select chn1 2:select chn2 3:select chn3 4:select chn4 m_ucDataLane3 data lane3 selection(default:0) 0:select chn0 1:select chn1 2:select chn2 3:select chn3 4:select chn4 m_pCmdBuff Mipi panel cmd m_pCmdBuff= { Cmd, parameter cnt, parameter0, parameter1, … , Cmd, parameter cnt, parameter0, parameter1, … , Cmd, parameter cnt, parameter0, parameter1, … , ……… } m_ucPolCh0 Chn0极性 0：default 1：positive 2：negative m_ucPolCh1 Chn1极性 0：default 1：positive 2：negative m_ucPolCh2 Chn2极性 0：default 1：positive 2：negative m_ucPolCh3 Chn3极性 0：default 1：positive 2：negative m_ucPolCh4 Chn4极性 0：default 1：positive 2：negative 根据屏规格书填写屏参：

在屏规格书中找到Timing相关部分，如下表定义：

屏规格书中Timing定义和屏参参数对应如下表所示：

m_wPanelHSyncWidth HSYNC period time m_wPanelHSyncBackPorch 参考HSYNC blanking的要求 根据上表，如果HSYNC blanking为320，那么m_wPanelHSyncBackPorch要小于320，差值部分为hsync front porch大小 m_wPanelVSyncWidth VSYNC period time m_wPanelVBackPorch 参考VSYNC blanking的要求 根据上表，如果VSYNC blanking为35，那么m_wPanelVBackPorch要小于35，差值部分为vsync front porch大小 m_wPanelHStart m_wPanelHSyncWidth+m_wPanelHSyncBackPorch m_wPanelVStart m_wPanelVSyncWidth+ m_wPanelVBackPorch m_wPanelWidth Horizonial display area m_wPanelHeight Vertical display area m_wPanelHTotal m_wPanelWidth+HSYNC blanking m_wPanelVTotal m_wPanelHeight+VSYNC blanking m_wPanelDCLK m_wPanelHTotal*m_wPanelVTotal*fps 如果是MIPI panel，还需要配置MIPI AC timing相关参数，首先在panel规格书中找到MIPI timing specification部分。

UI的计算方法：

H_Total = HACT+HPW+HBP+HFP

V_Total = VACT+VPW+VBP+VFP

BitsPerPixel=24(RGB888)/18(RGB666)/16(RGB565)

Bitrate = H_Total*V_Total*FPS*BitsPerPixel/lane number

UI = 1/Bitrate

比如表格中HS-PREPARE的要求是大于40ns+4*UI并且小于85ns+6*UI，那么对应MIPI AC timing中的参数如下。

(40ns+4*UI)/8*UI \< m_wHsTrail \< (85ns+6*UI)/8*UI

其他MIPI AC timing中参数计算方法同上。

注意：

当前这套屏参设置需要更新：config_tool/mi_disp/mhal，若涉及uboot 点屏需要更新uboot。