hi_isp_ae_route_node
Description
Defines the attribute of the AE allocation route node.
Definition
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;
Members
Member |
Description |
|---|---|
int_time |
Node exposure time (in μs). Value range: (0x0, 0xFFFFFFFF] |
sys_gain |
Node gain (10-bit precision), including the sensor analog gain, sensor digital gain, and ISP digital gain. Value range: [0x400, 0xFFFFFFFF] |
iris_fno |
F-number of the node iris. Only the P-Iris is supported. Value range: [HI_ISP_IRIS_F_NO_32_0, HI_ISP_IRIS_F_NO_1_0] |
iris_fno_lin |
Equivalent gain of the node iris f-number. Only the P-Iris is supported. Value range: [1, 1024] |
Restrictions
- The node exposure is the product of the exposure time, gain, and iris. The node exposure must be monotonically increasing. To be specific, the exposure of a node is greater than or equal to that of the previous node. The exposure of the first node is the lowest, and the exposure of the last one is the highest. During exposure calculation, the iris f-number must be equivalent to a gain. The formula is as follows: Equivalent gain FNO = 1 <<HI_ISP_IRIS_F_NO_XX_XX. The supported minimum iris is F32.0. In other words, F32.0 corresponds to gain 1, F22.0 corresponds to gain 2, and F16.0 corresponds to gain 4. As the rule applies, F1.0 corresponds to gain 1024.
- fno_ex_valid in hi_isp_piris_attr can be configured to determine whether iris_fno or iris_fno_lin is used as the iris value of the AE route node that actually takes effect. If fno_ex_valid is HI_TRUE, the high-precision iris_fno_lin will be used. iris_fno is used by default. iris_fno is restricted by max_iris_fno_target/min_iris_fno_target in hi_isp_piris_attr, and iris_fno_lin is restricted by max_iris_fno_target_linear/min_iris_fno_target_linear in hi_isp_piris_attr. In addition, iris_fno and iris_fno_lin are restricted by max_iris_fno/min_iris_fno in hi_isp_ae_sensor_default. Therefore, you need to assign a proper value to max_iris_fno/min_iris_fno in cmos.c when the P-Iris is connected.
- The nodes cannot be configured to have the same exposure.
- To ensure the exposure of the exposure node, when one component of the exposure node is restricted, other components that have not reached the maximum value will be adjusted. The route that takes effect may be inconsistent with the configured route. In addition, to avoid exposure overflow, the maximum product value of the exposure time and system gain of 10-bit precision of a node cannot exceed 0x1FFFFFFFFFFFFF if the iris component is enabled, and cannot exceed 0x7FFFFFFFFFFFFFFF if the iris component is disabled.
- If the exposure of adjacent nodes increases, the value of a component should increase while the values of other components remain unchanged. The component with an increased value determines the allocation policy of the route. For example, if the value of the gain component increases, the allocation policy of the route is gain-first.
- Only the P-Iris is supported. The DC-iris is not supported, because it cannot be accurately controlled.
- For the P-Iris, you are advised to set the exposure time, gain, and iris f-number of the first node to the corresponding minimum target values, and set those of the last node to the corresponding maximum target values.
Parent topic: Data Types