Tina Linux Display开发指南
tina_linux_display_开发指南 1 概述 1.1 编写目的 让显示应用开发人员了解显示驱动的接口及使用流程，快速上手，进行开发；让新人接手工作时能快速地了解驱动接口，进行调试排查问题。
1.2 适用范围 sunxi 平台de1.0/de2.0。
1.3 相关人员 与显示相关的应用开发人员，及与显示相关的其他模块的开发人员，以及新人。
2 模块介绍 2.1 模块功能介绍
图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: 硬件术语介绍表
术语 解释
de display 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)
图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 驱动框架介绍
图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 标识的部分，其余部分是隐藏的，不能在屏幕上显示出来的。
图3-1: size 和crop 示意图
• crop 和screen_win
crop 上面已经介绍过，screen_win 为crop 部分buffer 在屏幕上显示的位置。如果不需要进行缩放的话，crop 和screen_win 的width,height 是相等的，如果需要
缩放，crop 和screen_win 的width,height 可以不相等。
图3-2: crop 和screen win 示意图
• alpha
alpha 模式有三种:
gloabal alpha: 全局alpha，也叫面alpha，即整个图层共用一个alpha，统一的透明度。
pixel alpha: 点alpha，即每个像素都有自己单独的alpha，可以实现部分区域全透，部分区域半透，部分区域不透的效果。
global_pixel alpha: 可以是说以上两种效果的叠加，在实现pxiel alpha 的效果的同时，还可以做淡入浅出的效果。
图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
所有图层都支持缩放。对图层的操作如下所示：
设置图层参数并使能，接口为disp_layer_set_config，图像格式，buffer size， buffer 地址，alpha 模式，enable，图像帧id 号等参数。
关闭图层，依然通过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 区别
项目平台 disp2 disp1
图层标识 以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（辅）。
同显或异显，差别只在于显示内容，如果显示内容一样，则为同显；反之，则为异显。
如果是android 系统，4.2 版本以上版本，原生框架已经支持多显（同显，异显，虚拟显示设备），实现同显则比较简单，在android hal 与上层对接好即可。
如果是android 4.1 以下版本，同显需要自行实现，参考做法为主屏内容由android 原生提供，辅屏需要android hal 在合适的时机（比如hdmi 插入时）打开
辅屏，并且将主屏的内容（存放于fb0 中），拷贝至辅屏的显示后端buffer 中，然后将辅屏的后端buffer 切换到前端buffer。注意问题为，两路显示的显示
buffer 的同步，如果同步不好，会产生图像撕裂，错位的现象。
如果是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 显示驱动句柄
cmd disp_shadow_protect
arg arg[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 显示驱动句柄
cmd disp_set_bkcolor
arg arg[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 显示驱动句柄
cmd disp_get_bkcolor
arg arg[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 显示驱动句柄
cmd disp_get_scn_width
arg arg[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 显示驱动句柄
cmd disp_get_scn_height
arg arg[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 显示驱动句柄
cmd disp_get_output_type
arg arg[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 显示驱动句柄
cmd disp_get_output
arg arg[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 显示驱动句柄
cmd disp_vsync_event_en
arg arg[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 显示驱动句柄
cmd disp_device_switch
arg arg[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 显示驱动句柄
cmd disp_device_set_config
arg arg[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 显示驱动句柄
cmd disp_device_get_config
arg arg[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 显示驱动句柄
cmd disp_cmd_set_layer_config
arg arg[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 显示驱动句柄
cmd disp_layer_get_config
arg arg[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 显示驱动句柄
cmd disp_set_layer_config2
arg arg[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 显示驱动句柄
cmd disp_capture_start
arg arg[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 显示驱动句柄
cmd disp_capture_commit
arg arg[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 显示驱动句柄
cmd disp_capture_stop
arg arg[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 显示驱动句柄
cmd disp_capture_query
arg arg[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 显示驱动句柄
cmd disp_lcd_set_brightness
arg arg[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 显示驱动句柄
cmd disp_lcd_get_brightness
arg arg[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 显示驱动句柄
cmd disp_enhance_enable
arg arg[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 显示驱动句柄
cmd disp_enhance_disable
arg arg[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 显示驱动句柄
cmd disp_enhance_demo_enable
arg arg[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 显示驱动句柄
cmd disp_enhance_demo_disable
arg arg[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 显示驱动句柄
cmd disp_smbl_enable
arg arg[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 显示驱动句柄
cmd disp_smbl_enable
arg arg[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 显示驱动句柄
cmd disp_smbl_set_window
arg arg[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 显示驱动句柄
cmd disp_hdmi_support_mode
arg arg[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 显示驱动句柄
cmd disp_hdmi_get_hpd_status
arg arg[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 inn); else printf(hdmi plug outn);
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 /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 inn); 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;
• 成员
变量 说明
addr framebuffer 的内容地址，对于interleaved 类型，只有addr[0] 有效；planar 类型，三个都有；uv combined 的类型addr[0]，addr[1]有效
size size of framebuffer, 单位为pixel
align 对齐位宽，为2 的指数
format pixel format, 详见disp_pixel_format
color_space color space mode, 详见disp_cs_mode
b_trd_src 1:3d source; 0：2d source
trd_mode source 3d mode, 详见disp_3d_src_mode
trd_right_addr used 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
zorder layer zorder, 优先级高的图层可能会覆盖优先级低的图层
alpha_mode 0:pixel alpha, 1:global alpha, 2:global pixel alpha
alpha_value layer global alpha value，valid while alpha_mode(1/2)
screenn_win screen window，图层在屏幕上显示的矩形窗口
fb framebuffer 的属性，详见disp_fb_info,valid when buffer_mode
color display color, valid when color_mode
b_trd_out if output in 3d mode,used for scaler layer
out_trd_mode output 3d mode, 详见disp_3d_out_mode
id frame 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;
• 成员
变量 说明
x x
y y
• 描述
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_8888 32bpp, a 在最高位，b 在最低位
disp_format_yuv420_p planar yuv 格式，分三块存放，需三个地址，p3在最高位
disp_format_yuv422_sp_uvuv semi-planar yuv 格式，分两块存放，需两个地址，u 在低位
disp_format_yuv422_sp_vuvu semi-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_normal 2d
disp_bf_stereo_tb top bottom 模式
disp_bf_stereo_fp framepacking
disp_bf_stereo_ssf side by side full, 左右全景
disp_bf_stereo_ssh side by side half, 左右半景
disp_bf_stereo_li line 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_fp framepacking
disp_3d_out_mode_ssf side by side full, 左右全景
disp_3d_out_mode_ssh side by side half, 左右半景
disp_3d_out_mode_li line interleaved, 行交织
disp_3d_out_mode_fa field 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_lcd lcd 输出
disp_output_type_tv tv 输出
disp_output_type_hdmi hdmi 输出
disp_output_type_vga vga 输出
• 描述
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_buffer buffer 模式，带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 < /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, 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流程。
信实计划与vivo合作在印度推出700元的4G手机
苹果博通欲推翻11亿美元的WIFI专利案
日本科学家利用太赫兹等离子体技术,开发出对生物组织可视化装置
AQI分析与预测-2
压力变送器常用输出信号选择
Tina Linux Display开发指南
Intel 12代酷睿处理器亮点汇总
漫途房屋结构安全监测方案，守护城市建筑的安全底线
云计算等下一代信息技术正在成为全球经济背后的新驱动力
中国3G用户到1.5亿户还差1亿 三大运营商任务艰巨
用CPLD实现FIR数字滤波器的设计
电池钢壳生产工艺流程
华为完成5G技术第三阶段SA基站功能测试
跑步机音乐播放语音芯片方案，WTV890-32N
热像仪成为了单兵高技术装备的首选
中小企业数字化模式创新研究报告
可穿戴设备中防水气压传感器的作用无处不在
Silicon Labs发布两款全新的Sub-GHz无线SoC
发展人工智能，不能因为其潜在的安全威胁而踟蹰不前
可燃气体检测仪有什么功能?-欧森杰
1.2 适用范围 sunxi 平台de1.0/de2.0。
1.3 相关人员 与显示相关的应用开发人员，及与显示相关的其他模块的开发人员，以及新人。
2 模块介绍 2.1 模块功能介绍
图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: 硬件术语介绍表
术语 解释
de display 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)
图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 驱动框架介绍
图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 标识的部分，其余部分是隐藏的，不能在屏幕上显示出来的。
图3-1: size 和crop 示意图
• crop 和screen_win
crop 上面已经介绍过，screen_win 为crop 部分buffer 在屏幕上显示的位置。如果不需要进行缩放的话，crop 和screen_win 的width,height 是相等的，如果需要
缩放，crop 和screen_win 的width,height 可以不相等。
图3-2: crop 和screen win 示意图
• alpha
alpha 模式有三种:
gloabal alpha: 全局alpha，也叫面alpha，即整个图层共用一个alpha，统一的透明度。
pixel alpha: 点alpha，即每个像素都有自己单独的alpha，可以实现部分区域全透，部分区域半透，部分区域不透的效果。
global_pixel alpha: 可以是说以上两种效果的叠加，在实现pxiel alpha 的效果的同时，还可以做淡入浅出的效果。
图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
所有图层都支持缩放。对图层的操作如下所示：
设置图层参数并使能，接口为disp_layer_set_config，图像格式，buffer size， buffer 地址，alpha 模式，enable，图像帧id 号等参数。
关闭图层，依然通过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 区别
项目平台 disp2 disp1
图层标识 以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（辅）。
同显或异显，差别只在于显示内容，如果显示内容一样，则为同显；反之，则为异显。
如果是android 系统，4.2 版本以上版本，原生框架已经支持多显（同显，异显，虚拟显示设备），实现同显则比较简单，在android hal 与上层对接好即可。
如果是android 4.1 以下版本，同显需要自行实现，参考做法为主屏内容由android 原生提供，辅屏需要android hal 在合适的时机（比如hdmi 插入时）打开
辅屏，并且将主屏的内容（存放于fb0 中），拷贝至辅屏的显示后端buffer 中，然后将辅屏的后端buffer 切换到前端buffer。注意问题为，两路显示的显示
buffer 的同步，如果同步不好，会产生图像撕裂，错位的现象。
如果是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 显示驱动句柄
cmd disp_shadow_protect
arg arg[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 显示驱动句柄
cmd disp_set_bkcolor
arg arg[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 显示驱动句柄
cmd disp_get_bkcolor
arg arg[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 显示驱动句柄
cmd disp_get_scn_width
arg arg[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 显示驱动句柄
cmd disp_get_scn_height
arg arg[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 显示驱动句柄
cmd disp_get_output_type
arg arg[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 显示驱动句柄
cmd disp_get_output
arg arg[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 显示驱动句柄
cmd disp_vsync_event_en
arg arg[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 显示驱动句柄
cmd disp_device_switch
arg arg[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 显示驱动句柄
cmd disp_device_set_config
arg arg[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 显示驱动句柄
cmd disp_device_get_config
arg arg[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 显示驱动句柄
cmd disp_cmd_set_layer_config
arg arg[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 显示驱动句柄
cmd disp_layer_get_config
arg arg[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 显示驱动句柄
cmd disp_set_layer_config2
arg arg[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 显示驱动句柄
cmd disp_capture_start
arg arg[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 显示驱动句柄
cmd disp_capture_commit
arg arg[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 显示驱动句柄
cmd disp_capture_stop
arg arg[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 显示驱动句柄
cmd disp_capture_query
arg arg[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 显示驱动句柄
cmd disp_lcd_set_brightness
arg arg[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 显示驱动句柄
cmd disp_lcd_get_brightness
arg arg[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 显示驱动句柄
cmd disp_enhance_enable
arg arg[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 显示驱动句柄
cmd disp_enhance_disable
arg arg[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 显示驱动句柄
cmd disp_enhance_demo_enable
arg arg[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 显示驱动句柄
cmd disp_enhance_demo_disable
arg arg[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 显示驱动句柄
cmd disp_smbl_enable
arg arg[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 显示驱动句柄
cmd disp_smbl_enable
arg arg[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 显示驱动句柄
cmd disp_smbl_set_window
arg arg[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 显示驱动句柄
cmd disp_hdmi_support_mode
arg arg[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 显示驱动句柄
cmd disp_hdmi_get_hpd_status
arg arg[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 inn); else printf(hdmi plug outn);
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 /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 inn); 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;
• 成员
变量 说明
addr framebuffer 的内容地址，对于interleaved 类型，只有addr[0] 有效；planar 类型，三个都有；uv combined 的类型addr[0]，addr[1]有效
size size of framebuffer, 单位为pixel
align 对齐位宽，为2 的指数
format pixel format, 详见disp_pixel_format
color_space color space mode, 详见disp_cs_mode
b_trd_src 1:3d source; 0：2d source
trd_mode source 3d mode, 详见disp_3d_src_mode
trd_right_addr used 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
zorder layer zorder, 优先级高的图层可能会覆盖优先级低的图层
alpha_mode 0:pixel alpha, 1:global alpha, 2:global pixel alpha
alpha_value layer global alpha value，valid while alpha_mode(1/2)
screenn_win screen window，图层在屏幕上显示的矩形窗口
fb framebuffer 的属性，详见disp_fb_info,valid when buffer_mode
color display color, valid when color_mode
b_trd_out if output in 3d mode,used for scaler layer
out_trd_mode output 3d mode, 详见disp_3d_out_mode
id frame 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;
• 成员
变量 说明
x x
y y
• 描述
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_8888 32bpp, a 在最高位，b 在最低位
disp_format_yuv420_p planar yuv 格式，分三块存放，需三个地址，p3在最高位
disp_format_yuv422_sp_uvuv semi-planar yuv 格式，分两块存放，需两个地址，u 在低位
disp_format_yuv422_sp_vuvu semi-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_normal 2d
disp_bf_stereo_tb top bottom 模式
disp_bf_stereo_fp framepacking
disp_bf_stereo_ssf side by side full, 左右全景
disp_bf_stereo_ssh side by side half, 左右半景
disp_bf_stereo_li line 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_fp framepacking
disp_3d_out_mode_ssf side by side full, 左右全景
disp_3d_out_mode_ssh side by side half, 左右半景
disp_3d_out_mode_li line interleaved, 行交织
disp_3d_out_mode_fa field 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_lcd lcd 输出
disp_output_type_tv tv 输出
disp_output_type_hdmi hdmi 输出
disp_output_type_vga vga 输出
• 描述
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_buffer buffer 模式，带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 < /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, 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流程。
信实计划与vivo合作在印度推出700元的4G手机
苹果博通欲推翻11亿美元的WIFI专利案
日本科学家利用太赫兹等离子体技术,开发出对生物组织可视化装置
AQI分析与预测-2
压力变送器常用输出信号选择
Tina Linux Display开发指南
Intel 12代酷睿处理器亮点汇总
漫途房屋结构安全监测方案，守护城市建筑的安全底线
云计算等下一代信息技术正在成为全球经济背后的新驱动力
中国3G用户到1.5亿户还差1亿 三大运营商任务艰巨
用CPLD实现FIR数字滤波器的设计
电池钢壳生产工艺流程
华为完成5G技术第三阶段SA基站功能测试
跑步机音乐播放语音芯片方案，WTV890-32N
热像仪成为了单兵高技术装备的首选
中小企业数字化模式创新研究报告
可穿戴设备中防水气压传感器的作用无处不在
Silicon Labs发布两款全新的Sub-GHz无线SoC
发展人工智能，不能因为其潜在的安全威胁而踟蹰不前
可燃气体检测仪有什么功能?-欧森杰