Skip to main content

Enviro pHAT Plus environmental monitoring add-on for Raspberry Pi

Project description

Enviro+

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

You are 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.

Note The code in this repository supports both the Enviro+ and Enviro Mini boards. The Enviro Mini board does not have the Gas sensor or the breakout for the PM sensor.

Enviro Plus pHAT Enviro Mini pHAT

:warning: This library now supports Python 3 only, Python 2 is EOL - https://www.python.org/doc/sunset-python-2/

Install and configure dependencies from GitHub:

  • git clone https://github.com/pimoroni/enviroplus-python
  • cd enviroplus-python
  • ./install.sh

Note Libraries will be installed in the "pimoroni" virtual environment, you will need to activate it to run examples:

source ~/.virtualenvs/pimoroni/bin/activate

Note Raspbian/Raspberry Pi OS Lite users may first need to install git: sudo apt install git

Or... Install from PyPi and configure manually:

  • python3 -m venv --system-site-packages $HOME/.virtualenvs/pimoroni
  • Run python3 -m pip install enviroplus

And install additional dependencies:

sudo apt install python3-numpy python3-smbus python3-pil python3-setuptools

Note this will not 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:

Bookworm

  • Enable serial: raspi-config nonint do_serial_hw 0
  • Disable serial terminal: raspi-config nonint do_serial_cons 1
  • Add dtoverlay=pi3-miniuart-bt to your /boot/config.txt

Bullseye

  • 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

Alternate Software & User Projects

Help & Support

1.0.2

  • README.md: Update install instructions
  • Fix installer to enable serial
  • Fix gas sensor heater pin

1.0.1

  • README.md: Fix images

1.0.0

  • BREAKING: Port to gpiod/gpiodevice for Pi 5/Bookworm.

0.0.6

  • Fix noise by specifying adau7002 device

0.0.5

  • Drop Python 2.x support
  • Add "available()" method for gas sensor

0.0.4

  • Add support for ads1015 >= v0.0.7 (ADS1115 ADCs)
  • Packaging tweaks

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

  • Initial Release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

enviroplus-1.0.2.tar.gz (125.7 kB view details)

Uploaded Source

Built Distribution

enviroplus-1.0.2-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file enviroplus-1.0.2.tar.gz.

File metadata

  • Download URL: enviroplus-1.0.2.tar.gz
  • Upload date:
  • Size: 125.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.2

File hashes

Hashes for enviroplus-1.0.2.tar.gz
Algorithm Hash digest
SHA256 c617098af8ad60d0429ca02e6c4fe989f7cd4486313c2b51a12d27bf8c45c2dd
MD5 5ff58433663ca2581c51a78001a76359
BLAKE2b-256 7f3e69d7bba671bbfc76d6e186357a86ca7657af1081c858fbc7ec39a52414f0

See more details on using hashes here.

File details

Details for the file enviroplus-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: enviroplus-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 10.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.2

File hashes

Hashes for enviroplus-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e3e862f08554f89183ea419c072b4a8647d69cc8dd256579453f4b38076edd04
MD5 d6570e2e474e39d5ef575175050e06e3
BLAKE2b-256 7fb8cc9474738a3441d2ee59c478deb173758a29893adaa25d98dd4e0e668778

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page