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
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.
: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
- Enviro Plus Dashboard - https://gitlab.com/dedSyn4ps3/enviroplus-dashboard - A React-based web dashboard for viewing sensor data
- Enviro+ Example Projects - https://gitlab.com/dedSyn4ps3/enviroplus-python-projects - Includes original examples plus code to stream to Adafruit IO (more projects coming soon)
- enviro monitor - https://github.com/roscoe81/enviro-monitor
- mqtt-all - https://github.com/robmarkcole/rpi-enviro-mqtt - now upstream: see examples/mqtt-all.py
- enviroplus_exporter - https://github.com/tijmenvandenbrink/enviroplus_exporter - Prometheus exporter (with added support for Luftdaten and InfluxDB Cloud)
- homekit-enviroplus - https://github.com/sighmon/homekit-enviroplus - An Apple HomeKit accessory for the Pimoroni Enviro+
- go-enviroplus - https://github.com/rubiojr/go-enviroplus - Go modules to read Enviro+ sensors
- homebridge-enviroplus - https://github.com/mhawkshaw/homebridge-enviroplus - a Homebridge plugin to add the Enviro+ to HomeKit via Homebridge
- Enviro Plus Web - https://gitlab.com/idotj/enviroplusweb - Simple Flask application serves a web page with the current sensor readings and a graph over a specified time period
Help & Support
- GPIO Pinout - https://pinout.xyz/pinout/enviro_plus
- Support forums - https://forums.pimoroni.com/c/support
- Discord - https://discord.gg/hr93ByC
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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | c617098af8ad60d0429ca02e6c4fe989f7cd4486313c2b51a12d27bf8c45c2dd |
|
MD5 | 5ff58433663ca2581c51a78001a76359 |
|
BLAKE2b-256 | 7f3e69d7bba671bbfc76d6e186357a86ca7657af1081c858fbc7ec39a52414f0 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | e3e862f08554f89183ea419c072b4a8647d69cc8dd256579453f4b38076edd04 |
|
MD5 | d6570e2e474e39d5ef575175050e06e3 |
|
BLAKE2b-256 | 7fb8cc9474738a3441d2ee59c478deb173758a29893adaa25d98dd4e0e668778 |