文本開發(fā)參考

1、所有 ©非經(jīng)本公司形式。2014-2015。保留一切權(quán)利。市半導(dǎo)體，任何和個人不得擅自摘抄、本文檔內(nèi)容的部分或全部，并不得以任何商標(biāo)、和其他商標(biāo)均為市半導(dǎo)體的商標(biāo)。本文檔提及的其他所有商標(biāo)或商標(biāo)，由各自的所有人擁有。注意您的、服務(wù)或特性等應(yīng)受公司商業(yè)合同和條款的約束，本文檔中描述的全部或部分產(chǎn)品、服務(wù)或特性可能不在您的或使用范圍之內(nèi)。除非合同另有約定，公司對本文檔內(nèi)容不做任何明示或默示的或保證。由于版本升級或其他，本文檔內(nèi)容會不定期進(jìn)行更新。除非另有約定，本文檔僅作為使用指導(dǎo)，本文檔中的所有陳述、信息和建議不任何明示或暗示的擔(dān)保。市半導(dǎo)體：51812地址市龍崗區(qū)坂田基地電氣生產(chǎn)中客戶

2、服務(wù)8551客戶服務(wù)傳真客戶服務(wù)郵箱supporthisilicon.coHiISP開發(fā)參言前言概述本文為使用 HiISP 開發(fā)的程序員而寫，目的是為您在開發(fā)過程中遇到的問題提供解決辦法和幫助。本文未做特殊說明，Hi3516D 與 Hi3516A 完全一致版本與本文檔相對應(yīng)的版本如下。讀者對象本文檔（本指南）主要適用于以下工程師：技術(shù)支持工程軟件開發(fā)工師zz符號定在本文中可能出現(xiàn)下列標(biāo)志，它們所代表的含義如。專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)i所有 ©號表示有高度潛在，如果不能避免，會導(dǎo)致或嚴(yán)重傷。名稱版本Hi3516AV100Hi3516DV100HiISP

3、開發(fā)參言修訂修訂 內(nèi)容。累積了每次文檔更新的說明。最新版本的文檔包含以前所有文檔版本的更新文檔版本 03 (2015-06-15)2.3 ISP_AE_RESULT_S、ISP_AWB_RESULT_S 有更改3.4.2 HI_MPI_ISP_SetAERouteAttr 和 HI_MPI_ISP_QueryExposureInfo 有修改3.4.3 HI_MPI_ISP_SetIrisAttr 有更改；新增 HI_MPI_ISP_SetDcirisAttr 到HI_MPI_ISP_GetPirisAttr3.5.2 ISP_EXPOSURE_ATTR_S、ISP_AE_ROUTE_NODE_

4、S、ISP_AE_ROUTE_S 和ISP_EXP_INFO_S 有更改3.5.3 新增 ISP_DCIRIS_ATTR_S 和 ISP_PIRIS_ATTR_S；添加表 3-1 和表 3-24.5.2 新增 ISP_AWB_CBCR_TRACK_ATTR_S 和ISP_AWB_LUM_HISTGRAM_ATTR_S，添加表 4-1表 4-46.1.36.7.3新增 ISP_RGBSHARPEN_ATTR_S新增 HI_MPI_ISP_SetNPTable 和 HI_MPI_ISP_GetNPTable6.7.4新增 ISP_NP_TABLE_S6.14.3 修改 ISP_ACM_ATTR_S

5、 和 ISP_ACM_LUT_S 中的【注意事項(xiàng)】11.2 小節(jié)涉及修改文檔版本 02 (2015-02-10)2.2 HI_MPI_ISP_SetPubAttr 中的【注意】有修改2.3 ISP_AE_INFO_S、ISP_SNS_REGS_INFO_S、ISP_AE_RESULT_S 有修改專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)ii所有 ©符號說明表示有中度或低度潛在，如果不能避免，可能導(dǎo)致人員輕微或中等。表示有潛在風(fēng)險(xiǎn)，如果忽視這些文本，可能導(dǎo)致設(shè)備損壞、數(shù)據(jù)丟失、設(shè)備性能降低或不可預(yù)知的結(jié)果。表示能幫助您解決某個問題或節(jié)省您的時間。表示是正文的附加信息，是

6、對正文的強(qiáng)調(diào)和補(bǔ)充。HiISP開發(fā)參言3.5.2 ISP_EXPOSURE_ATTR_S、ISP_WDR_EXPOSURE_ATTR_S 有修改，新增ISP_SUBFLICKER_S;3.5.3 ISP_IRIS_STATUS_E，ISP_IRIS_ATTR_S 和 ISP_IRIS_TYPE_E 有更改4.5.2 ISP_AWB_EXTRA_LIGHTSOURCE_INFO_S 有修改5.4 刪除 HI_MPI_ISP_SetColorToneAttr 和 HI_MPI_ISP_GetColorToneAttr;5.5 刪除 ISP_COLOR_TONE_ATTR_S新增 6.15 “Col

