K230视频输出API参考

版权所有©2023北京嘉楠捷思信息技术有限公司

免责声明

您购买的产品、服务或特性等应受北京嘉楠捷思信息技术有限公司（“本公司”，下同）及其关联公司的商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，本公司不对本文档的任何陈述、信息、内容的正确性、可靠性、完整性、适销性、符合特定目的和不侵权提供任何明示或默示的声明或保证。除非另有约定，本文档仅作为使用指导参考。

由于产品版本升级或其他原因，本文档内容将可能在未经任何通知的情况下，不定期进行更新或修改。

商标声明

、“嘉楠”和其他嘉楠商标均为北京嘉楠捷思信息技术有限公司及其关联公司的商标。本文档可能提及的其他所有商标或注册商标，由各自的所有人拥有。

版权所有 © 2023北京嘉楠捷思信息技术有限公司。保留一切权利。 非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。

目录

[TOC]

前言

概述

本文档主要介绍视频输出系统控制模块的功能和用法，其它模块的功能和用法将各有专门的文档加以论述。

读者对象

本文档（本指南）主要适用于以下人员：

• 技术支持工程师
• 软件开发工程师

缩略词定义

修订记录

1. 概述

VO（Video Output，视频输出）模块主动从内存相应位置读取视频和图形数据，并通过相应的显示设备输出视频和图形。芯片支持的显示/回写设备、视频层和图形层情况。

LAYER层支持：

OSD 层支持

1.1 硬件描述

本次硬件介绍是以evblp3 做的介绍

1.1.1 Mipi接口

在evblp3 上的硬件引脚如下：

• 屏幕触摸iic用的iic4 （scl：gpio7，sda gpio8）
• 屏幕触摸 rst：gpio29， int：gpio30
• 屏幕的rst：gpio9，backlight：gpio31
• Mipi的引脚和屏幕的引脚一一对应

1.1.2 实物图

• 图中1为mipi接口，采用的是软排线
• 图中2为mipi信号测试点、包含四路data线和一路clk线

1.2 软件描述

视频输出软件配置分为3部分配置：phy 配置、dsi配置、VO配置，

1.2.1 PHY的配置流程

phy的频率需要配置三个参数、计算PLL、配置voc、配置freq，根据这三个参数就可以确定txphy的频率，每一个的参数计算如下。

1.2.1.1 计算phy的pll

数据速率由 PLL 输出时钟相位频率的两倍给出：数据速率 (Gbps) = PLL Fout(GHz) * 2，输出频率是输入参考频率和倍频/分频比的函数。 计算phy 的pll共分为4种范围做的计算，不同的频率对应着不同的频率，它可以通过以下方式确定：

For：

然而在这个需要遵循下边的限制：

For：

For：

For：

上边的每一个for 对应着一个pll的等级、不同的等级对应着不同的计算公式和限制，计算示例如下：

Example：

mipi 的速率为 445.5M：所以pll的速率就是222.75M，应该选择第二个公式，计算如下

222750000 = 1M / 2N = (m+2) / 2(n+1) * 24000000 , 整理完成公式如下：

222.75n + 198.75 = 12m ，通过excel 计算如下：

得出来的m = 295 ，n = 15。

配置pll中的m 和n都是整数值、如果所有的值都不是整数，就需要在m 和 n的值做加1和减1处理、反推回去看哪个频率理你需要的最近，再去验证是否可用，不可以就重复上边的操作。

1.2.1.2 配置phy的voc

配置phy 的voc 可以根据表格查询即可：

Example：

mipi 的速率为 445.5M：所以pll的速率就是222.75M，voc = 010111 = 0x17

1.2.1.3 配置freq

配置phy 的freq 可以根据表格查询即可：

Example：

mipi 的速率为 445.5M：pll的速率就是222.75M，freq 选择0100101, 配置这个的时候需要将最高位bit[7] = 1，所有freq = 10100101= 0xa5

1.2.2 DSI的配置

DSI（Display Serial Interface）是MIPI 定义的一组通信协议的一部分联盟，主要实现 MIPI DSI 规范中定义的所有协议功能的数字控制器，包含了具有两个和四个通道的双向 PHY。

