#ifndef __SONIXCAMERA_H__ #define __SONIXCAMERA_H__ #include "util.h" //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 库初始化 //在调用库的接口函数之前，需要首先调用SonixCam_Init函数，只有该函数返回成功后，才可以调用其它接口函数 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_Init * Description: 库的初始化 * Parameters: videoIndex：/dev/videoX目录下的设备视频设备文件X索引号 * Return : 成功返回 true */ bool SonixCam_Init(int videoIndex); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_UnInit * Description: * Parameters: * Return : 成功返回 true */ bool SonixCam_UnInit(); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 重启设备 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_RestartDevice * Description: * Parameters: * Return : 成功返回 true */ bool SonixCam_RestartDevice(); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // Dsp寄存器读 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_AsicRegisterRead * Description: * Parameters: addr:dsp寄存器地址，pData读取数据缓存，len：要读取的数据字节数。 * Return : 成功返回 true */ bool SonixCam_AsicRegisterRead(unsigned short addr, unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // Dsp寄存器写 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_AsicRegisterWrite * Description: * Parameters: addr:dsp寄存器地址，pData：写数据缓存，len：要写的数据字节数。 * Return : 成功返回 true */ bool SonixCam_AsicRegisterWrite(unsigned short addr, unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得FLASH的类型 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetSerialFlashType * Description: * Parameters: sft：成功返回flash的类型，check：设为true，在flash读取flash类型 * Return : 成功返回 true */ bool SonixCam_GetSerialFlashType(SERIAL_FLASH_TYPE *sft, bool check); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得FW Code版本号 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetFWVersion * Description: * Parameters: pData：FW Code版本号缓存数组指针，len：缓存数组最大字节数，bNormalExport：为true以默认方式排列版本号字符串，为FALSH，以第二种方式排列版本号字符串, 和原始固件名相同。 * Return : 成功返回 true */ bool SonixCam_GetFwVersion(unsigned char pData[], long len, BOOL bNormalExport); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 从固件文件缓存中获得FW Code版本号 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetFWVersion * Description: * Parameters: pFwFile：无符号字符固件缓存指针，pData：FW Code版本号缓存数组指针，len：缓存数组最大字节数，bNormalExport：为true以默认方式排列版本号字符串，为FALSH，以第二种方式排列版本号字符串, 和原始固件名相同。 * Return : 成功返回 true */ bool SonixCam_GetFwVersionFromFile(unsigned char pFwFile[], unsigned char pData[], long len, BOOL bNormalExport); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得FW Code版本号， 如果是271设备，则需要调用该函数获得FW版本号 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetFWVersion * Description: * Parameters: romType： DSP的ROM大小， pData：FW Code版本号缓存数组指针，len：缓存数组最大字节数，bNormalExport：为true以默认方式排列版本号字符串，为FALSH，以第二种方式排列版本号字符串, 和原始固件名相同。 * Return : 成功返回 true */ bool SonixCam_GetFwVersionEx(DSP_ROM_TYPE romType, unsigned char pData[], long len, BOOL bNormalExport); // XU read bool SonixCam_XuRead(unsigned char pData[], unsigned int length, BYTE unitID, BYTE cs); // XU write bool SonixCam_XuWrite(unsigned char pData[], unsigned int length, BYTE unitID, BYTE cs); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // I2C读 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SensorRegisterCustomRead * Description: * Parameters: slaveId:I2c子设备ID,addr:要读的地址,addrByteNumber: 地址字节数,最大2字节, pData:读数据缓存, dataByteNumber:要读的数据字节数,最大2字节, pollSCL:SCL 拉高 * Return : 成功返回 true */ bool SonixCam_SensorRegisterCustomRead(unsigned char slaveId, unsigned short addr, unsigned short addrByteNumber, unsigned char pData[], long dataByteNumber, bool pollSCL); //bool pollSCL = false //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // I2C写 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SensorRegisterCustomWrite * Description: * Parameters: slaveId:I2c子设备ID,addr:要写的地址,addrByteNumber: 地址字节数,最大2字节, pData:写数据缓存, dataByteNumber:要写的数据字节数,最大2字节, pollSCL:SCL 拉高 * Return : 成功返回 true */ bool SonixCam_SensorRegisterCustomWrite(unsigned char slaveId, unsigned short addr, unsigned short addrByteNumber, unsigned char pData[], long dataByteNumber, bool pollSCL); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 第二组I2C读 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SensorTwoRegisterCustomRead * Description: * Parameters: slaveId:I2c子设备ID,addr:要读的地址,addrByteNumber: 地址字节数,最大2字节, pData:读数据缓存, dataByteNumber:要读的数据字节数,最大2字节, pollSCL:SCL 拉高 * Return : 成功返回 true */ bool SonixCam_SensorTwoRegisterCustomRead(unsigned char slaveId, unsigned short addr, unsigned short addrByteNumber, unsigned char pData[], long dataByteNumber, bool pollSCL); //bool pollSCL = false //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 第二组I2C写 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SensorTwoRegisterCustomWrite * Description: * Parameters: slaveId:I2c子设备ID,addr:要写的地址,addrByteNumber: 地址字节数,最大2字节, pData:写数据缓存, dataByteNumber:要写的数据字节数,最大2字节, pollSCL:SCL 拉高 * Return : 成功返回 true */ bool SonixCam_SensorTwoRegisterCustomWrite(unsigned char slaveId, unsigned short addr, unsigned short addrByteNumber, unsigned char pData[], long dataByteNumber, bool pollSCL); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // FLASH读，如果获得的DSP_ROM_TYPE是DRT_64K，则可以读取Flash的范围是0-64K, 否则如果DSP_ROM_TYPE是DRT_128K， 读取范围是0-128K //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SerialFlashRead * Description: * Parameters: addr：要写的地址，pData：写缓存， len：写数据长度 * Return : 成功返回 true */ bool SonixCam_SerialFlashRead(long addr, unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // FLASH写，写地址最大范围是0-256k空间，不要在开图的情况下调用该函数。 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SerialFlashSectorWrite * Description: 先关闭FLASH的写保护，并擦除参数addr地址所在的Flash的扇区，然后写入数据。 * Parameters: addr：写的地址，pData：写缓存， len：写数据长度，sft: FLASH的类型 * Return : 成功返回 true */ bool SonixCam_SerialFlashSectorWrite(long addr, unsigned char pData[], long len, SERIAL_FLASH_TYPE sft); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // FLASH写 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SerialFlashWrite * Description: 与SonixCam_SerialFlashSectorWrite的区别是它不擦除addr地址所在的扇区，需要确保调用该函数之前 * 已经关闭Flash的写保护并且addr地址要写的区域已经擦除。 * Parameters: addr：写的地址，pData：写缓存， len：写数据长度，sft: FLASH的类型 * Return : 成功返回 true */ bool SonixCam_SerialFlashWrite(long addr, unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // FLASH写，写速度比SonixCam_SerialFlashSectorWrite慢，但是写地址空间更大，不要在开图的情况下调用该函数。 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SerialFlashSectorCustomWrite * Description: * Parameters: addr：写的地址，pData：写缓存， len：写数据长度，sft: FLASH的类型 * Return : 成功返回 true */ bool SonixCam_SerialFlashSectorCustomWrite(long addr, unsigned char pData[], long len, SERIAL_FLASH_TYPE sft); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // FLASH读，读速度比SonixCam_SerialFlashRead慢，但是读地址空间更大 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SerialFlashRead * Description: * Parameters: addr：要写的地址，pData：写缓存， len：写数据长度 * Return : 成功返回 true */ bool SonixCam_SerialFlashCustomRead(long addr, unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得设备Manufacturer //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetManufacturer * Description: * Parameters: pData：Manufacturer缓存数组指针，len：缓存数组最大字节数 * Return : 成功返回 true */ bool SonixCam_GetManufacturer(unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得设备Product //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetProduct * Description: * Parameters: pData：Product缓存数组指针，len：缓存数组最大字节数 * Return : 成功返回 true */ bool SonixCam_GetProduct(unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得设备vidpid //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetVidPid * Description: * Parameters: pData：vidpid缓存数组指针，len：缓存数组最大字节数 * Return : 成功返回 true */ bool SonixCam_GetVidPid(unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得设备String3 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetString3 * Description: * Parameters: pData：String3缓存数组指针，len：缓存数组最大字节数 * Return : 成功返回 true */ bool SonixCam_GetString3(unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得设备Interface //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetInterface * Description: * Parameters: pData：Interface缓存数组指针，len：缓存数组最大字节数 * Return : 成功返回 true */ bool SonixCam_GetInterface(unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得设备序列号 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetSerialNumber * Description: * Parameters: pData：序列号缓存数组指针，len：缓存数组最大字节数 * Return : 成功返回 true */ bool SonixCam_GetSerialNumber(unsigned char pData[], long len); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 关闭FLASH的写保护 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_DisableSerialFlashWriteProtect * Description: * Parameters: sft：FLASH类型 * Return : 成功返回 true */ bool SonixCam_DisableSerialFlashWriteProtect(SERIAL_FLASH_TYPE sft); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 擦除FLASH //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_EraseSerialFlash * Description: * Parameters: sft： FLASH类型 * Return : 成功返回 true */ bool SonixCam_EraseSerialFlash(SERIAL_FLASH_TYPE sft); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 擦除FLASH的一个扇区 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_EraseSectorFlash * Description: * Parameters: addr：要擦除的扇区地址，sft：FLASH类型 * Return : 成功返回 true */ bool SonixCam_EraseSectorFlash(long addr, SERIAL_FLASH_TYPE sft); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 擦除FLASH的一个块区 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_EraseBlockFlash * Description: * Parameters: addr：要擦除的块区地址，sft：FLASH类型 * Return : 成功返回 true */ bool SonixCam_EraseBlockFlash(long addr, SERIAL_FLASH_TYPE sft); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 获得rom类型 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_GetAsicRomType * Description: * Parameters: romType：返回rom类型，chipID：当前dsp的芯片id值 * Return : 成功返回 true */ bool SonixCam_GetAsicRomType(DSP_ROM_TYPE *romType, unsigned char *chipID); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 进度回调函数指针 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Description: SonixCam_BurnerFW， SonixCam_WriteFwToFlash， SonixCam_ExportFW，SonixCam_FullCheckFW， SonixCam_CustomBurnerFW， * SonixCam_SetParamTableFromFWFile中可以传递函数指针来更新烧录进度 * Parameters: ptrClass：类指针，fProcess：当前进度值 * Return : 成功返回 true */ typedef void(*SonixCam_SetProgress)(void *ptrClass, float fProcess); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 烧录固件，不要在开图的情况下调用该函数。 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_BurnerFW * Description: 首先会关闭Flash的写保护，然后擦除整个Flash区域，然后将固件写入到Flash * Parameters: pFwBuffer：要烧录的固件缓存指针，lFwLength：固件缓存长度， setProgress：烧录进度回调函数指针， ptrClass：当前类， sft：flash类型， bFullCheckFW：烧录完成后是否进行全校验 * Return : 成功返回 true */ bool SonixCam_BurnerFW(unsigned char pFwBuffer[], LONG lFwLength, SonixCam_SetProgress setProgress, void *ptrClass, SERIAL_FLASH_TYPE sft, BOOL bFullCheckFW); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 烧录固件，不要在开图的情况下调用该函数。 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_WriteFwToFlash * Description: 该函数与SonixCam_BurnerFW的区别是它不会调用关闭写保护和擦除Flash，需要在调用该函数之前自己关闭Flash写保护和擦除Flash相应区域 * Parameters: pFwBuffer：要烧录的固件缓存指针，lFwLength：固件缓存长度， setProgress：烧录进度回调函数指针， ptrClass：当前类， bFullCheckFW：烧录完成后是否进行全校验 * Return : 成功返回 true */ bool SonixCam_WriteFwToFlash(unsigned char pFwBuffer[], LONG lFwLength, SonixCam_SetProgress setProgress, void *ptrClass, BOOL bFullCheckFW); //BOOL bFullCheckFW = FALSE //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 导出固件 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_ExportFW * Description: * Parameters: pFwBuffer：要保存固件缓存指针，lFwLength：固件缓存长度， setProgress：导出进度回调函数指针， ptrClass：当前类 * Return : 成功返回 true */ bool SonixCam_ExportFW(unsigned char pFwBuffer[], LONG lFwLength, SonixCam_SetProgress setProgress, void *ptrClass); //extend burner fw typedef struct { unsigned int SerialNumberLength; unsigned int ProductLength; unsigned int ManufactureLength; unsigned int VidPidLength; unsigned int InterfaceLength; unsigned int String3Length; char* pSerialNumber; char* pProduct; char* pManufacture; char* pVidPid; char* pString3; char* pInterface; }ChangeParamInfo; //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 自定义烧录固件，不要在开图的情况下调用该函数。 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_CustomBurnerFW * Description: 该函数和SonixCam_BurnerFW的区别是它可以更改设备的一些参数 * Parameters: paramInfo：要更改的参数信息，pFwBuffer：固件缓存指针，lFwLength：缓存长度，setProgress：烧录进度回调函数指针， ptrClass：当前类， sft:FLASH类型，bFullCheckFW：是否烧录完成后进行全校验 * Return : 成功返回true */ bool SonixCam_CustomBurnerFW(const ChangeParamInfo paramInfo, unsigned char pFwBuffer[], LONG lFwLength, SonixCam_SetProgress setProgress, void *ptrClass, SERIAL_FLASH_TYPE sft, BOOL bFullCheckFW); //////////////////////////////////////////////////////////////////////////////////////////////////////////////// // 修改设备参数表信息，不要在开图的情况下调用该函数。 //////////////////////////////////////////////////////////////////////////////////////////////////////////////// /* * Function: SonixCam_SetParamTableFromFWFile * Description: 该函数和SonixCam_BurnerFW的区别是它不需要把整个FW烧录到Flash，只需要烧录参数表所在的扇区数据，pFW固件缓存内容必须和设备FLASH中的固件相同 * Parameters: pFW：固件缓存指针，lFwLength：缓存长度，setProgress：烧录进度回调函数指针， ptrClass：当前类， sft:FLASH类型，pLogFilePath: 打印的Log文件路径，可以为空，则不打印Log信息， bFullCheckFW：是否烧录完成后进行全校验 * Return : 成功返回 true */ bool SonixCam_SetParamTableFromFWFile(unsigned char pFW[], long lFwLength, const ChangeParamInfo paramInfo, SonixCam_SetProgress setProgress, void *ptrClass, SERIAL_FLASH_TYPE sft, char* pLogFilePath, BOOL bFullCheckFW); #endif