Hi3520／Hi3515媒体处理软件开发参考

海思专有和保密信息版权所有©深圳市海思半导体有限公司Hi3520／Hi3515媒体处理软件开发参考文档版本05发布日期2010-07-01部件编码N/A海思专有和保密信息版权所有©深圳市海思半导体有限公司深圳市海思半导体有限公司为客户提供全方位的技术支持，用户可与就近的海思办事处联系，也可直接与公司总部联系。深圳市海思半导体有限公司地址：深圳市龙岗区坂田华为基地华为电气生产中心邮编：518129网址：客户服务电话：[phone]客户服务传真：[phone]客户服务邮箱：[e-mail]版权所有©深圳市海思半导体有限公司2009～2010。保留一切权利。非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。商标声明、、海思和其他海思商标均为深圳市海思半导体有限公司的商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。注意由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。Hi3520／Hi3515媒体处理软件开发参考前言文档版本05(2010-07-01)海思专有和保密信息版权所有©深圳市海思半导体有限公司1前言概述本文为使用Hi3520/Hi3515媒体处理芯片进行开发的程序员而写，目的是供您在开发过程中查阅媒体处理软件开发包的各种参考信息，包括API、头文件、错误码等。本文档描述了Hi3520/Hi3515媒体处理软件的各个API的使用方法，以及相关的数据结构和错误码。产品版本与本文档相对应的产品版本如下。产品名称产品版本Hi3520H.264编解码处理器V100Hi3515H.264编解码处理器V100读者对象本文档主要适用于以下工程师：z技术支持工程师z软件开发工程师约定符号约定在本文中可能出现下列标志，它们所代表的含义如下。符号说明表示有高度潜在危险，如果不能避免，会导致人员死亡或严重伤害。前言Hi3520／Hi3515媒体处理软件开发参考2海思专有和保密信息版权所有©深圳市海思半导体有限公司文档版本05(2010-07-01)符号说明表示有中度或低度潜在危险，如果不能避免，可能导致人员轻微或中等伤害。表示有潜在风险，如果忽视这些文本，可能导致设备损坏、数据丢失、设备性能降低或不可预知的结果。表示能帮助您解决某个问题或节省您的时间。表示是正文的附加信息，是对正文的强调和补充。通用格式约定格式说明宋体正文采用宋体表示。黑体一级、二级、三级标题采用黑体。楷体警告、提示等内容一律用楷体，并且在内容前后增加线条与正文隔离。“TerminalDisplay”格式“TerminalDisplay”格式表示屏幕输出信息。此外，屏幕输出信息中夹杂的用户从终端输入的信息采用加粗字体表示。“”用双引号表示文件路径。如“C:\ProgramFiles\Huawei”。命令行格式约定格式意义粗体命令行关键字（命令中保持不变、必须照输的部分）采用加粗字体表示。斜体命令行参数（命令中必须由实际值进行替代的部分）采用斜体表示。[]表示用“[]”括起来的部分在命令配置时是可选的。{x|y|...}表示从两个或多个选项中选取一个。[x|y|...]表示从两个或多个选项中选取一个或者不选。{x|y|...}*表示从两个或多个选项中选取多个，昀少选取一个，昀多选取所有选项。Hi3520／Hi3515媒体处理软件开发参考前言文档版本05(2010-07-01)海思专有和保密信息版权所有©深圳市海思半导体有限公司3格式意义[x|y|...]*表示从两个或多个选项中选取多个或者不选。数值单位约定数据容量、频率、数据速率等的表达方式说明如下。类别符号对应的数值1K10241M1,048,576数据容量（如RAM容量）1G1,073,741,8241k10001M1,000,000频率、数据速率等1G1,000,000,000地址、数据的表达方式说明如下。符号举例说明0x0xFE04、0x18用16进制表示的数据值、地址值。0b0b000、0b0000000000表示2进制的数据值以及2进制序列（寄存器描述中除外）。X00X、1XX在数据的表达方式中，X表示0或1。例如：00X表示000或001；1XX表示100、101、110或111。修订记录修订记录累积了每次文档更新的说明。昀新版本的文档包含以前所有文档版本的更新内容。修订日期版本修订说明2010-06-2905第2章系统控制2.4.1基本数据类型中VO设备的昀大个数由3改为6，其中包括3个虚拟设备；增加VO设备中物理设备的昀大个数、VO昀小显示buffer数、VO昀大显示buffer数、VO昀小虚拟设备buffer数、VO昀大虚拟设备buffer数的定义。前言Hi3520／Hi3515媒体处理软件开发参考4海思专有和保密信息版权所有©深圳市海思半导体有限公司文档版本05(2010-07-01)修订日期版本修订说明第4章视频输出HI_MPI_VO_SetPubAttr的注意中增加“虚拟设备不受公共属性限制，因此设置虚拟设备属性时该接口返回成功。”的描述。HI_MPI_VO_GetScreenFrame增加2条注意。HI_MPI_VO_DisableVideoLayer在【错误码】中增加错误码HI_ERR_VB_BUSY并增加一条注意。HI_MPI_VO_GetScreenFrame在【注意】中增加一条注意。HI_MPI_VO_SetDispBufLen函数中u32BufLen的参数中增加物理设备和虚拟设备的取值范围；【注意】中缓冲长度的默认值区分物理设备和虚拟设备；删除“缓冲长度不是默认值的相关描述”；“缓冲长度越大，即用户可以更长时间的持有显示数据。”改为“缓冲长度越大，即用户可以持有的显示图像越多。”；新增2条注意事项。VO_DEV的成员VO_DEV的描述中增加取值3～5对应的设备；【注意】中增加关于虚拟设备的注意。VO_VIDEO_LAYER_ATTR_S的[注意]中增加关于虚拟设备的注意。第6章视频编码HI_MPI_VENC_RegisterChn的【注意】中修改同组的主次码流宽高必须符合如下约束。HI_MPI_VENC_SetH264eRcPara的【注意】中增加3条事项。HI_MPI_VENC_GetH264eRcPara的【注意】中增加1条事项。VENC_ATTR_H264_RC_S的【定义】和【成员】中增加bFrameLostAllow；修改【成员】中3个成员的描述。第8章视频解码8.1概述中增加VDEC实现MJPEG、JPEG解码功能的说明。8.2重要概念中图象输出方式中的“快速输出”改为“直接输出”；增加“超大帧”的描述HI_MPI_VDEC_CreateChn的【举例】中增加JPEG的举例。HI_MPI_VDEC_SetChnAttr的【举例】中增加JPEG的举例。HI_MPI_VDEC_SendStream的【注意】中增加1条事项。HI_MPI_VDEC_ResetChn的【注意】中增加1条事项。增加HI_MPI_VDEC_SetChnParam、HI_MPI_VDEC_GetChnParam。8.4数据类型增加VDEC_CHN_PARAM_S。VDEC_ATTR_H264_S的成员u32RefFrameNum的描述有修改。第9章音频修改表9-1中AACEncoder协议的帧长；增加AACEncoder协Hi3520／Hi3515媒体处理软件开发参考前言文档版本05(2010-07-01)海思专有和保密信息版权所有©深圳市海思半导体有限公司5修订日期版本修订说明议中对aacPlus1和aacPlus2的补充说明。修改表9-2和表9-3的表描述；调整表9-2的表达样式；统一将NO改为Notsupported。HI_MPI_AI_SetPubAttr的【注意】中对buffer的大小重新定义。HI_MPI_AO_SetPubAttr的【注意】中修改“I2S主模式时，同一SIO下的AI和AO设备的时钟选择配置必须相同”。HI_MPI_AENC_CreateChn的【注意】中增加对buffer的建议配置值。HI_MPI_ADEC_CreateChn的【注意】中增加对buffer的建议配置值。HI_MPI_ADEC_SendStream的【注意】中增加“AAC解码只支持stream方式；LPCM解码只支持pack方式；其他音频格式的解码两种方式都支持，但正式应用中建议只使用pack方式”的描述。ADEC_ATTR_AMR_S的【定义】有修改。第10章Proc调试信息10.1概述中删除“不同版本中，这些调试信息可能不同，现以Hi3520_SDK_V1.0.2.4版本为准”的说明；修改关于“Hi3520与Hi3515显示的proc信息格式”的相关描述。10.6VO增加级联的相关调试信息及参数说明。10.8VENC修改VENCCHNSTATE的UserGet和userRls参数说明。10.12VDEC增加MODULEPARAM的相关调试信息及参数说明。10.18H264E更新调试信息及参数说明。10.19H264D中的Const增加参数FrmMax及相应说明、ErrStat增加参数ErrBigF及相应说明。2010-05-2904第3章视频输入修改表3-1下的表说明b中色度重采样ChromaRes的配置要求，由“一般配置为False既可”改为“详细说明请参考《Hi3520H.264编解码处理器用户指南》，没有特殊要求则配置为False。”表3-1下的关于采集区域CapRect的配置说明中增加“CapRect中所有项的取值都必须是偶数，其中宽度值还要求必须是4的整数倍”。第4章视频输出对API进行分类及顺序调整。HI_MPI_VO_SetChnFilter的【描述】中将“利用TDE单元进行缩放”改为“利用DSU单元进行缩放”；将系统内部提供滤波系数的相关说明改为系统提供的滤波参数和系数的相关说明；将“通过此接口可以设置缩放系数”改为“设置缩放类型”；【注意】中增加“设置enFilterType”和“当用户对缩放前言Hi3520／Hi3515媒体处理软件开发参考6海思专有和保密信息版权所有©深圳市海思半导体有限公司文档版本05(2010-07-01)修订日期版本修订说明效果有特定需求时”的注意事项。HI_MPI_VO_SetZoomInRatio的【注意】中局部放大比例结构体中的设置值由原来的“表示为百分之多少”改为“表示千分之多少”，同时删除“昀后一位表示精度”的说明；增加“当混合输入的时候，起始坐标的横坐标、宽度在大图像上会自从以4对齐（向靠近0的方向）”的说明。增加设置有效区处理模式时的视频层属性的相关概念示意图4-2。VO_CHN_FILTER_S的【定义】和【成员】中增加enFiltType的描述。增加图4-3局部放大原理示意。第5章视频前处理增加接口HI_MPI_VPP_SetDsuFiltParam和HI_MPI_VPP_GetDsuFiltParam。接口HI_MPI_VPP_SetConf的【注意】中增加关于滤波参数、滤波类型和滤波系数的描述。增加DSU_HFILTER_PARAM_NUM、DSU_VFILTER_PARAM_NUM、DSU_HSCALE_FILTER_E和DSU_FILTER_PARAM_S。VIDEO_PREPROC_CONF_S的【定义】和【成员】中增加enFilterType的相关内容；【注意事项】中增加滤波类型、滤波参数和滤波系数的描述。第6章视频编码增加接口HI_MPI_VENC_SetMeParam和HI_MPI_VENC_GetMeParam。增加数据类型VENC_ME_PARAM_H264_S和VENC_ME_PARAM_S。HI_MPI_VENC_SetParamSet的【注意】中