DSI在软件中主要配置屏幕显示用的timing和发送命令的功能。

1.2.2.1 配置显示器的timing

每个厂家的屏幕都会有一组时序用来做屏幕的控制，主要包含了帧的控制时序和一行的控制时序，如下图所示：

DSI中也会用到这些参数、配置的时序和屏幕一致即可。

1.2.2.2 DSI的命令下发

需要dsi 先进入lp模式、然后就可以发送命令，需要的api如下：

• kd_mpi_dsi_set_lp_mode_send_cmd
• kd_mpi_dsi_send_cmd

发送的数据是按照8位发送的，会根据数量自动选择发送长包还是短包。

1.2.2.3 DSI 的自测模式

DSI 自测模式会按照自己配置的dsi timing 产生color bar 的数据发送出去，这样不依赖vo从ddr读取数据，测试模式显示如下图：

DSI 和vo之间采用的是24位接口，所以配置出来的color bar 是上图的效果，使用方法只需要配置完成dsi之后使能color bar即可，api如下

• kd_mpi_dsi_set_test_pattern

1.2.3 VO的配置

VO（video output）主要是VO（Video Output，视频输出）模块主动从内存相应位置读取视频和图形数据，并通过相应的显示设备输出视频和图形，VO这部分包含两个配置、一个是timing 的配置、另一个是视频层的配置

1.2.3.1 VO 时序配置

VO的时序配置和dsi 的时序配置采用的一样的配置参数，具体的行和列一样，看dsi timing 介绍即可

V1.2.3.2 O的layer层配置

VO layer 层目前支持3个layer层、4个osd层。Layer层只能显示yuv的图像格式（layer0 和 layer1 支持的功能在概述中的图表）。

1.2.3.3 VO 的回写功能配置

VO 还支持回写功能、这个可以验证VO配置的是否正确，VO配置完成之后会将数据写回到ddr 当中，方便验证VO的配置是否出现异常

1.2.4 VO模块的调试方法

1.2.4.1 屏幕的测试方法

• 可以通过LP命令配置屏幕进入自测模式、看产生的图像是否正常
• 通过LP命令读取屏幕寄存器看是否有返回

1.2.4.2 DSI 的测试方法

• 配置完dsi之后，让屏幕进入自测模式，量取信号看时候正常，也可以看屏幕是否产生color bar 的图像
• 查看phy的err 状态寄存器、看是否有err 状态，可以通过proc查看

1.2.4.3 VO的测试方法

• VO配置完成之后、打开writeback 功能，查看是否和配置的要求一致
• 读取DSI的err状态寄存器，查看VO和dsi之间数据传输是否出现underflow和overflow，如果出现、适当的调整timing再次尝试

2. API 参考

2.1 TXPHY

该功能模块提供以下API：

• kd_mpi_set_mipi_phy_attr

2.1.1 kd_mpi_set_mipi_phy_attr

【描述】

设置phy 的频率

【语法】

k_s32 kd_mpi_set_mipi_phy_attr(k_vo_mipi_phy_attr *attr)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.2 DSI

该功能模块提供以下API：

• kd_mpi_dsi_set_attr
• kd_mpi_dsi_enable
• kd_mpi_dsi_send_cmd
• kd_mpi_dsi_read_pkg
• kd_mpi_dsi_set_test_pattern
• kd_mpi_dsi_set_lp_mode_send_cmd

2.2.1 kd_mpi_dsi_set_attr

【描述】

配置dsi 属性参数

【语法】

k_s32 kd_mpi_dsi_set_attr(k_display_mode *attr)【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.2.2 kd_mpi_dsi_enable

【描述】

打开dsi

【语法】

k_s32 kd_mpi_dsi_enable(void)

【参数】

无

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.2.3 kd_mpi_dsi_send_cmd

【描述】

Dsi 发送命令

【语法】

k_s32 kd_mpi_dsi_send_cmd(k_u8 *data, k_s32 cmd_len)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.2.4 kd_mpi_dsi_read_pkg

【描述】

Dsi 读取命令

【语法】

k_s32 kd_mpi_dsi_read_pkg(k_u8 *rx_buf, k_s32 cmd_len)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.2.5 kd_mpi_dsi_set_test_pattern

