Metadata-Version: 2.1
Name: pi_lightsensor_webthing
Version: 0.2.15
Summary: A web connected digital light sensor measuring the intensity of ambient light on Raspberry Pi
Home-page: https://github.com/grro/pi_lightsensor_webthing
Author: Gregor Roth
Author-email: gregor.roth@web.de
License: MIT
Description: # pi_lightsensor_webthing
        A web connected digital light sensor measuring the intensity of ambient light on Raspberry Pi
        
        This project provides a [webthing API](https://iot.mozilla.org/wot/) to a digital light sensor such as [BH1750](https://learn.adafruit.com/adafruit-bh1750-ambient-light-sensor). 
        Please consider to [activate I2C](https://learn.adafruit.com/adafruits-raspberry-pi-lesson-4-gpio-setup/configuring-i2c) on raspberry pi.
        
        The pi_lightsensor_webthing package exposes an http webthing endpoint which supports measuring the intensity of ambient light via http. E.g. 
        ```
        # webthing has been started on host 192.168.0.23
        
        curl http://192.168.0.23:9122/properties 
        
        {
           "brightness": 100
        }
        ```
        
        Regarding the RaspberryPi/digital light sensor hardware setup and wiring please refer tutorials mentioned above
        
        To install this software you may use [Docker](https://phoenixnap.com/kb/docker-on-raspberry-pi) or [PIP](https://realpython.com/what-is-pip/) package manager such as shown below
        
        **Docker approach**
        ```
        sudo docker run --privileged -p 9122:9122 grro/pi_lightsensor_webthing
        ```
        
        **PIP approach**
        ```
        sudo pip install pi_lightsensor_webthing
        ```
        
        After this installation you may start the webthing http endpoint inside your python code or via command line using
        ```
        sudo lightsensor --command listen --port 9122 
        ```
        Here, the webthing API will be bind to the local port 9122
        
        Alternatively to the *listen* command, you can use the *register* command to register and start the webthing service as systemd unit. 
        By doing this the webthing service will be started automatically on boot. Starting the server manually using the *listen* command is no longer necessary. 
        ```
        sudo lightsensor --command register --port 9122
        ```  
        
Keywords: webthings,home automation,digital,light,sensor,ambient,light,BH1750
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Description-Content-Type: text/markdown
