docs

Author: caternuson

README.rst

@@ -10,7 +10,7 @@ Introduction
     :target: https://gitter.im/adafruit/circuitpython?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge
     :alt: Gitter
 
-TODO
+CircuitPython driver for TSL2561 Light Sensor.
 
 Dependencies
 =============
@@ -26,7 +26,13 @@ This is easily achieved by downloading
 Usage Example
 =============
 
-TODO
+.. code-block:: python
+
+    >>> import adafruit_tsl2561
+    >>> tsl = adafruit_tsl2561.TSL2561()
+    >>> tsl.enabled = True
+    >>> tsl.light
+    3294.37
 
 Contributing
 ============

adafruit_tsl2561.py

@@ -44,6 +44,7 @@
 
 TSL2561_GAIN_SCALE = (16, 1)
 TSL2561_TIME_SCALE = (1 / 0.034, 1 / 0.252, 1)
+TSL2561_CLIP_THRESHOLD = (4900, 37000, 65000)
 
 class TSL2561():
     """Class which provides interface to TSL2561 light sensor."""
@@ -67,7 +68,7 @@ def id(self):
     @property
     def enabled(self):
         """The state of the sensor."""
-        return self._read_register(TSL2561_REGISTER_CONTROL) & 0x03
+        return bool(self._read_register(TSL2561_REGISTER_CONTROL) & 0x03)
 
     @enabled.setter
     def enabled(self, enable):
@@ -134,6 +135,8 @@ def _compute_lux(self):
         """Based on datasheet for FN package."""
         ch0, ch1 = self.luminosity
         if ch0 == 0: return 0
+        if ch0 > TSL2561_CLIP_THRESHOLD[self.integration_time]: return 0
+        if ch1 > TSL2561_CLIP_THRESHOLD[self.integration_time]: return 0
         ratio = ch1 / ch0
         if ratio > 0 and ratio <= 0.50:
             lux = 0.0304 * ch0 - 0.062 * ch0 * ratio**1.4