---
title: hi_isp_ae_route_node
description: "定义AE分配路线节点属性。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0200.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0200.html
indexId: 8a0a1060d2092fea93cb0ab76e2d280a60948f79c6e3879f56bdfba1fef5167f65
---
# hi_isp_ae_route_node

#### 说明

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


#### 定义

```
typedef struct {
hi_u32
int_time;
hi_u32
sys_gain;
hi_isp_iris_f_no
iris_fno;
hi_u32
iris_fno_lin;
} hi_isp_ae_route_node;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| int\_time | 节点曝光时间，单位为微秒(us)。 取值范围：(0x0, 0xFFFFFFFF] |
| sys\_gain | 节点增益，包括sensor模拟增益，sensor数字增益和ISP数字增益，10bit精度。 取值范围：[0x400, 0xFFFFFFFF] |
| 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] |


#### 注意事项

- 节点的曝光量是曝光时间、增益和光圈的乘积，节点曝光量必须单调递增，即后一个节点的曝光量大于或等于前一个节点的曝光量，第一个节点的曝光量最小，最后一个节点的曝光量最大。在计算曝光量时，光圈F值要等效成一个增益，公式如下：等效增益FNO = 1 <<HI_ISP_IRIS_F_NO_XX_XX，所支持的最小光圈为F32.0。由此可知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_linear/min_iris_fno_target_linear的限制。另外，iris_fno和iris_fno_lin还会受到hi_isp_ae_sensor_default中max_iris_fno/max_iris_fno的限制，所以对接P-Iris时要在cmos.c中给max_iris_fno/min_iris_fno赋合适的值。
- 不支持设置等曝光量节点。
- 为了保证曝光节点的曝光量，曝光节点的一个分量发生限制时，会对其他未达到最大值的分量进行调整，实际生效路径可能与设定路径不一致。为了防止曝光量溢出，如果光圈分量使能，则同一节点的曝光时间与10bit精度系统增益的乘积最大值不能超过0x1FFFFFFFFFFFFF，如果光圈分量不使能，则同一节点的曝光时间与10bit精度系统增益的乘积最大值不能超过 0x7FFFFFFFFFFFFFFF。
- 如果相邻节点的曝光量增加，则应该有一个分量增加，其他分量固定，增加的分量决定该段路线的分配策略。例如增益分量增加，那么该段路线的分配策略是增益优先。
- 光圈分量仅支持P-Iris，不支持DC-Iris，因为DC-Iris无法精确控制。
- 针对P-Iris，建议将第一个节点的曝光时间、增益和光圈F值都设置为相应的最小目标值，最后一个节点的曝光时间、增益和光圈F值都设置为相应的最大目标值。
