屏参使用指南¶
REVISION HISTORY¶
Revision No.
Description
Date
1.0
Initial release
02/22/2024
1. 基本介绍¶
1.1 概述¶
屏参顾名思义是屏幕使用的参数配置。本文档主要讲解点屏相关配置，屏参的含义和如何设置正确的屏参。
1.2. 关键字说明¶
TTL/BT656
TTL： Transistor-Transistor Logic，接口信号为数字信号，传输并行RGB数据。
BT656： 接口信号为数字信号，传输YUV数据。
2. 屏参配置文件介绍¶
2.1 屏参配置文件路径¶
project\board\$(chip)\$(boardname)\config\config_disp.json
2.2 屏参配置文件组成¶
系统启动过程中会去解析屏参配置文件，然后将不同屏参保存到系统中，给显示模块使用。显示模块会根据用户调用API的参数设定向系统获取所需屏参。
获取屏参流程请参考：MI_DISP_API
屏参配置文件组成如下图所示，mi_disp是根节点，包含三个子节点：content，屏参，PQ。
content节点是屏参名称列表的集合，包含了两个子节点：m_pnlList、m_btList。
m_pnlList
m_pnlList罗列了每种接口类型的屏参名称，用户自定义屏参可放于此处，但是一种接口类型只能对应一份屏参，若存在相同类型，只会选取排在最前面的屏参。
m_btList
m_btList罗列BT656多种分辨率屏参名称。
屏参由section、variable name组成：
section指的是图中屏参名称，EX："SAT070AT50H18BH"。
variable name指的是":"左边的字段，右边是给variable name赋的值。
section是唯一的，不允许有同名，但是variable name允许。如上图，section SAT070AT50H18BH只能有一个，但是m_pPanelName可以在不同的section中。系统根据不同的section区分variable name，然后添加不同的屏参。
3. 新增屏参¶
1、新增的屏参定义的section name不允许和已有的section name重名
2、新增的屏参可以放在在m_pnlList的前面（同类panel只有第一个panel是有效的）。如果m_pnlList存在与新增屏参相同接口类型的屏参，可以将原有相同接口类型的屏参删除，也可以将新增的屏参加在原有接口屏参前面。
3、在屏参节点中添加新屏参，如下所示：
"SAT070AT50H18BH": {
"m_wPanelDispPath": 0,
"m_pPanelName": "SAT070AT50H18BH",
"m_ePanelTiming": 52,
"m_ePanelIntfType": 9,
"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": 51000000,
"m_bPanelInvDCLK": 0,
"m_bPanelInvDE": 0,
"m_bPanelInvHSync": 0,
"m_bPanelInvVSync": 0,
"m_wSpreadSpectrumFreq": 0,
"m_wSpreadSpectrumRatio": 0,
"m_ucPanelSwapChnR": 3,
"m_ucPanelSwapChnG": 2,
"m_ucPanelSwapChnB": 1,
"m_ucPanelSwapRgbML": 0
},
4. 屏参参数说明¶
4.1 公共参数¶
参数
描述
m_pPanelName
panel name
m_ePanelTiming
输出分辨率，52表示用户自定义
m_ePanelIntfType
接口类型 BT656：3 TTL：9
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
pixel clk: m_wPanelHTotal * m_wPanelVTotal * fps
m_bPanelInvDCLK
pixel clk极性反转
m_bPanelInvHSync
Hsync极性反转
m_bPanelInvVSync
Vsync极性反转
m_wSpreadSpectrumFreq
时钟延展幅度调制（详见spreadSpectrumFreqCalculation）
m_wSpreadSpectrumRatio
时钟延展频率调制（详见spreadSpectrumFreqCalculation）
m_ucPanelSwapChnR
Swap channel R default = 0（保持物理线路原始连接，即R通道使用硬件设计中默认对应的信号源） 1：select R（强制覆盖通道信号源，将R通道数据替换为主控输出的R通道信号） 2：select G 3：select B
m_ucPanelSwapChnG
Swap channel G default = 0 1：select R 2：select G 3：select B
m_ucPanelSwapChnB
Swap channel B default = 0 1：select R 2：select G 3：select B
m_ucPanelSwapRgbML
Swap RGB MSB/LSB（控制RGB数据的高低位（MSB/LSB）顺序交换） 0：disable M/L swap 1：enable M/L swap MSB：数据的最高位有效 LSB：数据的最低位有效
m_ePanelRgbDataType
RGB data type or LCD data bus 0：E_MI_DISP_MHALPNL_RGB_DTYPE_RGB888, 1：E_MI_DISP_MHALPNL_RGB_DTYPE_RGB666, 2：E_MI_DISP_MHALPNL_RGB_DTYPE_RGB565, 3：E_MI_DISP_MHALPNL_RGB_DTYPE_RGB444, 4：E_MI_DISP_MHALPNL_RGB_DTYPE_RGB333, 5：E_MI_DISP_MHALPNL_RGB_DTYPE_RGB332, 6：E_MI_DISP_MHALPNL_RGB_DTYPE_BGR888, 7：E_MI_DISP_MHALPNL_RGB_DTYPE_BGR666, 8：E_MI_DISP_MHALPNL_RGB_DTYPE_BGR565, 9：E_MI_DISP_MHALPNL_RGB_DTYPE_BGR444, 10：E_MI_DISP_MHALPNL_RGB_DTYPE_BGR333, 11：E_MI_DISP_MHALPNL_RGB_DTYPE_BGR332, 12：E_MI_DISP_MHALPNL_RGB_DTYPE_YUV422_UY0VY1, 13：E_MI_DISP_MHALPNL_RGB_DTYPE_YUV422_VY0UY1, 14：E_MI_DISP_MHALPNL_RGB_DTYPE_YUV422_UY1VY0, 15：E_MI_DISP_MHALPNL_RGB_DTYPE_YUV422_VY1UY0, 16：E_MI_DISP_MHALPNL_RGB_DTYPE_YUV422_Y0UY1V, 17：E_MI_DISP_MHALPNL_RGB_DTYPE_YUV422_Y0VY1U, 18：E_MI_DISP_MHALPNL_RGB_DTYPE_YUV422_Y1UY0V, 19：E_MI_DISP_MHALPNL_RGB_DTYPE_YUV422_Y1VY0U
m_ePanelRgbDeltaOddMode
delta mode 奇场数据排列 0: RGB 1: RBG 2: GRB 3: GBR 4: BRG 5: BGR
m_ePanelRgbDeltaEvenMode
delta mode 偶场数据排列 0: RGB 1: RBG 2: GRB 3: GBR 4: BRG 5: BGR
m_ePanelRgbDataSwap
RGB data swap ，对所有的数据做swap 0: disable 1: enable
m_wPadDrvngLvl
pin脚驱动能力调整，对接口所有的pin脚设置驱动能力档位，共有4个档位 0: 4mA 1: 8mA 2: 12mA 3: 16mA
注：m_ePanelRgbDataType的12~13是BT接口可选。m_ucPanelSwapRgbML是交换RGB数据传输的高低位，m_ePanelRgbDataSwap是对RGB所有数据进行交换。
m_bPanelInvDCLK，m_bPanelInvHSync，m_bPanelInvVSync正常timing示意图：
m_bPanelInvDCLK，m_bPanelInvHSync，m_bPanelInvVSync开启极性反转timing示意图：
5. 配置正确的屏参¶
配置正确的屏参除了可以参考上述列表中的附件表格，还需要根据屏幕规格书或者协议规范调整对应的参数。
5.1 屏幕规格书¶
大部分屏芯片的规格书可以找到Timing相关部分，如下图所示。如果找不到，可以找厂家询问。
参数
描述
m_wPanelVSyncWidth
Horizontal Sync. Width
m_wPanelHSyncBackPorch
Horizontal Sync. Back Porch
m_wPanelVSyncWidth
Vertical Sync. Width
m_wPanelVBackPorch
Vertical Sync. Back Porch
m_wPanelHStart
m_wPanelHSyncWidth+m_wPanelHSyncBackPorch
m_wPanelVStart
m_wPanelVSyncWidth+m_wPanelVBackPorch
m_wPanelWidth
240(H)
m_wPanelHeight
320(V)
m_wPanelHTotal
m_wPanelHStart+m_wPanelWidth + hfp
m_wPanelVTotal
m_wPanelVStart+m_wPanelHeight + vfp