mpp中的例程
例程中结构体和枚举类型定义都是全大写字母用下划线分隔开，定义后面会用下划线带字母表示类型，采用驼峰法命名.
| 符号 | 含义 |
|---|---|
| *_E | 枚举类型 |
| *_S | 结构体类型 |
| en* | 枚举变量 |
| st* | 结构体变量 |
| 名词 | 解释 |
|---|---|
| PAYLOAD_TYPE_E | 被传输传输文件类型(码流类型) |
| butt | 枚举或者结构体中的结尾符 |
| VB_CONFIG_S | 视频缓存池设置参数 |
| HI_MPI_VB_SetConf() | 设置VB_CONFIG_S的参数到mpp中 |
| HI_MPI_VB_Init() | 执行mpp中设置的参数，使生效 |
| 缩写 | 含义 |
|---|---|
| VI | 视频输入 |
| VO | 视频输出 |
| VPSS | 视频处理 |
| VENC | 视频编码 |
| VDEC | 视频解码 |
| VO | 视频输出 |
| AVS | 视频拼接 |
| AI | 音频输入 |
| AO | 音频输出 |
| AENC | 音频编码 |
| ADEC | 音频解码 |
| REGION | 区域管理 |
概述：视频输入（VI）模块实现的功能：通过ITU-R BT656/601/1120接口或者Digital Camera接口,LVDS接口和HISPI接口接收视频数据
视频输入设备
在线模式与离线模式
视频物理通道
掩码
镜头畸变矫正(LDC)
VPSS(vedio Process Sub-System)支持对一幅输入图像进行统一处理，如去噪 去隔行等，然后对各通道分别进行缩放，锐化等处理，最后输出多种部分分辨率的图像
VPSS支持的具体图像处理功能包括FRC,Crop,NR,LDC,Rotate,COVER/Coverlay,Scale,Mirror/Flip,FishEye
VPSS一般是一进多出、
group: VPSS的虚拟化，就是把一个VPSS硬件虚拟成多个VPSS，每个VPSSgroup可以分时复用硬件VPSS
channel:通道分成2种，物理通道和扩展通道，VPSS提供多个物理通道，物理通道可以缩放，裁剪扩展通道具备缩放功能，可以把物理通道输出作为扩展通道的输入，把图像缩放成用户需要的分辨率输出
FRC:帧率控制分为group帧率控制和chn帧率控制
- group帧率控制：用于控制group对于图像的接收
- 通道帧率控制：用于控制各物理通道和扩展通道图像的处理
PIPE ：VPSS组的管道，只能取0
CROP： 裁剪分为3种：组裁剪，物理通道裁剪以及扩展通道裁剪
Sharpen 锐化： 对图像进行锐化处理
像素格式转换
支持输入输出图像的数据格式转换
- HI3516EV200 物理通道支持semi-planar422转semi-planar420/单分量， semi-planar420转单分量
Scale ：对图像进行缩小和放大，物理通道垂直最大支持15倍缩小，最大支持16倍放大， 扩展通道垂直支持30倍缩小，最大支持16倍放大
Mirror/File Mirror:水平镜像 Flip上下翻转
VI/VPASS的协作模式分成以下2种(模式切换由最开始加载ko文件的时候执行的load脚本控制，对应的sys模块参数vi_vpss_online(默认))
通过调用 SYS 模块的绑定接口，可与 AVS/USER/VDEC/VI 和 VO/VENC/SVP 等模块
进行绑定，其中前者为 VPSS 的输入源，后者为 VPSS 的接收者。用户可通过 MPI 接
口对 GROUP 进行管理。每个 GROUP 仅可与一个输入源绑定。GROUP 的物理通道有
两种工作模式：AUTO 和 USER，两种模式间可动态切换。AUTO 模式下各通道仅可
与一个接收者绑定，主要用于预览和回放场景下做播放控制。USER 模式下各通道可
与多个接收者绑定。需要 特别注意 的是，USER 模式主要用于对同一通道图像进行多
路编码的场景，此模式下播放控制不生效，因此回放场景下不建议使用 USER 模式。
VPSS 只有工作在离线模式下才支持 AUTO 模式
group的值一般是数字，代表编号
VI的通道对接的是VPSS的group，VPSS的chn对应的是输出流，HI3516EV200的流
单分量：图片信息中只有Y没有UV，就是黑白图片
图像编码压缩基本原理 参考：http://blog.csdn.net/newchenxf/article/details/51693753
profile: 视屏清晰度从低到高分为 BP MP HP，不同硬件和编码格式支持不同清晰度。
MPP手册中图像编码部分解读 参考：http://blog.csdn.net/u013354805/article/details/51988171
VENC:
学习重点
- SAMPLE_COMM_SYS_GetPicSize(enSize[i], &stSize[i]); 从预定义的enSize中获取一帧图片的像素点个数存放到stSize
- SAMPLE_COMM_VI_GetSensorInfo(&stViConfig);给多路摄像头标号到stViconfig中，Makefile定义SENSOR0_TYPE放到第0路设备中
- SAMPLE_VENC_CheckSensor(stViConfig.astViInfo[0].stSnsInfo.enSnsType,stSize[i]);检查摄像头能够输出的像素是否小于上文给出的像素点
- SAMPLE_VENC_ModifyResolution(stViConfig.astViInfo[0].stSnsInfo.enSnsType,&enSize[i],&stSize[i]);重新设置照片类型和像素点大小
- SAMPLE_VENC_GetDefaultVpssAttr(stViConfig.astViInfo[0].stSnsInfo.enSnsType, abChnEnable, stSize, &stParam);初始化VPSS
- GetVpssWrapBufLine(&stParam); ```现在还不知道```
- SAMPLE_VENC_GetCommVbAttr(stViConfig.astViInfo[0].stSnsInfo.enSnsType, &stParam, HI_FALSE, &commVbAttr); 初始化射频缓冲池的的参数
- SAMPLE_VENC_SYS_Init(&commVbAttr); 设置视频缓冲池
SAMPLE_COMM_SYS_Init() 初始化视频缓存池
HI_MPI_SYS_Exit(); 去初始化 MPP 系统
HI_MPI_VB_Exit(); 去初始化 MPP 视频缓存池
HI_MPI_VB_SetConfig：设置 MPP 视频缓存池属性
HI_MPI_VB_Init();初始化 MPP 视频缓存池
HI_MPI_SYS_Init();初始化 MPP 系统
SAMPLE_VENC_VI_Init(&stViConfig, ViVpssMode);
SAMPLE_COMM_VI_SetParam(pstViConfig); 设置VI参数
HI_MPI_SYS_GetVIVPSSMode(&stVIVPSSMode); 获取VI/VPSS的参数
SAMPLE_COMM_VI_UpdateVIVPSSMode(&stVIVPSSMode); 更新参数
HI_MPI_SYS_SetVIVPSSMode(&stVIVPSSMode); 设置参数
SAMPLE_COMM_VI_GetFrameRateBySensor(enSnsType, &u32FrameRate);从摄像头类型获取FPS
HI_MPI_ISP_GetCtrlParam(pstViConfig->astViInfo[0].stPipeInfo.aPipe[0], &stIspCtrlParam); 获取ISP控制参数
ISP_CHECK_PIPE(ViPipe); 检查管道
ISP_CHECK_POINTER(pstIspCtrlParam);
ISP_CH ECK_OPEN(ViPipe);
ioctl(g_as32IspFd[ViPipe], ISP_GET_CTRL_PARAM, pstIspCtrlParam);
HI_MPI_ISP_SetCtrlParam(pstViConfig->astViInfo[0].stPipeInfo.aPipe[0], &stIspCtrlParam); 设置ISP
ISP_CHECK_PIPE(ViPipe);
ISP_CHECK_POINTER(pstIspCtrlParam);
ISP_CHECK_OPEN(ViPipe);
return ioctl(g_as32IspFd[ViPipe], ISP_GET_CTRL_PARAM, pstIspCtrlParam); 把参数写入到ISP中
SAMPLE_COMM_VI_StartVi(pstViConfig); 启动VI
SAMPLE_COMM_VI_StartMIPI(pstViConfig);
SAMPLE_COMM_VI_SetParam(pstViConfig);
SAMPLE_COMM_VI_CreateVi(pstViConfig);
SAMPLE_COMM_VI_CreateIsp(pstViConfig);
SAMPLE_COMM_VI_DestroyVi(pstViConfig);
SAMPLE_COMM_SYS_Exit();
SAMPLE_COMM_VO_Exit();
HI_MPI_SYS_Exit();
HI_MPI_VB_ExitModCommPool(VB_UID_VDEC);
HI_MPI_VB_Exit();
SAMPLE_VENC_VPSS_Init(VpssGrp, &stParam);
SAMPLE_VENC_VPSS_CreateGrp(VpssGrp, pstParam); 创建用户组
SAMPLE_COMM_VI_GetSizeBySensor(pParam->enSnsType, &enSnsSize); 从摄像头类型获照片类型
SAMPLE_COMM_SYS_GetPicSize(enSnsSize, &stSnsSize);· 获取照片大小
HI_MPI_VPSS_CreateGrp(VpssGrp, &stVpssGrpAttr); 创建用户组
SAMPLE_VENC_VPSS_StartGrp(VpssGrp); 开启用户组
HI_MPI_VPSS_StartGrp(VpssGrp);
SAMPLE_VENC_VPSS_ChnDisable(VpssGrp, i)
SAMPLE_VENC_VPSS_DestoryGrp(VpssGrp);
SAMPLE_COMM_VI_Bind_VPSS(VI_PIPE ViPipe, VI_CHN ViChn, VPSS_GRP VpssGrp) 输入管道和输入通道绑定到用户组
CHECK_RET(HI_MPI_SYS_Bind(&stSrcChn, &stDestChn), "HI_MPI_SYS_Bind(VI-VPSS)");绑定输入通道和VPSS
SAMPLE_VENC_GetRcMode();
SAMPLE_RC_CBR() 用户输入帧率控制模式
SAMPLE_VENC_GetGopMode(); 用户选择用group模式，P B I 帧不同
SAMPLE_COMM_VENC_GetGopAttr(enGopMode,&stGopAttr); 从group得到 P B I 的参数
SAMPLE_COMM_VENC_Start() 创建H.265通道
SAMPLE_COMM_VENC_Creat()
SAMPLE_COMM_SYS_GetPicSize()
SAMPLE_COMM_VI_GetSensorInfo(&stViConfig);
SAMPLE_COMM_VI_GetFrameRateBySensor()
HI_MPI_VENC_CreateChn()
SAMPLE_COMM_VENC_CloseReEncode(VencChn);
HI_MPI_VENC_GetChnAttr(VencChn,&stChnAttr);
HI_MPI_VENC_GetRcParam(VencChn,&stRcParam);
HI_MPI_VENC_SetRcParam(VencChn,&stRcParam);
HI_MPI_VENC_StartRecvFrame(VencChn,&stRecvParam); 启动VENC通道
SAMPLE_COMM_VENC_SnapStart(VencChn[1], &stSize[1], bSupportDcf);JPEG 通道
SAMPLE_COMM_VENC_Start()创建H.264VENC通道
SAMPLE_COMM_VPSS_Bind_VENC() 绑定VPSS和VENC
SAMPLE_COMM_VENC_StartGetStream(VideoChn, 2);
pthread_create(&gs_VencPid, 0, SAMPLE_COMM_VENC_GetVencStreamProc, (HI_VOID*)&gs_stPara);创建线程把保存数据流
HI_MPI_VENC_GetChnAttr(VencChn, &stVencChnAttr); 获取VENC通道属性
SAMPLE_COMM_VENC_GetFilePostfix(enPayLoadType[i], szFilePostfix); 获取后缀名
fopen(aszFileName[i], "wb"); 创建文件保存VENC流数据
HI_MPI_VENC_GetFd(VencChn);从MPP中获取VENC通道文件描述符
HI_MPI_VENC_GetStreamBufInfo()获取码流 buffer 的物理地址和大小。
HI_MPI_VENC_QueryStatus(VencChn, &stStat);查询通道状态
HI_MPI_VENC_GetStream(VencChn, &stStream, -1); 从通道ID获取视屏流
SAMPLE_COMM_VENC_SaveStream(pFile, &stStream);保存视屏流到指定文件
SAMPLE_COMM_VENC_Getdcfinfo(char* SrcJpgPath, char* DstThmPath)从保存的视屏文件保存JPEG文件
HI_MPI_VENC_ReleaseStream(VencChn, &stStream);释放编码通道
HI_MPI_VENC_StopRecvFrame(VencChn);停止接受视屏流
SAMPLE_COMM_VENC_SnapProcess(VencChn[1], 1, HI_TRUE, HI_FALSE);
SAMPLE_COMM_VENC_StopGetStream();
SAMPLE_COMM_VPSS_UnBind_VENC(VpssGrp,VpssChn[1],VencChn[2]);
SAMPLE_COMM_VENC_Stop(VencChn[2]);
SAMPLE_COMM_VI_UnBind_VPSS(ViPipe,ViChn,VpssGrp);
SAMPLE_COMM_VPSS_Stop(VpssGrp,abChnEnable);
SAMPLE_COMM_VI_StopVi(&stViConfig);
SAMPLE_COMM_SYS_Exit();