第1页 / 共1084页
第2页 / 共1084页
第3页 / 共1084页
第4页 / 共1084页
第5页 / 共1084页
第6页 / 共1084页
第7页 / 共1084页
第8页 / 共1084页
海思HiMPP视频编解码开发文档.pdf
扉 页
前 言
1 系统概述
目 录
1.1 概述
1.2 系统架构
1.3 海思媒体处理平台架构
2 系统控制
目 录
表格目录
2.1 概述
2.2 功能描述
2.2.1 视频缓存池
2.2.2 系统绑定
2.3 API参考
HI_MPI_SYS_SetConf
HI_MPI_SYS_GetConf
HI_MPI_SYS_Init
HI_MPI_SYS_Exit
HI_MPI_SYS_Bind
HI_MPI_SYS_UnBind
HI_MPI_SYS_GetBindbyDest
HI_MPI_SYS_GetVersion
HI_MPI_SYS_GetCurPts
HI_MPI_SYS_InitPtsBase
HI_MPI_SYS_SyncPts
HI_MPI_SYS_Mmap
HI_MPI_SYS_Munmap
HI_MPI_SYS_SetReg
HI_MPI_SYS_GetReg
HI_MPI_SYS_MmzAlloc
HI_MPI_SYS_MmzAlloc_Cached
HI_MPI_SYS_MmzFlushCache
HI_MPI_SYS_MmzFree
HI_MPI_SYS_SetMemConf
HI_MPI_SYS_GetMemConf
HI_MPI_SYS_CloseFd
HI_MPI_VB_SetConf
HI_MPI_VB_GetConf
HI_MPI_VB_Init
HI_MPI_VB_Exit
HI_MPI_VB_CreatePool
HI_MPI_VB_DestroyPool
HI_MPI_VB_GetBlock
HI_MPI_VB_ReleaseBlock
HI_MPI_VB_Handle2PhysAddr
HI_MPI_VB_Handle2PoolId
HI_MPI_VB_MmapPool
HI_MPI_VB_MunmapPool
HI_MPI_VB_GetBlkVirAddr
2.4 数据类型
2.4.1 基本数据类型
公共数据类型
Hi3531的基本数据类型
Hi3521的基本数据类型
POINT_S
SIZE_S
RECT_S
MOD_ID_E
MPP_CHN_S
PAYLOAD_TYPE_E
2.4.2 系统控制数据类型
MPP_SYS_CONF_S
VB_CONF_S
MPP_VERSION_S
2.4.3 视频公共类型
VIDEO_NORM_E
PIXEL_FORMAT_E
VIDEO_FIELD_E
VIDEO_FRAME_S
VIDEO_FRAME_INFO_S
BITMAP_S
VIDEO_VBI_INFO_S
2.5 错误码
2.5.1 系统控制错误码
2.5.2 视频缓存池错误码
3 视频输入
目 录
插图目录
表格目录
3.1 概述
3.2 重要概念
3.3 功能描述
3.3.1 Hi3531/Hi3532
功能框图
视频输入设备
视频物理通道
典型应用场景
绑定关系
默认绑定关系详解
掩码配置
级联模式
3.3.2 Hi3521/Hi3520A
功能框图
视频输入设备
视频物理通道
绑定关系
掩码配置
级联模式
3.3.3 Hi3520D/Hi3515A/Hi3515C
功能框图
视频输入设备
视频物理通道
绑定关系
掩码配置
级联模式
3.3.4 Hi3518/Hi3516C
功能框图
视频输入设备
视频物理通道
视频扩展通道
绑定关系
掩码配置
3.4 API参考
HI_MPI_VI_SetDevAttr
HI_MPI_VI_GetDevAttr
HI_MPI_VI_SetDevAttrEx
HI_MPI_VI_GetDevAttrEx
HI_MPI_VI_EnableDev
HI_MPI_VI_DisableDev
HI_MPI_VI_SetChnAttr
HI_MPI_VI_GetChnAttr
HI_MPI_VI_SetChnMinorAttr
HI_MPI_VI_GetChnMinorAttr
HI_MPI_VI_ClearChnMinorAttr
HI_MPI_VI_EnableChn
HI_MPI_VI_DisableChn
HI_MPI_VI_EnableChnInterrupt
HI_MPI_VI_DisableChnInterrupt
HI_MPI_VI_SetFrameDepth
HI_MPI_VI_GetFrameDepth
HI_MPI_VI_GetFrame
HI_MPI_VI_GetFrameTimeOut
HI_MPI_VI_ReleaseFrame
HI_MPI_VI_SetUserPic
HI_MPI_VI_EnableUserPic
HI_MPI_VI_DisableUserPic
HI_MPI_VI_EnableCascade
HI_MPI_VI_DisableCascade
HI_MPI_VI_EnableCascadeChn
HI_MPI_VI_DisableCascadeChn
HI_MPI_VI_ChnBind
HI_MPI_VI_ChnUnBind
HI_MPI_VI_GetChnBind
HI_MPI_VI_GetFd
HI_MPI_VI_Query
HI_MPI_VI_SetFlashConfig
HI_MPI_VI_GetFlashConfig
HI_MPI_VI_FlashTrigger
HI_MPI_VI_SetExtChnAttr
HI_MPI_VI_GetExtChnAttr
HI_MPI_VI_SetLDCAttr
HI_MPI_VI_GetLDCAttr
HI_MPI_VI_SetCSCAttr
HI_MPI_VI_GetCSCAttr
HI_MPI_VI_SetRotate
HI_MPI_VI_GetRotate
HI_MPI_VI_GetChnLuma
3.5 数据类型
VIU_MAX_DEV_NUM
VIU_MAX_WAY_NUM_PER_DEV
VIU_MAX_PHYCHN_NUM
VIU_EXT_CHN_START
VIU_MAX_EXT_CHN_NUM
VIU_MAX_EXTCHN_BIND_PER_CHN
VIU_MAX_CHN_NUM
SUBCHN
VI_CAS_CHN_1
VI_CAS_CHN_2
VI_INTF_MODE_E
VI_INPUT_MODE_E
VI_WORK_MODE_E
VI_SCAN_MODE_E
VI_DATA_YUV_SEQ_E
VI_CLK_EDGE_E
VI_COMP_MODE_E
VI_COMBINE_MODE_E
VI_VSYNC_E
VI_VSYNC_NEG_E
VI_HSYNC_E
VI_HSYNC_NEG_E
VI_VSYNC_VALID_E
VI_VSYNC_VALID_NEG_E
VI_TIMING_BLANK_S
VI_SYNC_CFG_S
BT656_FIXCODE_E
BT656_FIELD_POLAR_E
VI_BT656_SYNC_CFG_S
VI_DEV_ATTR_S
VI_DEV_ATTR_EX_S
VI_CHN_BIND_ATTR_S
VI_CAPSEL_E
VI_CHN_ATTR_S
VI_USERPIC_MODE_E
VI_USERPIC_BGC_S
VI_USERPIC_ATTR_S
VI_CHN_STAT_S
ROTATE_E
VI_DATA_PATH_E
VI_DATA_TYPE_E
VI_EXT_CHN_ATTR_S
LDC_VIEW_TYPE_E
LDC_ATTR_S
VI_LDC_ATTR_S
VI_CSC_TYPE_E
VI_CSC_ATTR_S
VI_FLASH_MODE_E
VI_FLASH_CONFIG_S
VI_CHN_LUM_S
3.6 错误码
4 视频输出
目 录
插图目录
表格目录
4.1 概述
4.2 重要概念
4.3 API参考
HI_MPI_VO_Enable
HI_MPI_VO_Disable
HI_MPI_VO_SetPubAttr
HI_MPI_VO_GetPubAttr
HI_MPI_VO_CloseFd
HI_MPI_VO_SetDevFramerate
HI_MPI_VO_GetDevFramerate
HI_MPI_VO_EnableVideoLayer
HI_MPI_VO_DisableVideoLayer
HI_MPI_VO_SetVideoLayerAttr
HI_MPI_VO_GetVideoLayerAttr
HI_MPI_VO_PipLayerBindDev
HI_MPI_VO_PipLayerUnBindDev
HI_MPI_VO_SetPipLayerAttr
HI_MPI_VO_GetPipLayerAttr
HI_MPI_VO_EnablePipLayer
HI_MPI_VO_DisablePipLayer
HI_MPI_VO_EnableChn
HI_MPI_VO_DisableChn
HI_MPI_VO_SetChnAttr
HI_MPI_VO_GetChnAttr
HI_MPI_VO_SetChnDispPos
HI_MPI_VO_GetChnDispPos
HI_MPI_VO_SetChnField
HI_MPI_VO_GetChnField
HI_MPI_VO_SendFrame
HI_MPI_VO_SendFrameTimeOut
HI_MPI_VO_SetChnFrameRate
HI_MPI_VO_GetChnFrameRate
HI_MPI_VO_ChnPause
HI_MPI_VO_ChnResume
HI_MPI_VO_ChnStep
HI_MPI_VO_ChnRefresh
HI_MPI_VO_SetZoomInWindow
HI_MPI_VO_GetZoomInWindow
HI_MPI_VO_GetChnPts
HI_MPI_VO_SetAttrBegin
HI_MPI_VO_SetAttrEnd
HI_MPI_VO_ChnShow
HI_MPI_VO_ChnHide
HI_MPI_VO_QueryChnStat
HI_MPI_VO_GetChnFrame
HI_MPI_VO_ReleaseChnFrame
HI_MPI_VO_ClearChnBuffer
HI_MPI_VO_SetChnDispThreshold
HI_MPI_VO_GetChnDispThreshold
HI_MPI_VO_EnableChnDoubleFrame
HI_MPI_VO_DisableChnDoubleFrame
HI_MPI_VO_GetScreenFrame
HI_MPI_VO_ReleaseScreenFrame
HI_MPI_VO_SetDevCSC
HI_MPI_VO_GetDevCSC
HI_MPI_VO_SetVgaParam
HI_MPI_VO_GetVgaParam
HI_MPI_VO_SetDispBufLen
HI_MPI_VO_GetDispBufLen
HI_MPI_VO_SetPlayToleration
HI_MPI_VO_GetPlayToleration
HI_MPI_VO_SetVtth
HI_MPI_VO_GetVtth
HI_MPI_VO_EnableWbc
HI_MPI_VO_DisableWbc
HI_MPI_VO_SetWbcAttr
HI_MPI_VO_GetWbcAttr
HI_MPI_VO_SetWbcMode
HI_MPI_VO_GetWbcMode
HI_MPI_VO_SetWbcDepth
HI_MPI_VO_GetWbcDepth
HI_MPI_VO_WbcGetScreenFrame
HI_MPI_VO_WbcReleaseScreenFrame
HI_MPI_VO_GfxLayerBindDev
HI_MPI_VO_GfxLayerUnBindDev
HI_MPI_VO_SetGfxLayerCSC
HI_MPI_VO_GetGfxLayerCSC
HI_MPI_VO_SetCascadeAttr
HI_MPI_VO_GetCascadeAttr
HI_MPI_VO_EnableCascadeDev
HI_MPI_VO_DisableCascadeDev
HI_MPI_VO_SetCascadePattern
HI_MPI_VO_GetCascadePattern
HI_MPI_VO_CascadePosBindChn
HI_MPI_VO_CascadePosUnBindChn
HI_MPI_VO_EnableCascade
HI_MPI_VO_DisableCascade
4.4 数据类型
VO_DEV
VO_PUB_ATTR_S
VO_VIDEO_LAYER_ATTR_S
VO_CHN_ATTR_S
VO_DISPLAY_FIELD_E
VO_QUERY_STATUS_S
VO_ZOOM_RATIO_S
VO_ZOOM_ATTR_S
VO_CSC_S
VO_VGA_PARAM_S
VO_CSC_MATRIX_E
VO_WBC_ATTR_S
VO_WBC_MODE_E
VO_CAS_MODE_E
VO_CAS_RGN_E
VO_CAS_ATTR_S
4.5 错误码
5 视频处理子系统
目 录
插图目录
表格目录
5.1 概述
5.2 功能描述
5.2.1 基本概念
5.2.2 功能描述
5.2.3 芯片差异
5.3 API参考
HI_MPI_VPSS_CreateGrp
HI_MPI_VPSS_DestroyGrp
HI_MPI_VPSS_GetGrpAttr
HI_MPI_VPSS_SetGrpAttr
HI_MPI_VPSS_StartGrp
HI_MPI_VPSS_StopGrp
HI_MPI_VPSS_ResetGrp
HI_MPI_VPSS_GetChnAttr
HI_MPI_VPSS_SetChnAttr
HI_MPI_VPSS_EnableChn
HI_MPI_VPSS_DisableChn
HI_MPI_VPSS_SetGrpParam
HI_MPI_VPSS_GetGrpParam
HI_MPI_VPSS_SetCropCfg
HI_MPI_VPSS_GetCropCfg
HI_MPI_VPSS_UserSendFrame
HI_MPI_VPSS_UserSendFrameTimeout
HI_MPI_VPSS_SetChnMode
HI_MPI_VPSS_GetChnMode
HI_MPI_VPSS_SetDepth
HI_MPI_VPSS_GetDepth
HI_MPI_VPSS_UserGetFrame
HI_MPI_VPSS_UserReleaseFrame
HI_MPI_VPSS_UserGetGrpFrame
HI_MPI_VPSS_UserReleaseGrpFrame
HI_MPI_VPSS_SetChnNrParam
HI_MPI_VPSS_GetChnNrParam
HI_MPI_VPSS_SetChnSpParam
HI_MPI_VPSS_GetChnSpParam
HI_MPI_VPSS_SetPreScale
HI_MPI_VPSS_GetPreScale
HI_MPI_VPSS_SetChnField
HI_MPI_VPSS_GetChnField
HI_MPI_VPSS_SetGrpSizer
HI_MPI_VPSS_GetGrpSizer
HI_MPI_VPSS_SetGrpFrameRate
HI_MPI_VPSS_GetGrpFrameRate
HI_MPI_VPSS_SetDelay
HI_MPI_VPSS_GetDelay
HI_MPI_VPSS_SetExtChnAttr
HI_MPI_VPSS_GetExtChnAttr
5.4 数据类型
VPSS_MAX_GRP_NUM
VPSS_MAX_CHN_NUM
VPSS_MAX_PHY_CHN_NUM
VPSS_MAX_EXT_CHN_NUM
VPSS_BSTR_CHN
VPSS_LSTR_CHN
VPSS_PRE0_CHN
VPSS_PRE1_CHN
VPSS_BYPASS_CHN
VPSS_GRP
VPSS_CHN
VPSS_DIE_MODE_E
VPSS_DISPLAY_MODE_E
VPSS_SF_WINDOW_E
VPSS_FRAME_WORK_E
VPSS_CROP_COORDINATE_E
RECT_S
VPSS_CROP_INFO_S
VPSS_GRP_ATTR_S
VPSS_FRAME_S
VPSS_CHN_ATTR_S
VPSS_GRP_PARAM_S
VPSS_CHN_MODE_E
VPSS_CHN_MODE_S
VPSS_CHN_NR_PARAM_S
VPSS_CHN_SP_PARAM_S
VPSS_CHN_PARAM_S
VPSS_CAPSEL_E
VPSS_PRESCALE_INFO_S
VPSS_SIZER_INFO_S
VPSS_FRAME_RATE_S
VPSS_EXT_CHN_ATTR_S
5.5 错误码
6 视频编码
目 录
插图目录
表格目录
6.1 概述
6.2 功能描述
6.2.1 编码数据流程图
6.2.2 编码通道与通道组
6.2.3 码率控制
CBR
VBR
FIXQP
6.2.4 跳帧参考
6.2.5 高级跳帧参考模式
6.2.6 彩转灰
6.2.7 裁剪编码
6.2.8 ROI
6.2.9 JPEG抓拍模式
6.3 API参考
HI_MPI_VENC_CreateGroup
HI_MPI_VENC_DestroyGroup
HI_MPI_VENC_CreateChn
HI_MPI_VENC_DestroyChn
HI_MPI_VENC_RegisterChn
HI_MPI_VENC_UnRegisterChn
HI_MPI_VENC_StartRecvPic
HI_MPI_VENC_StartRecvPicEx
HI_MPI_VENC_StopRecvPic
HI_MPI_VENC_Query
HI_MPI_VENC_SetChnAttr
HI_MPI_VENC_GetChnAttr
HI_MPI_VENC_GetStream
HI_MPI_VENC_ReleaseStream
HI_MPI_VENC_InsertUserData
HI_MPI_VENC_SendFrame
HI_MPI_VENC_SetMaxStreamCnt
HI_MPI_VENC_GetMaxStreamCnt
HI_MPI_VENC_RequestIDR
HI_MPI_VENC_GetFd
HI_MPI_VENC_SetRoiCfg
HI_MPI_VENC_GetRoiCfg
HI_MPI_VENC_SetH264SliceSplit
HI_MPI_VENC_GetH264SliceSplit
HI_MPI_VENC_SetH264InterPred
HI_MPI_VENC_GetH264InterPred
HI_MPI_VENC_SetH264IntraPred
HI_MPI_VENC_GetH264IntraPred
HI_MPI_VENC_SetH264Trans
HI_MPI_VENC_GetH264Trans
HI_MPI_VENC_SetH264Entropy
HI_MPI_VENC_GetH264Entropy
HI_MPI_VENC_SetH264Poc
HI_MPI_VENC_GetH264Poc
HI_MPI_VENC_SetH264Dblk
HI_MPI_VENC_GetH264Dblk
HI_MPI_VENC_SetH264Vui
HI_MPI_VENC_GetH264Vui
HI_MPI_VENC_SetJpegParam
HI_MPI_VENC_GetJpegParam
HI_MPI_VENC_SetMpeg4Param
HI_MPI_VENC_GetMpeg4Param
HI_MPI_VENC_SetMjpegParam
HI_MPI_VENC_GetMjpegParam
HI_MPI_VENC_SetGrpFrmRate
HI_MPI_VENC_GetGrpFrmRate
HI_MPI_VENC_SetRcPara
HI_MPI_VENC_GetRcPara
HI_MPI_VENC_SetH264eRefMode
HI_MPI_VENC_GetH264eRefMode
HI_MPI_VENC_SetH264eRefParam
HI_MPI_VENC_GetH264eRefParam
HI_MPI_VENC_SetColor2GreyConf
HI_MPI_VENC_GetColor2GreyConf
HI_MPI_VENC_SetGrpColor2Grey
HI_MPI_VENC_GetGrpColor2Grey
HI_MPI_VENC_SetGrpCrop
HI_MPI_VENC_GetGrpCrop
HI_MPI_VENC_SetJpegSnapMode
HI_MPI_VENC_GetJpegSnapMode
6.4 数据类型
H264E_NALU_TYPE_E
H264E_REFSLICE_TYPE_E
JPEGE_PACK_TYPE_E
MPEG4E_PACK_TYPE_E
VENC_DATA_TYPE_U
VENC_PACK_S
VENC_STREAM_INFO_H264_S
VENC_STREAM_INFO_JPEG_S
VENC_STREAM_INFO_MPEG4_S
VENC_STREAM_S
VENC_ATTR_H264_S
VENC_ATTR_MJPEG_S
VENC_ATTR_JPEG_S
VENC_ATTR_MPEG4_S
VENC_ATTR_S
VENC_CHN_ATTR_S
VENC_CHN_STAT_S
VENC_PARAM_H264_SLICE_SPLIT_S
VENC_PARAM_H264_INTER_PRED_S
VENC_PARAM_H264_INTRA_PRED_S
VENC_PARAM_H264_TRANS_S
VENC_PARAM_H264_ENTROPY_S
VENC_PARAM_H264_POC_S
VENC_PARAM_H264_DBLK_S
VENC_PARAM_H264_VUI_S
VENC_PARAM_JPEG_S
VENC_PARAM_MJPEG_S
VENC_PARAM_MPEG4_S
VENC_ROI_CFG_S
VENC_ATTR_H264_REF_MODE_E
VENC_ATTR_H264_REF_PARAM_S
VENC_RC_ATTR_S
VENC_RC_MODE_E
VENC_ATTR_H264_CBR_S
VENC_ATTR_H264_VBR_S
VENC_ATTR_H264_FIXQP_S
VENC_ATTR_MPEG4_CBR_S
VENC_ATTR_MPEG4_VBR_S
VENC_ATTR_MPEG4_FIXQP_S
VENC_ATTR_MJPEG_FIXQP_S
VENC_ATTR_MJPEG_CBR_S
VENC_ATTR_MJPEG_VBR_S
VENC_SUPERFRM_MODE_EN
VENC_PARAM_H264_CBR_S
VENC_PARAM_H264_VBR_S
VENC_PARAM_MJPEG_CBR_S
VENC_PARAM_MJPEG_VBR_S
VENC_PARAM_MPEG4_CBR_S
VENC_PARAM_MPEG4_VBR_S
VENC_PARAM_H264_CBRV2_S
VENC_RC_PARAM_S
GROUP_CROP_CFG_S
GROUP_FRAME_RATE_S
GROUP_COLOR2GREY_S
GROUP_COLOR2GREY_CONF_S
VENC_JPEG_SNAP_MODE_E
VENC_RECV_PIC_PARAM_S
6.5 错误码
7 视频侦测分析
目 录
插图目录
表格目录
7.1 概述
7.2 功能描述
7.2.1 基本概念
7.2.2 创建通道
相同配置项
不同配置项(only for MD)
不同配置项(only for OD)
配置注意事项
7.2.3 输入源
7.2.4 处理VDA结果
MD通道
OD通道
7.3 API参考
HI_MPI_VDA_CreateChn
HI_MPI_VDA_DestroyChn
HI_MPI_VDA_SetChnAttr
HI_MPI_VDA_GetChnAttr
HI_MPI_VDA_StartRecvPic
HI_MPI_VDA_StopRecvPic
HI_MPI_VDA_GetData
HI_MPI_VDA_ReleaseData
HI_MPI_VDA_ResetOdRegion
HI_MPI_VDA_Query
HI_MPI_VDA_UpdateRef
HI_MPI_VDA_GetFd
HI_MPI_VDA_UserSendPic
7.4 数据类型
VDA_CHN
VDA_CHN_NUM_MAX
VDA_MAX_WIDTH
VDA_MAX_HEIGHT
VDA_OD_RGN_NUM_MAX
VDA_OBJ_S
VDA_REF_MODE_E
VDA_ALG_E
VDA_MB_SIZE_E
VDA_MB_SADBITS_E
VDA_OD_RGN_ATTR_S
VDA_MD_ATTR_S
VDA_OD_ATTR_S
VDA_WORK_MODE_E
VDA_WORK_MODE_ATTR_U
VDA_CHN_ATTR_S
VDA_MB_SAD_DATA_S
VDA_OBJ_DATA_S
VDA_MD_DATA_S
VDA_OD_DATA_S
VDA_DATA_U
VDA_DATA_S
VDA_CHN_STAT_S
7.5 错误码
8 区域管理
目 录
插图目录
表格目录
8.1 概述
8.2 功能描述
8.2.1 重要概念
8.2.2 使用示意
8.3 API参考
HI_MPI_RGN_Create
HI_MPI_RGN_Destroy
HI_MPI_RGN_GetAttr
HI_MPI_RGN_SetAttr
HI_MPI_RGN_SetBitMap
HI_MPI_RGN_SetAttachField
HI_MPI_RGN_GetAttachField
HI_MPI_RGN_AttachToChn
HI_MPI_RGN_DetachFrmChn
HI_MPI_RGN_SetDisplayAttr
HI_MPI_RGN_GetDisplayAttr
8.4 数据类型
RGN_HANDLE_MAX
OVERLAY_MAX_NUM
COVER_MAX_NUM
COVEREX_MAX_NUM
OVERLAYEX_MAX_NUM
RGN_HANDLE
RGN_TYPE_E
INVERT_COLOR_MODE_E
OVERLAY_QP_INFO_S
OVERLAY_INVERT_COLOR_S
RGN_ATTACH_FIELD_E
OVERLAY_ATTR_S
OVERLAY_CHN_ATTR_S
COVER_CHN_ATTR_S
COVEREX_CHN_ATTR_S
OVERLAYEX_ATTR_S
OVERLAYEX_CHN_ATTR_S
RGN_ATTR_U
RGN_CHN_ATTR_U
RGN_ATTR_S
RGN_CHN_ATTR_S
8.5 错误码
9 音频
目 录
表格目录
插图目录
9.1 概述
9.2 功能描述
9.2.1 音频输入和音频输出
9.2.1.1 音频接口和AI、AO设备
9.2.1.2 录音和播放原理
9.2.1.3 音频接口时序和AI、AO通道排列
音频接口时序
AI、AO通道
9.2.1.4 回声抵消、重采样和噪声抑制
回声抵消
重采样
噪声抑制
9.2.2 音频编码和解码
9.2.2.1 音频编解码流程
9.2.2.2 音频编解码协议
9.2.2.3 海思语音帧结构
9.2.3 芯片差异介绍
音频接口差异
音频的输入输出设备号范围
9.2.4 内置Audio Codec
9.2.4.1 概述
9.2.4.2 重要概念
9.2.4.3 ioctl函数
9.3 API参考
9.3.1 音频输入
HI_MPI_AI_SetPubAttr
HI_MPI_AI_GetPubAttr
HI_MPI_AI_Enable
HI_MPI_AI_Disable
HI_MPI_AI_EnableChn
HI_MPI_AI_DisableChn
HI_MPI_AI_GetFrame
HI_MPI_AI_ReleaseFrame
HI_MPI_AI_SetChnParam
HI_MPI_AI_GetChnParam
HI_MPI_AI_EnableAec
HI_MPI_AI_DisableAec
HI_MPI_AI_EnableReSmp
HI_MPI_AI_DisableReSmp
HI_MPI_AI_EnableAnr
HI_MPI_AI_DisableAnr
HI_MPI_AI_GetFd
9.3.2 音频输出
HI_MPI_AO_SetPubAttr
HI_MPI_AO_GetPubAttr
HI_MPI_AO_Enable
HI_MPI_AO_Disable
HI_MPI_AO_EnableChn
HI_MPI_AO_DisableChn
HI_MPI_AO_SendFrame
HI_MPI_AO_EnableReSmp
HI_MPI_AO_DisableReSmp
HI_MPI_AO_PauseChn
HI_MPI_AO_ResumeChn
HI_MPI_AO_ClearChnBuf
HI_MPI_AO_QueryChnStat
HI_MPI_AO_SetVolume
HI_MPI_AO_GetVolume
HI_MPI_AO_GetFd
9.3.3 音频编码
HI_MPI_AENC_CreateChn
HI_MPI_AENC_DestroyChn
HI_MPI_AENC_SendFrame
HI_MPI_AENC_GetStream
HI_MPI_AENC_ReleaseStream
HI_MPI_AENC_GetFd
HI_MPI_AENC_RegeisterEncoder
HI_MPI_AENC_UnRegisterEncoder
9.3.4 音频解码
HI_MPI_ADEC_CreateChn
HI_MPI_ADEC_DestroyChn
HI_MPI_ADEC_SendStream
HI_MPI_ADEC_ClearChnBuf
HI_MPI_ADEC_RegeisterDecoder
HI_MPI_ADEC_UnRegisterDecoder
9.3.5 内置Audio Codec
9.3.5.1 Audio Codec标准功能cmd
ACODEC_SOFT_RESET_CTRL
ACODEC_SET_I2S1_FS
ACODEC_SET_MIXER_MIC
ACODEC_SET_GAIN_MICL
ACODEC_SET_GAIN_MICR
ACODEC_SET_DACL_VOL
ACODEC_SET_DACR_VOL
ACODEC_SET_ADCL_VOL
ACODEC_SET_ADCR_VOL
ACODEC_SET_MICL_MUTE
ACODEC_SET_MICR_MUTE
ACODEC_SET_DACL_MUTE
ACODEC_SET_DACR_MUTE
ACODEC_DAC_SOFT_MUTE
ACODEC_DAC_SOFT_UNMUTE
ACODEC_GET_GAIN_MICL
ACODEC_GET_GAIN_MICR
ACODEC_GET_DACL_VOL
ACODEC_GET_DACR_VOL
ACODEC_GET_ADCL_VOL
ACODEC_GET_ADCR_VOL
ACODEC_SET_PD_DACL
ACODEC_SET_PD_DACR
ACODEC_SET_PD_ADCL
ACODEC_SET_PD_ADCR
9.3.5.2 扩展功能cmd
ACODEC_SEL_DAC_CLK
ACODEC_SEL_ANA_MCLK
ACODEC_DACL_SEL_TRACK
ACODEC_DACR_SEL_TRACK
ACODEC_ADCL_SEL_TRACK
ACODEC_ADCR_SEL_TRACK
ACODEC_SET_DAC_DE_EMPHASIS
ACODEC_SET_ADC_HP_FILTER
ACODEC_DAC_POP_FREE
ACODEC_DAC_SOFT_MUTE_RATE
ACODEC_DAC_SEL_I2S
ACODEC_ADC_SEL_I2S
ACODEC_SET_I2S1_DATAWIDTH
ACODEC_SET_I2S2_DATAWIDTH
ACODEC_SET_I2S2_FS
ACODEC_SET_DACR2DACL_VOL
ACODEC_SET_DACL2DACR_VOL
ACODEC_SET_ADCL2DACL_VOL
ACODEC_SET_ADCR2DACL_VOL
ACODEC_SET_ADCL2DACR_VOL
ACODEC_SET_ADCR2DACR_VOL
9.4 数据类型
9.4.1 音频输入输出
SIO_MAX_NUM
AIO_MAX_CHN_NUM
AUDIO_SAMPLE_RATE_E
AUDIO_BIT_WIDTH_E
AIO_MODE_E
AUDIO_SOUND_MODE_E
AIO_ATTR_S
AUDIO_FRAME_S
AEC_FRAME_S
AI_CHN_PARAM_S
AUDIO_STREAM_S
AUDIO_RESAMPLE_TYPE_E
AUDIO_RESAMPLE_ATTR_S
AO_CHN_STATE_S
G726_BPS_E
ADPCM_TYPE_E
9.4.2 音频编码
AENC_MAX_CHN_NUM
AENC_ATTR_G711_S
AENC_ATTR_G726_S
AENC_ATTR_ADPCM_S
AENC_CHN_ATTR_S
AENC_ENCODER_S
9.4.3 音频解码
MAX_AUDIO_FRAME_NUM
ADEC_MAX_CHN_NUM
ADEC_ATTR_G711_S
ADEC_ATTR_G726_S
ADEC_ATTR_ADPCM_S
ADEC_MODE_E
ADEC_CHN_ATTR_S
ADEC_DECODER_S
9.4.4 内置Audio Codec
ACODEC_FS_E
ACODEC_MIXER_E
AUDIO_VOL_CTRL
9.5 错误码
音频输入错误码
音频输出错误码
音频编码错误码
音频解码错误码
10 视频解码
目 录
10.1 概述
10.2 重要概念
10.3 API参考
HI_MPI_VDEC_CreateChn
HI_MPI_VDEC_DestroyChn
HI_MPI_VDEC_StartRecvStream
HI_MPI_VDEC_StopRecvStream
HI_MPI_VDEC_Query
HI_MPI_VDEC_QueryData
HI_MPI_VDEC_GetChnAttr
HI_MPI_VDEC_SendStream
HI_MPI_VDEC_SendStream_TimeOut
HI_MPI_VDEC_GetUserData
HI_MPI_VDEC_GetUserData_TimeOut
HI_MPI_VDEC_ReleaseUserData
HI_MPI_VDEC_GetImage
HI_MPI_VDEC_GetImage_TimeOut
HI_MPI_VDEC_ReleaseImage
HI_MPI_VDEC_GetFd
HI_MPI_VDEC_ResetChn
HI_MPI_VDEC_SetChnParam
HI_MPI_VDEC_GetChnParam
HI_MPI_VDEC_SetPrtclParam
HI_MPI_VDEC_GetPrtclParam
10.4 数据类型
VDEC_CHN_ATTR_S
VDEC_ATTR_JPEG_S
VDEC_ATTR_VIDEO_S
VDEC_STREAM_S
VDEC_USERDATA_S
VDEC_CHN_STAT_S
VDEC_DECODE_ERROR_S
VIDEO_MODE_E
VDEC_CHN_PARAM_S
VDEC_PRTCL_PARAM_S
VDEC_STD_EXTENSION_U
10.5 错误码
11 智能加速引擎
目 录
插图目录
表格目录
11.1 概述
11.2 功能描述
11.2.1 重要概念
11.2.2 使用示意
11.3 API参考
HI_MPI_IVE_DMA
HI_MPI_IVE_FILTER
HI_MPI_IVE_CSC
HI_MPI_IVE_FILTER_AND_CSC
HI_MPI_IVE_SOBEL
HI_MPI_IVE_CANNY
HI_MPI_IVE_DILATE
HI_MPI_IVE_ERODE
HI_MPI_IVE_THRESH
HI_MPI_IVE_AND
HI_MPI_IVE_SUB
HI_MPI_IVE_OR
HI_MPI_IVE_INTEG
HI_MPI_IVE_HIST
HI_MPI_IVE_Query
11.4 数据类型
IVE_MAX_HANDLE_NR
IVE_MEM_INFO_S
IVE_SRC_FMT_E
IVE_SRC_INFO_S
IVE_CSC_OUT_FMT_E
IVE_CSC_MODE_E
IVE_CSC_CTRL_S
IVE_FILTER_CTRL_S
IVE_FILTER_AND_CSC_CTRL_S
IVE_SOBEL_CTRL_S
IVE_CANNY_OUT_FMT_E
IVE_CANNY_CTRL_S
IVE_DILATE_CTRL_S
IVE_ERODE_CTRL_S
IVE_THRESH_OUT_FMT_E
IVE_THRESH_CTRL_S
IVE_SUB_OUT_FMT_E
11.5 错误码
12 HDMI
目 录
表格目录
12.1 概述
12.2 重要概念
12.3 API参考
HI_MPI_HDMI_Init
HI_MPI_HDMI_DeInit
HI_MPI_HDMI_Open
HI_MPI_HDMI_Close
HI_MPI_HDMI_SetAttr
HI_MPI_HDMI_GetAttr
HI_MPI_HDMI_Start
HI_MPI_HDMI_Stop
HI_MPI_HDMI_GetSinkCapability
HI_MPI_HDMI_SetAVMute
HI_MPI_HDMI_Force_GetEDID
HI_MPI_HDMI_SetDeepColor
HI_MPI_HDMI_GetDeepColor
HI_MPI_HDMI_SetCsc
HI_MPI_HDMI_GetCsc
HI_MPI_HDMI_SetInfoFrame
HI_MPI_HDMI_GetInfoFrame
12.4 数据类型
HI_HDMI_ID_E
HI_HDMI_INIT_PARA_S
HI_HDMI_EVENT_TYPE_E
HI_HDMI_FORCE_ACTION_E
HI_HDMI_ATTR_S
HI_HDMI_VIDEO_FMT_E
HI_HDMI_VIDEO_MODE_E
HI_HDMI_DEEP_COLOR_E
HI_HDMI_SND_INTERFACE_E
HI_HDMI_SAMPLE_RATE_E
HI_HDMI_BIT_DEPTH_E
HI_HDMI_SINK_CAPABILITY_S
HI_HDMI_EDID_S
HI_HDMI_CSC_S
HI_HDMI_INFOFRAME_TYPE_E
HI_HDMI_AVI_INFOFRAME_VER2_S
HI_HDMI_AUD_INFOFRAME_VER1_S
HI_HMDI_INFORFRAME_UNIT_U
HI_HDMI_INFOFRAME_S
12.5 错误码
13 Proc调试信息说明
目 录
13.1 概述
13.2 SYS
13.3 VB
13.4 LOG
13.5 CHNL
13.6 DSU
13.7 GROUP
13.8 H264E
13.9 JPEGE
13.10 RC
13.11 REGION
13.12 VENC
13.13 VDEC
13.14 VI
13.15 VO
13.16 VPSS
13.17 IVE
13.18 VDA
13.19 AI
13.20 AO
13.21 AENC
13.22 ADEC
13.23 MPEG4E
13.24 HDMI
HiMPP 媒体处理软件
开发参考
文档版本
16
发布日期
2013-11-30
部件编码
N/A
深圳市海思半导体有限公司为客户提供全方位的技术支持，用户可与就近的海思办事处联系，也可直接与公
司总部联系。
深圳市海思半导体有限公司
地址：
深圳市龙岗区坂田华为基地华为电气生产中心 邮编：518129
网址：
http://www.hisilicon.com
客户服务电话： +86-755-28788858
客户服务传真： +86-755-28357515
客户服务邮箱： support@hisilicon.com
版权所有 © 深圳市海思半导体有限公司 2011-2013。保留一切权利。
非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式
传播。
商标声明
、
、海思和其他海思商标均为深圳市海思半导体有限公司的商标。
本文档提及的其他所有商标或注册商标，由各自的所有人拥有。
注意
由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，
本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
HiMPP 媒体处理软件
开发参考
前 言
前 言
概述
本文为使用 HiMPP 媒体处理芯片进行开发的程序员而写，目的是供您在开发过程中查
阅媒体处理软件开发包的各种参考信息，包括 API、头文件、错误码等。
本文档描述 HiMPP 媒体处理软件的各个 API 的使用方法，以及相关的数据结构和错误
码。
产品版本
与本文档相对应的产品版本如下。
产品名称
Hi3531 芯片
Hi3532 芯片
Hi3521 芯片
Hi3520A 芯片
Hi3518 芯片
Hi3516C 芯片
Hi3520D 芯片
Hi3515A 芯片
Hi3515C 芯片
产品版本
V100
V100
V100
V100
V100
V100
V100
V100
V100
读者对象
本文档主要适用于以下工程师：
技术支持工程师
文档版本 16 (2013-11-30)
海思专有和保密信息
版权所有 © 深圳市海思半导体有限公司
1
HiMPP 媒体处理软件
开发参考
软件开发工程师
约定
符号约定
在本文中可能出现下列标志，它们所代表的含义如下。
符号
说明
前 言
表示有高度潜在危险，如果不能避免，会导致人员死亡或
严重伤害。
表示有中度或低度潜在危险，如果不能避免，可能导致人
员轻微或中等伤害。
表示有潜在风险，如果忽视这些文本，可能导致设备损坏、
数据丢失、设备性能降低或不可预知的结果。
表示能帮助您解决某个问题或节省您的时间。
表示是正文的附加信息，是对正文的强调和补充。
说明
正文采用宋体表示。
一级、二级、三级标题采用黑体。
警告、提示等内容一律用楷体，并且在内容前后增加线条
与正文隔离。
通用格式约定
格式
宋体
黑体
楷体
“Terminal Display”格式 “Terminal Display”格式表示屏幕输出信息。此外，屏幕
输出信息中夹杂的用户从终端输入的信息采用加粗字体
表示。
用双引号表示文件路径。如“C:\Program Files\Huawei”。
“”
文档版本 16 (2013-11-30)
海思专有和保密信息
版权所有 © 深圳市海思半导体有限公司
2
HiMPP 媒体处理软件
开发参考
命令行格式约定
格式
粗体
斜体
[ ]
{ x | y | ... }
[ x | y | ... ]
{ x | y | ... } *
[ x | y | ... ] *
前 言
意义
命令行关键字（命令中保持不变、必须照输的部分）采用
加粗字体表示。
命令行参数（命令中必须由实际值进行替代的部分）采用
斜体表示。
表示用“[ ]”括起来的部分在命令配置时是可选的。
表示从两个或多个选项中选取一个。
表示从两个或多个选项中选取一个或者不选。
表示从两个或多个选项中选取多个，最少选取一个，最多
选取所有选项。
表示从两个或多个选项中选取多个或者不选。
数值单位约定
数据容量、频率、数据速率等的表达方式说明如下。
类别
符号
1K
数据容量（如 RAM 容量）
1M
频率、数据速率等
1G
1k
1M
1G
地址、数据的表达方式说明如下。
对应的数值
1024
1,048,576
1,073,741,824
1000
1,000,000
1,000,000,000
符号
0x
0b
X
举例
说明
0xFE04、0x18
用 16 进制表示的数据值、地址值。
0b000、0b00 00000000 表示 2 进制的数据值以及 2 进制序列
（寄存器描述中除外）。
00X、1XX
在数据的表达方式中，X 表示 0 或 1。
例如：00X 表示 000 或 001；
1XX 表示 100、101、110 或 111。
文档版本 16 (2013-11-30)
海思专有和保密信息
版权所有 © 深圳市海思半导体有限公司
3
HiMPP 媒体处理软件
开发参考
修订记录
前 言
修订记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本的更新内
容。
修订日期 版本 修订说明
2013-11-30 16
第 4 章 视频输出
新增 HI_MPI_VO_SetDevFramerate 和
HI_MPI_VO_GetDevFramerate。
VO_PUB_ATTR_S 的【注意事项】中删除“用户可以自定义时
序”的描述。
第 13 章 Proc 调试信息
更新 VO 和 VPSS。
2013-09-25 15
第 2 章 系统控制
增加“MPP 不支持多进程调用”的描述。
表 2-1 中，修改 VDEC 和 VO 的相关描述。
HI_MPI_SYS_Init 的【注意】中删除“只要有一个进程进行初
始化即可”的描述。
第 3 章 视频输入
VI_CHN_STAT_S 增加【成员】u32AutoDisInt 及描述。
第 4 章 视频输出
新增 HI_MPI_VO_EnableChnDoubleFrame 和
HI_MPI_VO_DisableChnDoubleFrame。
新增 HI_MPI_VO_SetVtth 和 HI_MPI_VO_GetVtth。
VO_PUB_ATTR_S 的【成员】enIntfSync 新增
VO_OUTPUT_1600x1200_60、VO_OUTPUT_1680x1050_60、
VO_OUTPUT_1920x1200_60、VO_OUTPUT_640x480_60；【注
意事项】中修改 enIntfSync 的最大值为 22。
第 5 章 视频子系统
5.2.3 芯片差异中增加 chn1 及修改 chn0 的部分描述。
更新图 5-3。
第 6 章 视频编码
更新 HI_MPI_VENC_CreateGroup、
HI_MPI_VENC_StartRecvPicEx 的【举例】。
HI_MPI_VENC_GetStream 的【注意】中增加码流特征信息
stMpeg4Info。
HI_MPI_VENC_SetH264eRefParam、
HI_MPI_VENC_GetH264eRefParam 的【语法】更新。
文档版本 16 (2013-11-30)
海思专有和保密信息
版权所有 © 深圳市海思半导体有限公司
4
HiMPP 媒体处理软件
开发参考
修订日期 版本 修订说明
前 言
HI_MPI_VENC_GetJpegSnapMode 的【注意】中修改“通道组”
为“通道”。
新增 VENC_PARAM_H264_CBRV2_S。
VENC_STREAM_INFO_H264_S、
VENC_STREAM_INFO_JPEG_S、
VENC_STREAM_INFO_MPEG4_S、VENC_RC_ATTR_S、
VENC_RC_MODE_E、VENC_PARAM_H264_CBR_S、
VENC_PARAM_H264_VBR_S、
VENC_PARAM_MJPEG_CBR_S、
VENC_PARAM_MJPEG_VBR_S、
VENC_PARAM_MPEG4_CBR_S、
VENC_PARAM_MPEG4_VBR_S、VENC_RC_PARAM_S 的【语
法】更新。
第 10 章 视频解码
增加 VDEC_DECODE_ERROR_S。
更新 VDEC_CHN_STAT_S【定义】。
第 12 章 HDMI
新增 HI_MPI_HDMI_SetInfoFrame、
HI_MPI_HDMI_GetInfoFrame。
新增 HI_HDMI_INFOFRAME_TYPE_E、
HI_HDMI_AVI_INFOFRAME_VER2_S、
HI_HDMI_AUD_INFOFRAME_VER1_S、
HI_HMDI_INFORFRAME_UNIT_U 和
HI_HDMI_INFOFRAME_S。
第 13 章 Proc 调试信息
更新 VDEC 和 VO。
2013-07-31 14
第 9 章 音频
9.3.2 音频输出中新增 HI_MPI_AO_SetVolume 和
HI_MPI_AO_GetVolume。
2013-07-03 13
第 13 章 Proc 调试信息
更新 Log。
2013-06-21 12
补充 Hi3515C 的相关信息描述。
2013-05-20 11
补充 Hi3515A 的相关信息描述。
第 3 章 视频输入
3.3 功能描述中，增加 Hi3518/Hi3516C 的视频输入设备 Dev0
不支持非连续 pixel clock 时序的描述。
第 4 章 视频输出
表 4-1 中增加 Hi3520D/Hi3515A 对支持的显示设备的描述。
新增 HI_MPI_VO_SetChnDispThreshold 和
文档版本 16 (2013-11-30)
海思专有和保密信息
版权所有 © 深圳市海思半导体有限公司
5
HiMPP 媒体处理软件
开发参考
修订日期 版本 修订说明
前 言
HI_MPI_VO_GetChnDispThreshold。
HI_MPI_VO_SetChnFrameRate 的【注意】中新增两个事项
HI_MPI_VO_SetChnField 的【描述】中增加一个应用场合；更
新【举例】。
HI_MPI_VO_SetZoomInWindow 的【注意】中增加注意事项。
VO_ZOOM_ATTR_S 的【注意事项】中修改按位置和按比例两
种类型的描述。
HI_MPI_VO_SetDevCSC、HI_MPI_VO_SetVgaParam 的【差异
说明】的描述有更新。
修改 HI_MPI_VO_SetDispBufLen 的【参数】u32BufLen 的最小
值为 3。
VO_CSC_S 和 VO_VGA_PARAM_S 的【成员】中增加各成员
的取值范围。
增加三个错误码。
第 8 章 区域管理
增加 HI_MPI_RGN_SetAttachField 和
HI_MPI_RGN_GetAttachField。
增加 RGN_ATTACH_FIELD_E。
修改 COVER_CHN_ATTR_S 和 COVEREX_CHN_ATTR_S 的
【成员】stRect 的取值范围。
第 9 章 音频
ACODEC_SOFT_RESET_CTRL 的【注意】中增加一条事项。
ACODEC_SET_MIXER_MIC 的【注意】中增加“选择 LINEIN”
的相关描述。
ACODEC_SET_GAIN_MICL 和 ACODEC_SET_GAIN_MICR
的【注意】中增加一条事项；修改【举例】中的配置值。
第 12 章 HDMI
新增 HI_MPI_HDMI_SetCsc、HI_MPI_HDMI_GetCsc 和
HI_HDMI_CSC_S。
第 13 章 Proc 调试信息
更新 REGION、VI、VO。
第 3 章 视频输入
HI_MPI_VI_SetUserPic 的【注意】中增加“VI 通道混合采集时，
如何设置图片”。
第 4 章 视频输出
HI_MPI_VO_SetChnAttr 的【注意】中增加“HD 设备的通道属
性设置”的相关描述。
HI_MPI_VO_SetChnDispPos 的【注意】中增加“设置显示位置
后，通道 disable 后”的相关描述。
2013-04-03 10
文档版本 16 (2013-11-30)
海思专有和保密信息
版权所有 © 深圳市海思半导体有限公司
6
相关推荐
2023年江西萍乡中考道德与法治真题及答案.doc
2012年重庆南川中考生物真题及答案.doc
2013年江西师范大学地理学综合及文艺理论基础考研真题.doc
2020年四川甘孜小升初语文真题及答案I卷.doc
2020年注册岩土工程师专业基础考试真题及答案.doc
2023-2024学年福建省厦门市九年级上学期数学月考试题及答案.doc
2021-2022学年辽宁省沈阳市大东区九年级上学期语文期末试题及答案.doc
2022-2023学年北京东城区初三第一学期物理期末试卷及答案.doc
2018上半年江西教师资格初中地理学科知识与教学能力真题及答案.doc
2012年河北国家公务员申论考试真题及答案-省级.doc
2020-2021学年江苏省扬州市江都区邵樊片九年级上学期数学第一次质量检测试题及答案.doc
2022下半年黑龙江教师资格证中学综合素质真题及答案.doc
