himpp mipi使用指南海思半导体2017保留一切权利

何形式。商 注您的产品、服务或特性等应受海思公司商业合同和条款的约束，本文档中描述的全部或部分产市海思半导 客户服务传真客户服务邮箱 产品版读者对本文档（本指南）主要适用于以下工程师：符号约

符说表示能帮助您解决某个问题或节省您的时间修订记

HIMIPISETOUTPUTMSB。HIMIPIDISABLESENSOR【定义】涉及更新。HIMIPIRESETSENSORHIMIPIUNRESETSENSOR义】和【叁数】涉及修改小节，新增SYNCCODENUM、wdrmodetslvsdevattrt，dataratet改名为mipidataratetphycmvmodet和combodevattrt涉及更新。删除outputmsbt。combodevtsnsrstsourcet,和snsclksourcet小节，修改表1-HIMIPIENABLEMIPIHIMIPIDISEABLESENSORCLOCK；HIMIPISETDEVATTRSENSORMAXRESETDEV、SENSORMAXCLOCKDEV、SNSRESETDEV和SNSCLOCKDEVHiMPPHiMPP目录 HiMPPMIPI使用指 概 API参 PROC信 MIPI频率说 HiMPPHiMPP 图1-3MIPI数据 表1-1最大支持Lane的个 表1-2MIPIRxLane分布模 表1-3最大支持lane的个 表1-4MIPIRx与SLVS-EC的Lane复用关系 表1-6SENSOR与MIPIRx管脚关 文档版本文档版本00B04(2017-09- 信vHiMPPMIPI使用概

MIPIRx通过低电压差分信号接收原始数据，将接收到的串行差分信号（serialdifferentialsignal）转化为DC（DigitalCamera）时序后传递给下一级模块ViCAP SignalSpeedSerialPixelInterface）等串行信号输入，同时兼容DC接口。SLVS-EC接口由SONY公司定义，用于高帧率和高分辨率图像，它可以将高速串行的数据转化为DC（DigitalCamera）时序后传递给下一级模块VICAP（Capture的冗余度也更低。在应用中SLVS-EC接口提供了更加可靠和稳定的传输。重要概MIPI的全称是IndustryProcessorInterface(移动行业处理器接口)，本文描述的MIPI接口特指物理层使用D-PHY传输规范，协议层使用CSI-2的通口。LVDSLowVoltagedifferentialSignaling(低压差分信号)，通过同步码区分SLVS-SLVSEC的全称是ScalableLowVoltageSignalingEmbeddedClockMIPI并用于连接发送端和接收端的一对高速差分线，即可以是时钟Lane，也可以是数据发送端和接收端之间的时钟Lane和至少一个数据LaneLink，本文中的link是一个软件概念，每一个link包括两个数据lane。同步MIPI接口使用CSI-2里面的短包进行同步，LVDS使用同步码区分有效数据和消隐区。LVDS有两种同步方式：使用SOF/EOF表示帧起始和结束，使用SOL/EOL表示行的起始和结束。同步方式如图1-1所示。使用SAV(invalidEAV(invalid)表示消隐区的无效数据开始和结束，使用SAV(valid)EAV(valid)表示有效像素数据的开始和结束。每个同步码由4个字段组成，每个字段的位宽与像素数据位宽保持一致。前4个字段由sensor由于不同的sensor可能会有不同的同步码，所以需要根据sensor配置同步码。同步方式如图1-2所示。DOL的全称是DigitalOverlapSONY的WDR功能描MIPIRx是一个支持多种差分输入接口单元，通过combo-PHY接收Lane个数如表1-1所示。类定MIPIRx8LaneMIPI16LaneLVDSMIPIRx6sensorsensorsensorLaneMIPIRxLANE分布模式。具体的Lane分布模式请参见表1-2。MIPIMIPIMIPIMIPIMIPIMIPI0不支不支不支不支1不支不支不支MIPIMIPIMIPIMIPIMIPIMIPI2不支不支3不支不支不支不支4不支不支不支5不支不支6不支7不支不支8不支9SLVS-EC接口支持更高帧率更大分辨率图像，通过SLVS-EC的PHY接收高速串行的数据转化为DC（DigitalCamera）时序，通过不同的功能模式配置，SLVS-EC可以支持多种速度和分辨率的数据传输需求，支持多种外部输入设备。最大支持Lane个数如表1-3所示。类定MIPIRxSLVS-ECLane复用管脚，同一时刻同一个LaneMIPIRxSLVS-ECLane1-4√-----√√--√-----√√--√-----√√--√-----√√--√√----√√--√√----√√--√√----√√--√√----√√--√-√---√√√-√√---√√√-√---√√√-√√---√√√---√--√√√---√√--√√√---√--√√√---√√--√√APIMIPIRx提供对接sensor时序的功能。提供ioctl接口，可用令如下HIMIPISETDEVATTR：设置MIPI、SLVSHIMIPISETHSMODE：设置MIPIRxLaneHIMIPISETPHYCMVMODEHIMIPIRESETSENSOR：复位sensorHIMIPIUNRESETSENSOR：撤销复位sensorHIMIPIRESETMIPIMIPIRxHIMIPIUNRESETMIPIMIPIRxHIMIPIRESETSLVS：复位SLVSHIMIPIUNRESETSLVS：撤销复位SLVSHIMIPIENABLEMIPICLOCKMIPIHIMIPIDISABLEMIPICLOCKMIPIHIMIPIENABLESLVSCLOCK：打开SLVSHIMIPIDISABLESLVSCLOCK：关闭SLVSHIMIPIENABLESENSORCLOCKSENSORHIMIPIDISABLESENSORCLOCK：关闭SENSOR#defineHIMIPISETDEV IOW(HIMIPIIOCMAGIC,combodevattrcombodevattrt返回描0成功-失败，并设置头文件：hiHIMIPISETDEVATTRHIMIPISETHS打开MIPI/SLVS时钟：接口为HIMIPIENABLEMIPICLOCK/HIMIPIENABLESLVSCLOCKMIPI/SLVSHIMIPIRESETMIPI/HIMIPIRESETSLVSSENSORHIMIPIENABLESENSORCLOCKSENSORHIMIPIRESET撤销复位MIPI/SLVS：接HIMIPIUNRESETMIPI/HIMIPIUNRESETSENSORHIMIPIUNRESETSENSOR所对接的MIPI打开多路SENSOR复位对接的所有撤销复位多路SENSOR所对接的MIPI撤销复位对接的所有复位多路对接的SENSOR关闭多路SENSOR复位多路SENSOR所对接的MIPIRx/SLVS关闭多路MIPI/SLVS操作SENSOR复位信号线和时钟信号线会对所对接的所有SENSOR都产生效果。【相关数据类型及接口】HIMIPISETHSHIMIPIRESETHIMIPIUNRESETHIMIPIRESETHIMIPIUNRESETHIMIPIRESETHIMIPIUNRESETMIPIRxLane分布模式，对SLVS#defineHIMIPISETHS IOW(HIMIPIIOCMAGIC,lanedividemodelanedividemodet返回描0成功-失败，并设置【差异类支头文件：hi#defineHIMIPISETPHY IOW(HIMIPIIOCMAGIC,phycmvphycmvt返回描0成功-失败，并设置【差异类支头文件：hisensor#defineHIMIPIRESET IOW(HIMIPIIOCMAGIC,snsrstsourcesnsrstsourcetSENSOR返回描0成功-失败，并设置【差异类支头文件：hi撤销复位sensor#defineHIMIPIUNRESET IOW(HIMIPIIOCMAGIC,snsrstsourcesnsrstsourcetSENSOR返回描0成功-失败，并设置【差异类支头文件：hiMIPIRx#defineHIMIPIRESET IOW(HIMIPIIOCMAGIC,combodevcombodevt返回描0成功-失败，并设置【差异类支头文件：hiMIPIRx#defineHIMIPIUNRESET IOW(HIMIPIIOCMAGIC,0x08,combodevcombodevt返回描0成功-失败，并设置【差异类支头文件：hi#defineHIMIPIRESET IOW(HIMIPIIOCMAGIC,0x09,combodevcombodevt返回描0成功-失败，并设置【差异类支头文件：hi撤销复位SLVS#defineHIMIPIUNRESET IOW(HIMIPIIOCMAGIC,0x0a,combodevcombodevt返回描0成功-失败，并设置【差异类支头文件：hi打开MIPI#defineHIMIPIENABLEMIPI IOW(HIMIPIIOCMAGIC,combodevcombodevt返回描0成功-失败，并设置【差异类支头文件：hi关闭MIPI#defineHIMIPIDISABLEMIPI IOW(HIMIPIIOC0x0d,combodevcombodevt返回描0成功-失败，并设置【差异类支头文件：hi打开SLVS设备的时钟。#defineHIMIPIENABLESLVS IOW(HIMIPIIOC0x0e,combodevcombodevt返回描0成功-失败，并设置【差异类支头文件：hi关闭SLVS设备的时钟。#defineHIMIPIDISABLESLVS IOW(HIMIPIIOC0x0f,combodevcombodevt返回描0成功-失败，并设置【差异类支头文件：hi#defineHIMIPIENABLESENSOR IOW(HIMIPIIOCMAGIC,snsclksourceSENSOR的时返回描0成功-失败，并设置【差异类支头文件：hi#defineHIMIPIDISABLESENSOR IOW(HIMIPIIOCMAGIC,snsclksourceSENSOR的时返回描0成功-失败，并设置【差异类支头文件：hi数据类MIPIRx相关数据类型定义如下：HIMIPIIOCMAGIC：MIPIRxioctlcombodevt：MIPIRx、SLVSSENSORMAXRESETDEV：SENSORSENSORMAXCLOCKDEV：SENSORsnsrstsourcet：SENSOR的复位信号线编号，软件上称为SENSORsnsclksourcet：SENSOR的时钟信号线编号，软件上称为SENSORMIPIMAXDEVNUM：MIPIRxSLVSMAXDEVNUM：SLVSSLVSDEVNUMSTART：SLVSCOMBOMAXLANENUM：设备最大支持的LaneMAXLANENUMPERLINK：MIPIRxlinkLaneMIPILANENUM：MIPIRxMIPI设备支持的最大LaneLVDSLANENUM：LVDS/HiSPi接口支持的LaneSLVSLANENUM：SLVS设备支持的最大LaneCOMBOMAXLINKNUM：MIPIRxLinkCOMBOMAXDEVNUM：MIPIRxWDRVCNUM：定义最多支持的VirtualChnnaelSYNCCODENUM：定义LVDSVirtualChannellanedividemodet：MIPIRxLaneinputmodet：MIPIRxmipidataratet：MIPIRx，SLVSimgrectt：cropslvslaneratet：SLVSLanerawdatatypet：传输的rawmipiwdrmodet：MIPIWDRmipidevattrt：MIPIwdrmodet：LVDSWDRlvdssyncmodet：LVDSlvdsbitendiantlvdsvsynctypet：LVDSvsynclvdsvsyncattrt：LVDSvsynclvdsfidtypet：FrameidentificationIdlvdsfidattrt：FrameindentificationIdlvdsdevattrt：LVDS/SubLVDS/HiSPislvsdevattrt：SLVSphycmvmodet：PHYphycmvt：PHYoutputmsbtcombodevattrt：comboMIPIRxioctl#defineHIMIPIIOCMAGIC

typedefunsignedintcombodev【差异类SLVS[0,MIPIMAXDEV[SLVSDEVNUMSTART,COMBOMAXDEV【相关数据类型及接口】combodevattrHIMIPISETDEVHIMIPIRESETHIMIPIUNRESETHIMIPIRESETHIMIPIUNRESETSENSOR的复#defineSENSORMAXRESET SENSOR的时#defineSENSORMAXCLOCK SENSOR的复位信号线编号，软件上称为SENSOR的复typedefunsignedintsnsrstsource【差异类[0,SENSORMAXRESETHi3559AESV100SENSOR的复位信号线，每条可以接两个SENSOR，用户需要根据板子的连线确认SENSOR复位信号线编号。【相关数据类型及接口】HIMIPIRESETHIMIPIUNRESETSENSOR的时钟信号线编号，软件上称为SENSOR的时typedefunsignedintsnsclksource【差异类[0,SENSORMAXCLOCKHi3559AESV100SENSOR的时钟信号线，每条可以接两个SENSOR，用户需要根据板子的连线确认SENSOR时钟信号线编号。【相关数据类型及接口】HIMIPIENABLESENSORHIMIPIDISABLESENSOR#defineMIPIMAXDEV SLVS支持#defineSLVSMAXDEV 无SLVS起始设#defineSLVSDEVNUM MIPIMAXDEV#defineCOMBOMAXLANE MIPIRxlinkLane#defineMAXLANENUMPERLINK这里的link是软件概念，软件上把一个逻辑的link拆分成了2个软件的linkMIPIRxMIPILane#defineMIPILANE (MAXLANENUMPERLINK*MIPIRxLVDSLane#defineLVDSLANE COMBOMAXLANESLVSLane#defineSLVSLANE MIPIRxLink#defineCOMBOMAXLINK MIPIRx#defineCOMBOMAXDEV (MIPIMAXDEVNUM+SLVSMAXDEV无定义最多支持的VirtualChnnael#defineWDRVC #defineSYNCCODE MIPIRxLANEtypedef{0123456789}lanedividemodeMIPILANE【相关数据类型及接口】HIMIPISETHStypedef{/*mipi/*SUBLVDS/*LVDS/*HISPI/*CMOS/*CMOS/*SLVS/*MIPIBypass}inputmode【差异无INPUTMODEMIPIINPUTMODESLVSMIPIRx，SLVStypedef{MIPIDATARATEX1 /*output1pixelperclock*/MIPIDATARATE /*output2pixelperclockMIPIDATARATE}mipidatarate

MIPI0SLVS6Mipicrop属性。typedef{intx;intunsignedintwidth;unsignedintheight;}imgrect描xCropxyCropyCropCropSLVSLANE的输入速率typedef{SLVSLANERATELOW0,/*1152Mbps*/SLVSLANERATEHIGH1,/*2304Mbps*/SLVSLANERATEBUTT}slvslanerateMIPI0SLVS6传输的rawtypedef{RAWDATA8BIT RAWDATA10BIT,RAWDATA12BIT,RAWDATA14BIT,RAWDATA16BIT,RAWDATABUTT}rawdatatypetypedef{HIMIPIWDRMODE HIMIPIWDRMODEVC /*VirtualChannel*/HIMIPIWDRMODEDT /*DataType*/HIMIPIWDRMODEDOL /*DOLMode*/HIMIPIWDRMODEBUTT}mipiwdrmode描HIMIPIWDRMODEHIMIPIWDRMODEPacketheaderVirtualChannel区分长短曝描HIMIPIWDRMODEPacketheader中的自定义Datatype区分长短曝HIMIPIWDRMODEDOLWDR，使用Packetheader之后的一个pixel识别长短帧typedef{rawdatatypet rawdatatype;mipiwdrmodet wdrmode; laneid[MIPILANENUM];{shortdatatype[WDRVC}mipidevattr描rawdatarawdatalane发送端(sensor)和接收端(MIPIRx)Lane的对应关系未使用的Lane设置为-1。wdrMIPIWDR描datawdrmodeHIMIPIWDRMODEDTdatatype，表示不同长度数据对应的DataType

【相关数据类型及接口】rawdatatypemipiwdrmodeHIMIPISETDEVtypedef{}描HIWDRMODEHIWDRMODE2HIWDRMODE3HIWDRMODE4描HIWDRMODEDOLDOL2HIWDRMODEDOLDOL3HIWDRMODEDOLDOL4DOLWDR模式需要配置为HIWDRMODEDOL2F/HIWDRMODEDOL3FHIWDRMODEDOL4F。Built-inWDR模式和帧合成WDRHIWDRMODENONELVDS同步typedef{LVDSSYNCMODESOF /*sensorSOL,EOL,SOF,EOF*/LVDSSYNCMODESAV, /*SAV,EAV*/LVDSSYNCMODE}lvdssyncmodesyncLVDSSYNCMODESOF、EOF、SOL、LVDSSYNCMODE【定typedef{LVDSENDIANLITTLE LVDSENDIANBIG LVDSENDIANBUTT}lvdsbitendianLVDSvsynctypedef{LVDSVSYNCNORMAL LVDSVSYNCSHARE LVDSVSYNCHCONNECT LVDSVSYNCBUTT}lvdsvsynctype描LVDSVSYNC长短帧有独立的SOF-EOF、SOL-EOL或,LVDSVSYNC长短帧共用一对SOF-EOF标识，短的LVDSVSYNC长短帧共用一对SAV-EAV标识，长短LVDSVSYNCSHARELongShort--LVDSVSYNCHCONNECT-【差异无【相关数据类型及接口】lvdsvsyncattrtypedef{lvdsvsynctypetsyncunsignedshorthblank1;unsignedshort}lvdsvsyncattrsynctypeLVDSVSYNCHCONNECT时，需要配置hblank1和hblank2，表示Hconnect的消隐区长度。【相关数据类型及接口】lvdsvsynctypetypedef{LVDSFID LVDSFIDINSAV /*frameidentificationidinSAV4th*/LVDSFIDIN 0x02, /*frameidentificationidinfirstdataLVDSFID}lvdsfidtype描LVDSFIDLVDSFIDINFIDSAV4个字段中，DOL4个字段的同步码需要将fidtype配置为LVDSFIDINSAV。LVDSFIDINFIDFrameinformationcolumn插入在同步码之后的第一个像前，DOL5个字段的同步码需要将fidtype配置为LVDSFIDINDATA。typedef{lvdsfidtypetfidtype;HIBOOLoutputfil;}lvdsfidattr描fidLVDSDOL模式下的FrameidentificationIdoutputDOLFrameinformationlineV-Blanking之后输出，FrameID是Frameinformationline中的第一个像素值。·outputfilHITRUE，Frameinformationline会输描·outputfilHIFALSE，MIPIRx将丢弃这一行数【相关数据类型及接口】lvdsfidtypeLVDS/SubLVDS/HiSPi设备属性。typedef{rawdatatypet rawdatatype;wdrmodet wdrmode;lvdssyncmodet syncmode;lvdsvsyncattrtvsyncattr;lvdsfidattrt fidattr;lvdsbitendiantdataendian;lvdsbitendiantsynccodeendian; laneid[LVDSLANENUM];unsigned synccode[LVDSLANENUM][WDRVCNUM][SYNCCODE}lvdsdevattr描rawdatarawdatawdrWDRsyncLVDS同步模vsyncvsyncwdrmodDOLsyncmodeLVDSSYNCMODESAV时，需要配置vsync描fidframeidentificationwdrmodeDOLsyncmodeLVDSSYNCMODESAVdatasynccodelane发送端(sensor)和接收端(MIPIRx)lane的对应关系未使用的lane设置为-1syncVirtualChannel4个同步码，根据同步模式不同，分别表示SOF/EOF/SOL/EOL的同步码或者invalidSAV/invalidEAV/validSAV/validEAV的同步码。【相关数据类型及接口】wdrmodelvdssyncmoderawdatatypelvdsbitendianlvdsvsynctypelvdsfidtypeHIMIPISETDEVSLVS设备typedef{rawdatatypet rawdatatype;wdrmodet wdrmode;slvslanerate lane sensorvalid laneid[LVDSLANE}slvsdevattr描rawdatarawdatawdrWDRlaneSLVSLanesensorvalidSENSOR实际有lane发送端(sensor)和接收端(SLVS)Lane的对应关系。未使用的lane设置为-1。SLVS只能支持线性模式和WDR2to1【相关数据类型及接口】rawdatatypeslvslanerateHIMIPISETDEVPHY共模电typedef{PHYCMV PHYCMVLT1200MV PHYCMVBUTT}phycmvmode描PHYCMVPHYCMV

PHYtypedef{combodevt phycmvmodetcmvmode;}phycmv描MIPIRxcmvPHY功能电【相关数据类型及接口】phycmvmodeHIMIPISETPHYcombo设备属性，由于MIPIRxCSI-2、LVDS、HiSPi等时序，所以将MIPIRx称为combo设备。typedef{combodevt inputmodet inputmode;mipidataratet datarate;imgrectt imgrect;{mipidevattrtmipiattr;lvdsdevattrtlvdsattr;slvsdevattrtslvsattr;}combodevattr描MIPIRx，SLVSinputdataimgcropmipiinputmodeINPUTMODEMIPI，则必须配置mipiattr。lvds如果inputmode配置为INPUTMODESUBLVDS/INPUTMODELVDSINPUTMODEHISPI，则必须配置lvdsslvsinputmodeINPUTMODESLVS，则必须配置slvsattr。PROCMIPIRX正常工作状态下proc信息中宽高应该是稳定不变且和sensor输出时序的宽高匹配，并且MIPIRX各种错误中断计数为0。如果错误中断计数不为0，请检查MIPIRXModule:[MIPI],BuildTime:[May232017,10:04:19]MIPILANEDIVIDEMODE7MIPIDEVDevnoWorkModeDataRateDataTypeWDRMode 0, MIPILANE 0,1,2,3,-1,-1,-1,-LinkIdxLaneCountLaneIdAlignedData1ValidLaneLinkIdxLaneCountLaneIdAlignedData1ValidLane 0, 2,MIPIDETECTDevnoVCwidth0 0 0 0 LVDSDETECTDevnoVCwidth0 0 0 0 LVDSLANEDETECTDevno width 020304050607080FSMTIMEOUTANDESCAPEtttt tt00000000000100000000002000000000030000000000ALINGERRORDevnoFIFOFullErrLane0ErrLane1ErrLane2ErrLane3ErrLane4ErrLane5ErrLane6ErrLane7ErrLane8ErrLane9ErrLane10ErrLane11ErrLane12ErrLane13ErrLane14ErrLane15Err0000000000000000SLVSDEV DevnoWorkModeDataRateDataTypeWDRMode ImgHLaneRate 0,1,2, SLVSLANE 0,1,2,3,4,5,6,SLVSDETECT 60610062006300SLVSDEVERRORDevnoHeaderCRCPayloadCRCEccErrCmdFifoFullSkewErr

600000 PHY0033033306033070330001000100011000MIPIRx通过Phy接收sensor的差分数据，PhyController检测到同步头后，将每条lane上的数据对齐；PixelController解析同步信息并按照rawdata的位宽将lanePixel数据；Output模式将Pixel数据发PhyPhyControllerPixelController由sensor的pixelclk提供时钟，output模块的时钟为称为随路时钟，与后级模块的工作时钟相同。MIPIRx的crop功能在PixelController的末端实现，所以Crop后可以降低需要的随路时钟。参描MIPIRxlaneMIPIMIPIRxRAW8/RAW10/RAW12/RAW14/bitWDR2To1：213To1：314To1：41Link，对应LinkID。一个物理Link对应4个Lane。CropCrop参描tLaneLaneLinkIDLink中使用了几条Lane检测到帧同步信号后的实时数据检测到帧同步信号后的实时数据LinkLaneIDMIPI模式下可见MI