X-Git-Url: https://zdv2.bktei.com/gitweb/EVA-2020-02-2.git/blobdiff_plain/ab1eb580b3cf5e9d068d883c42088863a880d021..f19fbc14e48c967e377e9557e85806336c3b0363:/library/README.rst diff --git a/library/README.rst b/library/README.rst index f90e072..bd74b9d 100644 --- a/library/README.rst +++ b/library/README.rst @@ -1,29 +1,92 @@ -Enviro+ pHAT -============ +Enviro+ +======= -`Build Status `__ -`Coverage -Status `__ -`PyPi Package `__ `Python -Versions `__ +Designed for environmental monitoring, Enviro+ lets you measure air +quality (pollutant gases and particulates), temperature, pressure, +humidity, light, and noise level. Learn more - +https://shop.pimoroni.com/products/enviro-plus + +|Build Status| |Coverage Status| |PyPi Package| |Python Versions| Installing ========== -Stable library from PyPi: +You're best using the "One-line" install method if you want all of the +UART serial configuration for the PMS5003 particulate matter sensor to +run automatically. + +One-line (Installs from GitHub) +------------------------------- + +:: -- Just run ``sudo pip install enviroplus`` + curl -sSL https://get.pimoroni.com/enviroplus | bash -(**Note** that you’re best using the git clone / install.sh method below -if you want all of the UART serial configuration for the PMS5003 -particulate matter sensor to run automatically) +**Note** report issues with one-line installer here: +https://github.com/pimoroni/get -Latest/development library from GitHub: +Or... Install and configure dependencies from GitHub: +----------------------------------------------------- - ``git clone https://github.com/pimoroni/enviroplus-python`` - ``cd enviroplus-python`` - ``sudo ./install.sh`` +**Note** Raspbian Lite users may first need to install git: +``sudo apt install git`` + +Or... Install from PyPi and configure manually: +----------------------------------------------- + +- Run ``sudo pip install enviroplus`` + +**Note** this wont perform any of the required configuration changes on +your Pi, you may additionally need to: + +- Enable i2c: ``raspi-config nonint do_i2c 0`` +- Enable SPI: ``raspi-config nonint do_spi 0`` + +And if you're using a PMS5003 sensor you will need to: + +- Enable serial: + ``raspi-config nonint set_config_var enable_uart 1 /boot/config.txt`` +- Disable serial terminal: ``sudo raspi-config nonint do_serial 1`` +- Add ``dtoverlay=pi3-miniuart-bt`` to your ``/boot/config.txt`` + +And install additional dependencies: + +:: + + sudo apt install python-numpy python-smbus python-pil python-setuptools + +Help & Support +-------------- + +- GPIO Pinout - https://pinout.xyz/pinout/enviro\_plus +- Support forums - http://forums.pimoroni.com/c/support +- Discord - https://discord.gg/hr93ByC + +.. |Build Status| image:: https://travis-ci.com/pimoroni/enviroplus-python.svg?branch=master + :target: https://travis-ci.com/pimoroni/enviroplus-python +.. |Coverage Status| image:: https://coveralls.io/repos/github/pimoroni/enviroplus-python/badge.svg?branch=master + :target: https://coveralls.io/github/pimoroni/enviroplus-python?branch=master +.. |PyPi Package| image:: https://img.shields.io/pypi/v/enviroplus.svg + :target: https://pypi.python.org/pypi/enviroplus +.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/enviroplus.svg + :target: https://pypi.python.org/pypi/enviroplus + +0.0.3 +----- + +* Fix "self.noise_floor" bug in get_noise_profile + +0.0.2 +----- + +* Add support for extra ADC channel in Gas +* Handle breaking change in new ltr559 library +* Add Noise functionality + 0.0.1 -----