1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
|
/*
Copyright (c) 2002 Finger Lakes Instrumentation (FLI), L.L.C.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials
provided with the distribution.
Neither the name of Finger Lakes Instrumentation (FLI), LLC
nor the names of its contributors may be used to endorse or
promote products derived from this software without specific
prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
======================================================================
Finger Lakes Instrumentation, L.L.C. (FLI)
web: http://www.fli-cam.com
email: support@fli-cam.com
*/
#ifndef _LIBFLI_LIBFLI_H_
#define _LIBFLI_LIBFLI_H_
#include <string.h>
#ifdef WIN32
#define LIBFLIAPI __declspec(dllexport) long __stdcall
#endif
#include "libfli.h"
#include "libfli-sys.h"
#include "libfli-debug.h"
#define __STRINGIFY(x) ___STRINGIFY(x)
#define ___STRINGIFY(x) #x
#define __LIBFLIVER_MAJOR__ 1
#define __LIBFLIVER__ __STRINGIFY(__LIBFLIVER_MAJOR__) "." \
__STRINGIFY(__LIBFLI_MINOR__)
#define CHKDEVICE(xdev) \
do { \
if((xdev < 0) || (xdev >= MAX_OPEN_DEVICES)) \
{ \
debug(FLIDEBUG_WARN, \
"Attempt to use a device out of range (%d)", xdev); \
return -EINVAL; \
} \
if(devices[xdev] == NULL) \
{ \
debug(FLIDEBUG_WARN, \
"Attempt to use a NULL device (%d)", xdev); \
return -EINVAL; \
} \
} while(0)
#define CHKFUNCTION(func) \
do { \
if(func == NULL) \
{ \
debug(FLIDEBUG_WARN, \
"Attempt to use a NULL function (" #func ")"); \
return -EINVAL; \
} \
} while(0)
#define IO(dev, buf, wlen, rlen) \
do { \
int err; \
if((err = devices[dev]->fli_io(dev, buf, wlen, rlen))) \
{ \
debug(FLIDEBUG_WARN, "Communication error: %d [%s]", \
err, strerror(-err)); \
return err; \
} \
} while(0)
#define COMMAND(function) \
do { \
int err; \
if((err = function)) \
{ \
debug(FLIDEBUG_WARN, \
"Function `" #function "' failed, error: %d [%s]", \
err, strerror(-err)); \
return err; \
} \
} while(0)
#define FLIUSB_VENDORID 0xf18
#define FLIUSB_CAM_ID 0x02
#define FLIUSB_FILTER_ID 0x07
#define FLIUSB_FOCUSER_ID 0x06
#define MAX_OPEN_DEVICES (32)
#define MAX_SEARCH_LIST (16)
/* Common device information */
typedef struct {
long type;
long fwrev;
long hwrev;
long devid;
long serno;
char *model;
char *devnam;
} flidevinfo_t;
/* A specific device instance */
typedef struct {
char *name; /* The device name */
long domain; /* The device's domain */
flidevinfo_t devinfo; /* Device information */
long io_timeout; /* Timeout in msec for all I/O */
void *io_data; /* For holding I/O specific data */
void *device_data; /* For holding device specific data */
void *sys_data; /* For holding system specific data */
/* System-specific functions */
long (*fli_lock)(flidev_t dev);
long (*fli_unlock)(flidev_t dev);
/* Domain-specific functions */
long (*fli_io)(flidev_t dev, void *buf, long *wlen, long *rlen);
/* Device-specific functions */
long (*fli_open)(flidev_t dev);
long (*fli_close)(flidev_t dev);
long (*fli_command)(flidev_t dev, int cmd, int argc, ...);
} flidevdesc_t;
extern const char* version;
extern flidevdesc_t *devices[MAX_OPEN_DEVICES];
#define DEVICE devices[dev]
/* Device commands, the format is FLI_COMMAND(<command name>, <number of args>) */
#define FLI_COMMANDS \
FLI_COMMAND(FLI_NONE, 0) \
FLI_COMMAND(FLI_GET_PIXEL_SIZE, 2) \
FLI_COMMAND(FLI_GET_ARRAY_AREA, 4) \
FLI_COMMAND(FLI_GET_VISIBLE_AREA, 4) \
FLI_COMMAND(FLI_SET_EXPOSURE_TIME, 1) \
FLI_COMMAND(FLI_SET_IMAGE_AREA, 4) \
FLI_COMMAND(FLI_SET_HBIN, 1) \
FLI_COMMAND(FLI_SET_VBIN, 1) \
FLI_COMMAND(FLI_SET_FRAME_TYPE, 1) \
FLI_COMMAND(FLI_CANCEL_EXPOSURE, 0) \
FLI_COMMAND(FLI_GET_EXPOSURE_STATUS, 1) \
FLI_COMMAND(FLI_SET_TEMPERATURE, 1) \
FLI_COMMAND(FLI_GET_TEMPERATURE, 1) \
FLI_COMMAND(FLI_GRAB_ROW, 2) \
FLI_COMMAND(FLI_EXPOSE_FRAME, 0) \
FLI_COMMAND(FLI_FLUSH_ROWS, 2) \
FLI_COMMAND(FLI_SET_FLUSHES, 1) \
FLI_COMMAND(FLI_SET_BIT_DEPTH, 1) \
FLI_COMMAND(FLI_READ_IOPORT, 1) \
FLI_COMMAND(FLI_WRITE_IOPORT, 1) \
FLI_COMMAND(FLI_CONFIGURE_IOPORT, 1) \
FLI_COMMAND(FLI_CONTROL_SHUTTER, 1) \
FLI_COMMAND(FLI_CONTROL_BGFLUSH, 1) \
FLI_COMMAND(FLI_SET_FILTER_POS, 1) \
FLI_COMMAND(FLI_GET_FILTER_POS, 1) \
FLI_COMMAND(FLI_GET_FILTER_COUNT, 1) \
FLI_COMMAND(FLI_STEP_MOTOR, 1) \
FLI_COMMAND(FLI_GET_STEPPER_POS, 1) \
FLI_COMMAND(FLI_HOME_FOCUSER, 0)
/* Enumerate the commands */
enum {
#define FLI_COMMAND(name, args) name,
FLI_COMMANDS
#undef FLI_COMMAND
};
#endif /* _LIBFLI_LIBFLI_H_ */
|