7、orTone"小節(jié)7.3 ISP_AF_CFG_S、ISP_AF_SQU_MODE_E 涉及修改11.2 小節(jié)有修改文檔版本 01 (2014-12-20)添加 Hi3516D 的相關(guān)內(nèi)容2.3 新增 ISP_CTRL_PROC_WRITE_S 和 ISP_CTRL_CMD_E3.4.23.4.33.5.2新增 HI_MPI_ISP_SetWDRExposureAttr 和 HI_MPI_ISP_GetWDRExposureAttr刪除 HI_MPI_ISP_SetAICalibrate 和 HI_MPI_ISP_GetAICalibrate新增 ISP_WDR_EXPOSURE_A

8、TTR_S3.5.3新增 ISP_IRIS_TYPE_E 和 ISP_IRIS_F_NO_E，刪除 ISP_AI_ATTR_S、ISP_STATUS_E 和 ISP_AI_CALIBRATE_S4.5.2 新增圖 4-3，更改 ISP_AWB_ATTR_EX_S 的【注意事項(xiàng)】，ISP_AWB_IN_OUT_ATTR_S 有更改6.3.3 ISP_DRC_ATTR_S 有更改6.15.1 功能描述有涉及修改7.3 刪除 ISP_FOCUS_STATISTICS_S8.1 添加概述中的流程步驟文檔版本 00B05 (2014-11-10)2.2 新增 HI_MPI_ISP_SetRegister

9、 和 HI_MPI_ISP_GetRegister。HI_MPI_ISP_SetPubAttr和 HI_MPI_ISP_SetWDRMode 中的【注意】有更改2.3 新增 ISP_CMOS_SENSOR_IMAGE_MOD，刪除 ISP_CMOS_WDR_ATTR_S、ISP_CMOS_SENSOR_MAX_RESOLUTION 和 ISP_CMOS_SENSOR_IMAGE_MODE。RECT_S、ISP_SENSOR_EXP_FUNC_S、ISP_CMOS_DEFAULT_S 和ISP_SNS_REGS_INFO_S 中的【成員】有更改5.4 HI_MPI_ISP_SetCCMAttr

10、中的【注意】有新增6.3.3 ISP_DRC_ATTR_S 的【成員】有更改，新增圖 6-1 和圖 6-2。專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)iii所有 ©HiISP開發(fā)參言6.13.3 ISP_FPN_ATTR_S、ISP_FPN_MANUAL_ATTR_S 和 ISP_FPN_AUTO_ATTR_S都有更改。6.15.1 新增圖 6-8 和圖 6-910 表 10-1 有更改。文檔版本 00B04 (2014-10-19)2.3 ISP_AE_RESULT_S 中有新增【成員】3.4.2 HI_MPI_ISP_SetAERouteAttr 中【注意】有新增

11、3.5.2 ISP_AE_ATTR_S 中【注意事項(xiàng)】有新增4.5.2 ISP_AWB_ATTR_S 和 ISP_WB_ATTR_S 有修改6.13.3 ISP_FPN_CALIBRATE_ATTR_S 有更改6.15.3 ISP_WDR_FS_ATTR_S 中【注意事項(xiàng)】有新增7.3 ISP_AE_STATISTICS_CFG_S 中【成員】和【注意事項(xiàng)】有更改新增“8 Cmos 默認(rèn)參數(shù)配置”一章文檔版本 00B03 (2014-09-25)1.22.3刪除“文件組織”章節(jié) 添加圖 2-5圖 2-83.3章節(jié) 修改圖 3-2 和圖 3-4，3.4.1、3.4.2、3.5.2 和 3.5.3

12、 章節(jié)都涉及修改4.4.1 刪除 HI_MPI_ISP_AWBLibRegCallBack，4.5.2 修改圖 4-35.4 和 6.1 章節(jié)都涉及修改6.5.3 章節(jié) HI_MPI_ISP_ SetDPCalibrate t 和 HI_MPI_ISP_ GetDPCalibrate 涉及修改6.5.4 章節(jié)添加圖 6-1，6.6.4 章節(jié) ISP_CR_ATTR_S 涉及修改6.9.3 章節(jié) ISP_DEFOG_AUTO_ATTR_S 涉及修改6.13.3 章節(jié) ISP_FPN_CALIBRATE_ATTR_S 涉及修改6.15.3 ISP_GAMMAFE_ATTR_S 和 ISP_WDR_

13、FS_ATTR_S 的【成員】有修改7.3 ISP_AE_STATISTICS_CFG_S 中的【成員】和【注意事項(xiàng)】有修改， ISP_WB_STATISTICS_CFG_PARA_S、ISP_WB_BAYER_STATISTICS_INFO_S 和ISP_FOCUS_ZONE_S 中的【成員】有修改10.2 章節(jié) 更改 AE INFO 參數(shù)文檔版本 00B02 (2014-09-14)第二次臨時版本發(fā)布。1.2.2 及 2.2 涉及修改專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)iv所有 ©HiISP開發(fā)參言2.3 章節(jié) ISP_AWB_PARAM_S、ISP_AE_

