全志Tina Linux Display 开发指南支持百问网T113 D1-H哪吒DongshanPI-D1s V853-Pro等开发板

news2024/10/6 14:28:18

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

1 概述

让显示应用开发人员了解显示驱动的接口及使用流程，快速上手，进行开发；让新人接手工作时能快速地了解驱动接口，进行调试排查问题。sunxi 平台DE1.0/DE2.0。与显示相关的应用开发人员，及与显示相关的其他模块的开发人员，以及新人。

2 模块介绍

2.1 模块功能介绍

image-20221123145359081

图2-1: 模块框图

本模块框图如上，由显示引擎（DE）和各类型控制器（tcon）组成。输入图层（layers）在DE中进行显示相关处理后，通过一种或多种接口输出到显示设备上显

示，以达到将众多应用渲染的图层合成后在显示器呈现给用户观看的作用。DE 有2 个独立单元（可以简称de0、de1），可以分别接受用户输入的图层进行合成，

输出到不同的显示器，以实现双显。DE 的每个独立的单元有1-4 个通道（典型地，de0 有4 个，de1 有2 个），每个通道可以同时处理接受4 个格式相同的

图层。sunxi 平台有视频通道和UI 通道之分。视频通道功能强大，可以支持YUV 格式和RGB图层。UI 通道只支持RGB 图层。

简单来说，显示模块的主要功能如下：

• 支持lcd(hv/lvds/cpu/dsi) 输出。
• 支持双显输出。
• 支持多图层叠加混合处理。
• 支持多种显示效果处理（alpha, colorkey, 图像增强，亮度/对比度/饱和度/色度调整）。
• 支持智能背光调节。
• 支持多种图像数据格式输入(arg,yuv)。
• 支持图像缩放处理。
• 支持截屏。
• 支持图像转换。

2.2 相关术语介绍

2.2.1 硬件术语介绍

表2-1: 硬件术语介绍表
术语解释
dedisplay engine，显示引擎，负责将输入的多图层进行叠加、混合、缩放等处理的硬件模块
channel一个硬件通道，包含若干图层处理单元，可以同时处理若干（典型4 个）格式相同的图层
layer一个图层处理单元，可以处理一张输入图像，按支持的图像格式分video 和ui类型
capture截屏，将de 的输出保存到本地文件
alpha透明度，在混合时决定对应图像的透明度
transform图像变换，如平移、旋转等
overlay图像叠加，按顺序将图像叠加一起的效果。z 序大的靠近观察者，会把z 序小的挡住
blending图像混合，按alpha 比例将图像合成一起的效果
enhance图像增强，有目的地处理图像数据以达到改善图像效果的过程或方法

2.2.2 软件术语介绍

表2-2: 软件术语介绍表
术语解释
fb帧缓冲（framebuffer）,Linux 为显示设备提供的一个接口，把显存抽象成的一种设备。有时也指一块显存
al抽象层，驱动中将底层硬件抽象成固定业务逻辑的软件层
lowlevel底层，直接操作硬件寄存器的软件层

2.3 模块配置介绍

2.3.1 kenel_menuconfig 配置说明

make kenel_menuconfig

具体配置目录为：

Device Drivers --->
	Graphics support --->
		<*> Support for frame buffer devices --->
			Video support for sunxi --->
				<*> DISP Driver Support(sunxi-disp2)

image-20221123150416330

图2-2: disp 配置

其中：

• DISP Driver Support(sunxi-disp2)

DE 驱动请选上。

• debugfs support for disp driver(sunxi-disp2)

调试节点，建议选上，方便调试。

• composer support for disp driver(sunxi-disp2)

disp2 的fence 处理。linux 系统可以不选择。

2.4 源码结构介绍

源码结构如下：

├─drivers
│ ├─video
│ │ ├─fbdev
│ │ │ ├─sunxi --display driver for sunxi
│ │ │ │ ├─disp2/ --disp2 的目录
│ │ │ │ │ ├─disp
│ │ │ │ │ │ ├─dev_disp.c --display driver 层
│ │ │ │ │ │ ├─dev_fb.c --framebuffer driver 层
│ │ │ │ │ │ ├─de --bsp层
│ │ │ │ │ │ │ ├─disp_lcd.c --disp_manager.c ..
│ │ │ │ │ │ │ ├─disp_al.c --al层
│ │ │ │ │ │ │ │ └─lowlevel_sun*i/ --lowlevel 层
│ │ │ │ │ │ │ │ ├─de_lcd.c ...
│ │ │ │ │ │ │ └─disp_sys_int.c --OSAL 层,与操作系统相关层
│ │ │ │ │ │ ├─lcd/ lcd driver
│ │ │ │ │ │ │ │─lcd_src_interface.c --与display 驱动的接口
│ │ │ │ │ │ │ │─default_panel.c... --平台已经支持的屏驱动
include
├─video video header dir
│ ├─sunxi_display2.h display header file

2.5 驱动框架介绍

image-20221123151947713

图2-3: 驱动框图

显示驱动可划分为三个层面，驱动层，框架层及底层。底层与图形硬件相接，主要负责将上层配置的功能参数转换成硬件所需要的参数，并配置到相应寄存器中。

显示框架层对底层进行抽象封装成一个个的功能模块。驱动层对外封装功能接口，通过内核向用户空间提供相应的设备结点及统一的接口。在驱动层，分为四个驱

动，分别是framebuffer 驱动，disp 驱动，lcd 驱动，hdmi 驱动。Framebuffer 驱动与framebuffer core 对接，实现linux 标准的framebuffre 接口。

Disp 驱动是是整个显示驱动中的核心驱动模块，所有的接口都由disp 驱动来提供，包括lcd 的接口。

3 模块接口概述

模块使用主要通过ioctl 实现，对应的驱动节点是/dev/disp。

具体定义请仔细阅读头文件上面的注释，kernel/linux-4.9/include/video/sunxi_display2.h。

对于显示模块来说，把图层参数设置到驱动，让显示器显示为最重要。sunxi 平台的DE 接受用户设置图层参数，通过disp,channel,layer_id 三个索引确定需要设置的显示位置（disp:0/1,channel: 0/1/2/3，layer_id:0/1/2/3)，其中disp 表示显示器索引，channel 表示通道索引，layer_id 表示通道内的图层索引。

下面着重地把图层的参数从头文件中拿出来介绍。

truct disp_fb_info2 {
    int fd;
    struct disp_rectsz size[3];
    unsigned int align[3];
    enum disp_pixel_format format;
    enum disp_color_space color_space;
    int trd_right_fd;
    bool pre_multiply;
    struct disp_rect64 crop;
    enum disp_buffer_flags flags;
    enum disp_scan_flags scan;
    enum disp_eotf eotf;
    int depth;
    unsigned int fbd_en;
    int metadata_fd;
    unsigned int metadata_size;
    unsigned int metadata_flag;
};

• fd

显存的文件句柄。

• size 与crop

Size 表示buffer 的完整尺寸，crop 则表示buffer 中需要显示裁减区。如下图所示，完整的图像以size 标识，而矩形框住的部分为裁减区，以crop 标识，在屏幕上

只能看到crop 标识的部分，其余部分是隐藏的，不能在屏幕上显示出来的。

image-20221123152906780

图3-1: size 和crop 示意图

• crop 和screen_win

crop 上面已经介绍过，Screen_win 为crop 部分buffer 在屏幕上显示的位置。如果不需要进行缩放的话，crop 和screen_win 的width,height 是相等的，如果需要

缩放，crop 和screen_win 的width,height 可以不相等。

image-20221123152930138

图3-2: crop 和screen win 示意图

• alpha

Alpha 模式有三种:

  1. gloabal alpha: 全局alpha，也叫面alpha，即整个图层共用一个alpha，统一的透明度。
  2. pixel alpha: 点alpha，即每个像素都有自己单独的alpha，可以实现部分区域全透，部分区域半透，部分区域不透的效果。
  3. global_pixel alpha: 可以是说以上两种效果的叠加，在实现pxiel alpha 的效果的同时，还可以做淡入浅出的效果。

image-20221123153137180

图3-3: alpha 叠加模式

• align

显存的对齐字节数。

• format

输入图层的格式。Ui 通道支持的格式：

DISP_FORMAT_ARGB_8888
DISP_FORMAT_ABGR_8888
DISP_FORMAT_RGBA_8888
DISP_FORMAT_BGRA_8888
DISP_FORMAT_XRGB_8888
DISP_FORMAT_XBGR_8888
DISP_FORMAT_RGBX_8888
DISP_FORMAT_BGRX_8888
DISP_FORMAT_RGB_888
DISP_FORMAT_BGR_888
DISP_FORMAT_RGB_565
DISP_FORMAT_BGR_565
DISP_FORMAT_ARGB_4444
DISP_FORMAT_ABGR_4444
DISP_FORMAT_RGBA_4444
DISP_FORMAT_BGRA_4444
DISP_FORMAT_ARGB_1555
DISP_FORMAT_ABGR_1555
DISP_FORMAT_RGBA_5551
DISP_FORMAT_BGRA_5551
DISP_FORMAT_A2R10G10B10
DISP_FORMAT_A2B10G10R10
DISP_FORMAT_R10G10B10A2
DISP_FORMAT_B10G10R10A2

Video 通道支持的格式：

DISP_FORMAT_ARGB_8888
DISP_FORMAT_ABGR_8888
DISP_FORMAT_RGBA_8888
DISP_FORMAT_BGRA_8888
DISP_FORMAT_XRGB_8888
DISP_FORMAT_XBGR_8888
DISP_FORMAT_RGBX_8888
DISP_FORMAT_BGRX_8888
DISP_FORMAT_RGB_888
DISP_FORMAT_BGR_888
DISP_FORMAT_RGB_565
DISP_FORMAT_BGR_565
DISP_FORMAT_ARGB_4444
DISP_FORMAT_ABGR_4444
DISP_FORMAT_RGBA_4444
DISP_FORMAT_BGRA_4444
DISP_FORMAT_ARGB_1555
DISP_FORMAT_ABGR_1555
DISP_FORMAT_RGBA_5551
DISP_FORMAT_BGRA_5551
DISP_FORMAT_YUV444_I_AYUV
DISP_FORMAT_YUV444_I_VUYA
DISP_FORMAT_YUV422_I_YVYU
DISP_FORMAT_YUV422_I_YUYV
DISP_FORMAT_YUV422_I_UYVY
DISP_FORMAT_YUV422_I_VYUY
DISP_FORMAT_YUV444_P
DISP_FORMAT_YUV422_P
DISP_FORMAT_YUV420_P
DISP_FORMAT_YUV411_P
DISP_FORMAT_YUV422_SP_UVUV
DISP_FORMAT_YUV422_SP_VUVU
DISP_FORMAT_YUV420_SP_UVUV
DISP_FORMAT_YUV420_SP_VUVU
DISP_FORMAT_YUV411_SP_UVUV
DISP_FORMAT_YUV411_SP_VUVU
DISP_FORMAT_YUV444_I_AYUV_10BIT
DISP_FORMAT_YUV444_I_VUYA_10BIT

