blob: a2787777655d822d150bd396191cd47eed74b76c (
plain)
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
|
#ifndef EX1_H
/*
* Argyll Color Correction System
*
* Image Engineering EX1
*
* Author: Graeme W. Gill
* Date: 4/4/2015
*
* Copyright 2001 - 2015, Graeme W. Gill
* All rights reserved.
*
* This material is licenced under the GNU GENERAL PUBLIC LICENSE Version 2 or later :-
* see the License2.txt file for licencing details.
*
* Based on spebos.h
*/
/*
If you make use of the instrument driver code here, please note
that it is the author(s) of the code who take responsibility
for its operation. Any problems or queries regarding driving
instruments with the Argyll drivers, should be directed to
the Argyll's author(s), and not to any other party.
If there is some instrument feature or function that you
would like supported here, it is recommended that you
contact Argyll's author(s) first, rather than attempt to
modify the software yourself, if you don't have firm knowledge
of the instrument communicate protocols. There is a chance
that an instrument could be damaged by an incautious command
sequence, and the instrument companies generally cannot and
will not support developers that they have not qualified
and agreed to support.
*/
#include "inst.h"
#ifdef __cplusplus
extern "C" {
#endif
/* Communication errors */
#define EX1_TIMEOUT 0xFF02 /* Communication timeout */
#define EX1_COMS_FAIL 0xFF03 /* Communication failure */
#define EX1_UNKNOWN_MODEL 0xFF04 /* Not an ex1 */
#define EX1_SHORT_WRITE 0xFF06 /* Write failure */
#define EX1_SHORT_READ 0xFF07 /* Read failure */
#define EX1_LONG_READ 0xFF08 /* Read more data than expected */
#define EX1_DATA_CHSUM_ERROR 0xFF09 /* Checksum failed */
#define EX1_DATA_PARSE_ERROR 0xFF0A /* Read data parsing error */
/* Measurement errors */
#define EX1_RD_SENSORSATURATED 0xFF0B /* Sensor is saturated */
/* Internal software errors */
#define EX1_INTERNAL_ERROR 0xE000 /* Internal software error */
#define EX1_NOT_IMP 0xE001 /* Function not implemented */
#define EX1_MEMORY 0xE002 /* Memory allocation fail */
#define EX1_INT_THREADFAILED 0xE003
#define EX1_INTTIME_RANGE 0xE004 /* Integration time is out of range */
#define EX1_DELTIME_RANGE 0xE005 /* Trigger Delaty time time is out of range */
#define EX1_STROBE_RANGE 0xE006 /* Strobe period time is out of range */
#define EX1_AVERAGE_RANGE 0xE007 /* Number to average is out of range */
#define EX1_BOXCAR_RANGE 0xE008 /* Boxcar filtering size out of ange */
#define EX1_INT_CAL_SAVE 0xE009 /* Saving calibration to file failed */
#define EX1_INT_CAL_RESTORE 0xE00A /* Restoring calibration to file failed */
#define EX1_INT_CAL_TOUCH 0xE00B /* Touching calibration to file failed */
#define EX1_INT_CIECONVFAIL 0xE00C /* Creating spec. to XYZ conversion failed */
/* Configuration or operation errors */
#define EX1_NO_WL_CAL 0xD001 /* There is no wavelegth calibration info */
#define EX1_NO_IR_CAL 0xD002 /* There is no irradiance calibration info */
/* Real instrument error code */
#define EX1_OK 0
#define EX1_UNSUP_PROTOCOL 1
#define EX1_MES_UNKN 2
#define EX1_MES_BAD_CHSUM 3
#define EX1_MES_TOO_LARGE 4
#define EX1_MES_PAYLD_LEN 5
#define EX1_MES_PAYLD_INV 6
#define EX1_DEV_NOT_RDY 7
#define EX1_MES_UNK_CHSUM 8
#define EX1_DEV_UNX_RST 9
#define EX1_TOO_MANY_BUSSES 10
#define EX1_OUT_OF_MEM 11
#define EX1_NO_INF 12
#define EX1_DEV_INT_ERR 13
#define EX1_DECRYPT_ERR 100
#define EX1_FIRM_LAYOUT 101
#define EX1_PACKET_SIZE 102
#define EX1_HW_REV_INCPT 103
#define EX1_FLASH_MAP 104
#define EX1_DEFERRED 255
/* EX1 communication object */
struct _ex1 {
INST_OBJ_BASE
ORD8 *cbuf; /* USB communication buffer */
int cbufsz; /* Current cbuf size */
char *alias; /* Alias string (OEM Model ?) */
int hwrev; /* Hardware rev number */
int fwrev; /* Hardware rev number */
char *serno; /* ASCII serial number */
int slitw; /* Slit width in microns */
int fiberw; /* Fiber width in microns */
char *grating; /* Grating description */
char *filter; /* Filter description */
char *coating; /* Coating description */
inst_mode mode; /* Currently instrument mode */
double max_meastime; /* Maximum integration time to use for measurement */
double inttime; /* Current integration time */
int noaverage; /* Current number being averaged */
rspec_inf sconf; /* Measurement & spectral configuration */
/* Don't know what to do with stray light - not present in EX1 ? */
unsigned int nstraylight; /* Number in array */
double *straylight; /* Array of stray light coefficients. */
unsigned int nemis_coef; /* Number in array */
double *emis_coef; /* Emission calibration coefficients for raw */
double emis_area; /* Emission collection area */
/* Adaptive emission black calibration */
int idark_valid; /* idark calibration factors valid */
time_t iddate; /* Date/time of last dark idark calibration */
double idark_int_time[2]; /* Target dark integration times */
/* Other state */
inst_opt_type trig; /* Reading trigger mode */
int want_dcalib; /* Want Dark Calibration at start */
int noinitcalib; /* Disable initial calibration if not essential */
int lo_secs; /* Seconds since last opened (from calibration file mod time) */
xsp2cie *conv; /* spectral to XYZ conversion */
}; typedef struct _ex1 ex1;
/* Constructor */
extern ex1 *new_ex1(icoms *icom, instType itype);
#ifdef __cplusplus
}
#endif
#define EX1_H
#endif /* EX1_H */
|
