Metadata-Version: 2.1
Name: python-tsl2591
Version: 0.1.5
Summary: Community-coded Python module for TSL2591 sensor converted from Adafruit's TSL2591 library. Use at your own risk.
Home-page: http://github.com/kyletaylored/python-tsl2591
Author: Max Hofbauer
Author-email: maxhofb@gmail.com
License: MIT license
Description: 
        # TSL2591 Python Library
        
        [![GitHub stars](https://img.shields.io/github/stars/kyletaylored/python-tsl2591.svg)](https://github.com/kyletaylored/python-tsl2591/stargazers)
        [![GitHub forks](https://img.shields.io/github/forks/kyletaylored/python-tsl2591.svg)](https://github.com/kyletaylored/python-tsl2591/network)
        [![GitHub issues](https://img.shields.io/github/issues/kyletaylored/python-tsl2591.svg)](https://github.com/kyletaylored/python-tsl2591/issues)
        [![Inspired by Adafruit](https://img.shields.io/badge/Inspired%20by-adafruit-blue.svg)](https://gitgud.io/adafruit/Adafruit_TSL2591_Library)
        [![Travis CI](https://img.shields.io/travis/kyletaylored/python_tsl2591.svg)](https://travis-ci.org/kyletaylored/python_tsl2591)
        
        This is a simple python library for the Adafruit TSL2591 breakout board based on the [Arduino library](https://github.com/adafruit/Adafruit_TSL2591_Library) from Adafruit. It was developed to work on a Raspberry PI.
        
        ## Installation
        
        This module can be installed using pip (and can find a copy of this module on [PyPi](https://pypi.org/project/tsl2591/)).
        
        ```bash
        pip install python-tsl2591
        ```
        
        ### Step 1: Enable I2C
        
        You can enable I2C on the Raspberry Pi by following the instructions on [Adafruit](https://learn.adafruit.com/adafruits-raspberry-pi-lesson-4-gpio-setup/configuring-i2c).
        
        The quick version is:
        
        1. Run `sudo raspi-config`
        2. Select `Advanced Options`
        3. Enable I2C
        4. Reboot (`sudo reboot`)
        
        When testing I2C (`sudo i2cdetect -y 1`), you should see at least one connected device, your TSL2591 at `0x29`. For more information, see the [FAQ](#i2c-check-for-static-address).
        
        ### Step 2: Install System dependencies
        
        Prior to using this library, you will need the following packages installed on your Raspberry Pi.
        
        ```bash
        sudo apt-get install python3-dev python3-smbus libffi-dev libssl-dev
        ```
        
        ### Step 3: Install Python dependencies
        
        To install the Python module, download this repository and run:
        
        ```
        python setup.py install
        ```
        
        ## Quickstart
        
        ```
        from python_tsl2591 import tsl2591
        
        tsl = tsl2591()  # initialize
        full, ir = tsl.get_full_luminosity()  # read raw values (full spectrum and ir spectrum)
        lux = tsl.calculate_lux(full, ir)  # convert raw values to lux
        print lux, full, ir
        ```
        
        ## FAQ
        
        ### Fatal error
        
        If you do not have those Raspbian packages installed prior to installing this library, you will run into errors that look similar to this.
        
        ```
        fatal error: ffi.h: No such file or directory
             #include <ffi.h>
                             ^
        compilation terminated.
        error: command 'arm-linux-gnueabihf-gcc' failed with exit status 1
        ```
        
        ### I2C Check for Static Address
        
        Because the TSL2591 connects via I2C, it's always good to run the I2C detection to verify the address is being read. Unlike the TSL2561 with programmable addresses, the TSL2591's address is hard coded and cannot be changed - thus it will always show `0x29`.
        
        In the example output below, you can see there are two I2C devices detected, one being the TSL2591.
        
        ```
        pi@raspberrypi:~ $ sudo i2cdetect -y 1
             0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
        00:          -- -- -- -- -- -- -- -- -- -- -- -- --
        10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
        20: -- -- -- -- -- -- -- -- -- 29 -- -- -- -- -- --
        30: -- -- -- -- -- -- -- -- -- -- -- -- 3c -- -- --
        40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
        50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
        60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
        70: -- -- -- -- -- -- -- --
        ```
        
        ## License
        
        Python files in this repository are released under the [MIT license](LICENSE.md).
        
Keywords: python_tsl2591,tsl2591,light sensor,adafruit
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: POSIX :: Linux
Description-Content-Type: text/markdown