所有图层都支持缩放。对图层的操作如下所示：

  1. 设置图层参数并使能，接口为DISP_LAYER_SET_CONFIG，图像格式，buffer size，
    buffer 地址，alpha 模式，enable，图像帧id 号等参数。
  2. 关闭图层，依然通过DISP_LAYER_SET_CONFIG，将enable 参数设置为0 关闭。

4 显示输出设备操作说明

Disp2 支持多种的显示输出设备，LCD、TV、HDMI。开启显示输出设备有几种方式，第一种是在sys_config 或dts 中配置[disp] 的初始化参数，显示模块在加载时

将会根据配置初始化选择的显示输出设备；第二种是在kernel 启动后，调用驱动模块的ioctl 接口去开启或关闭指定的输出设备，以下是操作的说明：

• 开启或切换到某个具体的显示输出设备，ioctl(DISP_DEVICE_SWITCH…），参数设置为特定的输出设备类型，DISP_OUTPUT_TYPE_LCD/TV/HDMI。

• 关闭某个设备，ioctrl(DISP_DEVICE_SWITCH…)，参数设置为DISP_OUTPUT_TYPE_NONE。

5 接口参数更改说明

sunxi 平台支持disp1 和disp2。

表5-1: disp1 与disp2 区别
项目\平台disp2disp1
图层标识以disp, chennel, layer_id 唯一标识以disp, layer_id 唯一标识
图层开关将开关当成图层参数设置DISP_LAYER_SET_CONFIG 中独立图层开关接口
图层size每个分量都需要设置1 个size一个buffer 只有1
图层align针对每个分量需要设置其align，单位为byte。无
图层Crop为64 位定点小数，高32 位为整数，低32位为小数为32 位参数，不支持小数
YUV MB 格式支持不再支持支持
PALETTE 格式支持不再支持支持
单色模式(无buffer)支持不支持
Pipe 选择Pipe 对用户透明，用户无需选择，只需要配置channel用户设置
zorder用户设置，保证zorder 不重复，从0 到N-1用户不能设置
设置图层信息接口一次可设置多个图层的信息，增加一个图层信息数目参数一次设置1 个图层信息

6 输出设备介绍

平台支持屏以及HDMI 输出，及二者同时显示。

6.1 屏

屏的接口很多，平台支持RGB/CPU/LVDS/DSI 接口。

6.2 HDMI

HDMI 全名是：High-Definition Multimedia Interface。可以提供DVD,audio device, settop boxes，television sets, and other video displays 之间的高清互

联。可以承载音，视频数据，以及其他的控制，数据信息。支持热插拔，内容保护，模式是否支持的查询。

6.3 同显

驱动支持双路显示。屏（主）+ HDMI（辅）。

同显或异显，差别只在于显示内容，如果显示内容一样，则为同显；反之，则为异显。

  1. 如果是android 系统，4.2 版本以上版本，原生框架已经支持多显（同显，异显，虚拟显示设备），实现同显则比较简单，在android hal 与上层对接好即可。

  2. 如果是android 4.1 以下版本，同显需要自行实现，参考做法为主屏内容由android 原生提供，辅屏需要android hal 在合适的时机（比如HDMI 插入时）打开

辅屏，并且将主屏的内容（存放于FB0 中），拷贝至辅屏的显示后端buffer 中，然后将辅屏的后端buffer 切换到前端buffer。注意问题为，两路显示的显示

buffer 的同步，如果同步不好，会产生图像撕裂，错位的现象。

  1. 如果是Linux 系统，做法与上一个做法类似。

7 IOCTL 接口描述

sunxi 平台下显示驱动给用户提供了众多功能接口，可对图层、LCD、hdmi 等显示资源进行操作。

7.1 Global Interface

7.1.1 DISP_SHADOW_PROTECT

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_SHADOW_PROTECT
argarg[0] 为显示通道0/1；arg[1] 为protect 参数，1 表示protect, 0: 表示not protect

• 返回值

如果成功，返回DIS_SUCCESS，否则，返回失败号。

• 描述

DISP_SHADOW_PROTECT（1）与DISP_SHADOW_PROTECT（0）配对使用，在protect期间，所有的请求当成一个命令序列缓冲起来, 等到调用

DISP_SHADOW_PROTECT（0）后将一起执行。

• 示例

//启动cache，disphd为显示驱动句柄
unsigned int arg[3];
arg[0] = 0;//disp0
arg[1] = 1;//protect
ioctl(disphd, DISP_SHADOW_PROTECT, (void*)arg);
//do somthing other
arg[1] = 0;//unprotect
ioctl(disphd, DISP_SHADOW_PROTECT, (void*)arg);

7.1.2 DISP_SET_BKCOLOR

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_SET_BKCOLOR
argarg[0] 为显示通道0/1；arg[1] 为backcolor 信息，指向disp_color 数据结构指针

• 返回值

如果成功，返回DIS_SUCCESS，否则，返回失败号。

• 描述

该函数用于设置显示背景色。

• 示例

//设置显示背景色，disphd为显示驱动句柄，sel为屏0/1
disp_color bk;
unsigned int arg[3];
bk.red = 0xff;
bk.green = 0x00;
bk.blue = 0x00;
arg[0] = 0;
arg[1] = (unsigned int)&bk;
ioctl(disphd, DISP_SET_BKCOLOR, (void*)arg);

7.1.3 DISP_GET_BKCOLOR

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_GET_BKCOLOR
argarg[0] 为显示通道0/1；arg[1] 为backcolor 信息，指向disp_color 数据结构指针

• 返回值

如果成功，返回DIS_SUCCESS，否则，返回失败号。

• 描述

该函数用于获取显示背景色。

• 示例

//获取显示背景色，disphd为显示驱动句柄，sel为屏0/1
disp_color bk;
unsigned int arg[3];
arg[0] = 0;
arg[1] = (unsigned int)&bk;
ioctl(disphd, DISP_GET_BKCOLOR, (void*)arg);

7.1.4 DISP_GET_SCN_WIDTH

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_GET_SCN_WIDTH
argarg[0] 显示通道0/1

• 返回值

如果成功，返回当前屏幕水平分辨率，否则，返回失败号。

• 描述

该函数用于获取当前屏幕水平分辨率。

• 示例

//获取屏幕水平分辨率
unsigned int screen_width;
unsigned int arg[3];
arg[0] = 0;
screen_width = ioctl(disphd, DISP_GET_SCN_WIDTH, (void*)arg);

7.1.5 DISP_GET_SCN_HEIGHT

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_GET_SCN_HEIGHT
argarg[0] 显示通道0/1

• 返回值

如果成功，返回当前屏幕垂直分辨率，否则，返回失败号。

• 描述

该函数用于获取当前屏幕垂直分辨率。

• 示例

//获取屏幕垂直分辨率
unsigned int screen_height;
unsigned int arg[3];
arg[0] = 0;
screen_height = ioctl(disphd, DISP_GET_SCN_HEIGHT, (void*)arg);

7.1.6 DISP_GET_OUTPUT_TYPE

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_GET_OUTPUT_TYPE
argarg[0] 显示通道0/1

• 返回值

如果成功，返回当前显示输出类型，否则，返回失败号。

• 描述

该函数用于获取当前显示输出类型(LCD,TV,HDMI,VGA,NONE)。

• 示例

//获取当前显示输出类型
disp_output_type output_type;
unsigned int arg[3];
arg[0] = 0;
output_type = (disp_output_type)ioctl(disphd, DISP_GET_OUTPUT_TYPE, (void*)arg);

7.1.7 DISP_GET_OUTPUT

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_GET_OUTPUT
argarg[0] 为显示通道0/1；arg[1] 为指向disp_output 结构体的指针，用于保存返回值

• 返回值

如果成功，返回0，否则，返回失败号。

• 描述

该函数用于获取当前显示输出类型及模式(LCD,TV,HDMI,VGA,NONE)。

• 示例

//获取当前显示输出类型
unsigned int arg[3];
disp_output output;
disp_output_type type;
disp_tv_mode mode;
arg[0] = 0;
arg[1] = (unsigned long)&output;
ioctl(disphd, DISP_GET_OUTPUT, (void*)arg);
type = (disp_output_type)output.type;
mode = (disp_tv_mode)output.mode;

7.1.8 DISP_VSYNC_EVENT_EN

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_VSYNC_EVENT_EN
argarg[0] 为显示通道0/1；arg[1] 为enable 参数，0：disable, 1:enable

• 返回值

如果成功，返回DIS_SUCCESS。

否则，返回失败号。

• 描述

该函数开启/关闭vsync 消息发送功能。

• 示例

//开启/关闭vsync消息发送功能，disphd为显示驱动句柄，sel为屏0/1
unsigned int arg[3];
arg[0] = 0;
arg[1] = 1;
ioctl(disphd, DISP_VSYNC_EVENT_EN, (void*)arg);

7.1.9 DISP_DEVICE_SWITCH

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_DEVICE_SWITCH
argarg[0] 为显示通道0/1；arg[1] 为输出类型；arg[2] 为输出模式，在输出类型不为LCD 时有效

• 返回值

如果成功，返回DIS_SUCCESS，否则，返回失败号。

• 描述

该函数用于切换输出类型。

• 示例

//切换
unsigned int arg[3];
arg[0] = 0;
arg[1] = （unsigned long)DISP_OUTPUT_TYPE_HDMI;
arg[2] = (unsigned long)DISP_TV_MOD_1080P_60HZ;
ioctl(disphd, DISP_DEVICE_SWITCH, (void*)arg);

说明：如果传递的type 是DISP_OUTPUT_TYPE_NONE，将会关闭当前显示通道的输出。

