Automate air filtration with air quality sensors

Automate air filtration with air quality sensors

1. Overview

Leaving an air filtration system running at all times is inefficient but you also don't want to forget to turn it on if the air quality reaches concerning levels. Use Viam to automate an air filtration system using air quality sensors and an air filter attached to a box fan. Set up a conditional workflow to turn on the air filtration when particulate values rise above a specified threshold, and then turn it off again when the air is clean.

Instead of leaving the air filtration running at all times, or forgetting to turn it on, this is a way to automatically remove household pollutants and allergens from the air in your home.

Prerequisites

What You'll Learn

What You'll Need

What You'll Build

Watch the Video

See a demonstration and overview of the air quality monitoring system in this video.

Air quality monitoring | Demo

2. Set up your air monitoring device

The PMS7003 particulate sensor measures the air quality and transmits data in a serial stream from the transmitter pin (TX) to the receiver pin (RX pin) on the Raspberry Pi.

Refer to the following wiring diagram to connect the Raspberry Pi to the PMS7003 air monitoring device.

To power the Raspberry Pi, you can use the USB cord from earlier to continue providing power from your computer, or use a separate USB power supply.

How does the air sensor transmit data to your Raspberry Pi?

WiFi, I2C, Serial, MQTT

3. Set up your air filter

Make your own air purifier by combining a box fan and air filter to effectively clean the air in a small to medium sized, closed room.

  1. Attach the filter to the back of the fan, ensuring the airflow arrow points toward the fan. The fan should pull air through the filter when operating. If the filter will block access to the fan's power knob, now is a good time to switch it to an on position.
  2. Secure the filter using 3D-printed clips or duct tape. Write the date when the filter is first used directly on the filter.

Set up your smart plug

  1. Plug your Kasa smart plug into a power outlet.
  2. Set up your smart plug and connect it to your local Wifi using the Kasa mobile app from the App Store or Google Play.
  3. Find your smart plug's IP address on your router's admin page. From a web browser, enter your router's IP address (commonly 192.168.1.1 or 192.168.0.1) and log in using your admin username and password. Look for a section like "Connected Devices," "Device List," or "DHCP Clients." Locate your Kasa smart plug by its name, MAC address (shown in the Kasa mobile app), or manufacturer name (usually TP-Link). Make a note of the IP address since we'll need it again soon.
  4. Plug the box fan into the Kasa smart plug.

4. Set up your Raspberry Pi

The Raspberry Pi boots from a USB flash drive (or microSD card). You need to install Raspberry Pi OS on a USB flash drive that you will use with your Pi. For more details about alternative methods of setting up your Raspberry Pi, refer to the Viam docs.

Install Raspberry Pi OS

  1. Connect the USB flash drive (or microSD card) to your computer.
  2. Download the Raspberry Pi Imager and launch it.
  3. Click CHOOSE DEVICE. Select your model of Pi, which is Raspberry Pi 5.
  4. Click CHOOSE OS. Select Raspberry Pi OS (64-bit) from the menu.
  5. Click CHOOSE STORAGE. From the list of devices, select the USB flash drive you intend to use in your Raspberry Pi.
  6. Configure your Raspberry Pi for remote access. Click Next. When prompted to apply OS customization settings, select EDIT SETTINGS.
  7. Check Set hostname and enter the name you would like to access the Pi by in that field, for example, air.
  8. Select the checkbox for Set username and password and set a username (for example, your first name) that you will use to log into the Pi. If you skip this step, the default username will be pi (not recommended for security reasons). And specify a password.
  9. Connect your Pi to Wi-Fi so that you can run viam-server wirelessly. Check Configure wireless LAN and enter your wireless network credentials. SSID (short for Service Set Identifier) is your Wi-Fi network name, and password is the network password. Change the section Wireless LAN country to where your router is currently being operated.
  10. Select the SERVICES tab, check Enable SSH, and select Use password authentication.
  11. Save your updates, and confirm YES to apply OS customization settings. Confirm YES to erase data on the USB flash drive. You may also be prompted by your operating system to enter an administrator password. After granting permissions to the Imager, it will begin writing and then verifying the Linux installation to the USB flash drive.
  12. Remove the USB flash drive from your computer when the installation is complete.

