Initial commit for Open Air with CO2

All sensor included.
No support for button presses or LED at this time.

Author: MallocArray

airgradient-open-air-co2.yaml

@@ -0,0 +1,250 @@
+# AirGradient Open Air Outdoor Monitor with CO2 and TVOC
+# Model: O-1PST
+# https://www.airgradient.com/open-airgradient/instructions/overview/
+
+# Needs ESPHome 2023.7.0 or later
+
+substitutions:
+  devicename: "ag-open-air-o-1pst"
+  upper_devicename: "AG Open Air CO2"
+  ag_esphome_config_version: 0.1.0
+
+esphome:
+  name: "${devicename}"
+  friendly_name: "${upper_devicename}"
+  name_add_mac_suffix: true  # Set to false if you don't want part of the MAC address in the name
+  on_boot:
+    priority: 200  # Network connections setup
+    then:
+      - http_request.post:
+          # Return wifi signal -50 as soon as device boots to show activity on AirGradient Dashboard site
+          # Using -50 instead of actual value as the wifi_signal sensor has not reported a value at this point in boot process
+          url: !lambda |-
+            return "http://hw.airgradient.com/sensors/airgradient:" + get_mac_address() + "/measures";
+          headers:
+              Content-Type: application/json
+          json:
+            wifi: !lambda return to_string(-50);
+
+esp32:
+  board: esp32-c3-devkitm-1
+
+# Enable logging
+# https://esphome.io/components/logger.html
+logger:
+  baud_rate: 0  # Must disable serial logging as it conflicts with pms5003 uart pins and ESP32-C3 only has 2 hardware UART
+  # hardware_uart: USB_SERIAL_JTAG
+  logs:
+    component: ERROR  # Hiding warning messages about component taking a long time https://github.com/esphome/issues/issues/4717
+
+# Enable Home Assistant API
+api:
+
+ota:
+
+wifi:
+  ssid: !secret wifi_ssid
+  password: !secret wifi_password
+  manual_ip:
+    static_ip: 192.168.2.120
+    gateway: 192.168.2.1
+    subnet: 255.255.255.0
+    dns1: 192.168.2.1
+    dns2: 4.2.2.2
+  # Enable fallback hotspot (captive portal) in case wifi connection fails
+  ap:
+
+# The captive portal is a fallback mechanism for when connecting to the configured WiFi fails.
+# https://esphome.io/components/captive_portal.html
+captive_portal:
+
+web_server:  # Please note that enabling this component will take up a lot of memory and may decrease stability, especially on ESP8266.
+
+# Create a switch for safe_mode in order to flash the device
+# Solution from this thread:
+# https://community.home-assistant.io/t/esphome-flashing-over-wifi-does-not-work/357352/1
+switch:
+  - platform: safe_mode
+    name: "Flash Mode (Safe Mode)"
+    icon: "mdi:cellphone-arrow-down"
+
+
+uart:
+  # https://esphome.io/components/uart.html#uart
+  - rx_pin: GPIO0  # Pin 12
+    tx_pin: GPIO1  # Pin 13
+    baud_rate: 9600
+    id: senseair_s8_uart
+
+  - rx_pin: GPIO20  # Pin 30 or RX
+    tx_pin: GPIO21  # Pin 31, or TX
+    baud_rate: 9600
+    id: pms5003_uart
+
+i2c:
+  # https://esphome.io/components/i2c.html
+  sda: GPIO7 # Pin 21
+  scl: GPIO6 # Pin 20
+  frequency: 400kHz  # 400kHz eliminates warnings about components taking a long time other than SGP40 component: https://github.com/esphome/issues/issues/4717
+
+sensor:
+  - platform: pmsx003
+    # PMS5003T with temperature and humidity https://esphome.io/components/sensor/pmsx003.html
+    type: PMS5003T
+    uart_id: pms5003_uart
+    pm_2_5:
+      name: "PM 2.5"
+      id: pm_2_5
+      on_value:
+        lambda: |-
+          // https://en.wikipedia.org/wiki/Air_quality_index#Computing_the_AQI
+          // Borrowed from https://github.com/kylemanna/sniffer/blob/master/esphome/sniffer_common.yaml
+          if (id(pm_2_5).state <= 12.0) {
+            // good
+            id(pm_2_5_aqi).publish_state((50.0 - 0.0) / (12.0 - 0.0) * (id(pm_2_5).state - 0.0) + 0.0);
+          } else if (id(pm_2_5).state <= 35.4) {
+            // moderate
+            id(pm_2_5_aqi).publish_state((100.0 - 51.0) / (35.4 - 12.1) * (id(pm_2_5).state - 12.1) + 51.0);
+          } else if (id(pm_2_5).state <= 55.4) {
+            // usg
+            id(pm_2_5_aqi).publish_state((150.0 - 101.0) / (55.4 - 35.5) * (id(pm_2_5).state - 35.5) + 101.0);
+          } else if (id(pm_2_5).state <= 150.4) {
+            // unhealthy
+            id(pm_2_5_aqi).publish_state((200.0 - 151.0) / (150.4 - 55.5) * (id(pm_2_5).state - 55.5) + 151.0);
+          } else if (id(pm_2_5).state <= 250.4) {
+            // very unhealthy
+            id(pm_2_5_aqi).publish_state((300.0 - 201.0) / (250.4 - 150.5) * (id(pm_2_5).state - 150.5) + 201.0);
+          } else if (id(pm_2_5).state <= 350.4) {
+            // hazardous
+            id(pm_2_5_aqi).publish_state((400.0 - 301.0) / (350.4 - 250.5) * (id(pm_2_5).state - 250.5) + 301.0);
+          } else if (id(pm_2_5).state <= 500.4) {
+            // hazardous 2
+            id(pm_2_5_aqi).publish_state((500.0 - 401.0) / (500.4 - 350.5) * (id(pm_2_5).state - 350.5) + 401.0);
+          } else {
+            id(pm_2_5_aqi).publish_state(500);
+          }
+    pm_1_0:
+      name: "PM 1.0"
+      id: pm_1_0
+    pm_10_0:
+      name: "PM 10.0"
+      id: pm_10_0
+    pm_0_3um:
+      name: "PM 0.3"
+      id: pm_0_3um
+    temperature:
+      name: "Temperature"
+      id: temp
+    humidity:
+      name: "Humidity"
+      id: humidity
+    update_interval: 2min
+
+  - platform: template
+    name: "PM 2.5 AQI"
+    unit_of_measurement: "AQI"
+    icon: "mdi:air-filter"
+    accuracy_decimals: 0
+    id: pm_2_5_aqi
+
+  - platform: senseair
+    # SenseAir S8 https://esphome.io/components/sensor/senseair.html
+    # https://senseair.com/products/size-counts/s8-lp/
+    co2:
+      name: "SenseAir S8 CO2"
+      id: co2
+      filters:
+        - skip_initial: 2
+        - clamp:
+            min_value: 400  # 419 as of 2023-06 https://gml.noaa.gov/ccgg/trends/global.html
+    id: senseair_s8
+    uart_id: senseair_s8_uart
+
+  - platform: wifi_signal
+    name: "WiFi Signal"
+    id: wifi_dbm
+    update_interval: 60s
+
+  - platform: uptime
+    name: "Uptime"
+    id: device_uptime
+    update_interval: 10s
+
+  - platform: sgp4x
+    # SGP41 https://esphome.io/components/sensor/sgp4x.html
+    voc:
+      name: "VOC Index"
+      id: voc
+    nox:
+      name: "NOx Index"
+      id: nox
+    compensation:  # Remove this block if no temp/humidity sensor present for compensation
+      temperature_source: temp
+      humidity_source: humidity
+
+
+button:
+  # https://github.com/esphome/issues/issues/2444
+  - platform: template
+    name: SenseAir S8 Calibration
+    id: senseair_s8_calibrate_button
+    on_press:
+      then:
+        - senseair.background_calibration: senseair_s8
+        - delay: 70s
+        - senseair.background_calibration_result: senseair_s8
+  - platform: template
+    name: SenseAir S8 Enable Automatic Calibration
+    id: senseair_s8_enable_calibrate_button
+    on_press:
+      then:
+        - senseair.abc_enable: senseair_s8
+  - platform: template
+    name: SenseAir S8 Disable Automatic Calibration
+    id: senseair_s8_disable_calibrate_button
+    on_press:
+      then:
+        - senseair.abc_disable: senseair_s8
+
+output:
+  - platform: gpio
+    # Watchdog to reboot if no activity
+    id: watchdog
+    pin: GPIO2
+
+http_request:
+  # Used to support POST request to send data to AirGradient
+  # https://esphome.io/components/http_request.html
+
+
+interval:
+  - interval: 30s
+    # Notify watchdog device is still alive
+    then:
+      - output.turn_on: watchdog
+      - delay: 20ms
+      - output.turn_off: watchdog
+
+
+  - interval: 2.5min
+    # Send data to AirGradient API server
+    then:
+      - http_request.post:
+          # https://api.airgradient.com/public/docs/api/v1/
+          # AirGradient URL with the MAC address all lower case
+          url: !lambda |-
+            return "http://hw.airgradient.com/sensors/airgradient:" + get_mac_address() + "/measures";
+          headers:
+              Content-Type: application/json
+          # "!lambda return to_string(id(pm_2_5).state);" Converts sensor output from double to string
+          json:
+            wifi: !lambda return to_string(id(wifi_dbm).state);
+            pm01: !lambda return to_string(id(pm_1_0).state);
+            pm02: !lambda return to_string(id(pm_2_5).state);
+            pm10: !lambda return to_string(id(pm_10_0).state);
+            pm003_count: !lambda return to_string(id(pm_0_3um).state);
+            rco2: !lambda return to_string(id(co2).state);
+            atmp: !lambda return to_string(id(temp).state);
+            rhum: !lambda return to_string(id(humidity).state);
+            tvoc_index: !lambda return to_string(id(voc).state);
+            nox_index: !lambda return to_string(id(nox).state);