---
title: hi_mpi_isp_fpn_calibrate
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0327.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0327.html
indexId: 6af9986dec1656afcfc0cb91b2a2f7f106925f209167892ff5f28a74b0fcf5d565
---
# hi_mpi_isp_fpn_calibrate

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | ☓ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | ☓ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | ☓ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | ☓ |
| Atlas 训练系列产品 | ☓ |


#### 功能说明

设置去FPN标定属性。


#### 函数原型

```
hi_s32
hi_mpi_isp_fpn_calibrate(
hi_vi_pipe
vi_pipe,
hi_isp_fpn_calibrate_attr
*calibrate_attr)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| vi\_pipe | 输入 | VI PIPE号。 取值范围：[0, 12)。 |
| calibrate\_attr | 输入 | 去FPN标定属性指针。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  ISP返回码


#### 约束说明

- 该接口一般用于调试场景下标定FPN算法的参数，商用场景下不建议使用，可能会引起内存异常、图片效果异常等问题。

- 标定时用的内存注意要调用acltdtAllocBuf接口，按16bit进行分配，需要保证传入的黑帧地址有效。标定完成之后要把黑帧，ISO，黑帧的长度、OFFSET、是否压缩标志等保存到外部存储介质，在校正的时候要用到这些信息。
  acltdtAllocBuf接口的说明请参见“共享Buffer管理(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_1321.html)”章节。

- 不支持分块模式下标定。
- FPN标定不支持压缩，只能是非压缩模式。
- 在WDR场景下，不支持开启FPN标定。
- VI物理通道使能时，不支持开启FPN标定。
- 在调用接口禁用VI物理通道前，建议适当延时保证任务下发一次。
- 只支持单PIPE的FPN标定，且单个PIPE的FPN标定和校正不能同时进行。
- 标定的黑帧最小分辨率为120*120，最大分辨率为4096*4096。
- 当VI模块的PIPE有销毁操作时（例如：分辨率切换、WDR模式切换等情况），保存在VI模块的FPN属性会丢失，FPN功能需要在VI模块的PIPE创建后重新配置才能恢复。