---
title: hi_isp_ae_route_ex_node
description: "定义AE扩展分配路线节点属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0202.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0202.html
indexId: 9aa63c42a10c066fd5a1763821f6bc0f9c1f5a2b69a1f93421fbd8f478725a9265
---
# hi_isp_ae_route_ex_node

#### 说明

定义AE扩展分配路线节点属性。


#### 定义

```
typedef struct {
hi_u32
int_time;
hi_u32
a_gain;
hi_u32
d_gain;
hi_u32
isp_d_gain;
hi_isp_iris_f_no
iris_fno;
hi_u32
iris_fno_lin;
} hi_isp_ae_route_ex_node;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| int\_time | 节点曝光时间，单位为微秒(us)。 取值范围：(0x0, 0xFFFFFFFF] |
| a\_gain | sensor模拟增益，10bit精度。取值范围：[0x400, 0x3FFFFF] |
| d\_gain | sensor数字增益，10bit精度。取值范围：[0x400, 0x3FFFFF] |
| isp\_d\_gain | ISP数字增益，10bit精度。 取值范围：[0x400, 0x40000] |
| iris\_fno | 节点光圈F值大小，仅支持P\-Iris，不支持DC\-Iris。 取值范围：[HI\_ISP\_IRIS\_F\_NO\_32\_0, HI\_ISP\_IRIS\_F\_NO\_1\_0] |
| iris\_fno\_lin | 节点光圈F值等效增益大小，仅支持P\-Iris，不支持DC\-Iris。 取值范围：[1, 1024] |


#### 注意事项

- 节点的曝光量是曝光时间、sensor模拟增益、sensor数字增益、ISP数字增益和光圈的乘积，节点曝光量必须单调递增，即后一个节点的曝光量大于或等于前一个节点的曝光量，第一个节点的曝光量最小，最后一个节点的曝光量最大。在计算曝光量时，光圈F值要等效成一个增益，公式如下：等效增益FNO = 1 <<HI_ISP_IRIS_F_NO_XX_XX。由此可知F32.0对应增益1，F22.0对应增益2， F16.0对应增益4，以此类推，F1.0对应增益1024。

- 可以通过设置结构体hi_isp_piris_attr中的fno_ex_valid来决定实际生效的扩展AE route节点光圈值采用iris_fno或iris_fno_lin。fno_ex_valid为HI_TRUE时采用高精度的iris_fno_lin，默认采用iris_fno。iris_fno会受到hi_isp_piris_attr中max_iris_fno_target/ min_iris_fno_target的限制，iris_fno_lin会受到hi_isp_piris_attr中max_iris_fno_target/ min_iris_fno_target的限制。另外，iris_fno和iris_fno_lin还会受到hi_isp_ae_sensor_default中max_iris_fno/ min_iris_fno的限制，所以对接P-Iris时要在cmos.c中给max_iris_fno/ min_iris_fno赋合适的值。

- 不支持设置等曝光量节点。
- 为了保证曝光节点的曝光量，曝光节点的一个分量发生限制时，会对其他未达到最大值的分量进行调整，实际生效路径可能与设定路径不一致。
- 如果相邻节点的曝光量增加，则应该有一个分量增加，其他分量固定，增加的分量决定该段路线的分配策略。例如sensor模拟增益分量增加，那么该段路线的分配策略是sensor模拟增益优先。
- 光圈分量仅支持P-Iris，不支持DC-Iris，因为DC-Iris无法精确控制。
- 针对P-Iris，建议将第一个节点的曝光时间、增益和光圈F值都设置为相应的最小目标值，最后一个节点的曝光时间、增益和光圈F值都设置为相应的最大目标值。
- 节点的曝光时间不能设置为0，也不能设置过小，导致以us为单位的曝光时间对应的曝光行数为0，否则可能产生异常。
- 节点增益的范围相比非扩展AE route有所缩小。此外，为防止曝光量溢出， sensor模拟增益、sensor数字增益和ISP数字增益的乘积等效为10bit精度系统增益不能大于0xFFFFFFFF。如果光圈分量使能，则同一节点的曝光时间与10bit精度系统增益的乘积最大值不能超过0x1FFFFFFFFFFFFF，如果光圈分量不使能，则同一节点的曝光时间与10bit精度系统增益的乘积最大值不能超过0x7FFFFFFFFFFFFFFF。
- 若某段路线需要设置ISP数字增益优先，请注意不要把ISP数字增益用满，因为ISP数字增益还有弥补分配精度的作用，建议至少留下2倍ISP数字增益的余量，供弥补精度使用，即分配路线中节点的Isp_d_gain不要大于max_Isp_d_gain/2。
- 开启增益分开配置功能时，曝光节点中的ISP数字增益在实际分配时可能有部分被分配到WDRGain。