Connect with SSH

  1. Place the USB flash drive into your Raspberry Pi and boot the Pi by plugging it into an outlet. A red LED will turn on to indicate that the Pi is connected to power.
  2. Once the Pi is started, connect to it with SSH. From a command line terminal window, enter the following command. The text in <> should be replaced (including the < and > symbols themselves) with the user and hostname you configured when you set up your Pi.
ssh <USERNAME>@<HOSTNAME>.local
  1. If you are prompted "Are you sure you want to continue connecting?", type "yes" and hit enter. Then, enter the password for your username. You should be greeted by a login message and a command prompt.
  2. Update your Raspberry Pi to ensure all the latest packages are installed
sudo apt update
sudo apt upgrade

Enable communication protocols

  1. Launch the Pi configuration tool by running the following command
sudo raspi-config
  1. Use your keyboard to select "Interface Options", and press return.
  2. Enable the relevant protocols to support our hardware. Since you are using a sensor that communicates over the serial port, enable Serial Port.
  3. Confirm the options to enable the serial login shell and serial interface. And reboot the Pi when you're finished.

5. Configure your machine and peripherals

Configure your machine

  1. In the Viam app under the LOCATIONS tab, create a machine by typing in a name and clicking Add machine.
  2. Click View setup instructions.
  3. Install viam-server on the Raspberry Pi device that you want to use to communicate with and control your air sensor. Select the Linux / Aarch64 platform for the Raspberry Pi to control the air sensor, and leave your installation method as viam-agent.
  4. Use the viam-agent to download and install viam-server on your Raspberry Pi. Follow the instructions to run the command provided in the setup instructions from the SSH prompt of your Raspberry Pi. The setup page will indicate when the machine is successfully connected.

Add your Raspberry Pi

  1. In the Viam app, find the CONFIGURE tab. It's time to configure your hardware.
  2. Click the + icon in the left-hand menu and select Component.
  3. Select board, and find the pi5 module. This adds the module for working with the Raspberry Pi 5's GPIO pins. Leave the default name board-1 for now.
  4. Notice adding this module adds the board hardware component called board-1. The collapsible card on the right corresponds to the part listed in the left sidebar.
  5. Click Save in the top right to save and apply your configuration changes.

Add your air sensor

  1. In the Viam app, click the + icon and select Component. Select sensor, find the air:pms7003 module, and click Add module. This module provides the sensor model that supports the specific hardware we are using for this tutorial. Leave the default name sensor-1 for now.
  2. Notice adding this module adds the sensor hardware component called sensor-1 as well as a module called pms7003 which contains the logic for how our Raspberry Pi and air sensor work with each other.
  3. Save your updates.

Add your smart plug

  1. In the Viam app, let's configure the rest of our hardware so that your machine can communicate with the smart plug over wifi. Click the + icon in the left-hand menu and select Component. Select generic, and find the kasa:switch module. This is a generic module that's been configured to use the python-kasa library. In other words, it's a layer of abstraction that lets us use the Kasa manufacturer's APIs with Viam.
  2. Notice adding this module adds the generic hardware component called generic-1 as well as a module called kasasmartplug which contains the logic for how our Raspberry Pi and smart plug work with each other.
  3. Under the CONFIGURE section of the generic-1 card, add your own smart plug's IP address that you found in a previous step, formatted like the following.
{
     "plug_ip": "192.168.1.169"
}
  1. Save your updates.

6. Test the hardware

Test the air sensor

  1. In the Viam app under the CONTROL tab, you can see two hardware components called generic-1 and sensor-1. They are your smart plug and air sensor that you configured on the CONFIGURE tab.
  2. Find the sensor-1 card, and expand the TEST accordion. The module we added has a GetReadings function to get the readings from our air sensor. Select Manual refresh, and then click the refresh icon to manually get the readings.

Test the smart plug

  1. Next, test that your smart plug is working properly. Make sure the fan is still plugged in to the powered smart plug. Also make sure the fan knob is set to on.
  2. In the Viam app under the CONTROL tab, find the generic-1 card, and expand the DOCOMMAND accordion. The module we added has a few functions to control the smart plug. Under the Input section, add the following JSON object (if your fan is still running), and then click Execute to toggle off the smart plug.
{
     "toggle_off": []
}
  1. Now update `