Kontynuując temat z poprzednich wpisów dotyczących integracji systemów automatyki z systemem monitorowania jakości oraz poziomu zanieczyszczenia powietrza Airly przyszedł‚ i czas na wdrożenie funkcjonalności w HomeAssistant 😀 w tym krótkim wpisie postaram się pokrótce to przedstawić i opisać. Przechodzimy zatem do szczegółów…
Aby móc sczytywać informacje z serwisu Airly, potrzebne jest konto, jeśli jeszcze takowego nie mamy zakładamy je tutaj po rejestracji i zalogowaniu dostaniemy klucz API tj.:
Następnie musimy określić swoje położenie celem zlokalizowania najbliższej czujki. Wchodzimy więc na mapy, gdzie wpisujemy adres lub klikamy zlokalizuj mnie. Zostaną wyświetlone punkty czujek dostępne w określonym położeniu, po czym wybieramy najbliższy czujnik, klikając w niego - otrzymamy taki widok:
Wskazany sensor pokazuje pomiar na żywo, a klikając w pasek URL przeglądarki dostajemy wswpółrzędne geograficzne - kolejno szerokość i długość (patrz. na screen zaznaczenie kolorem czerwonym). Zapisujemy współrzędne czujnika Airly, które będziemy potrzebować w następnym kroku, w moim przykładzie jest to szerokość: 52.16471 i długość: 21.08311.
Dalej przechodzimy do zdefiniowania sensora HA, który będzie komunikował się z serwisem Airly pobierając wartości pogodowe z najbliżej zlokalizowanego czujnika względnem podanego położenie (krok wcześniejszy). Będzie to możliwe dzięki Airly API, które udostępnia szereg operacji wokół‚ zasobów, m. in. /v2/measurements/nearest zasobu zwracającego pomiary dla instalacji najbliżej określonej lokalizacji. Tworzymy zatem taki sensor dodając go do pliku configuration.yaml:
sensor:
- platform: rest
scan_interval: 900
name: Airly
resource: https://airapi.airly.eu/v2/measurements/nearest?lat=49.72347&lng=22.04834&maxDistanceKM=5
value_template: "{{ value_json['current']['values'][0]['value'] }} {{ value_json['current']['values'][1]['value'] }} {{ value_json['current']['values'][2]['value'] }} {{ value_json['current']['values'][3]['value'] }} {{ value_json['current']['values'][4]['value'] }} {{ value_json['current']['values'][5]['value'] }} {{ value_json['current']['indexes'][0]['level'] }} {{ value_json['current']['indexes'][0]['value'] }} {{ value_json['current']['indexes'][0]['description'] }}"
headers:
apikey: API_AIRLY
Accept-Language: pl
Komponent rest z platformy sensor zawiera klucz resource czyli adres czujnika Airly, który musimy przestawić: https://airapi.airly.eu/v2/measurements/nearest?lat=49.72347&lng=22.04834&maxDistanceKM=5
- lat= czyli szerokość geograficzna zmieniamy na wcześniej zapisane współrzędne czujnika (patrz wyżej)
- lng= długość geograficzna zmieniamy na wcześniej zapisane współrzędne (patrz wyżej)
- maxDistanceKM= określa limit odległości w kilometrach w jakiej od określonego punktu geograficznego znajdują się instalacje czujników.
Poza tym zamieniamy jeszcze wartość API_AIRLY klucza apikey - (patrz pierwszy screen - Twój klucz API).
Następnie konfigurując template sensor tworzymy konkretne sensory, jakie mają być:
- platform: template
sensors:
airly_pm1:
friendly_name: "Pył PM1"
icon_template: mdi:jquery
unit_of_measurement: "μg/m3"
value_template: "{{ states.sensor.airly.state.split(' ')[0] }}"
airly_pm25:
friendly_name: "Pył PM25"
icon_template: mdi:jquery
unit_of_measurement: "μg/m3"
value_template: "{{ states.sensor.airly.state.split(' ')[1] }}"
airly_pm10:
friendly_name: "Pył PM10"
icon_template: mdi:jquery
unit_of_measurement: "μg/m3"
value_template: "{{ states.sensor.airly.state.split(' ')[2] }}"
airly_pressure:
friendly_name: "Ciśnienie"
icon_template: mdi:gauge
unit_of_measurement: "hPA"
value_template: "{{ states.sensor.airly.state.split(' ')[3] | float | round(1) }}"
airly_humidity:
friendly_name: "Wilgotność"
icon_template: mdi:water-percent
unit_of_measurement: "%"
value_template: "{{ states.sensor.airly.state.split(' ')[4] | float | round(0) }}"
airly_temperature:
friendly_name: "Temperatura"
icon_template: mdi:thermometer
unit_of_measurement: "°C"
value_template: "{{ states.sensor.airly.state.split(' ')[5] | float | round(1) }}"
airly_quality:
friendly_name: "Jakość powietrza"
icon_template: mdi:quicktime
value_template: "{{ states.sensor.airly.state.split(' ')[6] }}"
airly_level:
friendly_name: "Poziom"
icon_template: mdi:database
value_template: "{{ states.sensor.airly.state.split(' ')[7] | float | round(0) }}"
airly_description:
friendly_name: "Komunikat"
icon_template: mdi:alert
value_template: "{{ states.sensor.airly.state.split(' ')[8:] | join(' ') }}"
Pozostaje stworzenie zakładki oraz widoku w interfejsie poprzez group wpisując w pliku groups.yaml:
pogoda:
name: 'Pogoda'
view: yes
icon: mdi:cloud
entities:
- group.airly
airly:
name: 'Stacja pogoda Airly'
entities:
- sensor.airly_quality
- sensor.airly_level
- sensor.airly_description
- sensor.airly_temperature
- sensor.airly_humidity
- sensor.airly_pressure
- sensor.airly_pm1
- sensor.airly_pm25
- sensor.airly_pm10
Natomiast jeśli korzystamy z Lovelace UI do pliku ui-lovelace.yaml dodajemy poniższy wpis:
title: 'Dom'
views:
- icon: mdi:cloud
id: pogoda
title: 'Pogoda'
cards:
- type: vertical-stack
cards:
- type: entities
title: 'Stacja pogody Airly'
entities:
- entity: sensor.airly_quality
- entity: sensor.airly_level
- entity: sensor.airly_description
- entity: sensor.airly_temperature
- entity: sensor.airly_humidity
- entity: sensor.airly_pressure
- entity: sensor.airly_pm1
- entity: sensor.airly_pm25
- entity: sensor.airly_pm10
Przeładowujemy konfigurację i wchodząc na HA poprzez WWW uzyskujemy taki o to efekt 🙂
Na koniec do ściągnięcia w formacie yaml wcześnie zaprezentowane pliki konfiguracyjne:
configuration.yaml - https://pastebin.com/Nsc8Guny
groups.yaml - https://pastebin.com/0vQ0zCr8
ui-lovelace.yaml - https://pastebin.com/EmTAdCkp
To by było na tyle. Jeśli coś jest niezrozumiałe lub macie jakieś pytania dawać znać, postaram się pomóc.
