https://github.com/3cky/flipperzero-airmon

Flipper Zero air quality monitoring application.
https://github.com/3cky/flipperzero-airmon

air-quality aqi-monitor flipperzero

Last synced: 5 months ago
JSON representation

Flipper Zero air quality monitoring application.

• Host: GitHub
• URL: https://github.com/3cky/flipperzero-airmon
• Owner: 3cky
• License: gpl-3.0
• Created: 2023-06-13T15:16:09.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2025-02-03T14:33:06.000Z (over 1 year ago)
• Last Synced: 2025-02-03T15:33:50.940Z (over 1 year ago)
• Topics: air-quality, aqi-monitor, flipperzero
• Language: C
• Homepage:
• Size: 189 KB
• Stars: 23
• Watchers: 4
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Airmon for Flipper Zero

[![FAP Build](https://github.com/3cky/flipperzero-airmon/actions/workflows/build.yml/badge.svg)](https://github.com/3cky/flipperzero-airmon/actions/workflows/build.yml)

A simple Flipper Zero air quality monitoring application. 

It displays measured PM1.0/PM2.5/PM10 [Particulate Matter] concentrations 

and calculated [Air Quality Index (AQI)].









## Hardware setup

Connect the Plantower PMS5003/PMS7003/PMS9003 sensor according to the wiring diagram below.







| Flipper Pin | Sensor Pin |

|:-----------:|:----------:|

| 1 (5V)      | 1 (5V)     |

| 11 (GND)    | 2 (GND)    |

| 13 (TX)     | 4 (RX)     |

| 14 (RX)     | 5 (TX)     |

## Building and installing

1. Clone `airmon` repository using `git clone https://github.com/3cky/flipperzero-airmon` command.

2. Install [uFBT] Flipper Build Tool.

3. Compile application running `ufbt` command in the cloned directory root.

4. Install and start `airmon` application on Flipper attached over USB using `ufbt launch` command.

## Application controls

Use left/right arrows for PM/AQI display mode switching. 

Flipper LED will blink once every successful sensor reading by color according to the current AQI value.

## License

Airmon is available under the GPL 3 license. See the [LICENSE](LICENSE) file for more info.

[Particulate Matter]: https://www.epa.gov/pm-pollution/particulate-matter-pm-basics

[Air Quality Index (AQI)]: https://www.airnow.gov/aqi/aqi-basics/

[uFBT]: https://github.com/flipperdevices/flipperzero-ufbt