carldunham / air-quality-monitor

Measure local air quality, display values from sensor and public sources

air-quality-monitor

Measure local air quality, display values from sensor and public sources

Built on the awesome Mongoose OS platform.

Designed to run on an Adafruit HUZZAH32 – ESP32 Feather Board, which is a nice, compact ESP32 platform.

Uses an Adafruit FeatherWing OLED - 128x32 for display.

Setup

Building the software

The usual Mongoose-OS stuff:

mos build --local --board featheresp32 --verbose && mos flash && mos console

air-quality-monitor's Issues

Config: Location

Add app config for current location. Include:

• Label
• Wifi settings
• Geo (lat/lon, place name, id for APIs, etc)

Rotate through some or all values

When idle, switch values every few seconds. When button pressing starts, stop switching until idle again (15-20 seconds?)

Highlight critical values

If air quality measured or reported exceeds "good" level, invert screen. If dangerous, flash screen. Higher levels do faster switching?

Config: Wifi

Include multiple selectable setups. Mongoose already has this, just need to be able to select the active one in the app config.

Basic web page

Point your browser to it and it shows:

• Measured values, updated
• Published values, over time, in graphs
• Public data
• Config section (wifi, locations, etc)

Display AirNow data

From https://docs.airnowapi.org/CurrentObservationsByLatLon/docs

Depends on #1 , #2 and #3.

Scroll through data with buttons

A should go Up, C should go Down
B will be Mode. A/C will wrap around (vertically).

When B pressed for more than x seconds, go to settings (later), otherwise wrap around horizontally (alternate modes).

Modes: measured, regional (from AirNow, depends on #6)

After timeout (default 5s, settable), return to home (measured PM2.5).

Measured list:

1. PM1.0
2. PM2.5 (home)
3. PM10
   4-9. Particles/liter

Reported list:

1. Ozone Quality (Good, Bad, etc)
2. Ozone (O3)
3. PM2.5 (home)
4. PM2.5 Quality

Publish to PubNub

Channel per device/location. Depends on #1 .

Something like:

{
  "pm": {
    "raw": {
      "1.0": 4,
      "2.5": 5,
      "10": 5
    },
    "adj": {
      "1.0": 4,
      "2.5": 5,
      "10": 5
    }
  },
  "prtcls": {
    ">0.3": 765,
    ">0.5": 221,
    ">1.0": 17,
    ">2.5": 1,
    ">5.0": 0,
    ">10.0": 0
  }
}

Where "pm" are the typical reported air quality metrics (μg/m³).

The "raw" are the "CF=1，standard particle" values, and "adj" are the "under atmospheric environment" values. I haven't been able to find much about what these mean, but it seems that "CF" stands for "Calibration Factory", so I have assumed that these are the uncalibrated numbers, and that some other "CF" value is assigned at the factory for each device, which is used to calculate the "environment" values.

The "prtcls" values are the number of measured (or estimated) particles greater than the given size (in μm) per 0.1 liters of air.