migGrabber.h

Go to the documentation of this file.

#pragma once
 
#ifndef _MIG_GRABBER_H_
#define _MIG_GRABBER_H_
 
#include "MIG_ErrCode.h"
 
#define MIG_PARAM_VIDEO_FMT             1 
#define MIG_PARAM_PIXEL_ORDER           2 
#define MIG_PARAM_HOR_RES               3 
#define MIG_PARAM_VER_RES               4 
#define MIG_PARAM_BITS_PER_PIXEL        5 
#define MIG_PARAM_SRC_BITS_PER_PIXEL    6 
#define MIG_PARAM_HOR_BACK_PORCH        7
#define MIG_PARAM_HOR_FRONT_PORCH       8
#define MIG_PARAM_VER_BACK_PORCH        9
#define MIG_PARAM_VER_FRONT_PORCH       10
 
#define MIG_PARAM_I2C_SLAVE_ADDR        11 
#define MIG_PARAM_I2C_ADDR_TYPE_WORD    12 
#define MIG_PARAM_I2C_DATA_TYPE_WORD    13 
#define MIG_PARAM_I2C_CHECK_ACK         14 
#define MIG_PARAM_I2C_REPEAT_START      15 
#define MIG_PARAM_I2C_SPEED_KHZ         16 
 
#define MIG_PARAM_FLIP_IMAGE            20 // 0:no flip , 1: hor flip , 2: ver flip , 3: hor and ver flip
#define MIG_PARAM_CHK_CAM_READY_SIG     21
#define MIG_PARAM_DESERIALIZER_SEL      22 // 1~8(CH1~8)
#define MIG_PARAM_UPDATE_ENCODER_USE    23
 
#define MIG_PARAM_BOARD_VERSION_FW      31
#define MIG_PARAM_BOARD_VERSION_FPGA    32
 
#define MIG_PARAM_BOARD_USB_RESET       33
 
#define MIG_PARAM_FMODEL_NO             41
 
#define MIG_PARAM_ENABLE_ENCODER_COUNT  51
 
#define MIG_PARAM_BOARD_PRESET          61 
#define MIG_PARAM_MIPI_LANE_SET         62 // valid 1~4
#define MIG_PARAM_MIPI_VIRTUAL_CH_SEL   63 // -1:skip scan  /  virtual channel 0,1,2,,,
 
 
 
#define MIG_PARAM_GPIO_1                71 
#define MIG_PARAM_GPIO_2                72
#define MIG_PARAM_GPIO_3                73
#define MIG_PARAM_GPIO_4                74
#define MIG_PARAM_GPIO_5                75
#define MIG_PARAM_GPIO_6                76
#define MIG_PARAM_GPIO_7                77
 

typedef struct _tagBOARD_INFO
{
    int     board_id; 
    int     scan_index; 
 
    DWORD   vender_id; 
    DWORD   device_id; 
 
    DWORD   ext_info1; 
    DWORD   ext_info2; 
    DWORD   ext_info3; 
} _BOARD_INFO;

typedef struct _tagBOARD_LIST
{
    int         num_board = 0; 
    _BOARD_INFO  board_info[255] = { 0, };
} _BOARD_LIST;
 
typedef void* MIG_HANDLE;
typedef void* MIG_PMSG;

typedef struct _tagMIG_VIDEO_CONF
{
    int    video_fmt; 
    int    pxl_order; 
    int    hor_res; 
    int    ver_res; 
    int    bit_per_pxl; 
    int    bit_per_pxl_src; 
} _MIG_VIDEO_CONF;

