Hmmbob's blog

esphome:
  name: weerhuisje
  platform: ESP8266
  board: nodemcuv2

wifi:
  networks:
  - ssid: "<<My SSID>>"
    password: "<<My WiFi Password>>"
  ap:
    ssid: "Weerhuisje AP"
    password: "<<Backup AP Password>>"
  manual_ip:
    static_ip: 10.0.1.2
    gateway: 10.0.1.1
    subnet: 255.255.255.0
  power_save_mode: none

captive_portal:
web_server:
logger:

# Enable Home Assistant API
api:
  reboot_timeout: 5min

ota:

time:
  - platform: homeassistant
    id: homeassistant_time
    timezone: Europe/Amsterdam

# Enable UART for SDS011
uart:
  rx_pin: D1
  tx_pin: D2
  baud_rate: 9600

# Enable i2c for BME280
i2c:
  sda: D5
  scl: D6

sensor:
  - platform: sds011
    pm_2_5:
      name: "Particulate Matter <2.5µm Concentration"
      accuracy_decimals: 2
    pm_10_0:
      name: "Particulate Matter <10.0µm Concentration"
      accuracy_decimals: 2
    update_interval: 30min
  - platform: bme280
    temperature:
      name: "BME280 Temperature"
      accuracy_decimals: 2
    pressure:
      name: "BME280 Pressure"
      accuracy_decimals: 4
    humidity:
      name: "BME280 Humidity"
      accuracy_decimals: 2
    update_interval: 5min
    address: 0x76
  - platform: uptime
    name: "Weerhuisje uptime"
    update_interval: 60s
  - platform: wifi_signal
    name: "Weerhuisje WiFi signaal"
    update_interval: 60s

binary_sensor:
  - platform: status
    name: "Weerhuisje Status"

text_sensor:
  - platform: wifi_info
    ip_address:
      name: Weerhuisje IP Address
    ssid:
      name: Weerhuisje Connected SSID
    bssid:
      name: Weerhuisje Connected BSSID
  - platform: version
    name: Weerhuisje Version

# rest_command.yaml, included from configuration.yaml

##################################
## Push values to Air Quality APIs
##################################

# The BME280 pressure value in HA is in hPa - the APIs expect it in Pa, hence the 
# multiplication of the value in the templates below.

# Push to Luftdaten API. Luftdaten uses headers to distinguish between different sensor
# types, so we need to push twice. The X-Sensor header contains the sensorID from Luftdaten,
# typically formatted as esp8266-12345678 or similar.
send_luftdaten_pm:
  url: https://api.sensor.community/v1/push-sensor-data/
  method: POST
  content_type: 'application/json'
  headers:
    X-Pin: 1  ## This tells Luftdaten that it is SDS011 data
    X-Sensor: !secret luftdaten_x_sensor
  payload: >
    {
      "software_version": "HomeAssistant-{{ states('sensor.current_version') }}",
      "sensordatavalues":[
        {"value_type":"P1","value":"{{ states('sensor.particulate_matter_10_0um_concentration') }}"},
        {"value_type":"P2","value":"{{ states('sensor.particulate_matter_2_5um_concentration') }}"}
      ]
    }
send_luftdaten_tph:
  url: https://api.sensor.community/v1/push-sensor-data/
  method: POST
  content_type: 'application/json'
  headers:
    X-Pin: 11  ## This tells Luftdaten that it is BME280 data
    X-Sensor: !secret luftdaten_x_sensor
  payload: >
    {
      "software_version": "HomeAssistant-{{ states('sensor.current_version') }}",
      "sensordatavalues":[
        {"value_type":"temperature","value":"{{ states('sensor.bme280_temperature') }}"},
        {"value_type":"pressure","value":"{{ states('sensor.bme280_pressure') | float * 100 }}"},
        {"value_type":"humidity","value":"{{ states('sensor.bme280_humidity') }}"}
      ]
    }

# Push to Madavi. This is related to Luftdaten and stores data for use in Grafana.
send_madavi:
  url: https://api-rrd.madavi.de/data.php
  method: POST
  content_type: 'application/json'
  headers:
    X-Pin: 0
    X-Sensor: !secret luftdaten_x_sensor
  payload: >
    {
      "software_version": "HomeAssistant-{{ states('sensor.current_version') }}", 
      "sensordatavalues":[
        {"value_type":"SDS_P1","value":"{{ states('sensor.particulate_matter_10_0um_concentration') }}"},
        {"value_type":"SDS_P2","value":"{{ states('sensor.particulate_matter_2_5um_concentration') }}"},
        {"value_type":"BME280_temperature","value":"{{ states('sensor.bme280_temperature') }}"},
        {"value_type":"BME280_pressure","value":"{{ states('sensor.bme280_pressure') | float * 100 }}"},
        {"value_type":"BME280_humidity","value":"{{ states('sensor.bme280_humidity') }}"}
      ]
    }