14、PARAM_S 涉及修改3.4.2 章節(jié) HI_MPI_ISP_ SetExposureAttr3.5.2 章節(jié) ISP_AE_MODE_E、ISP_AE_ATTR_S 涉及修改4.5.2 章節(jié) ISP_AWB_ALG_TYPE_E、ISP_AWB_CT_LIMIT_ATTR_S、ISP_AWB_IN_OUT_ATTR_S 涉及修改6.5.3 章節(jié) HI_MPI_ISP_SetDPCalibrate 涉及修改6.5.4 章節(jié) ISP_DP_STATIC_CALIBRATE_S 涉及修改7.3 章節(jié)，新增 ISP_AF_CFG_S、ISP_AF_PEAK_MODE_E、ISP_AF_SQU_MO

15、DE_E、ISP_AF_H_PARAM_S、ISP_AF_FV_PARAM_S、FOCUS_STATISTICS_CFG_S刪除第 9 章 AF文檔版本 00B01 (2014-07-15)第一次臨時版本發(fā)布。專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)v所有 ©HiISP開發(fā)參考目 錄目錄前 言i1概述11.1 概述11.2 功能描述11.2.11.2.21.2.31.2.4架構(gòu)2開發(fā)模式2內(nèi)部流程3軟件流程42系統(tǒng)62.1 功能概述62.2 API 參考62.3 數(shù)據(jù)類型333 AE743.13.23.3概述74重要概念74功能描述753.4 API 參考773.4

16、.1 AE 庫接口773.4.2 AE3.4.3 AI模塊82模塊963.5 數(shù)據(jù)類型1043.5.1 Register1043.5.2 AE1113.5.3 AI1304 AWB1424.14.24.3概述142重要概念142功能描述1424.3.1 AWB 模塊工作原理142專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)vi所有 ©HiISP開發(fā)參考目 錄4.4 API 參考1444.4.1 AWB 庫接口1444.4.2 AWB模塊1484.4.3 WB 統(tǒng)計(jì)信息1524.5 數(shù)據(jù)類型1534.5.1 Register1534.5.2 WB1565 CCM1735.

17、15.25.3概述173重要概念173功能描述1735.4 API 參考1745.5 數(shù)據(jù)類型1786 IMP1846.1 Sharpen1846.1.1 功能描述1846.1.2 API 參考1846.1.3 數(shù)據(jù)類型1866.2 Gamma1926.2.1 功能描述1926.2.2 API 參考1926.2.3 數(shù)據(jù)類型1946.3 DRC1956.3.1 功能描述1956.3.2 API 參考1966.3.3 數(shù)據(jù)類型1986.4鏡頭陰影校正2026.4.1 概述2026.4.2 功能描述2036.4.3 API 參考2036.4.4 數(shù)據(jù)類型205壞點(diǎn)校正2076.5.1 概述2076

18、.5.2 功能描述2076.5.3 API 參考2086.5.4 數(shù)據(jù)類型2126.56.6 Crosstalk Removal2186.6.1 概述2186.6.2 功能描述218專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)vii所有 ©HiISP開發(fā)參考目 錄6.6.3 API 參考2196.6.4 數(shù)據(jù)類型2216.7 去噪算法2226.7.1 概述2226.7.2 功能描述2226.7.3 API 參考2236.7.4 數(shù)據(jù)類型2276.8 DIS2306.8.1 概述2306.8.2 功能描述2316.8.3 API 參考2316.8.4 數(shù)據(jù)類型2356.9

19、 Defog2366.9.1 功能描述2366.9.2 API 參考2366.9.3 數(shù)據(jù)類型2386.10 去偽彩2406.10.1 概述2406.10.2 功能描述2406.10.3 API 參考2406.10.4 數(shù)據(jù)類型2426.11 去馬賽克2436.11.1 功能描述2436.11.2 API 參考2436.11.3 數(shù)據(jù)類型2456.12 黑電平2496.12.1 功能描述2496.12.2 API 參考2496.12.3 數(shù)據(jù)類型2516.13 去 FPN2526.13.1 功能描述2526.13.2 API 參考2536.13.3 數(shù)據(jù)類型2576.14 ACM2616.14

20、.1 功能描述2616.14.2 API 參考2616.14.3 數(shù)據(jù)類型2656.15 ColorTone2686.15.1 功能描述268專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)viii所有 ©HiISP開發(fā)參考目 錄6.15.2 API 參考2686.15.3 數(shù)據(jù)類型2706.16 WDR2716.16.1 功能描述2716.16.2 API 參考2756.16.3 數(shù)據(jù)類型2796.17 獲取 ISP 模塊虛擬地址2816.17.1 功能描述2816.17.2 API 參考2816.17.3 數(shù)據(jù)類型2827 統(tǒng)計(jì)信息2847.1 概述2847.2 API

