hi_mpi_isp_sensor_unreg_callback
基本概念
- 曝光时间:sensor积累电荷的时间,是sensor pixel从开始曝光到电量被读出的这段时间。
- 曝光增益:对sensor的输出电荷的总的放大系数,一般有数字增益和模拟增益,模拟增益引入的噪声会稍小,所以一般优先用模拟增益。
- 光圈:光圈是镜头中可以改变中间孔大小的机械装置。
- 抗闪烁:由于电灯的电源工频与sensor的帧率不匹配而导致的画面闪烁,一般通过限定曝光时间和修改sensor的帧率来达到抗闪烁的效果。
- 色温:色温是按绝对黑体定义的,光源辐射在可见区和绝对黑体的辐射完全相同时,此时黑体的温度称此光源的色温。
- 白平衡:在不同色温的光源下,白色在传感器中的响应会偏蓝或偏红。白平衡算法通过调整 R, G, B 三个颜色通道的强度,使白色真实呈现。
父主题: ISP系统控制及3A算法注册
hi_mpi_isp_sensor_reg_callback
函数功能
ISP提供的Sensor注册的回调接口,用于获取差异化的初始化参数,并控制sensor。
函数原型
hi_s32 hi_mpi_isp_sensor_reg_callback(hi_vi_pipe vi_pipe, const hi_isp_sns_attr_info *sns_attr_info, const hi_isp_sensor_register *sns_register)
约束说明
此接口不支持多进程操作。
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | VI PIPE号。 取值范围:[0, 4)。 |
| sns_attr_info | 输入 | 向ISP注册的Sensor的属性。 该结构体内的sensor_id是sensor库中自定义的值,需确保唯一,主要用于校对向ISP注册的sensor和向3A注册的sensor是否为同一个sensor。 |
| sns_register | 输入 | Sensor注册结构体指针。 |
返回值说明
- 0:成功
- 非0:失败,参见ISP返回码。
参考资源
接口调用流程,参见视频数据获取功能。
父主题: ISP系统控制及3A算法注册
hi_mpi_isp_sensor_unreg_callback
函数功能
ISP提供的取消Sensor注册的回调接口。
函数原型
hi_s32 hi_mpi_isp_sensor_unreg_callback(hi_vi_pipe vi_pipe, hi_sensor_id sensor_id)
约束说明
此接口不支持多进程操作。
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | VI PIPE号。 取值范围:[0, 4)。 |
| sensor_id | 输入 | 向ISP注册的Sensor的Id。 sensor_id是sensor库中自定义的值,需确保唯一,主要用于校对向ISP反注册的sensor和向3A反注册的sensor是否为同一个sensor。 |
返回值说明
- 0:成功
- 非0:失败,参见ISP返回码。
参考资源
接口调用流程,参见视频数据获取功能。
父主题: ISP系统控制及3A算法注册
hi_mpi_isp_mem_init
函数功能
初始化ISP内部资源。
函数原型
hi_s32 hi_mpi_isp_mem_init(hi_vi_pipe vi_pipe)
约束说明
- 调用该接口前,必须先调用hi_mpi_isp_sensor_reg_callback接口向ISP注册Sensor。
- 不支持多进程,必须要与hi_mpi_isp_sensor_reg_callback、hi_mpi_isp_ae_lib_reg_callback、hi_mpi_isp_awb_lib_reg_callback、hi_mpi_isp_init、hi_mpi_isp_run、hi_mpi_isp_exit、hi_mpi_ae_register、 hi_mpi_awb_register接口在同一个进程调用。
- 当前业务正在运行hi_mpi_isp_run接口时,不能调用本接口。
- 推荐调用hi_mpi_isp_exit接口后,再调用本接口重新初始化。
- 不支持相同vi_pipe时,多线程执行ISP创建和销毁(即多线程同时调用hi_mpi_isp_sensor_reg_callback、hi_mpi_isp_ae_lib_reg_callback、hi_mpi_isp_awb_lib_reg_callback、hi_mpi_isp_init、hi_mpi_isp_run、hi_mpi_isp_exit、hi_mpi_ae_register、 hi_mpi_awb_register接口)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | VI PIPE号。 取值范围:[0, 4)。 |
返回值说明
- 0:成功
- 非0:失败,参见ISP返回码。
参考资源
接口调用流程,参见视频数据获取功能。
父主题: ISP系统控制及3A算法注册
hi_mpi_isp_set_pub_attr
函数功能
设置ISP公共属性,例如裁剪分辨率、帧率等。
函数原型
hi_s32 hi_mpi_isp_set_pub_attr(hi_vi_pipe vi_pipe, const hi_isp_pub_attr *pub_attr)
约束说明
-
调用本接口前,必须先调用hi_mpi_isp_mem_init接口初始化ISP内部资源。
-
ISP支持运行过程中动态裁剪图像的起始位置。
-
调用本接口后ISP内的处理流程:
ISP firmware判断图像WDR模式、分辨率、帧率是否变化,若都不变则直接返回;否则,ISP firmware会调用通过hi_mpi_isp_sensor_reg_callback接口注册的回调函数pfn_cmos_set_wdr_mode、pfn_cmos_set_image_mode改变Sensor模式;
- 若sensor模式不改变(回调函数返回值-2),判断ISP的裁剪宽高是否变化,若有变化,ISP firmware切换分辨率,并调用通过hi_mpi_isp_sensor_reg_callback接口注册的回调函数pfn_cmos_sensor_init重新配置sensor;若无变化,就不变。
- 若sensor模式改变(回调函数返回值为0),则ISP firmware会调用通过hi_mpi_isp_sensor_reg_callback接口注册的回调函数pfn_cmos_sensor_init重新配置Sensor;
-
用户可以修改回调函数pfn_cmos_set_image_mode的实现来调整sensor模式切换的顺序。如只提供了5M30fps和1080P60fps初始化序列的Sensor,若要运行1080P30fps,可以从5M30fps裁剪得到,也可以从1080P60fps降帧得到, 修改pfn_cmos_set_image_mode函数实现即可。
-
切换线性模式和帧WDR模式时,同样会判断pfn_cmos_set_image_mode的返回值, 因此线性模式和帧WDR模式应该采用不同的 image_mode,才能保证切换成功。
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | VI PIPE号。 取值范围:[0, 4)。 |
| pub_attr | 输入 | ISP公共属性。 |
返回值说明
- 0:成功
- 非0:失败,参见ISP返回码。
参考资源
接口调用流程,参见视频数据获取功能。
父主题: ISP系统控制及3A算法注册
hi_mpi_isp_get_pub_attr
函数功能
获取ISP公共属性。
函数原型
hi_s32 hi_mpi_isp_get_pub_attr(hi_vi_pipe vi_pipe, hi_isp_pub_attr *pub_attr)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| vi_pipe | 输入 | VI PIPE号。 取值范围:[0, 4)。 |
| pub_attr | 输出 | ISP公共属性。 |
返回值说明
- 0:成功
- 非0:失败,参见ISP返回码。
父主题: ISP系统控制及3A算法注册
在线提单