Hi3516EV200设置手动曝光时间

0.测试环境说明

环境	参数
海思芯片型号	Hi3516EV200
传感器型号	IMX307
MPP	MPP4.0
SDK	Hi3516EV200_SDK_V1.0.1.1

1.手动曝光时间的设置

对手动曝光的控制接口函数为 HI_MPI_ISP_SetExposureAttr 和 HI_MPI_ISP_GetExposureAttr ，它们的说明在《HiISP 开发参考》P199。因为开发板环境为IMX307（无宽动态）所以使用这两个函数，如果涉及到宽动态可以看一下手册后面的HI_MPI_ISP_SetWDRExposureAttr和HI_MPI_ISP_GetWDRExposureAttr函数。

设置手动曝光时间的程序为：

VI_PIPE ViPipe=0;
ISP_EXPOSURE_ATTR_S ispExposureAttr;
s32Ret=HI_MPI_ISP_GetExposureAttr(ViPipe, &ispExposureAttr);
ispExposureAttr.bByPass = HI_FALSE;
ispExposureAttr.enOpType = OP_TYPE_MANUAL;
ispExposureAttr.stManual.enAGainOpType = OP_TYPE_MANUAL;
ispExposureAttr.stManual.enDGainOpType = OP_TYPE_MANUAL;
ispExposureAttr.stManual.enISPDGainOpType = OP_TYPE_MANUAL;
ispExposureAttr.stManual.enExpTimeOpType = OP_TYPE_MANUAL;
ispExposureAttr.stManual.u32AGain = 0x400;
ispExposureAttr.stManual.u32DGain = 0x400;
ispExposureAttr.stManual.u32ISPDGain = 0x400;
ispExposureAttr.stManual.u32ExpTime = 0x40000;
s32Ret=HI_MPI_ISP_SetExposureAttr(ViPipe, &ispExposureAttr);

这段程序来自ISP手册P201，和海思其他模块的属性设置套路一样，都是先读出，修改后再写入。

其中u32ExpTime变量就是设置的曝光时间，但是具体的值受其他参数和传感器影响，比如设置IMX307-30帧的情况下，该值的有效范围是0x59 ~ 0x81FA（89us ~ 33274us）。

另外该API内部会对设置值进行校正，所以设置的值和读出会有偏差，比如：

设置为10000(us)，查询为10006(us)
设置为20000(us)，查询为20012(us)
设置为30000(us)，查询为29988(us)

2.曝光参数设置位置

上面手动曝光是针对ISP的设置，在MPP4.0中放在VI-ViPIPE设置部分。

VI部分的初始化流程是这样的：

1.设置并启动MIPI
2.设置VI/VPSS离在线模式
3.使能VI设备
4.绑定VI设备和PIPE
5.启动VI PIPE
6.启动VI通道(Chn)
7.创建ISP

设置函数在创建ISP的时候进行，创建ISP又分为如下小步（参照mpp例程）：

1.更新ISP控制信息
2.注册3A库
3.ISP内存初始化
4.设置ISP公共属性
5.ISP初始化
6.启动对应VIPIPE的ISP线程

对ISP手动曝光的设置（上面那段程序）应该放在5、6步之间。

如果在第3步之前设置，会提示：

[Func]:HI_MPI_ISP_GetExposureAttr [Line]:303 [Info]:ISP[0] Mem NOT Init 0!

错误码为0xa01c8041（外部寄存器没有初始化）。

如果在第3~5步之间设置，会提示：

[Func]:HI_MPI_ISP_SetExposureAttr [Line]:126 [Info]:AGainMax/AGainMin should not be less than 0x400!

错误码为0xa01c8003（输入参数无效）。

3.曝光时间的获取

对当前曝光值的获取可以使用 HI_MPI_ISP_QueryExposureInfo 函数完成，它的说明在《HiISP 开发参考》P214。是一个很方便的查询接口：

#include "hi_comm_isp.h"//ISP相关数据类型
#include "mpi_ae.h"     //MPI-ISP函数声明

VI_PIPE ViPipe=0;
ISP_EXP_INFO_S stExpInfo;
HI_MPI_ISP_QueryExposureInfo(ViPipe,&stExpInfo);
printf("u32ExpTime: %dus\n",stExpInfo.u32ExpTime);

需要查询的时候，例如获取抓拍的数据或者每一帧的码流包时，可以从上面函数得到当前曝光时间，实时刷新出来或作他用。

————2020-4-27 @燕卫博————