| 147 |
Kevin |
1 |
#ifndef LUX_TSL2561_H
|
|
|
2 |
#define LUX_TSL2561_H
|
|
|
3 |
|
|
|
4 |
#define TSL2561_VISIBLE 2 // channel 0 - channel 1
|
|
|
5 |
#define TSL2561_INFRARED 1 // channel 1
|
|
|
6 |
#define TSL2561_FULLSPECTRUM 0 // channel 0
|
|
|
7 |
|
|
|
8 |
// 3 i2c address options!
|
|
|
9 |
#define TSL2561_ADDR_LOW 0x29
|
|
|
10 |
#define TSL2561_ADDR_FLOAT 0x39
|
|
|
11 |
#define TSL2561_ADDR_HIGH 0x49
|
|
|
12 |
|
|
|
13 |
// Lux calculations differ slightly for CS package
|
|
|
14 |
//#define TSL2561_PACKAGE_CS
|
|
|
15 |
#define TSL2561_PACKAGE_T_FN_CL
|
|
|
16 |
|
|
|
17 |
#define TSL2561_READBIT (0x01)
|
|
|
18 |
|
|
|
19 |
#define TSL2561_COMMAND_BIT (0x80) // Must be 1
|
|
|
20 |
#define TSL2561_CLEAR_BIT (0x40) // Clears any pending interrupt (write 1 to clear)
|
|
|
21 |
#define TSL2561_WORD_BIT (0x20) // 1 = read/write word (rather than byte)
|
|
|
22 |
#define TSL2561_BLOCK_BIT (0x10) // 1 = using block read/write
|
|
|
23 |
|
|
|
24 |
#define TSL2561_CONTROL_POWERON (0x03)
|
|
|
25 |
#define TSL2561_CONTROL_POWEROFF (0x00)
|
|
|
26 |
|
|
|
27 |
#define TSL2561_LUX_LUXSCALE (14) // Scale by 2^14
|
|
|
28 |
#define TSL2561_LUX_RATIOSCALE (9) // Scale ratio by 2^9
|
|
|
29 |
#define TSL2561_LUX_CHSCALE (10) // Scale channel values by 2^10
|
|
|
30 |
#define TSL2561_LUX_CHSCALE_TINT0 (0x7517) // 322/11 * 2^TSL2561_LUX_CHSCALE
|
|
|
31 |
#define TSL2561_LUX_CHSCALE_TINT1 (0x0FE7) // 322/81 * 2^TSL2561_LUX_CHSCALE
|
|
|
32 |
|
|
|
33 |
// T, FN and CL package values
|
|
|
34 |
#define TSL2561_LUX_K1T (0x0040) // 0.125 * 2^RATIO_SCALE
|
|
|
35 |
#define TSL2561_LUX_B1T (0x01f2) // 0.0304 * 2^LUX_SCALE
|
|
|
36 |
#define TSL2561_LUX_M1T (0x01be) // 0.0272 * 2^LUX_SCALE
|
|
|
37 |
#define TSL2561_LUX_K2T (0x0080) // 0.250 * 2^RATIO_SCALE
|
|
|
38 |
#define TSL2561_LUX_B2T (0x0214) // 0.0325 * 2^LUX_SCALE
|
|
|
39 |
#define TSL2561_LUX_M2T (0x02d1) // 0.0440 * 2^LUX_SCALE
|
|
|
40 |
#define TSL2561_LUX_K3T (0x00c0) // 0.375 * 2^RATIO_SCALE
|
|
|
41 |
#define TSL2561_LUX_B3T (0x023f) // 0.0351 * 2^LUX_SCALE
|
|
|
42 |
#define TSL2561_LUX_M3T (0x037b) // 0.0544 * 2^LUX_SCALE
|
|
|
43 |
#define TSL2561_LUX_K4T (0x0100) // 0.50 * 2^RATIO_SCALE
|
|
|
44 |
#define TSL2561_LUX_B4T (0x0270) // 0.0381 * 2^LUX_SCALE
|
|
|
45 |
#define TSL2561_LUX_M4T (0x03fe) // 0.0624 * 2^LUX_SCALE
|
|
|
46 |
#define TSL2561_LUX_K5T (0x0138) // 0.61 * 2^RATIO_SCALE
|
|
|
47 |
#define TSL2561_LUX_B5T (0x016f) // 0.0224 * 2^LUX_SCALE
|
|
|
48 |
#define TSL2561_LUX_M5T (0x01fc) // 0.0310 * 2^LUX_SCALE
|
|
|
49 |
#define TSL2561_LUX_K6T (0x019a) // 0.80 * 2^RATIO_SCALE
|
|
|
50 |
#define TSL2561_LUX_B6T (0x00d2) // 0.0128 * 2^LUX_SCALE
|
|
|
51 |
#define TSL2561_LUX_M6T (0x00fb) // 0.0153 * 2^LUX_SCALE
|
|
|
52 |
#define TSL2561_LUX_K7T (0x029a) // 1.3 * 2^RATIO_SCALE
|
|
|
53 |
#define TSL2561_LUX_B7T (0x0018) // 0.00146 * 2^LUX_SCALE
|
|
|
54 |
#define TSL2561_LUX_M7T (0x0012) // 0.00112 * 2^LUX_SCALE
|
|
|
55 |
#define TSL2561_LUX_K8T (0x029a) // 1.3 * 2^RATIO_SCALE
|
|
|
56 |
#define TSL2561_LUX_B8T (0x0000) // 0.000 * 2^LUX_SCALE
|
|
|
57 |
#define TSL2561_LUX_M8T (0x0000) // 0.000 * 2^LUX_SCALE
|
|
|
58 |
|
|
|
59 |
// CS package values
|
|
|
60 |
#define TSL2561_LUX_K1C (0x0043) // 0.130 * 2^RATIO_SCALE
|
|
|
61 |
#define TSL2561_LUX_B1C (0x0204) // 0.0315 * 2^LUX_SCALE
|
|
|
62 |
#define TSL2561_LUX_M1C (0x01ad) // 0.0262 * 2^LUX_SCALE
|
|
|
63 |
#define TSL2561_LUX_K2C (0x0085) // 0.260 * 2^RATIO_SCALE
|
|
|
64 |
#define TSL2561_LUX_B2C (0x0228) // 0.0337 * 2^LUX_SCALE
|
|
|
65 |
#define TSL2561_LUX_M2C (0x02c1) // 0.0430 * 2^LUX_SCALE
|
|
|
66 |
#define TSL2561_LUX_K3C (0x00c8) // 0.390 * 2^RATIO_SCALE
|
|
|
67 |
#define TSL2561_LUX_B3C (0x0253) // 0.0363 * 2^LUX_SCALE
|
|
|
68 |
#define TSL2561_LUX_M3C (0x0363) // 0.0529 * 2^LUX_SCALE
|
|
|
69 |
#define TSL2561_LUX_K4C (0x010a) // 0.520 * 2^RATIO_SCALE
|
|
|
70 |
#define TSL2561_LUX_B4C (0x0282) // 0.0392 * 2^LUX_SCALE
|
|
|
71 |
#define TSL2561_LUX_M4C (0x03df) // 0.0605 * 2^LUX_SCALE
|
|
|
72 |
#define TSL2561_LUX_K5C (0x014d) // 0.65 * 2^RATIO_SCALE
|
|
|
73 |
#define TSL2561_LUX_B5C (0x0177) // 0.0229 * 2^LUX_SCALE
|
|
|
74 |
#define TSL2561_LUX_M5C (0x01dd) // 0.0291 * 2^LUX_SCALE
|
|
|
75 |
#define TSL2561_LUX_K6C (0x019a) // 0.80 * 2^RATIO_SCALE
|
|
|
76 |
#define TSL2561_LUX_B6C (0x0101) // 0.0157 * 2^LUX_SCALE
|
|
|
77 |
#define TSL2561_LUX_M6C (0x0127) // 0.0180 * 2^LUX_SCALE
|
|
|
78 |
#define TSL2561_LUX_K7C (0x029a) // 1.3 * 2^RATIO_SCALE
|
|
|
79 |
#define TSL2561_LUX_B7C (0x0037) // 0.00338 * 2^LUX_SCALE
|
|
|
80 |
#define TSL2561_LUX_M7C (0x002b) // 0.00260 * 2^LUX_SCALE
|
|
|
81 |
#define TSL2561_LUX_K8C (0x029a) // 1.3 * 2^RATIO_SCALE
|
|
|
82 |
#define TSL2561_LUX_B8C (0x0000) // 0.000 * 2^LUX_SCALE
|
|
|
83 |
#define TSL2561_LUX_M8C (0x0000) // 0.000 * 2^LUX_SCALE
|
|
|
84 |
|
|
|
85 |
enum {
|
|
|
86 |
TSL2561_REGISTER_CONTROL = 0x00,
|
|
|
87 |
TSL2561_REGISTER_TIMING = 0x01,
|
|
|
88 |
TSL2561_REGISTER_THRESHHOLDL_LOW = 0x02,
|
|
|
89 |
TSL2561_REGISTER_THRESHHOLDL_HIGH = 0x03,
|
|
|
90 |
TSL2561_REGISTER_THRESHHOLDH_LOW = 0x04,
|
|
|
91 |
TSL2561_REGISTER_THRESHHOLDH_HIGH = 0x05,
|
|
|
92 |
TSL2561_REGISTER_INTERRUPT = 0x06,
|
|
|
93 |
TSL2561_REGISTER_CRC = 0x08,
|
|
|
94 |
TSL2561_REGISTER_ID = 0x0A,
|
|
|
95 |
TSL2561_REGISTER_CHAN0_LOW = 0x0C,
|
|
|
96 |
TSL2561_REGISTER_CHAN0_HIGH = 0x0D,
|
|
|
97 |
TSL2561_REGISTER_CHAN1_LOW = 0x0E,
|
|
|
98 |
TSL2561_REGISTER_CHAN1_HIGH = 0x0F
|
|
|
99 |
};
|
|
|
100 |
|
|
|
101 |
typedef enum {
|
|
|
102 |
TSL2561_INTEGRATIONTIME_13MS = 0x00, // 13.7ms
|
|
|
103 |
TSL2561_INTEGRATIONTIME_101MS = 0x01, // 101ms
|
|
|
104 |
TSL2561_INTEGRATIONTIME_402MS = 0x02 // 402ms
|
|
|
105 |
}
|
|
|
106 |
tsl2561IntegrationTime_t;
|
|
|
107 |
|
|
|
108 |
typedef enum {
|
|
|
109 |
TSL2561_GAIN_0X = 0x00, // No gain
|
|
|
110 |
TSL2561_GAIN_16X = 0x10 // 16x gain
|
|
|
111 |
}
|
|
|
112 |
tsl2561Gain_t;
|
|
|
113 |
|
|
|
114 |
typedef struct __TSL25611_DATA {
|
|
|
115 |
unsigned char address;
|
|
|
116 |
tsl2561IntegrationTime_t integration;
|
|
|
117 |
tsl2561Gain_t gain;
|
|
|
118 |
} TSL2561_DATA;
|
|
|
119 |
|
| 148 |
Kevin |
120 |
void LUX_Init(unsigned char address);
|
| 147 |
Kevin |
121 |
void LUX_Begin(void);
|
|
|
122 |
void LUX_Enable(void);
|
|
|
123 |
void LUX_Disable(void);
|
| 154 |
Kevin |
124 |
void LUX_Set_Timing(tsl2561IntegrationTime_t integration);
|
|
|
125 |
void LUX_Set_Gain(tsl2561Gain_t gain);
|
|
|
126 |
unsigned long LUX_Calculate_Lux(unsigned int ch0, unsigned int ch1);
|
|
|
127 |
unsigned long LUX_Get_Full_Luminosity(void);
|
|
|
128 |
unsigned int LUX_Get_Luminosity(unsigned char channel);
|
| 147 |
Kevin |
129 |
|
| 154 |
Kevin |
130 |
void LUX_Write_2_Bytes(unsigned char reg, unsigned char value);
|
|
|
131 |
unsigned int LUX_Read_2_Bytes(unsigned char reg);
|
| 148 |
Kevin |
132 |
|
| 147 |
Kevin |
133 |
#endif /* LUX_TSL2561_H */
|
|
|
134 |
|