【描述】

配置dsi 进入自测模式

【语法】

k_s32 kd_mpi_dsi_set_test_pattern(void)

【参数】、

无

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.2.6 kd_mpi_dsi_set_lp_mode_send_cmd

【描述】

配置dsi 进入lp mode 发送命令

【语法】

k_s32 kd_mpi_dsi_set_lp_mode_send_cmd(void)

【参数】

无

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3 VO

• kd_mpi_vo_init
• kd_mpi_vo_set_dev_param
• kd_mpi_vo_enable_video_layer
• kd_mpi_vo_disable_video_layer
• kd_mpi_vo_enable
• kd_mpi_vo_chn_insert_frame
• kd_mpi_vo_chn_dump_frame
• kd_mpi_vo_chn_dump_release
• kd_mpi_vo_osd_enable
• kd_mpi_vo_osd_disable
• kd_mpi_vo_set_video_osd_attr
• kd_mpi_vo_set_wbc_attr
• kd_mpi_vo_enable_wbc
• kd_mpi_vo_disable_wbc
• kd_display_reset
• kd_display_set_backlight
• kd_mpi_vo_set_user_sync_info
• kd_mpi_vo_draw_frame

2.3.1 kd_mpi_vo_init

【描述】

Vo 初始化默认参数

【语法】

k_s32 kd_mpi_vo_init(void);

【参数】

无

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.2 kd_mpi_vo_set_dev_param

【描述】

Dsi 发送命令

【语法】

k_s32 kd_mpi_vo_set_dev_param(k_vo_pub_attr *attr)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.3 kd_mpi_vo_enable_video_layer

【描述】

配置layer 层属性参数

【语法】

k_s32 kd_mpi_vo_enable_video_layer(k_vo_layer layer)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.4 kd_mpi_vo_disable_video_layer

【描述】

关闭视频层

【语法】

k_s32 kd_mpi_vo_disable_video_layer(k_vo_layer layer)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：
• 库文件：

【注意】

无

【举例】

无

【相关主题】

无

2.3.5 kd_mpi_vo_enable

【描述】

打开vo

【语法】

k_u8 kd_mpi_vo_enable(void);

【参数】

无

【返回值】

【芯片差异】

无

【需求】

• 头文件：
• 库文件：

【注意】

无

【举例】

无

【相关主题】

无

2.3.6 kd_mpi_vo_chn_insert_frame

【描述】

插入帧到vo的通道

【语法】

k_s32 kd_mpi_vo_chn_insert_frame(k_u32 chn_num, k_video_frame_info *vf_info)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h k_video_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.7 kd_mpi_vo_chn_dump_frame

【描述】

从vo 的通道中抓取一帧数据

【语法】

k_s32 kd_mpi_vo_chn_dump_frame(k_u32 chn_num, k_video_frame_info *vf_info, k_u32 timeout_ms);

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h k_video_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.8 kd_mpi_vo_chn_dump_release

【描述】

释放抓取帧

【语法】

k_s32 kd_mpi_vo_chn_dump_release(k_u32 chn_num, const k_video_frame_info *vf_info);

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件： mpi_vo_api.h k_video_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.9 kd_mpi_vo_osd_enable

【描述】

打开osd层

【语法】

k_s32 kd_mpi_vo_osd_enable(k_vo_osd layer)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.10 kd_mpi_vo_osd_disable

【描述】

关闭osd层

【语法】

k_s32 kd_mpi_vo_osd_disable(k_vo_osd layer)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.11 kd_mpi_vo_set_video_osd_attr

【描述】

设置osd层属性

【语法】

k_s32 kd_mpi_vo_set_video_osd_attr(k_vo_osd layer, k_vo_video_osd_attr *attr)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.12 kd_mpi_vo_set_wbc_attr

【描述】

设置回写属性

【语法】

k_s32 kd_mpi_vo_set_wbc_attr(k_vo_wbc_attr *attr)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.13 kd_mpi_vo_enable_wbc

【描述】

使能writeback

【语法】

k_s32 kd_mpi_vo_enable_wbc(void)

【参数】

