dc1394_vendor_daheng.h

libdhsvfc-1.1.0.tar.gz 1394接口工业数字相机需要的一个库

/***************************************************************************
 *  dhlibdc.h
 *
 *  Mon May  20 09:05:31 2005
 *  Copyright  2004  DAHENG-IMAGE PENGJIEJUN
 *  Email [e-mail]
 *  最后修订日期 : Wed Mar 29 09:07 2006 
 ****************************************************************************/

#ifndef _DAHENG_ADD_DC1394_CAMERA_CONTROL_H
#define _DAHENG_ADD_DC1394_CAMERA_CONTROL_H

#include <stddef.h>
#include <sys/types.h>
#include <libraw1394/raw1394.h>
#include <stdio.h>
#include <sys/time.h>
#include <stdlib.h>


enum SHUTTER_UNIT { 
    SHUTTER_US  = 0,
    SHUTTER_MS 	= 1,
    //SHUTTER_S = 2
};

enum STROBE_POLARITY { 
    STROBE_POLARITY_LOW  = 0,
    STROBE_POLARITY_HIGH = 1,
};

enum STROBE_SWITCH {
	STROBE_SWITCH_OFF = 0,
	STROBE_SWITCH_ON = 1,
};

#ifdef __cplusplus
extern "C" {
#endif


/*
说  明:设置ShutterUnit
参  数:handle 1394卡句柄, 
	  node 	 摄像机节点.
	  mode可取值有SHUTTER_US，SHUTTER_MS.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_set_shutter_unit(raw1394handle_t handle, nodeid_t node,
									unsigned int mode);
	
/*
说  明:读取ShutterUnit
参  数:handle 1394卡句柄, 
	  node 	 摄像机节点.
	  mode 	 存取数据的缓冲区,其值为SHUTTER_US，SHUTTER_MS.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/	
int
dc1394_daheng_get_shutter_unit(raw1394handle_t handle, nodeid_t node, 
									unsigned int *mode);

/*
说  明:设置增益分量值
参  数:handle 1394卡句柄, 
      node 	 摄像机节点.
	  r_value， g_value， b_value 分别表示要设置R,G,B值.
返回值：正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/	
int
dc1394_daheng_set_separate_gain(raw1394handle_t handle, nodeid_t node,
                        			unsigned int r_value, 
									unsigned int g_value, 
									unsigned int b_value);	
									
/*
说  明:读取增益分量值
参  数:handle 1394卡句柄, 
	 		 node 	 摄像机节点.
      r_value， g_value， b_value存取数据的缓冲区,保存R,G,B值。
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/	
int
dc1394_daheng_get_separate_gain(raw1394handle_t handle, nodeid_t node,
                         			unsigned int *r_value, 
									unsigned int *g_value, 
									unsigned int *b_value);

/*
说  明:帧冻结设置
参  数:handle  1394卡句柄, 
      node 	  摄像机节点.
      nfreeze 值为1, 帧冻结开;为0,帧冻结关.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/	
int
dc1394_daheng_set_freezeframe(raw1394handle_t handle, nodeid_t node, 
									int nfreeze);

/*
说  明:读取帧冻结设置
参  数:handle  1394卡句柄, 
      node 	  摄像机节点.
      nfreeze 值为1, 帧冻结开; 为0,帧冻结关.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/	
int
dc1394_daheng_get_freezeframe(raw1394handle_t handle, nodeid_t node, 
									int *nfreeze);

/*
说  明:AD控制(由导入的LUT文件实现)
参  数:handle 1394卡句柄,
      node 	 摄像机节点.
      ptr 	 读出的LUT文件数据缓冲区, nLong读取的长度单位为字节,
	  这里的LUT文件大小为16K,所以Lnong的大小固定为16*1024. 	   
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_load_lut(raw1394handle_t handle, nodeid_t node, 
									quadlet_t* ptr, 
									int nLong);

int
dc1394_daheng_read_lut(raw1394handle_t handle, nodeid_t node, 
							quadlet_t* ptr, int nLong);


/*
说  明:向相机的E2ROM中存储用户数据，最大长度是6K字节，最小是4字节。
参  数:handle 1394卡句柄, 
	  node 摄像机节点,
	  pdata 用户数据数据缓冲区, dwlen写入数据长度(单位为字节).
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_set_userdata(raw1394handle_t handle, nodeid_t node, 
									unsigned char* pdata, 
									int dwlen);
/*
说  明:从相机的E2ROM中读取用户数据，最大长度是6K字节，最小是4字节。
参  数:handle 1394卡句柄, 
	  node 	 摄像机节点.
      pdata 存取数据的缓冲区, dwlen数据长度(单位为字节).
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_get_userdata(raw1394handle_t handle, nodeid_t node, 
									unsigned char* pdata, 
									int dwlen);
									
/*
说  明:向相机的E2ROM中存储用户数据，最大长度是6K字节，最小是1字节, 偏移量和数据长度之和要小于6K。
参  数:handle 1394卡句柄, 
	  node		摄像机节点,
	  pdata	 	用户数据数据缓冲区, 
	  dwlen		写入数据长度(单位为字节),
	  offset	向用户数据区写入数据的地址偏移量.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_set_userdata_offset(raw1394handle_t handle, nodeid_t node, 
									unsigned char* pdata, 
									int dwlen,
									int offset);
/*
说  明:从相机的E2ROM中读取用户数据，最大长度是6K字节，最小是4字节, 偏移量和数据长度之和要小于6K。
参  数:handle	1394卡句柄, 
	  node		摄像机节点.
      pdata		存取数据的缓冲区, 
	  dwlen		数据长度(单位为字节),
	  offset	向用户数据区肚读取数据的地址偏移量.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_get_userdata_offset(raw1394handle_t handle, nodeid_t node, 
									unsigned char* pdata, 
									int dwlen,
									int offset);
									

/*
说  明:读取FPGA版本信息
参  数:handle   1394卡句柄, 
	  node 	    摄像机节点.
	  nVersion 存取数据的缓冲区,4字节的quadlet_t的数据,一般以16进制
	  显示(52,表示版本号为82)
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_get_FPGA_version (raw1394handle_t handle, nodeid_t node, 
									quadlet_t *nVersion);

/*
说  明:读取DSP版本信息
参  数:handle   1394卡句柄, 
	  node 	    摄像机节点.
	  nVersion 存取数据的缓冲区,4字节的quadlet_t的数据,一般以16进制
	  显示(如10203,表示版本号为1.23)
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_get_DSP_version (raw1394handle_t handle, nodeid_t node, 
									quadlet_t *nVersion);

/*
说  明:用户密码效验
参  数:handle   1394卡句柄, 
	  node     摄像机节点.
	  nVersion 存取数据的缓冲区,4字节的quadlet_t的数据.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_CheckUserPasswd(raw1394handle_t handle, nodeid_t node,
									quadlet_t* userpasswd);

/*
说  明:设置闪光灯极性
参  数:handle   1394卡句柄, 
	  node 	    摄像机节点.
	  polarity 1,闪光灯极性为高; polarity 0,闪光灯极性为低.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_set_strobe_polarity(raw1394handle_t handle, nodeid_t node,
									unsigned int polarity);
									
/*
说  明:读取闪光灯极性
参  数:handle   1394卡句柄, 
	  node 	    摄像机节点.
	  polarity 1,闪光灯极性为高; polarity 0,闪光灯极性为低.
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_get_strobe_polarity(raw1394handle_t handle, nodeid_t node,
									unsigned int *polarity);
									
									
/*
说  明:设置为软件触发模式
参  数:handle   1394卡句柄, 
	  node 	    摄像机节点.	  
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_set_soft_trigger(raw1394handle_t handle, nodeid_t node);

/*
说  明:清除软件触发模式
参  数:handle   1394卡句柄, 
	  node 	    摄像机节点.	  
返回值:正确返回DC1394_SUCCESS，错误返回DC1394_FAILURE.
*/
int
dc1394_daheng_unset_soft_trigger(raw1394handle_t handle, nodeid_t node);

#ifdef __cplusplus
}
#endif

#endif /* _DAHENG_ADD_DC1394_CAMERA_CONTROL_H */