---
title: hi_isp_iris_attr
description: "定义ISP光圈属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0212.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0212.html
indexId: 5d849932900ceeb80d438036e5e17fbf305f73a7fcf4f23d1676939e3058144d65
---
# hi_isp_iris_attr

#### 说明

定义ISP光圈属性。


#### 定义

```
typedef struct {
hi_bool
enable;
hi_op_mode
op_type;
hi_isp_iris_type iris_type;
hi_isp_iris_status iris_status;
hi_isp_mi_attr mi_attr;
} hi_isp_iris_attr;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| enable | 自动光圈使能。 |
| op\_type | 自动光圈或手动光圈模式选择。 |
| iris\_type | 光圈类型，DC\-Iris或P\-Iris。 |
| iris\_status | 光圈状态。 |
| mi\_attr | 手动光圈属性设置结构体。 |


#### 注意事项

- 进行AI算法测试前，建议确认AI电路特性是否符合IPC要求。
- 针对DC-Iris镜头，AI算法会根据画面亮度，调节PWM占空比对光圈进行控制。当曝光时间和增益达到最小目标值之后，会进入光圈控制区域。当光圈控制能满足目标亮度的要求时，AE直接返回，保持曝光时间和增益不变。当画面亮度稳定且PWM占空比维持在打开值一段时间后，AI算法会认为光圈已经打开至最大，退出光圈控制区，将控制权交还给AE。处于光圈控制区时，更改AE算法参数，如最大/最小曝光时间、最大/最小增益和抗闪等需要即时生效的参数，AE会即时响应，根据新设定的参数和环境亮度，AI算法重新决定是否要进入光圈控制区。由于进入光圈控制区域和退出光圈控制区域需要短暂时间，针对手动光圈镜头建议关闭AI功能，否则AE的调节速度会受到一点影响。针对DC-Iris镜头建议一直打开AI功能，随意开关AI容易导致光圈控制出现异常。针对某些长焦的DC-Iris镜头，默认参数可能会导致光圈打开/关闭速度过快，此时可以调节相关参数来解决，详见hi_isp_dciris_attr部分描述。
- 针对P-Iris镜头，光圈控制通过AE分配路线进行。P-Iris对接重点在于正确设置镜头相关参数和合理设置AE分配路线，详见hi_isp_piris_attr和hi_mpi_isp_set_ae_route_attr部分描述，才能保证P-Iris正常工作。由于不同P-Iris的驱动方式可能会有差别，用户可以自行修改P-Iris驱动以适配不同镜头。
- 关闭AI功能，对于DC-Iris镜头，光圈会打开到最大；对于P-Iris镜头，光圈会打开到最大光圈目标值对应步进电机位置，但此时曝光分配仍会参考AE路线，可能导致画面亮度异常，因此对接P-Iris镜头时，若不想使能AI，为保证曝光正常，需要把光圈类型切换至HI_ISP_IRIS_DC_TYPE。
- 由DC-Iris切换至P-Iris，需提前设置好P-Iris镜头相关参数，并且将光圈状态设置为HI_ISP_IRIS_KEEP，再进行切换。
- 利用Demo板或Ref板进行DC-Iris测试时，load ko时要配置以下2个寄存器，用于配置管脚复用和时钟：himm 0x102F0078 0x12F5；himm0x11014590 0x0010。
- 利用Demo板或Ref板进行P-Iris测试时，load ko时要配置以下1个寄存器，用于配置管脚复用和时钟：himm 0x102F0108 0x1101。
  注意：采用AE库时，AE_init会打开一次默认的PWM3信号，若客户需要采用PWM3做其他处理，需要指定AI对应的PWM Number为其他值。