21、 參考2847.3 數(shù)據(jù)類型2878 Cmos 默認(rèn)參數(shù)配置3068.1 概述3068.2 Cmos 結(jié)構(gòu)圖示意3078.3 INI 文件使用說明3078.3.1 AE3078.3.2 AWB3088.3.3 ISP3088.4 注意事項(xiàng)3119 Debug3129.1 概述3129.2 功能描述3129.3 API 參考3129.4 數(shù)據(jù)類型31510 錯誤碼31611 Proc 調(diào)試信息說明31711.1 概述31711.2 ISP317專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)ix所有 ©HiISP開發(fā)參考圖目錄圖目錄圖 1-1 ISP結(jié)構(gòu)示意圖1圖 1-2 I

22、SP firmware架構(gòu)2圖 1-3 ISP firmware內(nèi)部流程3圖 1-4 ISP firmware軟件結(jié)構(gòu)3圖 1-5 ISP firmware 使用流程4圖 2-1 ISP 庫與 sensor 庫間的接口23圖 2-2 ISP 庫與 AE 庫間的接口26圖 2-3 ISP 庫與 AWB 庫間的接口28圖 2-4 ISP 庫與 AF 庫間的接口30圖 2-5 Mag=8, Strength=127, Core 對 Sharpen 曲線影響49圖 2-6 Core=255, Strength=127, Mag 對 Sharpen 曲線影響49圖 2-7 Core=255, Mag=8

23、, Strength 對 Sharpen 曲線影響50圖 2-8 白域選擇相關(guān)參數(shù)69圖 3-1 AE 模塊工作流程圖74圖 3-2 AE 五段統(tǒng)計(jì)信息直方圖75圖 3-3 AE 256 段統(tǒng)計(jì)信息直方圖76圖 3-4 AE 工作原理圖76圖 3-5 AE 庫與 sensor 庫間的接口80圖 3-6 AE 分配路線示意圖90圖 4-1 AWB 工作原理圖143圖 4-2 AWB 庫 與 sensor 庫間的接口147圖 4-3 色溫曲線的參數(shù)示意167圖 4-4 室外色溫范圍參數(shù)的意義171圖 5-1 CCM 矩陣173圖 6-1 BrightEnhance = 255, Asymmetry

24、 對 DRC tone curve 影響201專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)x所有 ©HiISP開發(fā)參考圖目錄圖 6-2 Asymmetry = 20, BrightEnhance 對 DRC tone curve 影響202圖 6-3 動態(tài)壞點(diǎn)校正示意圖214圖 6-4 CrossTalk Remove 門限218圖 6-5 DIS 偏移示意圖231圖 6-6 FPN 標(biāo)定示意圖253圖 6-7 FPN 校正示意圖253圖 6-8 Sensor Built-in WDR 模式下的處理流程圖272圖 6-9 多幀WDR 模式下的處理流程圖274圖 7-1

25、Square 模式298圖 8-1 Cmos 結(jié)構(gòu)示意圖307專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)xi所有 ©HiISP開發(fā)參考表目錄表目錄表 3-1 P-Iris 步進(jìn)電機(jī)位置與 F 值表，以NV03105P 為例138表 3-2 P-Iris 鏡頭相關(guān)參數(shù)，以NV03105P 為例139表 4-1 au16CrMax 16在不同的增益情況下的設(shè)置值，參考。159表 4-2 au16CrMin 16在不同的增益情況下的設(shè)置值，參考。160表 4-3 au16CbMax 16在不同的增益情況下的設(shè)置值，參考。161表 4-4 au16CbMin 16在不同的增益

26、情況下的設(shè)置值，參考。161表 5-1 au8Sat16在不同的增益情況下的設(shè)置值，以 mn34220 為例180表 6-1 u8SharpenD ISP_AUTO_STENGTH_NUM在不同的增益情況下的設(shè)置值188表 6-2 u8SharpenUdISP_AUTO_STENGTH_NUM在不同的增益情況下的設(shè)置值188表 6-3 u8SharpenRGB ISP_AUTO_STENGTH_NUM在不同的增益情況下的設(shè)置值189表 6-4 u8Strength ISP_AUTO_STENGTH_NUM在不同的增益情況下的設(shè)置值221表 6-5 u8ThreshISP_AUTO_STENGT