7.1.10 DISP_DEVICE_SET_CONFIG

• 原型

int ioctl(int handle, unsigned int cmd,unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_DEVICE_SET_CONFIG
argarg[0] 为显示通道0/1；arg[1] 为指向disp_device_config 的指针

• 返回值

如果成功，返回DIS_SUCCESS，否则，返回失败号。

• 描述

该函数用于切换输出类型并设置输出设备的属性参数。

• 示例

//切换输出类型并设置输出设备的属性参数
unsigned long arg[3];
struct disp_device_config config;
config.type = DISP_OUTPUT_TYPE_LCD;
config.mode = 0;
config.format = DISP_CSC_TYPE_RGB;
config.bits = DISP_DATA_8BITS;
config.eotf = DISP_EOTF_GAMMA22;
config.cs = DISP_BT709;
arg[0] = 0;
arg[1] = （unsigned long)&config;
ioctl(dispfd, DISP_DEVICE_SET_CONFIG, (void*)arg);
//说明：如果传递的type是DISP_OUTPUT_TYPE_NONE，将会关闭当前显示通道的输出。

7.1.11 DISP_DEVICE_GET_CONFIG

• 原型

int ioctl(int handle, unsigned int cmd,unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_DEVICE_GET_CONFIG
argarg[0] 为显示通道0/1；arg[1] 为指向disp_device_config 的指针

• 返回值

如果成功，返回DIS_SUCCESS，否则，返回失败号。

• 描述

该函数用于获取当前输出类型及相关的属性参数。

• 示例

//获取当前输出类型及相关的属性参数
unsigned long arg[3];
struct disp_device_config config;
arg[0] = 0;
arg[1] = （unsigned long)&config;
ioctl(dispfd, DISP_DEVICE_GET_CONFIG, (void*)arg);
//说明：如果返回的type是DISP_OUTPUT_TYPE_NONE，表示当前输出显示通道为关闭状态

7.2 Layer Interface

7.2.1 DISP_LAYER_SET_CONFIG

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_CMD_SET_LAYER_CONFIG
argarg[0] 为显示通道0/1；arg[1] 为图层配置参数指针；arg[2] 为需要配置的图层数目

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于设置多个图层信息。

• 示例