无

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.14 kd_mpi_vo_disable_wbc

【描述】

关闭writeback

【语法】

k_s32 kd_mpi_vo_disable_wbc(void)

【参数】

无

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.15 kd_display_reset

【描述】

复位视频输出子系统

【语法】

k_s32 kd_display_reset(void)

【参数】

无

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.16 kd_display_set_backlight

【描述】

复位屏幕和打开背光

【语法】

k_s32 kd_display_set_backlight(void)

【参数】

无

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.17 kd_mpi_vo_set_user_sync_info

【描述】

设置用户接口时序信息，用于配置时钟源、时钟大小和时钟分频比

【语法】

k_s32 kd_mpi_vo_set_user_sync_info(k_vo_user_sync_info *sync_info)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.18 kd_mpi_vo_draw_frame

【描述】

画框

【语法】

k_s32 kd_mpi_vo_draw_frame(k_vo_draw_frame *frame)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h
• 库文件：libvo.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.19 kd_mpi_get_connector_info

【描述】

获取connecor 连接器的数据结构通过连接类型

【语法】

k_s32 kd_mpi_get_connector_info(k_connector_type connector_type, k_connector_info *connector_info)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h k_connector_comm.h
• 库文件：libvo.a libconnector.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.20 kd_mpi_connector_open

【描述】

获取connecor 连接器的数据结构通过连接类型

【语法】

k_s32 kd_mpi_connector_open(const char *connector_name)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h k_connector_comm.h
• 库文件：libvo.a libconnector.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.21 kd_mpi_connector_power_set

【描述】

打开connector 的电源

【语法】

k_s32 kd_mpi_connector_power_set(k_s32 fd, k_bool on)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h k_connector_comm.h
• 库文件：libvo.a libconnector.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.22 kd_mpi_connector_init

【描述】

vo connector 初始化

【语法】

k_s32 kd_mpi_connector_init(k_s32 fd, k_connector_info info)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h k_connector_comm.h
• 库文件：libvo.a libconnector.a

【注意】

无

【举例】

无

【相关主题】

无

2.3.23 kd_mpi_connector_get_negotiated_data

【描述】

Display驱动和显示器自动协商分辨率，协商成功后会将协商后的数据保存到negotiated_data变量

【语法】

k_s32 kd_mpi_connector_get_negotiated_data(k_s32 fd, k_connector_negotiated_data *negotiated_data);

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h k_connector_comm.h
• 库文件：libvo.a libconnector.a

【注意】

kd_mpi_connector_get_negotiated_data()仅仅只会和显示器进行协商，协商成功后不会将最佳分辨率设置到VO、DSI、HDMI模块上

【举例】

无

【相关主题】

无

2.3.24 kd_mpi_connector_adapt_resolution

【描述】

Display驱动和显示器自动协商分辨率，协商成功后会将协商后的数据保存到negotiated_data变量，同时会将最佳的分辨率设置到VO、DSI、HDMI模块

【语法】

k_s32 kd_mpi_connector_adapt_resolution(k_connector_type type, k_connector_negotiated_data *negotiated_data)

【参数】

【返回值】

【芯片差异】

无

【需求】

• 头文件：mpi_vo_api.h k_vo_comm.h k_connector_comm.h
• 库文件：libvo.a libconnector.a

【注意】

1 kd_mpi_connector_adapt_resolution()内部通过调用kd_mpi_connector_get_negotiated_data()和显示器进行协商

2 当应用程序调用kd_mpi_connector_adapt_resolution()函数完成自适应设置后，仍然可以调用 kd_mpi_get_connector_info()、kd_mpi_connector_open()、kd_mpi_connector_power_set()、kd_mpi_connector_init()重新设置输出分辨率

【举例】

无

【相关主题】

无

3. 数据类型

3.1 VO

3.1.1 k_vo_intf_sync

【说明】

定义视频中的分辨率和帧率

【定义】

typedef enum {
 K_VO_OUT_1080P30,
 K_VO_OUT_1080P60,
} k_vo_intf_sync;

【成员】

【注意事项】

无

【相关数据类型及接口】

3.1.2 k_vo_intf_type

【说明】

