ADA12 Home Assistant integráció

Mappastruktúra

1. homeassistant/
   • configuration.yaml
   • customize.yaml
   • custom_components/ada12/
     • manifest.json
     • sensor.py
     • __init__.py
   • www/ada.png

Fájlok módosítása és létrehozása

1. homeassistant/configuration.yaml

Ez a fő konfigurációs fájl, amely tartalmazza az összes szükséges beállítást a Home Assistant számára. Ebben érdemes hozzáadni az ADA12 integrációhoz kapcsolódó részleteket, például az ADA12 szenzor beállításait, MQTT kapcsolat részleteit, és egyéb kiegészítő paramétereket. A konfigurációs blokkokat itt külön sorokban adjuk meg.

2. homeassistant/customize.yaml

Ez a fájl a testreszabások helye. Itt lehet beállítani az ADA12 eszköz egyedi megjelenítési tulajdonságait, például ikonokat, neveket, és további vizuális elemeket. Az ADA12 szenzorokhoz tartozó testreszabásokat itt adjuk meg, hogy a Home Assistant felületén jól látható és áttekinthető legyen.

3. homeassistant/custom_components/ada12/manifest.json

Ez a JSON fájl az ADA12 integráció információit tartalmazza a Home Assistant számára. Itt adhatók meg az integráció neve, verziója, és a szükséges csomagok vagy függőségek. Fontos, hogy helyesen legyen beállítva, mivel ez segíti a Home Assistantot az integráció megfelelő felismerésében és kezelésében.

4. homeassistant/custom_components/ada12/sensor.py

Ez a Python fájl a fő logikai része az ADA12 szenzor működésének. Az ADA12 által küldött adatokat feldolgozza és továbbítja a Home Assistant rendszerébe. Itt kell meghatározni, hogy milyen adatokat gyűjtünk és hogyan kezeljük azokat, például melyik MQTT témára figyelünk, és hogyan alakítjuk át az adatokat Home Assistant-kompatibilis formátumra.

5. homeassistant/custom_components/ada12/__init__.py

Az __init__.py fájl az integráció inicializálásához szükséges. Itt kerül beállításra a kezdő konfiguráció, és hogy az ADA12 szenzor miként kapcsolódik a Home Assistant rendszeréhez. Ez a fájl szükséges a Python csomagok megfelelő működéséhez, valamint biztosítja, hogy a sensor.py fájl helyesen legyen inicializálva.

6. homeassistant/www/ada.png

Ez a kép fájl az ADA12 eszközhöz kapcsolódó grafikus elemek helye. Ezt a képet használhatjuk a Home Assistant felületén ikonként vagy vizuális azonosítóként. A kép URL-jét be lehet illeszteni a configuration.yaml vagy a customize.yaml fájlban, hogy megjelenjen a felületen.

A zip fájlban nem találhat de itt egy dasboard minta yaml fájl:
views:
  - title: ADA12
    path: energia
    badges: []
    cards:
      - type: history-graph
        title: Fogyasztás / Visszatáplálás
        entities:
          - entity: sensor.ada12_instantaneous_power_import
          - entity: sensor.ada12_instantaneous_power_export
        refresh_interval: 10
        hours_to_show: 0.4
      - type: gauge
        entity: sensor.ada12_voltage_phase_l1
        min: 220
        max: 260
        needle: true
        severity:
          green: 220
          yellow: 240
          red: 250
      - type: gauge
        entity: sensor.ada12_voltage_phase_l2
        min: 220
        max: 260
        needle: true
        severity:
          green: 220
          yellow: 240
          red: 250
      - type: gauge
        entity: sensor.ada12_voltage_phase_l3
        min: 220
        max: 260
        needle: true
        severity:
          green: 220
          yellow: 240
          red: 250
      - type: history-graph
        title: Fázisok
        entities:
          - entity: sensor.ada12_voltage_phase_l1
          - entity: sensor.ada12_voltage_phase_l2
          - entity: sensor.ada12_voltage_phase_l3
        refresh_interval: 10
        hours_to_show: 0.4

A fenti példa csak a fázisokra és a fogyasztás illetve visszatermelés adatit mutatja be. Ha további adatokkal szeretné bővíteni a forráskódot azt a következő változók neveivel teheti meg:

• username
• password
• client_id
• os_version
• timestamp
• cosem_logical_device_name
• meter_serial_number
• current_tariff
• circuit_breaker_status
• limiter_threshold
• active_import_energy_total
• active_import_energy_tariff_1
• active_import_energy_tariff_2
• active_import_energy_tariff_3
• active_import_energy_tariff_4
• active_export_energy_total
• active_export_energy_tariff_1
• active_export_energy_tariff_2
• active_export_energy_tariff_3
• active_export_energy_tariff_4
• reactive_import_energy
• reactive_export_energy
• reactive_energy_qi
• reactive_energy_qii
• reactive_energy_qiii
• reactive_energy_qiv
• total_active_energy
• voltage_phase_l1
• voltage_phase_l2
• voltage_phase_l3
• current_phase_l1
• current_phase_l2
• current_phase_l3
• power_factor
• power_factor_l1
• power_factor_l2
• power_factor_l3
• frequency
• instantaneous_power_import
• instantaneous_power_export
• instantaneous_reactive_power_qi
• instantaneous_reactive_power_qii
• instantaneous_reactive_power_qiii
• instantaneous_reactive_power_qiv
• current_limit_l1
• current_limit_l2
• current_limit_l3

Megjegyzés: Nem minden operációs rendszer képes a .local végződésű MDNS domainek feloldására a belső hálózaton. Ha a Home Assistant nem éri el az ADA12 eszközt az okosvillanyora.local címen, akkor lépjen be a hálózati admin felületre, és keresse meg a csatlakoztatott eszközök táblázatát. Ebben a táblázatban megtalálja az ADA12 eszköz helyi IP-címét. Ezután a Home Assistant konfigurációjában cserélje le az okosvillanyora.local címet az eszköz IP-címére, így biztosítva a kapcsolatot.