27、H_NUM在不同增益情況下對應(yīng)的設(shè)置值228表 6-6 au8LumThresh ISP_AUTO_STENGTH_NUM在不同增益情況下對應(yīng)的設(shè)置值247表 6-7 au8NpOffset ISP_AUTO_STENGTH_NUM在不同增益情況下對應(yīng)的設(shè)置值248表 10-1 ISP API 錯誤碼316專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)xii所有 ©HiISP開發(fā)參考1 概述1概述1.1 概述ISP 通過一系列數(shù)字圖像處理算法完成對數(shù)字圖像的效果處理。主要包括 3A、壞點(diǎn)校正、去噪、強(qiáng)光抑制、背光補(bǔ)償、色彩增強(qiáng)、鏡頭陰影校正等處理。ISP 包括邏輯部分以及

28、運(yùn)行在其上的 firmware。這里主要介紹 ISP 的用戶接口。1.2 功能描述ISP 的結(jié)構(gòu)如圖 1-1 所示，lens 將光信號投射到 sensor 的感光區(qū)域后，sensor 經(jīng)過光電轉(zhuǎn)換，將 Bayer 格式的原始圖像送給 ISP，ISP 經(jīng)過算法處理，輸出 RGB 空間域的圖像給后端的 和 sensor 進(jìn)行相應(yīng)firmware 的運(yùn)轉(zhuǎn)靠單元。在這個過程中，ISP 通過運(yùn)行在其上的 firmware 對 lens，進(jìn)而完成自動光圈、自動、自動衡等功能。其中，單元的中斷驅(qū)動。PQ Tools 工具通過網(wǎng)口或者串口完成對ISP 的圖像質(zhì)量調(diào)節(jié)。ISP 由 ISP 邏輯及運(yùn)行在其上的 F

29、irmware 組成，邏輯單元除了完成一部分算法處理外，還可以統(tǒng)計(jì)出當(dāng)前圖像的實(shí)時信息。Firmware 通過獲取 ISP 邏輯的圖像統(tǒng)計(jì)信息，重新計(jì)算，反饋lens、sensor 和 ISP 邏輯，以達(dá)到自動調(diào)節(jié)圖像質(zhì)量的目的。圖1-1 ISP結(jié)構(gòu)示意圖ISP 邏輯主要流程、具體概念和功能點(diǎn)請參見手冊。專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)1所有 ©HiISP開發(fā)參考1 概述1.2.1 架構(gòu)ISP 的 Firmware 包含三部分，一部分是 ISP單元和基礎(chǔ)算法庫，一部分是AE/AWB/AF 算法庫，一部分是 sensor 庫。Firmware 設(shè)計(jì)的基本思想是

30、單獨(dú)提供 3A 算法庫，由 ISP法庫和 3A 算法庫1-2 所示。單元調(diào)度基礎(chǔ)算法庫和 3A 算法庫，同時 sensor 庫分別向 ISP 基礎(chǔ)算函數(shù)回調(diào)，以實(shí)現(xiàn)差異化的 sensor 適配。ISP firmware 架構(gòu)如圖圖1-2 ISP firmware 架構(gòu)ISP CTRL & BASE ALG LIB不同的 sensor 都以回調(diào)函數(shù)的形式，向 ISP 算法庫函數(shù)。ISP單元調(diào)度基礎(chǔ)算法庫和 3A 算法庫時，將通過這些回調(diào)函數(shù)獲取初始化參數(shù)，并sensor，如調(diào)節(jié)時間、模擬增益、數(shù)字增益，lens 步進(jìn)聚焦或旋轉(zhuǎn)光圈等。1.2.2 開發(fā)模式SDK 支持用戶使用多種開發(fā)模式：

31、a.用戶使用的 3A 算法庫。這戶需要根據(jù) ISP 基礎(chǔ)算法庫和 3A 算法庫給出的 sensor 適配接口去適配不同的 sensor。每款 sensor 對應(yīng)一個文件夾，文件夾中包含兩個主要文件sensor_cmos c該文件中主要實(shí)現(xiàn) ISP 需要的回調(diào)函數(shù)，這些回調(diào)函數(shù)中包含了 sensor 的適配算法，不同的 sensor 可能有所不。sensor_ctr .czzsensor 的底層驅(qū)動，主要實(shí)現(xiàn) sensor 的讀寫和初始化動作。用戶可以根據(jù)sensor 的datasheet 進(jìn)行這兩個文件的開發(fā)，必要的時候可以向 sensor 廠家尋求持。b.用戶根據(jù) ISP 庫提供的 3A 算

32、法接口，實(shí)現(xiàn)的 3A 算法庫開發(fā)。這戶需要根據(jù) ISP 基礎(chǔ)算法庫和用戶的 3A 算法庫給出的 sensor 適配接口去適配不同的sen or。c.3A的 3A 算法庫。例如 AE 使用用戶部分使用算法庫，部分實(shí)現(xiàn)lib_hiae.a，AWB 使用的 3A 算法庫。SDK 提供了靈活多變的方式。高級用戶可以基于ISP 寄存器進(jìn)行有算法 發(fā)能力。的算法庫開發(fā)，當(dāng)然這需要對 ISP 邏輯比較熟悉，同時具專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)2所有 ©RegisterRegisterSENSOR 3ASENSOR ISPRegister3A LIBHiISP開發(fā)參考1

