-
Notifications
You must be signed in to change notification settings - Fork 3
/
TCS34725.py
275 lines (241 loc) · 12.2 KB
/
TCS34725.py
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
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
# Here's a probably-not-very-good port of the Adafruit Arduino library for
# this sensor. The Adafruit library is located here:
# https://github.com/adafruit/Adafruit_TCS34725
# This port is for the Beaglebone Black and the Adafruit_BBIO and Adafruit_I2C
# libraries. By AKA MEDIA SYSTEM
from Adafruit_I2C import Adafruit_I2C
import time
class TCS34725():
TCS34725_ADDRESS = 0x29
TCS34725_COMMAND_BIT = 0x80
TCS34725_ENABLE = 0x00
TCS34725_ENABLE_AIEN = 0x10 # RGBC Interrupt Enable
TCS34725_ENABLE_WEN = 0x08 # Wait enable - Writing 1 activates the wait timer
TCS34725_ENABLE_AEN = 0x02 # RGBC Enable - Writing 1 actives the ADC, 0 disables it
TCS34725_ENABLE_PON = 0x01 # Power on - Writing 1 activates the internal oscillator, 0 disables it
TCS34725_ATIME = 0x01 # Integration time
TCS34725_WTIME = 0x03 # Wait time (if TCS34725_ENABLE_WEN is asserted
TCS34725_WTIME_2_4MS = 0xFF # WLONG0 = 2.4ms WLONG1 = 0.029s
TCS34725_WTIME_204MS = 0xAB # WLONG0 = 204ms WLONG1 = 2.45s
TCS34725_WTIME_614MS = 0x00 # WLONG0 = 614ms WLONG1 = 7.4s
TCS34725_AILTL = 0x04 # Clear channel lower interrupt threshold
TCS34725_AILTH = 0x05
TCS34725_AIHTL = 0x06 # Clear channel upper interrupt threshold
TCS34725_AIHTH = 0x07
TCS34725_PERS = 0x0C # Persistence register - basic SW filtering mechanism for interrupts
TCS34725_PERS_NONE = 0b0000 # Every RGBC cycle generates an interrupt
TCS34725_PERS_1_CYCLE = 0b0001 # 1 clean channel value outside threshold range generates an interrupt
TCS34725_PERS_2_CYCLE = 0b0010 # 2 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_3_CYCLE = 0b0011 # 3 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_5_CYCLE = 0b0100 # 5 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_10_CYCLE = 0b0101 # 10 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_15_CYCLE = 0b0110 # 15 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_20_CYCLE = 0b0111 # 20 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_25_CYCLE = 0b1000 # 25 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_30_CYCLE = 0b1001 # 30 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_35_CYCLE = 0b1010 # 35 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_40_CYCLE = 0b1011 # 40 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_45_CYCLE = 0b1100 # 45 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_50_CYCLE = 0b1101 # 50 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_55_CYCLE = 0b1110 # 55 clean channel values outside threshold range generates an interrupt
TCS34725_PERS_60_CYCLE = 0b1111 # 60 clean channel values outside threshold range generates an interrupt
TCS34725_CONFIG = 0x0D
TCS34725_CONFIG_WLONG = 0x02 # Choose between short and long (12x wait times via TCS34725_WTIME
TCS34725_CONTROL = 0x0F # Set the gain level for the sensor
TCS34725_ID = 0x12 # 0x44 = TCS34721/TCS34725, 0x4D = TCS34723/TCS34727
TCS34725_STATUS = 0x13
TCS34725_STATUS_AINT = 0x10 # RGBC Clean channel interrupt
TCS34725_STATUS_AVALID = 0x01 # Indicates that the RGBC channels have completed an integration cycle
TCS34725_CDATAL = 0x14 # Clear channel data
TCS34725_CDATAH = 0x15
TCS34725_RDATAL = 0x16 # Red channel data
TCS34725_RDATAH = 0x17
TCS34725_GDATAL = 0x18 # Green channel data
TCS34725_GDATAH = 0x19
TCS34725_BDATAL = 0x1A # Blue channel data
TCS34725_BDATAH = 0x1B
# TCS34725_INTEGRATIONTIME_2_4MS = 0xFF, /**< 2.4ms - 1 cycle - Max Count: 1024
# TCS34725_INTEGRATIONTIME_24MS = 0xF6, /**< 24ms - 10 cycles - Max Count: 10240
# TCS34725_INTEGRATIONTIME_50MS = 0xEB, /**< 50ms - 20 cycles - Max Count: 20480
# TCS34725_INTEGRATIONTIME_101MS = 0xD5, /**< 101ms - 42 cycles - Max Count: 43008
# TCS34725_INTEGRATIONTIME_154MS = 0xC0, /**< 154ms - 64 cycles - Max Count: 65535
# TCS34725_INTEGRATIONTIME_700MS = 0x00 /**< 700ms - 256 cycles - Max Count: 65535
_tcs34725Initialised = False
_tcs34725Gain = 0
_tcs34725IntegrationTime = 0x00
def __init__(self, *args, **kwargs):
self.i2c = Adafruit_I2C(self.TCS34725_ADDRESS)
def write8(self, reg, val):
self.i2c.write8(self.TCS34725_COMMAND_BIT | reg, val & 0xFF)
def read16(self, reg):
return self.i2c.readU16Rev(self.TCS34725_COMMAND_BIT | reg)
def read8(self, reg):
return self.i2c.readU8(self.TCS34725_COMMAND_BIT | reg)
def begin(self):
x = self.read8(self.TCS34725_ID)
if x != 0x44: # code I was basing this on expects 0x44, not sure why. Got 0x12
print 'did not get the expected response from sensor: ', x
return False
self._tcs34725Initialised = True
self.setIntegrationTime(self._tcs34725IntegrationTime)
self.setGain(0)
self.enable()
return True
def enable(self):
self.write8(self.TCS34725_ENABLE, self.TCS34725_ENABLE_PON)
time.sleep(0.003)
self.write8(self.TCS34725_ENABLE, (self.TCS34725_ENABLE_PON | self.TCS34725_ENABLE_AEN))
def disable(self):
reg = 0
reg = self.i2c.readU8(self.TCS34725_COMMAND_BIT | self.TCS34725_ENABLE)
self.write8(self.TCS34725_ENABLE, (reg & ~(self.TCS34725_ENABLE_PON | self.TCS34725_ENABLE_AEN)))
def setIntegrationTime(self, theTime):
if theTime not in [0xFF,0xF6,0xEB,0xD5,0xC0,0x00]:
print 'setting integration time to 0x00, %s is illegal' % theTime
theTime = 0x00
self.write8(self.TCS34725_ATIME, theTime)
# self.i2c.write8(self.TCS34725_ATIME, theTime)
self._tcs34725IntegrationTime = theTime
def setGain(self, gain):
# TCS34725_GAIN_1X = 0x00, /**< No gain
# TCS34725_GAIN_4X = 0x01, /**< 2x gain
# TCS34725_GAIN_16X = 0x02, /**< 16x gain
# TCS34725_GAIN_60X = 0x03 /**< 60x gain
if gain not in [0,1,2,3]:
print 'setting gain to 0, %s is illegal' % gain
gain = 0
self.write8(self.TCS34725_CONTROL, gain)
self._tcs34725Gain = gain
def getStatus(self):
return self.i2c.readU8(self.TCS34725_COMMAND_BIT | self.TCS34725_STATUS)
def getRawData(self):
c = self.read16(self.TCS34725_CDATAL)
r = self.read16(self.TCS34725_RDATAL)
g = self.read16(self.TCS34725_GDATAL)
b = self.read16(self.TCS34725_BDATAL)
if self._tcs34725IntegrationTime == 0xFF:
time.sleep(0.0024)
elif self._tcs34725IntegrationTime == 0xF6:
time.sleep(0.024)
elif self._tcs34725IntegrationTime == 0xEB:
time.sleep(0.050)
elif self._tcs34725IntegrationTime == 0xD5:
time.sleep(0.101)
elif self._tcs34725IntegrationTime == 0xC0:
time.sleep(0.154)
elif self._tcs34725IntegrationTime == 0x00:
time.sleep(0.700)
else:
time.sleep(0.700)
return c, r, g, b
def getRawRGBData(self):
r = self.read16(self.TCS34725_RDATAL)
g = self.read16(self.TCS34725_GDATAL)
b = self.read16(self.TCS34725_BDATAL)
if self._tcs34725IntegrationTime == 0xFF:
time.sleep(0.0024)
elif self._tcs34725IntegrationTime == 0xF6:
time.sleep(0.024)
elif self._tcs34725IntegrationTime == 0xEB:
time.sleep(0.050)
elif self._tcs34725IntegrationTime == 0xD5:
time.sleep(0.101)
elif self._tcs34725IntegrationTime == 0xC0:
time.sleep(0.154)
elif self._tcs34725IntegrationTime == 0x00:
time.sleep(0.700)
else:
time.sleep(0.700)
return r, g, b
def getRGBData(self):
c = self.read16(self.TCS34725_CDATAL)
r = self.read16(self.TCS34725_RDATAL)
g = self.read16(self.TCS34725_GDATAL)
b = self.read16(self.TCS34725_BDATAL)
sumL = r+g+b
print 'sumL is ',sumL
# r = self.mapVals(r,0,sumL,0,255)
# g = self.mapVals(g,0,sumL,0,255)
# b = self.mapVals(b,0,sumL,0,255)
r = int(256*(r/float(sumL)))
g = int(256*(g/float(sumL)))
b = int(256*(b/float(sumL)))
if self._tcs34725IntegrationTime == 0xFF:
time.sleep(0.0024)
elif self._tcs34725IntegrationTime == 0xF6:
time.sleep(0.024)
elif self._tcs34725IntegrationTime == 0xEB:
time.sleep(0.050)
elif self._tcs34725IntegrationTime == 0xD5:
time.sleep(0.101)
elif self._tcs34725IntegrationTime == 0xC0:
time.sleep(0.154)
elif self._tcs34725IntegrationTime == 0x00:
time.sleep(0.700)
else:
time.sleep(0.700)
return c, r, g, b
def getWebColors(self, maximum):
# convenience function that doesn't work well
# the "maximum" parameter should be the max observed value for each channel
# which is a pain to calibrate manually, so this prob isn't useful
r = self.read16(self.TCS34725_RDATAL)
g = self.read16(self.TCS34725_GDATAL)
b = self.read16(self.TCS34725_BDATAL)
if self._tcs34725IntegrationTime == 0xFF:
time.sleep(0.0024)
elif self._tcs34725IntegrationTime == 0xF6:
time.sleep(0.024)
elif self._tcs34725IntegrationTime == 0xEB:
time.sleep(0.050)
elif self._tcs34725IntegrationTime == 0xD5:
time.sleep(0.101)
elif self._tcs34725IntegrationTime == 0xC0:
time.sleep(0.154)
elif self._tcs34725IntegrationTime == 0x00:
time.sleep(0.700)
else:
time.sleep(0.700)
r = int(self.mapVals(r,0,maximum,0,255))
g = int(self.mapVals(g,0,maximum,0,255))
b = int(self.mapVals(b,0,maximum,0,255))
return r, g, b
def mapVals(self, val, inMin, inMax, outMin, outMax):
toRet = outMin + (outMax - outMin) * ((val - inMin) / (inMax - inMin))
return self.clamp(toRet, outMin, outMax)
def clamp(self, val, min, max):
if (val < min):
val = min
if (val > max):
val = max
return val
def calculateColorTemperature(self, r, g, b):
# this is all from the Adafruit C library
# 1. Map RGB values to their XYZ counterparts.
# Based on 6500K fluorescent, 3000K fluorescent
# and 60W incandescent values for a wide range.
# Note: Y = Illuminance or lux
X = (-0.14282 * r) + (1.54924 * g) + (-0.95641 * b);
Y = (-0.32466 * r) + (1.57837 * g) + (-0.73191 * b);
Z = (-0.68202 * r) + (0.77073 * g) + ( 0.56332 * b);
# 2. Calculate the chromaticity co-ordinates
xc = (X) / (X + Y + Z);
yc = (Y) / (X + Y + Z);
# 3. Use McCamy's formula to determine the CCT
n = (xc - 0.3320) / (0.1858 - yc);
# Calculate the final CCT
cct = (449.0 * pow(n, 3)) + (3525.0 * pow(n, 2)) + (6823.3 * n) + 5520.33;
return cct
def calculateLux(self, r, g, b):
return ((-0.32466 * r) + (1.57837 * g) + (-0.73191 * b))
def setInterrupt(self, theBool):
r = self.read8(self.TCS34725_ENABLE)
if theBool:
r |= self.TCS34725_ENABLE_AIEN
else:
r &= ~self.TCS34725_ENABLE_AIEN
self.write8(self.TCS34725_ENABLE, r)
def clearInterrupt(self):
self.write8(self.TCS34725_ADDRESS, 0x66)
def setInterruptLimits(self, lo, hi):
pass