typedef struct _tagMIG_I2C_CONF
{
    int    slave_addr; 
    int    addr_type; 
    int    data_type; 
    int    check_ack; 
    int    speed; 
} _MIG_I2C_CONF;
 
 
#ifdef __cplusplus
extern "C"
{
#endif
 
typedef void             (__stdcall* _CbTerminalLog)(int BoardId, wchar_t* pLog);
 
namespace MIG_SDK
{
    typedef int             (__stdcall* _SetCbTerminalLog)(int BoardId, _CbTerminalLog fn);
    typedef int             (__stdcall* _GetMigSdkVersion)();
 
    typedef int             (__stdcall* _EnumerateBoard)(_BOARD_LIST* pDest);
    typedef int             (__stdcall* _GetNumOfBoard)();
    typedef int             (__stdcall* _GetBoardId)(int nUsbIndex);
    typedef void            (__stdcall* _GetErrStr)(int nErrCode, char* pBuff, int sizeBuff);
    typedef int             (__stdcall* _SetParamInt)(int BoardId, int type, int val);
    typedef int             (__stdcall* _GetParamInt)(int BoardId, int type);
    typedef int             (__stdcall* _SetParamDouble)(int BoardId, int type, double val);
    typedef double          (__stdcall* _GetParamDouble)(int BoardId, int type);
    typedef int             (__stdcall* _OpenGrabber)(int BoardId, int nGrabberType, MIG_HANDLE hwndParent);
    typedef void            (__stdcall* _SetConfigPathName)(int BoardId, const char* pConfigFilePath);
    typedef int             (__stdcall* _CloseGrabber)(int BoardId);
    typedef BOOL            (__stdcall* _IsGrabberOpened)(int BoardId);
    typedef int             (__stdcall* _GetGrabberType)(int BoardId);
    //typedef int             (__stdcall* _GetVersion)(int BoardId, unsigned short* pwFirmwareVer, unsigned short* pwFPGAVer);
    typedef int             (__stdcall* _GetSerialNo)(int BoardId, char* pSn, int sizeSN);
    typedef BOOL            (__stdcall* _IsVirtual)(int BoardId);
    typedef int             (__stdcall* _SetVideoConf)(int BoardId, _MIG_VIDEO_CONF* pConf);
    typedef int             (__stdcall* _SetI2cConf)(int BoardId, _MIG_I2C_CONF* pConf);
 
    typedef int             (__stdcall* _Grab)(int BoardId, int nNbImage, DWORD dwTimeOut_ms);
    typedef int             (__stdcall* _GrabContinuous)(int BoardId);
    typedef BOOL            (__stdcall* _GrabInProgress)(int BoardId);
    typedef int             (__stdcall* _HaltGrab)(int BoardId);
    typedef int             (__stdcall* _WaitForFrameDone)(int BoardId, DWORD dwTimeOut_ms);
    typedef int             (__stdcall* _GetSrcBitsPerPixel)(int BoardId);
    typedef int             (__stdcall* _GetBytesPerPixel)(int BoardId);
    typedef int             (__stdcall* _GetImageSizeBytes)(int BoardId);
    typedef int             (__stdcall* _GetImage)(int BoardId, unsigned char* pDstBuffer, int dstWidth, int dstHeight, int dstPitchBytes);
    typedef BOOL            (__stdcall* _PutImage)(int BoardId, unsigned char* pSrcBuffer, int srcWidth, int srcHeight, int srcPitchBytes);
    typedef int             (__stdcall* _ImportImage)(int BoardId, const char* pPathName);
    typedef int             (__stdcall* _ExportImage)(int BoardId, const char* pPathName);
    typedef int             (__stdcall* _RegisterEvent)(int BoardId, MIG_HANDLE hEv, int nMigEvent);
    typedef void            (__stdcall* _UnregisterEvent)(int BoardId, int nMigEvent);
 
    typedef int             (__stdcall* _i2cRead)(int BoardId, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
    typedef int             (__stdcall* _i2cWrite)(int BoardId, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
    typedef int             (__stdcall* _i2cR)(int BoardId, unsigned char slave, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
    typedef int             (__stdcall* _i2cW)(int BoardId, unsigned char slave, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
 
    typedef int             (__stdcall* _i2c2_R)(int BoardId, unsigned char slave, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
    typedef int             (__stdcall* _i2c2_W)(int BoardId, unsigned char slave, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
 
    typedef int             (__stdcall* _bulk_i2cReset)(int BoardId);
    typedef int             (__stdcall* _bulk_i2cSet)(int BoardId, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
    typedef int             (__stdcall* _bulk_i2cSetDelay)(int BoardId, WORD wDelay_ms);
    typedef int             (__stdcall* _bulk_i2cRun)(int BoardId);
    typedef int             (__stdcall* _pwrSetMode)(int BoardId, int mode);
    typedef int             (__stdcall* _pwrReset)(int BoardId);
    typedef int             (__stdcall* _pwrGetNumOfChannel)(int BoardId);
    typedef int             (__stdcall* _pwrGetMinVoltage)(int BoardId, int nPwrChannel, int* pnMinVoltage_mV);
    typedef int             (__stdcall* _pwrGetMaxVoltage)(int BoardId, int nPwrChannel, int* pnMaxVoltage_mV);
    typedef int             (__stdcall* _pwrGetMaxCurrent)(int BoardId, int nPwrChannel, int* pnMaxCurrent_mA);
    typedef BOOL            (__stdcall* _pwrIsPowerOn)(int BoardId);
    typedef int             (__stdcall* _pwrPowerOff)(int BoardId, int nPwrChannel);
    typedef int             (__stdcall* _pwrPowerOffAll)(int BoardId);
    typedef int             (__stdcall* _pwrSetVoltage)(int BoardId, int nPwrChannel, const int nPwrLevel_mV);
    typedef int             (__stdcall* _pwrMeasureVoltage)(int BoardId, int nPwrChannel, int* pPwrResult_mV);
    typedef int             (__stdcall* _pwrMeasureCurrent)(int BoardId, int nPwrChannel, int* pPwrResult_mA);
    typedef int             (__stdcall* _pwrMeasureOS)(int BoardId, int nPwrChannel, int* pPwrResult_mV);
    typedef int             (__stdcall* _pwrSetCurrentRange)(int BoardId, int nPwrChannel, const int nCurrentRange);
    //typedef int             (__stdcall* _pwrWritePowerConfig)(int BoardId, const char* pFile, const char* pSection, int* pnErrorIndex);
    typedef int             (__stdcall* _subPwrSetType)(int BoardId, int nSubType);
    typedef int             (__stdcall* _subPwrSetVoltage)(int BoardId, int nSubType, int nPwrChannel, int nPwrLevel_mV);
    typedef int             (__stdcall* _WriteRegisterSet)(int BoardId, const char* pFile, const char* pSection, int* pnErrorIndex);
    typedef int             (__stdcall* _ReadSyncCount)(int BoardId, DWORD dwTimeOut_ms, int* pDestHsync, int* pDestVsync, ULONG* pDestPClk_Hz);
    typedef int             (__stdcall* _GetFrameRate)(int BoardId, int nFpsType, float* pfFrameRate);
    typedef int             (__stdcall* _GetFrameDataRate)(int BoardId, double* pdDataRate_bps);
    typedef int             (__stdcall* _GetMotorCounter)(int BoardId, DWORD* pDest);
 
    typedef BOOL            (__stdcall* _IsDebug)(int BoardId);
    typedef void            (__stdcall* _SetDebug)(int BoardId, BOOL bDebug);
    typedef int             (__stdcall* _ExpCommand)(int BoardId, DWORD wCmd, int64_t pParam1, int64_t pParam2);
}
 
#ifndef _WINDOWS

extern int              GetMigSdkVersion();
extern int              EnumerateBoard(_BOARD_LIST* pDest);
extern int              GetNumOfBoard();
extern int              GetBoardId(int nUsbIndex);
extern void             GetErrStr(int nErrCode, char* pBuff, int sizeBuff);
extern int              SetParamInt(int BoardId, int type, int val);
extern int              GetParamInt(int BoardId, int type);
extern int              SetParamDouble(int BoardId, int type, double val);
extern double           GetParamDouble(int BoardId, int type);
extern int              OpenGrabber(int BoardId, int nGrabberType, MIG_HANDLE hwndParent);
extern void             SetConfigPathName(int BoardId, const char* pConfigFilePath);
extern int              CloseGrabber(int BoardId);
extern BOOL             IsGrabberOpened(int BoardId);
extern int              GetGrabberType(int BoardId);
//extern int             GetVersion(int BoardId, unsigned short* pwFirmwareVer, unsigned short* pwFPGAVer);
extern int              GetSerialNo(int BoardId, char* pSn, int sizeSN);
extern BOOL             IsVirtual(int BoardId);
extern int              Grab(int BoardId, int nNbImage, DWORD dwTimeOut_ms);
extern int              GrabContinuous(int BoardId);
extern BOOL             GrabInProgress(int BoardId);
extern int              HaltGrab(int BoardId);
extern int              WaitForFrameDone(int BoardId, DWORD dwTimeOut_ms);
extern int              GetBytesPerPixel(int BoardId);
extern int              GetImageSizeBytes(int BoardId);
extern int              GetImage(int BoardId, unsigned char* pDstBuffer, int dstWidth, int dstHeight, int dstPitchBytes);
extern BOOL             PutImage(int BoardId, unsigned char* pSrcBuffer, int srcWidth, int srcHeight, int srcPitchBytes);
extern int              ImportImage(int BoardId, const char* pPathName);
extern int              ExportImage(int BoardId, const char* pPathName);
extern int              RegisterEvent(int BoardId, MIG_HANDLE hEv, int nMigEvent);
extern void             UnregisterEvent(int BoardId, int nMigEvent);
extern int              i2cRead(int BoardId, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
extern int              i2cWrite(int BoardId, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
extern int              bulk_i2cReset(int BoardId);
extern int              bulk_i2cSet(int BoardId, unsigned short wRegAddr, BYTE* pbytValue, int nLength);
extern int              bulk_i2cSetDelay(int BoardId, WORD wDelay_ms);
extern int              bulk_i2cRun(int BoardId);
extern int              pwrSetMode(int BoardId, int mode);
extern int              pwrGetNumOfChannel(int BoardId);
extern BOOL             pwrIsPowerOn(int BoardId);
extern int              pwrPowerOff(int BoardId, int nPwrChannel);
extern int              pwrPowerOffAll(int BoardId);
extern int              pwrSetVoltage(int BoardId, int nPwrChannel, const int nPwrLevel_mV);
extern int              pwrMeasureVoltage(int BoardId, int nPwrChannel, int* pPwrResult_mV);
extern int              pwrMeasureCurrent(int BoardId, int nPwrChannel, int* pPwrResult_mA);
extern int              WriteRegisterSet(int BoardId, const char* pFile, const char* pSection, int* pnErrorIndex);
extern int              ReadSyncCount(int BoardId, DWORD dwTimeOut_ms, int* pDestHsync, int* pDestVsync, ULONG* pDestPClk_Hz);
extern int              GetFrameRate(int BoardId, int nFpsType, float* pfFrameRate);
 
extern BOOL             IsDebug(int BoardId);
extern void             SetDebug(int BoardId, BOOL bDebug);
extern int              ExpCommand(int BoardId, DWORD wCmd, int64_t pParam1, int64_t pParam2);
#endif // _WINDOWS
 
#ifdef __cplusplus
}
#endif
 
#endif //_MIG_GRABBER_H_