33、概述1.2.3 內(nèi)部流程Firmware 內(nèi)部流程分兩部分，如圖 1-3 所示。一部分是初始化任務(wù)，主要完成 ISP 控制單元的初始化、ISP 基礎(chǔ)算法庫的初始化、3A 算法庫的初始化，包括調(diào)用 sensor 的回調(diào)獲取 sensor 差異化的初始化參數(shù)；另一部分是動態(tài)調(diào)節(jié)過程，在這個過程中，firmware 中的 ISP單元調(diào)度 ISP 基礎(chǔ)算法庫和 3A 算法庫，實(shí)時計(jì)算并進(jìn)行相應(yīng)控制。Firmware 的軟件結(jié)構(gòu)如圖 1-4 所示。圖1-3ISP firmware 內(nèi)部流程中圖1-ISfirmwar軟件結(jié)專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)3所有 ©反復(fù)計(jì)

34、算任務(wù)初始化任務(wù)HiISP開發(fā)參考1 概述1.2.4 軟件流程ISP 作為前端部分，需要和單元（VIU）協(xié)同工作。ISP 初始化和基本配置完成后，需要 VIU 進(jìn)行接口時序匹配。一是為了匹配不同 sensor 的輸入時序，二是為 ISP 配置正確的輸入時序。待時序配置完成后，ISP 就可以啟動 Run 來進(jìn)行動態(tài)圖像質(zhì)量調(diào)節(jié)。此時輸出的圖像被 VIU 1-5 示。，進(jìn)而送去顯示或編碼。軟件使用流程如圖PQ Tools 工具主要完成在 PC 端進(jìn)行動態(tài)圖像質(zhì)量調(diào)節(jié)，可以調(diào)節(jié)多個影響圖像質(zhì)量的因子，如去噪強(qiáng)度、色彩轉(zhuǎn)換矩陣、飽和度等。圖1-5 ISP firmware 使用流程啟動系統(tǒng)配置MIPI

35、3A算法向ISP回調(diào)函數(shù)初始化ISP外部寄存器配置ISP寬動態(tài)模式配置圖像公共屬性運(yùn)行ISP配置VI？啟動VI捕獲圖像ISP系統(tǒng)專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)4所有 ©編碼顯示使用MPI調(diào)像使用PQ Tools工具調(diào)優(yōu)圖像初始化ISPSensor向3A算法和ISP回調(diào)函數(shù)HiISP開發(fā)參考1 概述如果用戶調(diào)試好圖像效果后，可以使用 PQ Tools 工具提供的配置文件保存功能進(jìn)行配置參數(shù)保存。在下次啟動時系統(tǒng)可以使用 PQ Tools 工具提供的配置文件加載功能加載已經(jīng)調(diào)節(jié)好的圖像參數(shù)。專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)5所有 &#

36、169;HiISP開發(fā)參考2 系統(tǒng)2系統(tǒng)2.1 功能概述系統(tǒng)部分包含了 ISP 公共屬性配置，初始化 ISP Firmware、運(yùn)行 ISP firmware、退出 ISP firmware，設(shè)置 ISP 各模塊等功能。2.2 API 參考本文檔中接口，如無特殊說明，支持多進(jìn)程。HI_MPI_ISP_MemInit：初始化 ISP 外部寄存器HI_MPI_ISP_Init：初始化I P firmwar 。HI_MPI_ISP_Run：運(yùn)行 SP firmwa e。zzzHI_MPI_ISP_Exit：退ISP firmw re。zHI_MPI_ISP_SetPubAttr：設(shè)置 ISP共屬性。

37、zHI_MPI_ISP_GetPubAttr：獲取 IS 公共屬性。HI_MPI_ISP_SetFMWStat ：設(shè)置 ISP firm are 狀態(tài)。HI_MPI_ISP_GetFMW tat ：獲取 ISP fir ware 狀態(tài)。HI_MPI_ISP_SetWDRMode：設(shè)置 SP 寬動態(tài)模式。zzzzHI_MPI_ISP_GetWDRMode：獲ISP 寬動態(tài)模式。zHI_MPI_ISP_SetModuleControl：設(shè)定 SP 功能模塊的。zHI_MPI_ISP_GetModuleControl：獲ISP 功能模塊的zHI_MPI_ISP_SetReg ster：設(shè)置寄存器值。

38、HI_MPI_ISP_GetRe ister：獲取寄存器值。HI_MPI_ISP_GetVDTim Out：獲取 ISP 中斷信息。HI_MPI_ISP_SensorRegCallBack：ISP 提的 sensorzzz的回調(diào)接口。zHI_MPI_ISP_SensorUnRegCallBack：ISP 提的 sensor 反的回調(diào)接口。zHI_MPI_ISP_AELibRegCallBackISP 提供的 AE 庫的回調(diào)接口。zHI_MPI_ISP_AELibUnRegCallBackISP 提供的 AE 庫反的回調(diào)接口。z專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)6所有 &