定义视频中的分辨率和帧率

【定义】

typedef enum {
 K_VO_INTF_MIPI = 0,
} k_vo_intf_type;

【成员】

【注意事项】

无

【相关数据类型及接口】

3.1.3 k_pixel_format

【说明】

显示中layer 支持的数据格式，下边结构体中只列举了显示支持的数据格式，并不是所有的数据格式

【定义】

typedef enum {
 PIXEL_FORMAT_YVU_PLANAR_420,
 PIXEL_FORMAT_YVU_PLANAR_422,
 PIXEL_FORMAT_RGB_565,
 PIXEL_FORMAT_RGB_888,
 PIXEL_FORMAT_ARGB_8888,
 PIXEL_FORMAT_ARGB_4444,
 PIXEL_FORMAT_ARGB_1555,
 PIXEL_FORMAT_RGB_MONOCHROME_8BPP,
} k_pixel_format;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.4 k_vo_osd

【说明】

OSD 的数量和每一个osd 的编号

【定义】

typedef enum {
 K_VO_OSD0,
 K_VO_OSD1,
 K_VO_OSD2,
 K_VO_OSD3,
 K_MAX_VO_OSD_NUM,
} k_vo_osd;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.5 k_vo_layer

【说明】

layer 的数量和每一个layer的编号

【定义】

typedef enum {
 K_VO_LYAER0 = 0,
 K_VO_LYAER1,
 K_VO_LYAER2,
 K_MAX_VO_LAYER_NUM,
} k_vo_layer;

成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.6 k_vo_rotation

【说明】

Layer rotation 支持的功能

【定义】

typedef enum {
 K_ROTATION_0 = (0x01L << 0),
 K_ROTATION_90 = (0x01L << 1),
 K_ROTATION_180 = (0x01L << 2),
 K_ROTATION_270 = (0x01L << 3),
} k_vo_rotation;

【注意事项】

无

【相关数据类型及接口】

无

3.1.7 k_vo_mirror_mode

【说明】

Layer mirror 支持的功能。

【定义】

typedef enum {
 K_VO_MIRROR_NONE = (0x01L << 4),
 K_VO_MIRROR_HOR = (0x01L << 5),
 K_VO_MIRROR_VER = (0x01L << 6),
 K_VO_MIRROR_BOTH = (0x01L << 7),
} k_vo_mirror_mode;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.8 k_vo_user_sync_info

【说明】

用户自定义做时钟分频。

【定义】

typedef struct {
 k_u32 ext_div;
 k_u32 dev_div;
 k_u32 clk_en;
} k_vo_user_sync_info;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.9 k_vo_point

【说明】

定义坐标信息结构体。

【定义】

typedef struct {
 k_u32 x;
 k_u32 y;
}k_vo_point;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.10 k_vo_size

【说明】

定义大小信息结构体。

【定义】

typedef struct {
 k_u32 width;
 k_u32 height;
} k_vo_size;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.11 k_vo_video_layer_attr

【说明】

定义 display layer 层属性

【定义】

typedef struct {
 k_point display_rect;
 k_size img_size;
 k_pixel_format pixel_format;
 k_u32 stride;
 k_u32 uv_swap_en;
 k_u32 alptha_tpye;
} k_vo_video_layer_attr;

【成员】

【注意事项】

alptha_tpye 仅对osd 层使用

【相关数据类型及接口】

无

3.1.12 k_vo_wbc_attr

【说明】

定义 writeback属性。

【定义】

typedef struct {
 k_vo_size target_size;
 k_pixel_format pixel_format;
 k_u32 stride;
 k_u32 y_phy_addr;
} k_vo_wbc_attr;

【成员】

【注意事项】

y_addr 需要分配空间

【相关数据类型及接口】

无

3.1.13 k_vo_pub_attr

【说明】

配置视频输出设备的公共属性。

【定义】

typedef struct {  k_u32 bg_color;
 k_vo_intf_type intf_type;
 k_vo_intf_sync intf_sync;
 k_vo_display_resolution *sync_info;
 }k_vo_pub_attr;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.14 k_vo_scaler_attr

【说明】

定义 scaler 属性

【定义】

