hi_isp_piris_attr

说明

定义P-Iris属性。

定义

typedef struct { 
    hi_bool step_fno_table_change; 
    hi_bool zero_is_max;
    hi_u16  total_step;
    hi_u16  step_count;
    hi_u16 step_fno_table[HI_ISP_AI_MAX_STEP_FNO_NUM]; 
    hi_isp_iris_f_no  max_iris_fno_target;
    hi_isp_iris_f_no  min_iris_fno_target;
    hi_bool fno_ex_valid; 
    hi_u32  max_iris_fno_target_linear;
    hi_u32  min_iris_fno_target_linear;
} hi_isp_piris_attr;

成员

注意事项

• 在线更换P-Iris镜头时，可以通过MPI设置该结构体，将新镜头的参数传递给AE算法和P-Iris驱动。
• step_fno_table_change为只写寄存器，通过MPI获取该参数的值始终为HI_FALSE。
• total_step表示P-Iris步进电机的总步数，可用于标定光圈的起始位置。
• step_count表示P-Iris步进电机的可用步数，一般小于total_step，因为靠近光圈关闭端的位置在将光圈孔径转换为F值时误差较大，光圈调节过程中容易出现振荡，所以通常不会利用光圈关闭端附近的那些位置。当前最多支持1024步的PIris镜头，若P-Iris镜头的精度很高，可调节步数超过1024，建议舍去光圈关闭端附近的那些位置。
• P-Iris步进电机位置与光圈F值映射表step_fno_table一般根据镜头原厂提供的步进电机位置与光圈孔径对应关系制作。由于 P-Iris的控制通过AE分配路线进行，这就要求光圈F值与曝光时间和增益有较好的线性关系，因此映射表需要较高的精度。这里用1024表示F1.0，512表示F1.4，以此类推，1表示F32.0。制作映射表时，可以根据最大光圈孔径对应的实际F值来规定映射表的最大值，也可以不用管光圈达到最大时的实际F值是多少，统一将最大光圈孔径映射为1024。同一款镜头处于不同焦距时，step_fno_table可能需要修改。
• 以福光NV03105P这款P-Iris镜头为例说明与镜头相关的参数该如何设置。表1中步进电机位置与孔径面积对应关系是镜头原厂提供的。该款镜头步进电机总步数为93，步进电机位置为0时，光圈孔径面积最大，标称最大相对孔径为F1.4，据此规定映射表F值最大值为512。规定好最大值后，就可以计算出其他孔径面积对应的F值，因为孔径面积与F值成线性关系。比如说步进电机位置1对应的孔径面积为48.835，得到F值为(48.835/49.366)*512=506，以此类推，可以得到所有有效步进电机位置对应的F值。由下表可以看到，当镜头靠近关闭端时，孔径面积很小，与最大孔径面积相差上万倍，映射表F值精度已不足以表现出孔径面积的变化，得到的F值都为0。实际上，哪怕提高映射表精度，由于镜头关闭端附近标称孔径面积与实际孔径面积一般相差较大，得到的F值也是不正确的，建议不要使用，否则在光圈调节过程中容易出现振荡。对于该款镜头，建议制作映射表时只取前62步，因此得到镜头相关的参数如下表所示。
• 步进电机位置与光圈F值映射表step_fno_table的前step_count个元素才是有效的，会被AE算法计算时用到，需要保证数组座标小于step_count时，值单调递增，当数组座标为(step_count-1)时，达到光圈最大F值。通过MPI设置 step_fno_table时，只有前step_count个元素才会被写入寄存器保存；通过MPI获取step_fno_table时，只有前 step_count个元素才会读出有效数值，其他值为0。
• 光圈类型为P-Iris时，昇腾AE算法计算最大/最小曝光量会参考max_iris_fno_target/min_iris_fno_target(若fno_ex_valid 为 true，则参考max_iris_fno_target_linear/min_iris_fno_target_linear)的值，因此这几个值要与step_fno_table的值相匹配，即最大/最小值都在step_fno_table有效数据范围内。
• 在手动配置DCF光圈相关信息时，需要关闭AI。如果需要配置的最大及实际光圈值为hi_isp_iris_f_no中定义的10个标准值，配置max_iris_fno_target为最大光圈值，配置min_iris_fno_target为实际光圈值即可。如果光圈不为10个标准值，则需要配置fno_ex_valid为HI_TRUE，以F32.0等效增益为1倍为基数计算实际光圈及最大光圈等效增益，并配置 max_iris_fno_target_linear为最大光圈等效增益，配置min_iris_fno_target_linear为实际光圈等效增益。如果AI使能，则根据实际光圈生效的大小计算光圈值，并更新DCF信息。光圈最小可支持到F32.0。