39、#169;HiISP開發(fā)參考2 系統(tǒng)HI_MPI_ISP_AWBLibRegCallBack：ISP 提供的 AWB 庫z的回調(diào)接口HI_MPI_ISP_AWBLibUnRegCallBack：ISP 提供的 AWB 庫反的回調(diào)接。zHI_MPI_ISP_AFLibRegCallBack：ISP 提供的 AF 庫的回調(diào)口。zHI_MPI_ISP_AFLibUnRegCallBack：ISP 提供的 AF 庫反的回接口。HI_MPI_ISP_SetBindAttr：設(shè)置 ISP 庫與 3A 庫、sensor 的定關(guān)系。zzHI_MPI_ISP_GetBindAttr：獲取 ISP 庫與 3A 庫

40、、sensorz綁定關(guān)系。HI_MPI_ISP_M mIni【描述】初始化 ISP部寄存器【語法】I_S32 HI_MPI_ISP_MemInit(IP_DEVIsDev)【參數(shù)【返回】【錯誤碼】【需求】頭文件：hi_comm_isp.h、mpi庫文件：li isp.isp.h【注意】專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)7所有 ©接口回值含義HI_ERR_ISP_MEM_NO _INIT外部寄存沒有初始化HI_ERR_ISP_SNS_UNRE ISTERSens r 未。HI_ERR_ISP_ILLEGAL PARAM數(shù)無效。回描述0功。非 0失敗，其錯誤碼。參

41、名稱描述輸入/輸出spDevI P 設(shè)。輸入HiISP開發(fā)參考2 系統(tǒng)外部寄存器初始化前需要確保 ko 已加載，sensor 向 ISPz了回調(diào)函數(shù)調(diào)用本接口后，才能調(diào)用 HI_MPI_ISP_SetWDRMode 和 HI_MPI_ISP_SetPubAttr分別配置 WDR 模式和圖像公共屬。不支持多進(jìn)程，必須要與 sensor_register_callback，HI_MPI_AE_Register， HI_MPI_AWB_Register，HI_MPI_AF_Register，HI_MPI_ISP_Init， HI_MPI_ISP_Run，HI_MPI_ISP_Exit 接口在同一個進(jìn)

42、程用。不支持重復(fù)調(diào)用接口。zzz推薦調(diào)用 HI_MPI_ISP_Exit 后，再調(diào)用本接口重初始化。z【例】無【關(guān)主題】HI_MPI_ISP ExitHI_MPI_ISPInit【描述】初化 ISP firm are?！菊Z法】H _S32 HI_MPI_ISP_Init(IS_DEVIspev);【參數(shù)】返回值錯誤碼】專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)8所有 ©口返值含義HI_ERR_ISP_MEM_NOT INIT外部寄存器有初始化HI_ERR_ISP_NOT INIT有初始化HI_ERR_ISP_SNS_UNREG STERSenso 未。返值描述成。非

43、0失敗，其值誤碼。參數(shù)稱描述入/輸出I pDevIS 設(shè)備輸入HiISP開發(fā)參考2 系統(tǒng)【需求】頭文件：hi_comm_isp.h、mpi_isp.h庫文件：libisp.a【注意】初始化前需要確保 ko 已加載，sensor 向 ISP了回調(diào)函數(shù)z初始化前需要確保已調(diào)用 HI_MPI_ISP_MemInit 初始化 ISP 外部寄存。初始化前需要確保已調(diào)用 HI_MPI_ISP_SetWDRMode 和 HI_MPI_ISP_SetPubAttr分別配置 WDR 模式和圖像公共性。不支持多進(jìn)程，必須要與 sensor_register_callback，HI_MPI_AE_Register，

44、 HI_MPI_AWB_Register，HI_MPI_AF_Register，HI_MPI_ISP_MemInit， HI_MPI_ISP_Run，HI_MPI_ISP_Exit 接口在同一個進(jìn)調(diào)用。不支持重復(fù)調(diào)本接口。zzzz推薦調(diào)用 HI_MPI_ISP_Exit 后，再調(diào)用本接口新初始化z舉例】無相關(guān)主題】HI_MPI_IS _ExitHI_MPI_IP_Ru【描述】運(yùn)行 ISP fir ware【語法】I_S32 HI_MPI_ISP_Run(IP_DEV Is Dev)【參數(shù)【返回】專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)9所有 ©回描述0功。非 0失敗