typedef struct{
 k_size in_size;
 k_size out_size;
 k_u32 stride;
}k_vo_scaler_attr;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.15 k_vo_draw_frame

【说明】

定义 画框的 属性

【定义】

typedef struct {
 k_u32 draw_en;
 k_u32 line_x_start;
 k_u32 line_y_start;
 k_u32 line_x_end;
 k_u32 line_y_end;
 k_u32 frame_num;
}k_vo_draw_frame;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.16 k_vo_display_resolution

【说明】

Display timing属性。

【定义】

typedef struct{
 k_u32 pclk;
 k_u32 phyclk;
 k_u32 htotal;
 k_u32 hdisplay;
 k_u32 hsync_len;
 k_u32 hback_porch;
 k_u32 hfront_porch;
 k_u32 vtotal;
 k_u32 vdisplay;
 k_u32 vsync_len;
 k_u32 vback_porch;
 k_u32 vfront_porch;
} k_vo_display_resolution;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.17 k_vo_mipi_phy_attr

【说明】

定义 mipi phy 频率的结构体

【定义】

typedef struct {
 k_u32 n;
 k_u32 m;
 k_u32 voc;
 k_u32 phy_lan_num;
 k_u32 hs_freq;
}k_vo_mipi_phy_attr;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.18 k_vo_video_osd_attr

【说明】

配置osd层的公共属性。

【定义】

typedef struct {
 k_vo_point display_rect;
 k_vo_size img_size;
 k_pixel_format pixel_format;
 k_u32 stride;
 k_u8 global_alptha;
} k_vo_video_osd_attr;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.19 k_video_frame_info

【说明】

一帧的信息。

【定义】

typedef struct {
 k_video_frame v_frame;
 k_u32 pool_id;
 k_mod_id mod_id;
} k_video_frame_info;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.20 k_connector_type

【说明】

连接屏幕的类型。

【定义】

typedef enum {
 HX8377_V2_MIPI_4LAN_1080X1920_30FPS;  LT9611_MIPI_4LAN_1920X1080_60FPS;  LT9611_MIPI_4LAN_1920X1080_30FPS; } k_connector_type;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.21 k_dsi_lan_num

【说明】

dsi 的 lane 数量。

【定义】

typedef enum {
 K_DSI_1LAN = 0,
 K_DSI_2LAN = 1,
 K_DSI_4LAN = 3,
} k_dsi_lan_num;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.22 k_dsi_work_mode

【说明】

dsi 的工作模式

【定义】

typedef enum{
 K_BURST_MODE = 0,
 K_NON_BURST_MODE_WITH_SYNC_EVENT = 1,
 K_NON_BURST_MODE_WITH_PULSES = 2,
} k_dsi_work_mode;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.23 k_vo_dsi_cmd_mode

【说明】

dsi 发送命令的模式。

【定义】

typedef enum {
 K_VO_LP_MODE,
 K_VO_HS_MODE,
} k_vo_dsi_cmd_mode;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.24 k_connectori_phy_attr

【说明】

connector 连接器 配置phy 的信息。

【定义】

typedef struct {
 k_u32 n;
 k_u32 m;
 k_u32 voc;
 k_u32 hs_freq;
} k_connectori_phy_attr;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.25 k_connector_info

【说明】

连接器的信息。

【定义】

typedef struct {
 const char *connector_name;
 k_u32 screen_test_mode;
 k_u32 dsi_test_mode;
 k_u32 bg_color;
 k_u32 intr_line;
 k_dsi_lan_num lan_num;
 k_dsi_work_mode work_mode;
 k_vo_dsi_cmd_mode cmd_mode;
 k_connectori_phy_attr phy_attr;
 k_vo_display_resolution resolution;
 k_connector_type type;
} k_connector_info;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

3.1.26 k_connector_negotiated_data

【说明】

Display驱动和HDMI显示器协商后的数据

【定义】

typedef struct {  
k_u32 connection_status;  
k_u32 negotiated_count;  
k_connector_type negotiated_types[256];
} k_connector_negotiated_data;

【成员】

【注意事项】

无

【相关数据类型及接口】

无

4. 错误码

表 41 VO API 错误码