AirGradientOnPi

This repository is aimed at developing a functional DIY Air Quality sensor based on AirGradient: https://www.airgradient.com/open-airgradient/instructions/diy/ except using a Raspberry Pi Zero with python instead of a D1 Mini Pro with Arduino/C++

Also containerized with docker for easy replication

List of Parts:

• Raspberry Pi Zero - Microprocessor
• SCD30 - Measures Temperature, Humidity, and CO2
• OLED Display - Displays Values
• PMS5003 - Measures Particulate Matter Concentrations

Wiring Diagram

Enabling UART and I2C

• I2C and UART must be enabled to work correctly:

  sudo raspi-config
  

  Enabling I2C:

  Navigate To Interface Options:

  

  Enter I2C Options:

  

  Select Yes:

  

  Enabling UART:

  Enter Serial Port Options Within Interface Option Menu:

  

  Select No:

  

  Select Yes:

  

  Select Finish:

  

Running with Docker

• Install docker:

sudo apt install docker.io

• Check if docker is functioning:

sudo docker run hello-world

• Clone repository to get Dockerfile and configuration files:

git clone https://github.com/NAU-IoT/AirGradientOnPi.git

• Change into directory:

cd AirGradientOnPi

• OPTIONAL: To change the docker containers time zone, edit line 15 in the Dockerfile. A list of acceptable time zones can be found at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
• Build docker image in AirGradientOnPi directory, this will take a while:

docker build -t airquality .

• Create a directory in a convenient location to store the docker volume. For example:

mkdir -p Data/AirQuality

• Create a volume to store data inside the directory created in the previous step:

docker volume create --driver local \
  --opt type=none \
  --opt device=/SOME/LOCAL/DIRECTORY \
  --opt o=bind \
  YOUR_VOLUME_NAME

• Execute docker container in AirGradientOnPi directory:

docker run --privileged -v YOUR_VOLUME_NAME:/Data -t -i -d --restart unless-stopped airquality

• Verify container is running:

docker ps

• Done!

Notes

• To enter the container:
  • This can be done to check log files or modify the container without rebuilding/restarting

docker exec -it CONTAINER_ID /bin/bash

• If error: Got permission denied while trying to connect to the Docker daemon socket at unix ... connect: permission denied
  • Run command, then log out and ssh back into system:

    sudo usermod -aG docker $USER
    

Running With Python

• Install Dependencies:

  • Install OLED Library:

    sudo pip install adafruit-circuitpython-ssd1306
    

  • Install SCD30 library:

    sudo pip install adafruit-circuitpython-scd30
    

  • Install Python Imaging Library:

    sudo pip install Pillow
    

  • Install PM25 Library:

    sudo pip install adafruit-circuitpython-pm25
    

• Clone This Repository:

  git clone https://github.com/NAU-IoT/AirGradientOnPi.git
  

• Change into directory:

  cd AirGradientOnPi
  

• Execute script:

  sudo python3 AirQuality.py
  

• Done!