45、，其錯誤碼。參名稱描述輸入/輸出spDevI P 設(shè)。輸入HiISP開發(fā)參考2系統(tǒng)【錯誤碼】【需求】頭文件：hi_comm_isp.h、mpi_isp.庫文件：libisp azz【注】運(yùn)行前需要確保 sensor 已經(jīng)初始化，并且向 ISP運(yùn)行前需要確保已調(diào)用 HI_MPI_ISP_Init 初始化了回調(diào)數(shù)。SP。zz不支持多進(jìn)程，必須要與 sensor_register_callback，HI_MPI_AE_Register， HI_MPI_AWB_Register，HI_MPI_AF_Register，HI_MPI_ISP_MemInit，zHI_MPI_ISP_Init，HI_MPI_

46、ISP_Exit 接口在同一個該接口是阻塞接口，建議用戶采用實(shí)線程處理程調(diào)用。z舉例】無相關(guān)主題】HI_MPI_IS _InitHI_MPI_IS_Exi【描述】ISP fir ware【語法】I_S32 HI_MPI_ISP_Exit(IP_DEVIs Dev)【參數(shù)【返回值】專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)10所有 ©參名稱描述輸入/輸出spDevI P 設(shè)。輸入接口返回值含義HI_ERR_ISP_SNS_UNREGISTERSensor 未。HI_ERR_ISP_MEM_NOT_INIT外部寄存器沒有初始化HI_ERR_ISP_NOT_INIT沒有初始

47、化HiISP開發(fā)參考2 系統(tǒng)【錯誤碼】無【需求】頭文件：hi_comm_isp.h、mpi_isp.庫文件：libisp azz【注】調(diào)用 HI_MPI_ISP_Init 和 HI_MPI_ISP_Run 之后，再調(diào)用本接口firmwa e。SPz不支持多進(jìn)程，必須要與 sensor_register_callback，HI_MPI_AE_Register， HI_MPI_AWB_Register，HI_MPI_AF_Register，HI_MPI_ISP_MemInit， HI_MPI_ISP_Init，HI_MPI_ISP_Run 接口在同一個進(jìn)調(diào)用。不支持重復(fù)調(diào)本接口。zz【例】無【關(guān)主

48、題】HI_MPI_ISP nitHI_MPI_ISP_Set【描述】ttr設(shè)置 ISP共屬性?！菊Z法】H _S32 HI_MPI_ISP_SetPubAttr(IS*pstPubA tr);_DEV Is Dev, onst ISP_PUB_ATR_S【參數(shù)】返回值】專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)11所有 ©參數(shù)稱描述入/輸出I pDevIS 設(shè)備。輸入pstttrISP共屬輸入返回值描述0。非 0失敗，其值為錯誤碼。HiISP開發(fā)參考2系統(tǒng)【錯誤碼】【需求】頭文件：hi_comm_isp.h、mpi_isp.庫文件：libisp azz【注】圖像屬性即對

49、應(yīng)的 sensor 的性。zISP 啟動時，需要確保已調(diào)用 HI_MPI_ISP_MemInit 初始化 ISP 外部存器。支持在 ISP 運(yùn)行之后，調(diào)用本接口實(shí)現(xiàn)動態(tài)分辨率和率切換。zz調(diào)用本接口后 ISP 內(nèi)的處流程： ) ISP firmware圖像分辨率和幀率是否變z化，若都不變則直接返回；則，ISP firmware 會調(diào)用 ensor cmos.c 里面的cmos_set_image_mode 函數(shù)改變 senso 模式；b) 若 sensor 模式改變（返回值為0 ，則 ISP firmware 會調(diào)用 sensor_init 函數(shù)重新配置 sen or； ) ISP firmw

50、are 將幀率信息傳給AE 庫，并決定是更改幀率。若調(diào)用本接口實(shí)現(xiàn)動態(tài)分辨率和幀率切換時 sensor 模式發(fā)生了改變，請參照sample 提供的切換流程操作（先停掉 Vi 設(shè)備，再切換，最后啟動 Vi 設(shè)備）。另外，動態(tài)分辨率和幀率切換時，切換的分辨率和幀率必須有一項(xiàng)要不同（即不能z切換到本身），否則，sensor 可能重新初始而導(dǎo)致異常使用 Vi Dev 和 ISP 提供的裁剪功能時，需要注意：若裁剪后的分辨率和幀率，小于另一組 sensor 模式的分辨率和幀率，則調(diào)用本接口會先切換到對應(yīng)的 s nsor 模式。用戶可更改 sensor cmos.c 里面的 cmos_set_image_mode 函數(shù)調(diào)整 sensor 模式切換的順序。如只提供了 5M30fps 和 1080P60fps 初始化序列的 sensor，若要運(yùn)行1080P30fps，可以從 5M30fps 裁剪得到，也可以從 1080P60fps 降幀得到，修改cmos_set_image_mo e 函數(shù)實(shí)即。zz【舉例】無【相關(guān)主題】HI_MPI_ISP_G tPubAttr專有和市信息半導(dǎo)體文檔版本 03 (2015-06-15)12所有 ©接口返回值含義HI_ERR_ISP_NULL_PTR空指針錯誤。HI_ERR