# Push to OpenSenseBox / OpenSenseMap. The url !secret contains the openSenseBox API url,
# which looks like https://api.opensensemap.org/boxes/<<yoursenseboxid>>/data
# The input_text items contain the sensor-IDs you need to publish the data to the API.
# You can find those on your SenseBox page on https://opensensemap.org/account
post_opensensebox:
  url: !secret opensensebox_api_url
  method: post
  headers:
    content-type: "application/json; charset=utf-8"
  payload: >-
    {
      "{{ states('input_text.opensensebox_sensorid_temp') }}": "{{ states('sensor.bme280_temperature') }}",
      "{{ states('input_text.opensensebox_sensorid_press') }}": "{{ states('sensor.bme280_pressure') | float * 100 }}",
      "{{ states('input_text.opensensebox_sensorid_hum') }}": "{{ states('sensor.bme280_humidity') }}",
      "{{ states('input_text.opensensebox_sensorid_pm25') }}": "{{ states('sensor.particulate_matter_2_5um_concentration') }}",
      "{{ states('input_text.opensensebox_sensorid_pm10') }}": "{{ states('sensor.particulate_matter_10_0um_concentration') }}"
    }

# secrets.yaml

luftdaten_x_sensor: esp8266-99999999 
opensensebox_api_url: https://api.opensensemap.org/boxes/<<YourSenseBoxID>>/data
opensensebox_sensorid_temp: 123456789012345678901231
opensensebox_sensorid_press: 123456789012345678901232
opensensebox_sensorid_hum: 123456789012345678901233
opensensebox_sensorid_pm25: 123456789012345678901234
opensensebox_sensorid_pm10: 123456789012345678901235

# input_text.yaml,  included from configuration.yaml

##################################
## Input text configuration
##################################

# I am using this workarond to hide sensor-IDs needed in the rest_command 
# payloads. These templates cannot handle secrets, but you can set these 
# input_text items with !secret, so in this way the IDs are obfuscated.
# I don't mind having these in my HA instance, I just don't want them on 
# GitHub to prevent copy-paste errors.

opensensebox_sensorid_temp:
  initial: !secret opensensebox_sensorid_temp

opensensebox_sensorid_press:
  initial: !secret opensensebox_sensorid_press

opensensebox_sensorid_hum:
  initial: !secret opensensebox_sensorid_hum

opensensebox_sensorid_pm25:
  initial: !secret opensensebox_sensorid_pm25

opensensebox_sensorid_pm10:
  initial: !secret opensensebox_sensorid_pm10

#air_quality.yaml, included from configuraiton.yaml automations

##################################
## Push values to Air Quality APIs
##################################
# Sensor uses a NodeMCUv2 and SDS011+BME280 sensors. NodeMCU is flashed with ESPHome
# software. SDS011 updates every 30 mins, the BME280 every 5 minutes. As all BME280
# sensors update at the same time, we only need to monitor one sensor to trigger
# the automation. Temperature is the sensor that changes most often.
- alias: 'Weerhuisje: Update Air Quality Sensors'
  initial_state: true
  mode: queued
  trigger: # Trigger on every update of the temperature
    platform: state
    entity_id: sensor.bme280_temperature 
  action:
    ## Send to Luftdaten / Sensor.Community API
    ## Split over two calls as the headers differ
    - service: rest_command.send_luftdaten_tph
    - service: rest_command.send_luftdaten_pm
    ## Send updates to Madavi.de too for statistics.
    - service: rest_command.send_madavi
    ## Send data to OpenSenseMap. 
    - service: rest_command.post_opensensebox

- alias: "Weerhuisje: Notify if weerhuisje Offline"
  initial_state: true
  trigger:
    - platform: state
      entity_id: binary_sensor.weerhuisje_status
      to: 'off'
      for:
        seconds: 60
  action:
    service: notify.notify
    data_template:
      title: "Weerhuisje is Offline"
      message: "Weerhuisje is offline"