struct
{
	disp_layer_info info,
bool enable;
	unsigned int channel,
	unsigned int layer_id,
} disp_layer_config;
//设置图层参数，disphd为显示驱动句柄
unsigned int arg[3];
disp_layer_config config;
unsigned int width = 1280;
unsigned int height = 800;
unsigned int ret = 0;
memset(&info, 0, sizeof(disp_layer_info));
config.channel = 0; //channel 0
config.layer_id = 0;//layer 0 at channel 0
config.info.enable = 1;
config.info.mode = LAYER_MODE_BUFFER;
config.info.fb.addr[0] = (__u32)mem_in; //FB地址
config.info.fb.size.width = width;
config.info.fb.format = DISP_FORMAT_ARGB_8888; //DISP_FORMAT_YUV420_P
config.info.fb.crop.x = 0;
config.info.fb.crop.y = 0;
config.info.fb.crop.width = ((unsigned long)width) << 32;//定点小数。高32bit为整数，低32bit为小
数
config.info.fb.crop.height= ((uunsigned long)height)<<32;//定点小数。高32bit为整数，低32bit为小
数
config.info.fb.flags = DISP_BF_NORMAL;
config.info.fb.scan = DISP_SCAN_PROGRESSIVE;
config.info.alpha_mode = 1; //global alpha
config.info.alpha_value = 0xff;
config.info.screen_win.x = 0;
config.info.screen_win.y = 0;
config.info.screen_win.width = width;
config.info.screen_win.height= height;
config.info.id = 0;
arg[0] = 0;//screen 0
arg[1] = (unsigned int)&config;
arg[2 = 1; //one layer
ret = ioctl(disphd, DISP_CMD_LAYER_SET_CONFIG, (void*)arg);

7.2.2 DISP_LAYER_GET_CONFIG

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_LAYER_GET_CONFIG
argarg[0] 为显示通道0/1；arg[1] 为图层配置参数指针；arg[2] 为需要获取配置的图层数目

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于获取图层参数。

• 示例

//获取图层参数，disphd为显示驱动句柄
unsigned int arg[3];
disp_layer_info info;
memset(&info, 0, sizeof(disp_layer_info));
config.channel = 0; //channel 0
config.layer_id = 0;//layer 0 at channel 0
arg[0] = 0;//显示通道0
arg[1] = 0;//图层0
arg[2 = (unsigned int)&info;
ret = ioctl(disphd, DISP_LAYER_GET_CONFIG, (void*)arg);

7.2.3 DISP_LAYER_SET_CONFIG2

• 原型

int ioctl(int handle, unsigned int cmd,unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_SET_LAYER_CONFIG2
argarg[0] 为显示通道0/1；arg[1] 为图层配置参数指针；arg[2] 为需要配置的图层数目

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于设置多个图层信息，注意该接口只接受disp_layer_config2 的信息。

• 示例

struct
{
disp_layer_info info,
bool enable;
unsigned int channel,
unsigned int layer_id,
}disp_layer_config2;
//设置图层参数，dispfd 为显示驱动句柄
unsigned long arg[3];
struct disp_layer_config2 config;
unsigned int width = 1280;
unsigned int height = 800;
unsigned int ret = 0;
memset(&config, 0, sizeof(struct disp_layer_config2));
config.channnel = 0;//blending channel
config.layer_id = 0;//layer index in the blending channel
config.info.enable = 1;
config.info.mode = LAYER_MODE_BUFFER;
config.info.fb.addr[0] = (unsigned long long)mem_in; //FB 地址
config.info.fb.size[0].width = width;
config.info.fb.align[0] = 4;//bytes
config.info.fb.format = DISP_FORMAT_ARGB_8888; //DISP_FORMAT_YUV420_P
config.info.fb.crop.x = 0;
config.info.fb.crop.y = 0;
config.info.fb.crop.width = ((unsigned long)width) << 32;//定点小数。高32bit 为整数，低32bit 为小数
config.info.fb.crop.height= ((uunsigned long)height)<<32;//定点小数。高32bit 为整数，低32bit 为小数
config.info.fb.flags = DISP_BF_NORMAL;
config.info.fb.scan = DISP_SCAN_PROGRESSIVE;
config.info.fb.eotf = DISP_EOTF_SMPTE2084; //HDR
config.info.fb.metadata_buf = (unsigned long long)mem_in2;
config.info.alpha_mode = 2; //global pixel alpha
config.info.alpha_value = 0xff;//global alpha value
config.info.screen_win.x = 0;
config.info.screen_win.y = 0;
config.info.screen_win.width = width;
config.info.screen_win.height= height;
config.info.id = 0;
arg[0] = 0;//screen 0
arg[1] = (unsigned long)&config;
arg[2 = 1; //one layer
ret = ioctl(dispfd, DISP_LAYER_SET_CONFIG2, (void*)arg);

7.2.4 DISP_LAYER_GET_CONFIG2

• 原型

int ioctl(int handle, unsigned int cmd,unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_CAPTURE_START
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于开启截屏功能。

• 示例

//启动截屏功能，dispfd 为显示驱动句柄
arg[0] = 0;//显示通道0
ioctl(dispfd, DISP_CAPTURE_START, (void*)arg);

7.3.2 DISP_CAPTURE_COMMIT

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_CAPTURE_COMMIT
argarg[0] 为显示通道0/1；arg[1] 为指向截屏的信息结构体，详见disp_capture_info

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于提交截屏的任务，提交一次，则会启动一次截屏操作。

• 示例

//提交截屏功能，dispfd 为显示驱动句柄
unsigned long arg[3];
struct disp_capture_info info;
arg[0] = 0;
screen_width = ioctl(dispfd, DISP_GET_SCN_WIDTH, (void*)arg);
screen_height = ioctl(dispfd, DISP_GET_SCN_HEIGHT, (void*)arg);
info.window.x = 0;
info.window.y = 0;
info.window.width = screen_width;
info.window.y = screen_height;
info.out_frame.format = DISP_FORMAT_ARGB_8888;
info.out_frame.size[0].width = screen_width;
info.out_frame.size[0].height = screen_height;
info.out_frame.crop.x = 0;
info.out_frame.crop.y = 0;
info.out_frame.crop.width = screen_width;
info.out_frame.crop.height = screen_height;
info.out_frame.addr[0] = fb_address; //buffer address
arg[0] = 0;//显示通道0
arg[1] = (unsigned long)&info;
ioctl(dispfd, DISP_CAPTURE_COMMIT, (void*)arg);

7.3.3 DISP_CAPTURE_STOP

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_CAPTURE_STOP
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于关闭截屏功能。

• 示例

//停止截屏功能，dispfd 为显示驱动句柄
unsigned long arg[3];
arg[0] = 0;//显示通道0
ioctl(dispfd, DISP_CAPTURE_STOP, (void*)arg);

7.3.4 DISP_CAPTURE_QUERY

• 原型

int ioctl(int handle, unsigned int cmd,unsigned int *arg);

• 参数

命令DISP_CAPTURE_QUERY 是查询功能。

参数说明
hdle显示驱动句柄
cmdDISP_CAPTURE_QUERY
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数查询刚结束的图像帧是否截屏成功。

• 示例

//查询截屏是否成功，dispfd 为显示驱动句柄
unsigned long arg[3];
arg[0] = 0;//显示通道0
ioctl(dispfd, DISP_CAPTURE_QUERY, (void*)arg);

7.4 LCD Interface

7.4.1 DISP_LCD_SET_BRIGHTNESS

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_LCD_SET_BRIGHTNESS
argarg[0] 为显示通道0/1；arg[1] 为背光亮度值，（0~255）

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于设置LCD 亮度。

• 示例

//设置LCD的背光亮度，disphd为显示驱动句柄
unsigned int arg[3];
unsigned int bl = 197;
arg[0] = 0;//显示通道0
arg[1] = bl;
ioctl(disphd, DISP_LCD_SET_BRIGHTNESS, (void*)arg);

7.4.2 DISP_LCD_GET_BRIGHTNESS

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_LCD_GET_BRIGHTNESS
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于获取LCD 亮度。

• 示例

//获取LCD的背光亮度，disphd为显示驱动句柄
unsigned int arg[3];
unsigned int bl;
arg[0] = 0;//显示通道0
bl = ioctl(disphd, DISP_LCD_GET_BRIGHTNESS, (void*)arg);

7.5 Enhance interface

7.5.1 DISP_ENHANCE_ENABLE

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_ENHANCE_ENABLE
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于使能图像后处理功能。

• 示例

//开启图像后处理功能，disphd为显示驱动句柄
unsigned int arg[3];
arg[0] = 0;//显示通道0
ioctl(disphd, DISP_ENHANCE_ENABLE, (void*)arg);

7.5.2 DISP_ENHANCE_DISABLE

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_ENHANCE_DISABLE
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于关闭图像后处理功能。

• 示例

//关闭图像后处理功能，disphd为显示驱动句柄
unsigned int arg[3];
arg[0] = 0;//显示通道0
ioctl(disphd, DISP_ENHANCE_DISABLE, (void*)arg);

7.5.3 DISP_ENHANCE_DEMO_ENABLE

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_ENHANCE_DEMO_ENABLE
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于开启图像后处理演示模式，开启后，在屏幕会出现左边进行后处理，右边未处理的图像画面，方便对比效果。演示模式需要在后处理功能开启之后才有

效。

• 示例

//开启图像后处理演示模式，disphd为显示驱动句柄
unsigned int arg[3];
arg[0] = 0;//显示通道0
ioctl(disphd, DISP_ENHANCE_DEMO_ENABLE, (void*)arg);

7.5.4 DISP_ENHANCE_DEMO_DISABLE

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_ENHANCE_DEMO_DISABLE
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于关闭图像后处理演示模式。

• 示例

//开启图像后处理演示模式，disphd为显示驱动句柄
unsigned int arg[3];
arg[0] = 0;//显示通道0
ioctl(disphd, DISP_ENHANCE_DEMO_ENABLE, (void*)arg);

7.6 Smart backlight

7.6.1 DISP_SMBL_ENABLE

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_SMBL_ENABLE
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于使能智能背光功能。

• 示例

//开启智能背光功能，disphd为显示驱动句柄
unsigned int arg[3];
arg[0] = 0;//显示通道0
ioctl(disphd, DISP_SMBL_ENABLE, (void*)arg);

7.6.2 DISP_SMBL_DISABLE

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_SMBL_ENABLE
argarg[0] 为显示通道0/1

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于关闭智能背光功能。

• 示例

//关闭智能背光功能，disphd为显示驱动句柄
unsigned int arg[3];
arg[0] = 0;//显示通道0
ioctl(disphd, DISP_SMBL_DISABLE, (void*)arg);

7.6.3 DISP_SMBL_SET_WINDOW

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_SMBL_SET_WINDOW
argarg[0] 为显示通道0/1；arg[1] 为指向struct disp_rect 的指针

• 返回值

如果成功，则返回DIS_SUCCESS；如果失败，则返回失败号。

• 描述

该函数用于设置智能背光开启效果的窗口，智能背光在设置的窗口中有效。

• 示例

//设置智能背光窗口，disphd为显示驱动句柄
unsigned int arg[3];
unsigned int screen_width, screen_height;
struct disp_rect window;
　　
screen_width = ioctl(disphd, DISP_GET_SCN_WIDTH, (void*)arg);
screen_height = ioctl(disphd, DISP_GET_SCN_HEIGHT, (void*)arg);
window.x = 0;
window.y = 0;
window.width = screen_width / 2;
widnow.height = screen_height;
arg[0] = 0;//显示通道0
arg[1] = (unsigned long)&window;
ioctl(disphd, DISP_SMBL_SET_WINDOW, (void*)arg);

7.7 Hdmi interface

7.7.1 DISP_HDMI_SUPPORT_MODE

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_HDMI_SUPPORT_MODE
argarg[0] 为显示通道0/1；arg[1] 为需要查询的模式，详见disp_tv_mode

• 返回值

如果支持，则返回1；如果失败，则返回0。

• 描述

该函数用于查询指定的HDMI 模式是否支持。

• 示例

//查询指定的HDMI模式是否支持
unsigned int arg[3];
arg[0] = 0;//显示通道0
arg[1] = (unsigned long)DISP_TV_MOD_1080P_60HZ;
ioctl(disphd, DISP_HDMI_SUPPORT_MODE, (void*)arg);

7.7.2 DISP_HDMI_GET_HPD_STATUS

• 原型

int ioctl(int handle, unsigned int cmd, unsigned int *arg);

• 参数

参数说明
hdle显示驱动句柄
cmdDISP_HDMI_GET_HPD_STATUS
argarg[0] 为显示通道0/1

• 返回值

如果HDMI 插入，则返回1；如果未插入，则返回0。

• 描述

该函数用于指定HDMI 是否处于插入状态。

• 示例

//查询HDMI是否处于插入状态
unsigned int arg[3];
arg[0] = 0;//显示通道0
if (ioctl(disphd, DISP_HDMI_GET_HPD_STATUS, (void*)arg) == 1)
printf("hdmi plug in\n");
else
printf("hdmi plug out\n");

8 sysfs 接口描述

以下两个函数在下面接口的demo 中会使用到。

    const int MAX_LENGTH = 128;
    const int MAX_DATA = 128;
    static ssize_t read_data(const char *sysfs_path, char *data)
    {
        ssize_t err = 0;
        FILE *fp = NULL;
        fp = fopen(sysfs_path, "r");
        if (fp) {
            err = fread(data, sizeof(char), MAX_DATA ,fp);
            fclose(fp);
        }
        return err;
    }
    static ssize_t write_data(const char *sysfs_path, const char *data, size_t len)
    {
        ssize_t err = 0;
        int fd = -1;
        fd = open(sysfs_path, O_WRONLY);
        if (fp) {
            errno = 0;
            err = write(fd, data, len);
            if (err < 0) {
                err = -errno;
    }
    close(fd);
    } else {
        ALOGE("%s: Failed to open file: %s error: %s", __FUNCTION__, sysfs_path,
        strerror(errno));
        err = -errno;
    }
    return err;
    }

8.1 enhance

8.1.1 enhance_mode

• 系统节点

/sys/class/disp/disp/attr/disp
/sys/class/disp/disp/attr/enhance_mode

• 参数

参数说明
disp display channel比如0: disp0, 1：disp1
enhance_mode0：standard, 1: enhance, 2: soft, 3: enahnce + demo

• 返回值

no。

• 描述

该接口用于设置色彩增强的模式。

• 示例

//设置disp0 的色彩增强的模式为增强模式
echo 0 > /sys/class/disp/disp/attr/disp;
echo 1 > /sys/class/disp/disp/attr/enhance_mode;
//设置disp1 的色彩增强的模式为柔和模式
echo 1 > /sys/class/disp/disp/attr/disp;
echo 2 > /sys/class/disp/disp/attr/enhance_mode;
//设置disp0 的色彩增强的模式为增加模式，并且开启演示模式
echo 0 > /sys/class/disp/disp/attr/disp;
echo 3 > /sys/class/disp/disp/attr/enhance_mode;

c/c++ 代码：

char sysfs_path[MAX_LENGTH];
char sysfs_data[MAX_DATA];
unisgned int disp = 0
unsigned int enhance_mode = 1;
snprintf(sysfs_path,sizeof(sysfs_full_path),"sys/class/disp/disp/attr/disp");
snprintf(sysfs_data, sizeof(sysfs_data),"%d",disp);
write_data(sysfs_path, sys_data, strlen(sysfs_data));
snprintf(sysfs_path,sizeof(sysfs_full_path),
"/sys/class/disp/disp/attr/enhance_mode");
snprintf(sysfs_data, sizeof(sysfs_data), "%d",enhance_mode);
write_data(sysfs_path, sys_data, strlen(sysfs_data));

8.1.2 enhance_bright/contrast/saturation/edge/detail/denoise

• 系统节点

/sys/class/disp/disp/attr/disp
/sys/class/disp/disp/attr/enhance_bright /* 亮度*/
/sys/class/disp/disp/attr/enhance_contrast /* 对比度*/
/sys/class/disp/disp/attr/enhance_saturation /* 饱和*/
/sys/class/disp/disp/attr/enhance_edge /* 边缘锐度*/
/sys/class/disp/disp/attr/enhance_detail /* 细节增强*/
/sys/class/disp/disp/attr/enhance_denoise /* 降噪*/

• 参数

disp display channel，比如0: disp0, 1：disp1。
enhance_xxx： 范围：0~100，数据越大，调节幅度越大。

• 返回值
no。

• 描述

该接口用于设置图像的亮度/对比度/饱和度/边缘锐度/细节增强/降噪的调节幅度。

• 示例

//设置disp0 的图像亮度为80
echo 0 > /sys/class/disp/disp/attr/disp;
echo 80 > /sys/class/disp/disp/attr/enhance_bright;
//设置disp1 的饱和度为50
echo 1 > /sys/class/disp/disp/attr/disp;
echo 50 > /sys/class/disp/disp/attr/enhance_saturation;

c/c++ 代码：

char sysfs_path[MAX_LENGTH];
char sysfs_data[MAX_DATA];
unisgned int disp = 0
unsigned int enhance_bright = 80;
snprintf(sysfs_path,sizeof(sysfs_full_path),"sys/class/disp/disp/attr/disp");
snprintf(sysfs_data, sizeof(sysfs_data),"%d",disp);
write_data(sysfs_path, sys_data, strlen(sysfs_data));
snprintf(sysfs_path,sizeof(sysfs_full_path),
"/sys/class/disp/disp/attr/enhance_bright");
snprintf(sysfs_data, sizeof(sysfs_data), "%d",enhance_bright);
write_data(sysfs_path, sys_data, strlen(sysfs_data));

8.2 hdmi edid

8.2.1 edid

• 系统节点

/sys/class/hdmi/hdmi/attr/edid

• 参数

no。

• 返回值

Edid data(1024 bytes)。

• 描述

该接口用于读取EDID 的裸数据。

• 示例

// 读取edid数据
cat /sys/class/hdmi/hdmi/attr/edid

c/c++ 代码：

#define EDID_MAX_LENGTH 1024
char sysfs_path[MAX_LENGTH];
char sysfs_data[EDID_MAX_LENGTH];
ssize_t edid_length;
snprintf(sysfs_path,sizeof(sysfs_full_path),"/sys/class/hdmi/hdmi/attr/edid");
edid_length = read_data(sysfs_path, sys_data);

8.2.2 hpd

• 系统节点

/sys/class/switch/hdmi/state

• 参数

no。

• 返回值

Hdmi hotplut state, 0: unplug; 1: plug in。

• 描述

该接口用于读取HDMI 的热插拔状态。

• 示例

// 读取HDMI热插拔状态
cat /sys/class/switch/hdmi/state

c/c++代码：

char sysfs_path[MAX_LENGTH];
char sysfs_data[MAX_DATA];
int hpd;
snprintf(sysfs_path,sizeof(sysfs_full_path),"/sys/class/hdmi/hdmi/attr/edid");
read_data(sysfs_path, sys_data);
hpd = atoi(sys_data);
If (hpd)
printf("hdmi plug in\n");
else
printf("hdmi unplug \n");

8.2.3 hdcp_enable

• 系统节点

/sys/class/hdmi/hdmi/attr/hdcp_enable

• 参数

enable: 0: disable hdmi hdcp function；1：enable hdmi hdcp function。

• 返回值

No returns。

• 描述

该接口用于使能、关闭hdmi hdcp 功能。

• 示例

// 开启hdmi hdcp功能
echo 1 > /sys/class/hdmi/hdmi/attr/hdcp_enable
// 关闭hdmi hdcp功能
echo 0 > /sys/class/hdmi/hdmi/attr/hdcp_enable

c/c++ 代码：

char sysfs_path[MAX_LENGTH];
char sysfs_data[MAX_DATA];
snprintf(sysfs_path,sizeof(sysfs_full_path),"/sys/class/hdmi/hdmi/attr/hdcp_enable");
snprintf(sysfs_data, sizeof(sysfs_data),"%d",1);
write_data(sysfs_path, sys_data, strlen(sysfs_data));

9 Data Structure

9.1 disp_fb_info

• 原型

typedef struct
{
    unsigned long long addr[3]; /* address of frame buffer,
    single addr for interleaved fomart,
    double addr for semi-planar fomart
    triple addr for planar format */
    disp_rectsz size[3]; //size for 3 component,unit: pixels
    unsigned int align[3]; //align for 3 comonent,unit: bytes(align=2^n,i.e
    .1/2/4/8/16/32..
    disp_pixel_format format;
    disp_color_space color_space; //color space
    unsigned int trd_right_addr[3];/* right address of 3d fb,
    used when in frame packing 3d mode */
    bool pre_multiply; //true: pre-multiply fb
    disp_rect64 crop; //crop rectangle boundaries
    disp_buffer_flags flags; //indicate stereo or non-stereo buffer
    disp_scan_flags scan; //scan type & scan order
}disp_fb_info;

• 成员

变量说明
addrframebuffer 的内容地址，对于interleaved 类型，只有addr[0] 有效；planar 类型，三个都有；UV combined 的类型addr[0]，addr[1]有效
sizesize of framebuffer, 单位为pixel
align对齐位宽，为2 的指数
formatpixel format, 详见disp_pixel_format
color_spacecolor space mode, 详见disp_cs_mode
b_trd_src1:3D source; 0：2D source
trd_modesource 3D mode, 详见disp_3d_src_mode
trd_right_addrused when in frame packing 3d mode
crop用于显示的buffer 裁减区
flags标识2D 或3D 的buffer
scan标识描述类型，progress, interleaved

• 描述

disp_fb_info 用于描述一个display frambuffer 的属性信息。

9.2 disp_layer_info

• 原型

typedef struct
{
    disp_layer_mode mode;
    unsigned char zorder; /*specifies the front-to-back ordering of the layers on
    the screen,
    the top layer having the highest Z value
    can't set zorder, but can get */
    unsigned char alpha_mode; //0: pixel alpha; 1: global alpha; 2: global
    pixel alpha
    unsigned char alpha_value; //global alpha value
    disp_rect screen_win; //display window on the screen
    bool b_trd_out; //3d display
    disp_3d_out_mode out_trd_mode;//3d display mode
    union {
        unsigned int color; //valid when LAYER_MODE_COLOR
        disp_fb_info fb; //framebuffer, valid when LAYER_MODE_BUFFER
    };
    unsigned int id; /* frame id, can get the id of frame display currently
    by DISP_LAYER_GET_FRAME_ID */
}disp_layer_info;

• 成员

变量说明
mode图层的模式，详见disp_layer_mode
zorderlayer zorder, 优先级高的图层可能会覆盖优先级低的图层
alpha_mode0:pixel alpha, 1:global alpha, 2:global pixel alpha
alpha_valuelayer global alpha value，valid while alpha_mode(1/2)
screenn_winscreen window，图层在屏幕上显示的矩形窗口
fbframebuffer 的属性，详见disp_fb_info,valid when BUFFER_MODE
colordisplay color, valid when COLOR_MODE
b_trd_outif output in 3d mode,used for scaler layer
out_trd_modeoutput 3d mode, 详见disp_3d_out_mode
idframe id, 设置给驱动的图像帧号，可以通过DISP_LAYER_GET_FRAME_ID 获取当前显示的帧号，以做一下特定的处理，比如释放掉已经显示完成的图像帧buffer。

• 描述

disp_layer_info 用于描述一个图层的属性信息。

9.3 disp_layer_config

• 原型

typedef struct
{
    disp_layer_info info;
    bool enable;
    unsigned int channel;
    unsigned int layer_id;
}disp_layer_config;

• 成员

变量说明
info图像的信息属性
enable使能标志
channel图层所在的通道id（0/1/2/3）
layer_id图层的id，此id 是在通道内的图层id。即(channel,layer_id)=(0,0) 表示通道0 中的图层0 之意

• 描述

disp_layer_config 用于描述一个图层配置的属性信息。

9.4 disp_color_info

• 原型

typedef struct
{
    u8 alpha;
    u8 red;
    u8 green;
    u8 blue;
}disp_color_info;

• 成员

变量说明
alpha颜色的透明度
red红
green绿
blue蓝

• 描述

disp_color_info 用于描述一个颜色的信息。

9.5 disp_rect

• 原型

typedef struct
{
    s32 x;
    s32 y;
    u32 width;
    u32 height;
}disp_rect;

• 成员

变量参数
ｘ起点x 值
y起点y 值
width宽
height高

• 描述

disp_rect 用于描述一个矩形窗口的信息。

9.6 disp_rect64

• 原型

typedef struct
{
    long long x;
    long long y;
    long long width;
    long long height;
}disp_rect64;

• 成员

变量说明
x起点x 值, 定点小数，高32bit 为整数，低32bit 为小数
y起点y 值, 定点小数，高32bit 为整数，低32bit 为小数
width宽, 定点小数，高32bit 为整数，低32bit 为小数
height高, 定点小数，高32bit 为整数，低32bit 为小数

• 描述

disp_rect64 用于描述一个矩形窗口的信息。

9.7 disp_position

• 原型

typedef struct
{
    s32 x;
    s32 y;
}disp_posistion;

• 成员

变量说明
xx
yy

• 描述

disp_position 用于描述一个坐标的信息。

9.8 disp_rectsz

• 原型

typedef struct
{
    u32 width;
    u32 height;
}disp_rectsz;

• 成员

变量说明
width宽
height高

• 描述

disp_rectsz 用于描述一个矩形尺寸的信息。

9.9 disp_pixel_format

• 原型

typedef enum
{
    DISP_FORMAT_ARGB_8888 = 0x00,//MSB A-R-G-B LSB
    DISP_FORMAT_ABGR_8888 = 0x01,
    DISP_FORMAT_RGBA_8888 = 0x02,
    DISP_FORMAT_BGRA_8888 = 0x03,
    DISP_FORMAT_XRGB_8888 = 0x04,
    DISP_FORMAT_XBGR_8888 = 0x05,
    DISP_FORMAT_RGBX_8888 = 0x06,
    DISP_FORMAT_BGRX_8888 = 0x07,
    DISP_FORMAT_RGB_888 = 0x08,
    DISP_FORMAT_BGR_888 = 0x09,
    DISP_FORMAT_RGB_565 = 0x0a,
    DISP_FORMAT_BGR_565 = 0x0b,
    DISP_FORMAT_ARGB_4444 = 0x0c,
    DISP_FORMAT_ABGR_4444 = 0x0d,
    DISP_FORMAT_RGBA_4444 = 0x0e,
    DISP_FORMAT_BGRA_4444 = 0x0f,
    DISP_FORMAT_ARGB_1555 = 0x10,
    DISP_FORMAT_ABGR_1555 = 0x11,
    DISP_FORMAT_RGBA_5551 = 0x12,
    DISP_FORMAT_BGRA_5551 = 0x13,
    /* SP: semi-planar, P:planar, I:interleaved
    * UVUV: U in the LSBs; VUVU: V in the LSBs */
    DISP_FORMAT_YUV444_I_AYUV = 0x40,//MSB A-Y-U-V LSB
    DISP_FORMAT_YUV444_I_VUYA = 0x41,//MSB V-U-Y-A LSB
    DISP_FORMAT_YUV422_I_YVYU = 0x42,//MSB Y-V-Y-U LSB
    DISP_FORMAT_YUV422_I_YUYV = 0x43,//MSB Y-U-Y-V LSB
    DISP_FORMAT_YUV422_I_UYVY = 0x44,//MSB U-Y-V-Y LSB
    DISP_FORMAT_YUV422_I_VYUY = 0x45,//MSB V-Y-U-Y LSB
    DISP_FORMAT_YUV444_P = 0x46,//MSB P3-2-1-0 LSB, YYYY UUUU VVVV
    DISP_FORMAT_YUV422_P = 0x47,//MSB P3-2-1-0 LSB YYYY UU VV
    DISP_FORMAT_YUV420_P = 0x48,//MSB P3-2-1-0 LSB YYYY U V
    DISP_FORMAT_YUV411_P = 0x49,//MSB P3-2-1-0 LSB YYYY U V
    DISP_FORMAT_YUV422_SP_UVUV = 0x4a,//MSB V-U-V-U LSB
    DISP_FORMAT_YUV422_SP_VUVU = 0x4b,//MSB U-V-U-V LSB
    DISP_FORMAT_YUV420_SP_UVUV = 0x4c,
    DISP_FORMAT_YUV420_SP_VUVU = 0x4d,
    DISP_FORMAT_YUV411_SP_UVUV = 0x4e,
    DISP_FORMAT_YUV411_SP_VUVU = 0x4f,
}disp_pixel_format;

• 成员

变量说明
DISP_FORMAT_ARGB_888832bpp, A 在最高位，B 在最低位
DISP_FORMAT_YUV420_Pplanar yuv 格式，分三块存放，需三个地址，P3在最高位
DISP_FORMAT_YUV422_SP_UVUVsemi-planar yuv 格式，分两块存放，需两个地址，U 在低位
DISP_FORMAT_YUV422_SP_VUVUsemi-planar yuv 格式，分两块存放，需两个地址，V 在低位

• 描述

disp_pixel_format 用于描述像素格式。

9.10 disp_buffer_flags

• 原型

typedef enum
{
    DISP_BF_NORMAL = 0,//non-stereo
    DISP_BF_STEREO_TB = 1 << 0,//stereo top-bottom
    DISP_BF_STEREO_FP = 1 << 1,//stereo frame packing
    DISP_BF_STEREO_SSH = 1 << 2,//stereo side by side half
    DISP_BF_STEREO_SSF = 1 << 3,//stereo side by side full
    DISP_BF_STEREO_LI = 1 << 4,//stereo line interlace
}disp_buffer_flags;

• 成员

变量说明
DISP_BF_NORMAL2d
DISP_BF_STEREO_TB top bottom模式
DISP_BF_STEREO_FPframepacking
DISP_BF_STEREO_SSFside by side full, 左右全景
DISP_BF_STEREO_SSHside by side half, 左右半景
DISP_BF_STEREO_LIline interleaved, 行交错模式

• 描述

disp_buffer_flags 用于描述3D 源模式。

9.11 disp_3d_out_mode

• 原型

typedef enum
{
    //for lcd
    DISP_3D_OUT_MODE_CI_1 = 0x5,//column interlaved 1
    DISP_3D_OUT_MODE_CI_2 = 0x6,//column interlaved 2
    DISP_3D_OUT_MODE_CI_3 = 0x7,//column interlaved 3
    DISP_3D_OUT_MODE_CI_4 = 0x8,//column interlaved 4
    DISP_3D_OUT_MODE_LIRGB = 0x9,//line interleaved rgb
    //for hdmi
    DISP_3D_OUT_MODE_TB = 0x0,//top bottom
    DISP_3D_OUT_MODE_FP = 0x1,//frame packing
    DISP_3D_OUT_MODE_SSF = 0x2,//side by side full
    DISP_3D_OUT_MODE_SSH = 0x3,//side by side half
    DISP_3D_OUT_MODE_LI = 0x4,//line interleaved
    DISP_3D_OUT_MODE_FA = 0xa,//field alternative
}disp_3d_out_mode;

• 成员

for lcd：

变量说明
DISP_3D_OUT_MODE_CI_1列交织
DISP_3D_OUT_MODE_CI_2列交织
DISP_3D_OUT_MODE_CI_3列交织
DISP_3D_OUT_MODE_CI_4列交织
DISP_3D_OUT_MODE_LIRGB行交织

for hdmi：

变量说明
DISP_3D_OUT_MODE_TB top bottom上下模式
DISP_3D_OUT_MODE_FPframepacking
DISP_3D_OUT_MODE_SSFside by side full, 左右全景
DISP_3D_OUT_MODE_SSHside by side half, 左右半景
DISP_3D_OUT_MODE_LIline interleaved, 行交织
DISP_3D_OUT_MODE_FAfield alternate 场交错

• 描述

disp_3d_out_mode 用于描述3D 输出模式。

9.12 disp_color_space

• 原型

typedef enum
{
    DISP_BT601 = 0,
    DISP_BT709 = 1,
    DISP_YCC = 2,
}disp_color_mode;

• 成员

变量说明
DISP_BT601用于标清视频
DISP_BT709用于高清视频
DISP_YCC用于图片

• 描述

disp_color_space 用于描述颜色空间类型。

9.13 disp_output_type

• 原型

typedef enum
{
    DISP_OUTPUT_TYPE_NONE = 0,
    DISP_OUTPUT_TYPE_LCD = 1,
    DISP_OUTPUT_TYPE_TV = 2,
    DISP_OUTPUT_TYPE_HDMI = 4,
    DISP_OUTPUT_TYPE_VGA = 8,
}disp_output_type;

• 成员

变量说明
DISP_OUTPUT_TYPE_NONE无显示输出
DISP_OUTPUT_TYPE_LCDLCD 输出
DISP_OUTPUT_TYPE_TVTV 输出
DISP_OUTPUT_TYPE_HDMIHDMI 输出
DISP_OUTPUT_TYPE_VGAVGA 输出

• 描述

disp_output_type 用于描述显示输出类型。

9.14 disp_tv_mode

• 原型

typedef enum
{
    DISP_TV_MOD_480I = 0,
    DISP_TV_MOD_576I = 1,
    DISP_TV_MOD_480P = 2,
    DISP_TV_MOD_576P = 3,
    DISP_TV_MOD_720P_50HZ = 4,
    DISP_TV_MOD_720P_60HZ = 5,
    DISP_TV_MOD_1080I_50HZ = 6,
    DISP_TV_MOD_1080I_60HZ = 7,
    DISP_TV_MOD_1080P_24HZ = 8,
    DISP_TV_MOD_1080P_50HZ = 9,
    DISP_TV_MOD_1080P_60HZ = 0xa,
    DISP_TV_MOD_1080P_24HZ_3D_FP = 0x17,
    DISP_TV_MOD_720P_50HZ_3D_FP = 0x18,
    DISP_TV_MOD_720P_60HZ_3D_FP = 0x19,
    DISP_TV_MOD_1080P_25HZ = 0x1a,
    DISP_TV_MOD_1080P_30HZ = 0x1b,
    DISP_TV_MOD_PAL = 0xb,
    DISP_TV_MOD_PAL_SVIDEO = 0xc,
    DISP_TV_MOD_NTSC = 0xe,
    DISP_TV_MOD_NTSC_SVIDEO = 0xf,
    DISP_TV_MOD_PAL_M = 0x11,
    DISP_TV_MOD_PAL_M_SVIDEO = 0x12,
    DISP_TV_MOD_PAL_NC = 0x14,
    DISP_TV_MOD_PAL_NC_SVIDEO = 0x15,
    DISP_TV_MOD_3840_2160P_30HZ = 0x1c,
    DISP_TV_MOD_3840_2160P_25HZ = 0x1d,
    DISP_TV_MOD_3840_2160P_24HZ = 0x1e,
    DISP_TV_MODE_NUM = 0x1f,
}disp_tv_mode;

• 成员

• 描述

disp_tv_mode 用于描述TV 输出模式。

9.15 disp_output

• 原型

typedef struct
{
    unsigned int type;
    unsigned int mode;
}disp_output;

• 成员

变量说明
Type输出类型
Mode输出模式，480P/576P, etc

• 描述

disp_output 用于描述显示输出类型，模式。

9.16 disp_layer_mode

• 原型

typedef enum
{
    LAYER_MODE_BUFFER = 0,
    LAYER_MODE_COLOR = 1,
}disp_layer_mode;

• 成员

变量说明
LAYER_MODE_BUFFERbuffer 模式，带buffer 的图层
LAYER_MODE_COLOR单色模式，无buffer 的图层，只需要一个颜色值表示图像内容

• 描述

disp_layer_mode 用于描述图层模式。

9.17 disp_scan_flags

• 原型

typedef enum
{
    DISP_SCAN_PROGRESSIVE = 0,//non interlace
    DISP_SCAN_INTERLACED_ODD_FLD_FIRST = 1 << 0,//interlace ,odd field first
    DISP_SCAN_INTERLACED_EVEN_FLD_FIRST = 1 << 1,//interlace,even field first
}disp_scan_flags;

• 成员

变量说明
DISP_SCAN_PROGRESSIVE逐行模式
DISP_SCAN_INTERLACED_ODD_FLD_FIRST隔行模式，奇数行优先
DISP_SCAN_INTERLACED_EVEN_FLD_FIRST隔行模式，偶数行优先

• 描述
disp_scan_flags 用于描述显示Buffer 的扫描方式。

10 调试

10.1 查看显示模块的状态

cat /sys/class/disp/disp/attr/sys

示例如下：

# cat /sys/class/disp/disp/attr/sys
screen 0:
de_rate 432000000 Hz /* de 的时钟频率*/, ref_fps=50 /* 输出设备的参考刷新率*/
hdmi output mode(4) fps:50.5 1280x 720
err:0 skip:54 irq:21494 vsync:0
BUF enable ch[0] lyr[0] z[0] prem[N] a[globl 255] fmt[ 1] fb
[1920,1080;1920,1080;1920,1080] crop[ 0, 0,1920,1080] frame[ 32, 18,1216, 684]
addr[716da000, 0, 0] flags[0x 0] trd[0,0]
screen 1:
de_rate 432000000 Hz /* de 的时钟频率*/, ref_fps=50 /* 输出设备的参考刷新率*/
tv output mode(11) fps:50.5 720x 576 /* TV 输出| 模式为（11：PAL） | 刷新率为：50.5Hz | 分辨
率为：720x576 */
err:0 skip:54 irq:8372 vsync:0
BUF enable ch[0] lyr[0] z[0] prem[Y] a[globl 255] fmt[ 0] fb[ 720, 576; 720, 576; 720,
576] crop[ 0, 0, 720, 576] frame[ 18, 15, 684, 546]
addr[739a8000, 0, 0] flags[0x 0] trd[0,0]
acquire: 225, 2.6 fps
release: 224, 2.6 fps
display: 201, 2.5 fps

图层各信息描述如下：

BUF: 图层类型，BUF/COLOR，一般为BUF，即图层是带BUFFER 的。COLOR 意思是显示一个纯色的画面，不带
BUFFER。
enable: 显示处于enable 状态。
ch[0]: 该图层处于blending 通道0。
lyr[0]: 该图层处于当前blending 通道中的图层0。
z[0]: 图层z 序，越小越在底部，可能会被z 序大的图层覆盖住。
prem[Y]: 是否预乘格式，Y 是，N 否。
a: alpha 参数， globl/pixel/; alpha 值。
fmt: 图层格式，值64 以下为RGB 格式；以上为YUV 格式，常见的72 为YV12,76 为NV12。
fb: 图层buffer 的size，width,height，三个分量。
crop: 图像buffer 中的裁减区域， [x,y,w,h]。
frame: 图层在屏幕上的显示区域，[x,y,w,h]。
addr: 三个分量的地址。
flags: 一般为0， 3D SS 时0x4, 3D TB 时为0x1, 3D FP 时为0x2。
trd: 是否3D 输出，3D 输出的类型（HDMI FP 输出时为1）各counter 描述如下：
err： de 缺数的次数，de 缺数可能会出现屏幕抖动，花屏的问题。de 缺数一般为带宽不足引起。
skip: 表示de 跳帧的次数，跳帧会出现卡顿问题。跳帧是指本次中断响应较慢，de 模块判断在本次中断已经接近或
者超过了消隐区，将放弃本次更新图像的机会，选择继续显示原有的图像。
irq: 表示该通路上垂直消隐区中断执行的次数，一直增长表示该通道上的timing。
controller 正在运行当中。
vsync:表示显示模块往用户空间中发送的vsync 消息的数目，一直增长表示正在不断地发送中。
acquire/release/display 含义如下,只在android 方案中有效。
acquire： 是hw composer 传递给disp driver 的图像帧数以及帧率，帧率只要有在有图像更新时才有效，静止
时的值是不准确的。
release: 是disp driver 显示完成之后，返还给android 的图像帧数以及帧率，帧率只要有在有图像更新时才有
效，静止时的值是不准确的。
display： 是disp 显示到输出设备上的帧数以及帧率，帧率只要有在有图像更新时才有效，静止时的值是不准确的如
果acquire 与release 不一致，说明disp 有部分图像帧仍在使用，未返还，差值在1~2 之间为正常值。二者不能
相等，如果相等，说明图像帧全部返还，显示将会出。
现撕裂现象。如果display 与release 不一致，说明在disp 中存在丢帧情况，原因为在一个active 区内
hwcomposer 传递多于一帧的图像帧下来。

调试说明：

1. 对于android 系统，可以dumpsys SurfaceFlinger 打印surface 的信息，如果信息与disp 中sys 中的信息不一致，很大可能是hwc 的转换存在问题。
2. 如果发现图像刷新比较慢，存在卡顿问题，可以看一下输出设备的刷新率，对比一下ref_fps 与fps 是否一致，如果不一致，说明tcon 的时钟频率或timing 没配置正确。如果ref_fps 与屏的spec 不一致，则需要检查sys_config 中的时钟频率和timing配置是否正确。屏一般为60Hz，而如果是TV 或HDMI，则跟模式有关，比较常
见的为60/50/30/24Hz。
如果是android 方案，还可以看一下display 与release 的counter 是否一致，如果相差太大，说明android送帧不均匀，造成丢帧。
3. 如果发现图像刷新比较慢，存在卡顿问题，也需要看一下skip counter，如果skip counter 有增长，说明现在的系统负荷较重，对vblank 中断的响应较慢，出现跳帧，导致了图像卡顿问题。
4. 如果屏不亮，怀疑背光时，可以看一下屏的背光值是否为0。如果为0，说明上层传递下来的背光值不合理；如果不为0，背光还是不亮，则为驱动或硬件问题了。硬件上可以通过测量bl_en 以及pwm 的电压值来排查问题。
5. 如果花屏或图像抖动，可以查看err counter，如果err counter 有增长，则说明de缺数，有可能是带宽不足，或者瞬时带宽不足问题。

10.2 截屏

echo 0 > /sys/class/disp/disp/attr/disp
echo /data/filename.bmp > /sys/class/disp/disp/attr/capture_dump

该调试方法用于截取DE 输出到TCON 前的图像，用于显示通路上分段排查。如果截屏没有问题而界面异常，可以确定TCON 到显示器间出错。

第一个路径接受显示器索引0 或1。

第二个路径接受文件路径。

10.3 colorbar

echo 0 > /sys/class/disp/disp/attr/disp
echo > /sys/class/disp/disp/attr/colorbar

第一个路径接受显示器索引0 或1。

第二个路径表示TCON 选择的输入源。1，DE 输出；2-7，TCON 自检用的colorbar；8,DE自检用的colorbar。

10.4 显示模块debugfs 接口

10.4.1 总述

调试节点

mount -t debugfs none /sys/kernek/debug;
/sys/kernel/debug/dispdbg;

name command param start info
//name: 表示操作的对象名字
//command: 表示执行的命令
//param: 表示该命令接收的参数
//start: 输入1 开始执行命令
//info: 保存命令执行的结果
//只读，大小是1024 bytes。

10.4.2 切换显示输出设备

name: disp0/1/2 //表示显示通道0/1/2
command: switch
param: type mode
//参数说明：type:0(none),1(lcd),2(tv),4(hdmi),8(vga)
//mode 详见disp_tv_mode 定义
/* 例子*/
/* 显示通道0 输出LCD */
echo disp0 > name;echo switch > command;echo 1 0 > param;echo 1 > start;
/* 关闭显示通道0 的输出*/
echo disp0 > name;echo switch > command;echo 0 0 > param;echo 1 > start;

10.4.3 开关显示输出设备

name: disp0/1/2 //表示显示通道0/1/2
command: blank
param: 0/1
//参数说明：1 表示blank，即关闭显示输出；0 表示unblank，即开启显示输出
/* 例子*/
/* 关闭显示通道0 的显示输出*/
echo disp0 > name;echo blank > command;echo 1 > param;echo 1 > start;
/* 开启显示通道1 的显示输出*/
echo disp1 > name;echo blank > command;echo 0 > param;echo 1 > start;

10.4.4 电源管理(suspend/resume) 接口

name: disp0/1/2 //表示显示通道0/1/2
command: suspend/resume //休眠，唤醒命令
param: 无
/* 例子*/
/* 让显示模块进入休眠状态*/
echo disp0 > name;echo suspend > command;echo 1 > start;
/* 让显示模块退出休眠状态*/
echo disp1 > name;echo resume > command;echo 1 > start;

10.4.5 调节lcd 屏幕背光

name: lcd0/1/2 //表示lcd0/1/2
command: setbl //设置背光亮度
param: xx
//参数说明：背光亮度值，范围是0~255。
/* 例子*/
/* 设置背光亮度为100 */
echo lcd0 > name;echo setbl > command;echo 100 > param;echo 1 > start;
/* 设置背光亮度为0 */
echo lcd0 > name;echo setbl > command;echo 0 > param;echo 1 > start;

10.4.6 vsync 消息开关

name: disp0/1/2 //表示显示通道0/1/2
command: vsync_enable //开启/关闭vsync 消息
param: 0/1
//参数说明：0：表示关闭； 1：表示开启
/* 例子*/
/* 关闭显示通道0 的vsync 消息*/
echo disp0 > name;echo vsync_enable > command;echo 0 > param;echo 1 > start;
/* 开启显示通道1 的vsync 消息*/
echo disp1 > name;echo vsync_enable > command;echo 1 > param;echo 1 > start;

10.4.7 查看enhance 的状态

name: enhance0/1/2 //表示enhance0/1/2
command: getinfo //获取enhance 的状态
param: 无
/* 例子*/
/* 获取显示通道0 的enhance 状态信息*/
# echo enhance0 > name;echo getinfo > command;echo 1 > start;cat info;
# enhance 0: enable, normal

10.4.8 查看智能背光的状态

name: smbl0/1/2 //表示显示通道0/1/2
command: getinfo //获取smart backlight 的状态
param: 无
/* 例子*/
/* 获取显示通道0 的smbl 状态信息*/
# echo smbl0 > name;echo getinfo > command;echo 1 > start;cat info;
# smbl 0: disable, window<0,0,0,0>, backlight=0, save_power=0 percent
//显示的是智能背光是否开启，有效窗口大小，当前背光值，省电比例

10.5 常见问题

10.5.1 黑屏（无背光）

问题现象：机器接LCD 输出，发现LCD 没有任何显示，仔细查看背光也不亮。

问题分析：此现象说明LCD 背光供电不正常，不排除还有其他问题，但没背光的问题必须先解决。

问题排查步骤：

• 步骤一

使用电压表量LCD 屏的各路电压，如果背光管脚电压不正常，确定是PWM 问题。否则，尝试换个屏再试。

• 步骤二

先看看随sdk 有没发布PWM 模块使用指南，如果有按照里面步骤进行排查。

• 步骤三

如果sdk 没有发布PWM 模块使用指南。可以cat /sys/kernel/debug/pwm 看看有没输出。如果没有就是PWM 驱动没有加载，请检查一下menuconfig 有没打开。

• 步骤四

如果步骤三未解决问题，请排查dts 或board.dts 配置。如果还没有解决，可以寻求技术支持。

10.5.2 黑屏（有背光）

问题现象：机器接LCD，发现有背光，界面输出黑屏。

问题分析：此现象说明没有内容输出，可能是DE、TCON 出错或应用没有送帧。

问题排查步骤：

• 步骤一

根据10.1 章节排查应用输入的图层信息是否正确。其中，宽高、显存的文件句柄出错问题最多。

• 步骤二

根据10.2 章节截屏，看看DE 输出是否正常。如果不正常，排查DE 驱动配置是否正确；如果正常，接着下面步骤。

• 步骤三
根据10.3 章节输出colorbar，如果TCON 自身的colorbar 也没有显示，排查硬件通路；如果
有显示，排查TCON 输入源选择的寄存器。后者概率很低，此时可寻求技术支持。

10.5.3 绿屏

问题现象：显示器出现绿屏，切换界面可能有其他变化。

问题分析：此现象说明处理图层时DE 出错。可能是应用送显的buffer 内容或者格式有问题；也

可能DE 配置出错。

问题排查步骤：

• 步骤一

根据10.1 章节排查应用输入的图层信息是否正确。其中，图层格式填错的问题最多。

• 步骤二

导出DE 寄存器，排查异常。此步骤比较复杂，需要寻求技术支持。

10.5.4 界面卡住

问题现象：界面定在一个画面，不再改变。

问题分析：此现象说明显示通路一般是正常的，只是应用没有继续送帧。

问题排查步骤：

• 步骤一

根据10.1 章节排查应用输入的图层信息有没改变，特别关注图层的地址。

• 步骤二

排查应用送帧逻辑，特别关注死锁，线程、进行异常退出，fence 处理异常。

10.5.5 局部界面花屏

问题现象：画面切到特定场景时候，出现局部花屏，并不断抖动。

问题分析：此现象是典型的DE scaler 出错现象。

问题排查步骤：

根据10.1 章节查看问题出现时带缩放图层的参数。如果屏幕输出的宽x 高除以crop 的宽x 高小于1/16 或者大于32，那么该图层不能走DE 缩放，改用GPU，或应

用修改图层宽高。

10.5.6 快速切换界面花屏

问题现象：快速切换界面花屏，变化不大的界面显示正常。

问题分析：此现象是典型的性能问题，与显示驱动关系不大。

问题排查步骤：

• 步骤一

排查DRAM 带宽是否满足场景需求。

• 步骤二

若是安卓系统，排查fence 处理流程；若是纯linux 系统，排查送帧流程、swap buffer、pandisplay流程。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/124173.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

操作系统期末考试必会题库1——引言+用户界面

操作系统期末考试必会题库1——引言+用户界面

1.请简要描述操作系统的定义及其功能。 操作系统定义&#xff1a; 是计算机系统中的一个系统软件&#xff0c;是一些程序模块的集合 &#xff0c;它们管理和控制计算机系统中的软硬件资源&#xff0c;合理的组织计算机的工作流程&#xff0c;以便有效的利用这些资源为用户提供一…
阅读更多...
Linux用户权限详解

Linux用户权限详解

为什么有人冲了钱就能享受至尊VIP待遇&#xff1f;为什么冲了黄钻、绿钻、紫钻就会享受一些特殊活动呢&#xff1f;我们起初都是一群普通用户&#xff0c;为什么有些人就能通过某些手段得到一些异于常人的服务呢&#xff1f;这其中的奥秘是什么呢&#xff1f;接下来带大家了解这…
阅读更多...
【Vue】course_1

【Vue】course_1

一、vue简介 Vue是一款用于构建用户界面的 JavaScript 框架。 它基于标准 HTML、CSS 和 JavaScript 构建&#xff0c;并提供了一套声明式的、组件化的编程模型&#xff0c;帮助你高效地开发用户界面。 无论是简单还是复杂的界面&#xff0c;Vue 都可以胜任。 二、vue3选项式…
阅读更多...
ASEMI肖特基二极管MBR30100CT和MBR40200PT有什么区别

ASEMI肖特基二极管MBR30100CT和MBR40200PT有什么区别

编辑-Z 别看ASEMI肖特基二极管MBR30100CT和MBR40200PT两种型号从名字上看很像&#xff0c;其实他们的参数和封装都是不一样的&#xff0c;具体MBR30100CT和MBR40200PT有什么区别呢&#xff1f; 肖特基二极管MBR30100CT参数&#xff1a; 型号&#xff1a;MBR30100CT 封装&…
阅读更多...
[开源工具]使用Fiddler/Postman简单计算QPS[新手开箱可用]

[开源工具]使用Fiddler/Postman简单计算QPS[新手开箱可用]

使用Fiddler/Postman简单计算QPS1.什么是QPS?2.怎么计算QPS?3.如何使用Fiddler/Postman得到一个API接口的QPS?3.1Fiddler使用3.2Postman使用4.如何得到本机的核心数?5.根据公式计算QPS?6.扩展计算单机可支撑PV(理论值)?1.什么是QPS? qps即每秒查询率&#xff0c;是对一…
阅读更多...
Postfix + Extmail 企业邮件服务器搭建

Postfix + Extmail 企业邮件服务器搭建

ExtMail套件用于提供从浏览器中登录、使用邮件系统的Web操作界面&#xff0c;而Extman套件用于提供从浏览器中管理邮件系统的Web操作界面。它以GPL版权释出&#xff0c;设计初衷是希望设计一个适应当前高速发展的IT应用环境&#xff0c;满足用户多变的需求&#xff0c;能快速进…
阅读更多...
数据预处理和特征工程-sklearn

数据预处理和特征工程-sklearn

数据挖掘的五大流程&#xff1a; 获取数据数据预处理 数据预处理是从数据中检测&#xff0c;纠正或删除损坏&#xff0c;不准确或不适用于模型的记录的过程。 数据预处理的目的&#xff1a;让数据适应模型&#xff0c;匹配模型的需求特征工程 特征工程是将原始数据转换为更能代…
阅读更多...
NLP 中文智能纠错 API 数据接口

NLP 中文智能纠错 API 数据接口

NLP 中文智能纠错 API 数据接口 专注于中文语句智能纠错&#xff0c;基于 NLP&#xff0c;多模型参与纠错。 1. 产品功能 秒级 NLP 智能纠错性能&#xff1b;NLP 加载多个模型进行纠错处理&#xff1b;返回纠正字符以及对应位置索引&#xff1b;底层模型以及语料库持续更新集…
阅读更多...
正大国际期货：五十句期货投资理念

正大国际期货：五十句期货投资理念

1.许多期货投资人交易时没有计划。交易前&#xff0c;他们既不设定风险限度&#xff0c;也不设定盈利目标。即使是制定了计划&#xff0c;他们总是“半路出家”&#xff0c;并不坚持既定的计划&#xff0c;尤其是在出现亏损的情况下。结果往往是过量操作&#xff0c;把自己逼在…
阅读更多...
Android 操作系统简介

Android 操作系统简介

Android 操作系统简介1. 起源2. 操作系统市场占有率3. Android 系统架构3.1 Linux Kernel3.2 Hardware Abstraction Layer (HAL)3.3 运行时 系统库3.3.1 Android Runtime3.3.1 Native C/C Libraries3.4 Java API Framework3.5 System Apps1. 起源 安卓&#xff08;Android&…
阅读更多...
程序员年底如何升职加薪？这份涨薪指南来了！

程序员年底如何升职加薪？这份涨薪指南来了！

年底了&#xff0c;这个时间节点对于各个公司来说都很重要。 今年大家也知道情况&#xff0c;互联网整体行情都不太好&#xff0c;国外也不好过&#xff0c;硅谷裁员大刀阔斧&#xff0c;实实在在的 感受到了寒意。 能顺利熬到年底的程序员&#xff0c;现在就会关心“公司会普调…
阅读更多...
一分钟搞定Netty 三大组件，如果搞不定，再看3遍

一分钟搞定Netty 三大组件，如果搞不定，再看3遍

1. 三大组件简介 Channel 与 Buffer Java NIO 系统的核心在于&#xff1a;通道 (Channel) 和缓冲区 (Buffer)。通道表示打开到 IO 设备 (例如&#xff1a;文件、套接字) 的连接。若需要使用 NIO 系统&#xff0c;需要获取用于连接 IO 设备的通道 以及用于容纳数据的缓冲区。然…
阅读更多...
黑客使用虚假 DDoS 保护页面分发恶意软件

黑客使用虚假 DDoS 保护页面分发恶意软件

WordPress 网站被黑客入侵后显示欺诈性 Cloudflare DDoS 保护页面&#xff0c;这些页面被用于分发恶意软件&#xff08;例如 NetSupport RAT 和 Raccoon Stealer&#xff09;。 “最近针对 WordPress 网站的 JavaScript 注入激增&#xff0c;通过弹出虚假的 DDoS 阻止提示&…
阅读更多...
DaVinci：跟踪器 - 窗口

DaVinci：跟踪器 - 窗口

调色页面&#xff1a;跟踪器Color&#xff1a;Tracker跟踪器 - 窗口 Tracker - Window&#xff0c;是 DaVinci Resolve 提供的一款强大的跟踪工具。可以利用窗口调板所设置的窗口区域&#xff0c;通过自动分析之后&#xff0c;在此区域内产生许多如云状分布的特征点&#xff08…
阅读更多...
Java8 Stream详细用法介绍

Java8 Stream详细用法介绍

Java8 Stream详细用法介绍一、Stream概述1.1、流的定义1.2、流与集合1.3、流的特性1.4、Stream的创建1.5、Stream操作分类二、Stream API 使用2.1 中间操作2.1.1、filter() 过滤2.1.2、map与flatMap 映射2.1.3、sorted() 排序2.2 终止操作2.2.1、forEach() 遍历2.2.2、collect(…
阅读更多...
ThinkPHP 多应用模式下访问其他应用忽略入口文件

ThinkPHP 多应用模式下访问其他应用忽略入口文件

目录 问题描述&#xff1a; 解决方法&#xff1a; 1.配置两个域名分别指向项目public目录 2.项目全局配置域名绑定应用 问题描述&#xff1a; 使用TP6.0做多应用项目开发&#xff0c;分为前端Api和后台管理 项目中已配置地址重写规则 Api为默认应用&#xff0c;可忽略入…
阅读更多...
Allegro如何手动和自动10度走线操作指导

Allegro如何手动和自动10度走线操作指导

Allegro如何手动和自动10度走线操作指导 PCB上有时需要10度走线，可以有效的避免玻纤效应的产生，尤其是在应对高速设计的时候，Allegro支持10度走线如下图 具体操作如下 选择setup Parameter选择route
阅读更多...
50个超级有用的JavaScript单行代码

50个超级有用的JavaScript单行代码

在这篇文章中&#xff0c;我列出了一个系列的50个 JavaScript 单行代码&#xff0c;它们在使用 vanilla js&#xff08;≥ ES6&#xff09;进行开发时非常有用。它们也是使用该语言在最新版本中为我们提供的所有功能来解决问题的优雅方式。 我将它们分为以下5大类&#xff1a;…
阅读更多...
波士顿房价数据集进行数据预处理和模型训练（Python）

波士顿房价数据集进行数据预处理和模型训练（Python）

目录 前言 一、数据预处理定义 二、波士顿房价数据进行数据预处理 2.1 下载波士顿房价数据集 2.2 查看数据集的描述、特征及数据条数、特征数量 2.3 将数据读入pandas的DataFrame并转存到csv文件 2.4 查看数据集各个特征的类型以及是否有空值 2.5 对数据集做中心化度量&a…
阅读更多...
自动驾驶技术平台分享：百度Apollo开放平台8.0再升级，更简单，更便捷，更高效

自动驾驶技术平台分享：百度Apollo开放平台8.0再升级，更简单，更便捷，更高效

文章目录自动驾驶技术入门&#xff0c;先看平台Appllo主要优势版本更新新特性颠覆更新“新”架构全新加入软件包管理机制加入新感知模型感知全流程开放与提效全新PnC工具链写在最后自动驾驶技术入门&#xff0c;先看平台 近年来&#xff0c;自动化驾驶的话题越来越成为热点。对…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023