Home Assistant a cheacha: posílání dat o výrobě a spotřebě

Pokud doma používáte Home Assistant, už nejspíš víte, kolik energie odebíráte ze sítě, kolik do ní posíláte a kolik vyrobí vaše fotovoltaika. Tyhle údaje umí Home Assistant posílat i do cheacha. Stačí jeden přístupový klíč, krátký kus konfigurace a automatizace, která data odesílá každou minutu.

K čemu to je

cheacha plánuje nabíjení podle cen elektřiny, ale také podle toho, co se na vašem odběrném místě skutečně děje:

• Přebytky z fotovoltaiky: když cheacha ví, kolik právě vyrábíte a spotřebováváte, přesune nabíjení auta do hodin, kdy máte vlastní energii.
• Přesnější předpovědi: ze skutečné historie výroby a spotřeby se počítá odhad na další dny.
• Přehled po čtvrthodinách: na detailu odběrného místa uvidíte výrobu, spotřebu a nabíjení v jednom grafu.
• Sdílení energie: přebytky, které sdílíte se sousedy nebo rodinou, se počítají ze skutečných dat.

Co budete potřebovat

• Home Assistant s přístupem do internetu.
• Senzory energie s kumulativním stavem v kWh – stejné, jaké používá panel Energie v Home Assistantu (odběr ze sítě, návrat do sítě, výroba solárních panelů, případně celková spotřeba domu). Typicky je dodá integrace elektroměru, střídače nebo měřiče jako Shelly EM.
• Účet v cheacha s odběrným místem.

Návod krok za krokem

1. Přidejte v cheacha zařízení Home Assistant

Otevřete Moje odběrná místa, vyberte své odběrné místo a v kartě Zařízení a měření klikněte na + Přidat zařízení. Jako typ zvolte Home Assistant, způsob integrace nechte Veřejné API cheacha a vyplňte kód zařízení, třeba HA_DOMA. Tímto kódem se bude Home Assistant v datech identifikovat.

2. Uložte si přístupový klíč

Po přidání vám cheacha ukáže přístupový klíč. Zobrazí se jen jednou, proto si ho hned zkopírujte. Pokud ho ztratíte, vygenerujete v kartě zařízení nový (starý tím přestane platit).

Klíč uložte do souboru secrets.yaml v konfiguraci Home Assistantu – i se slovem Bearer, tak jak se posílá v hlavičce:

# secrets.yaml
cheacha_authorization: "Bearer chd_sem-vložte-svůj-klíč"

3. Přidejte odesílací příkaz (rest_command)

Do configuration.yaml přidejte příkaz, který pošle aktuální stavy senzorů do cheacha. V části cheacha přiřaďte každé veličině svůj senzor (ID entit najdete v Nastavení → Zařízení a služby → Entity) a HA_DOMA nahraďte kódem zařízení z kroku 1. Veličinu, kterou neměříte, prostě vynechte.

rest_command:
  cheacha_measurements:
    url: "https://cheacha.cz/api/measurements/measurements"
    method: POST
    headers:
      Authorization: !secret cheacha_authorization
    content_type: "application/json"
    payload: >-
      {% set ts = utcnow().isoformat(timespec='seconds') %}
      {% set cheacha = {
        'GRID_IMPORT_TOTAL': 'sensor.elektromer_odber',
        'GRID_EXPORT_TOTAL': 'sensor.elektromer_dodavka',
        'ENERGY_PRODUCED_TOTAL': 'sensor.fve_vyroba',
        'ENERGY_CONSUMED': 'sensor.spotreba_domu',
      } %}
      [
      {%- for metric, entity in cheacha.items() if states(entity) | is_number %}
        {"device_code": "HA_DOMA", "metric_code": "{{ metric }}", "ts": "{{ ts }}", "value_num": {{ states(entity) | float }}}{{ "," if not loop.last }}
      {%- endfor %}
      ]

Senzory, které jsou zrovna nedostupné, se do zprávy nepřidají – cheacha tak nedostane nesmyslnou nulu.

4. Nastavte automatizaci, která data posílá

Přidejte automatizaci (např. do automations.yaml), která příkaz spustí každou minutu. Pak Home Assistant restartujte, nebo znovu načtěte konfiguraci YAML.

- alias: "cheacha – odeslat měření"
  triggers:
    - trigger: time_pattern
      minutes: "/1"
  actions:
    - action: rest_command.cheacha_measurements

5. Vyberte zdroje dat odběrného místa

Jakmile první data dorazí, uvidíte je u zařízení v cheacha v řádku Měří. Nahoře v kartě Zařízení a měření pak v sekci Zdroje dat lokality vyberete, ze kterého zařízení se má brát odběr, dodávka, výroba FV a spotřeba. Pokud máte i jiné měřicí zařízení (třeba střídač napojený přímo), můžete jednotlivé veličiny brát z různých zařízení.

Které hodnoty můžete posílat

Posílejte vždy kumulativní čítače v kWh (hodnota jen roste), ne okamžitý výkon ve W. cheacha si z rozdílů čítačů sama spočítá energii v každé čtvrthodině.

Když něco nefunguje

Chyby odesílání najdete v Home Assistantu v Nastavení → Systém → Protokoly (hledejte rest_command):

• 401 – chybí nebo nesedí přístupový klíč. Zkontrolujte secrets.yaml (včetně slova Bearer), případně vygenerujte nový klíč.
• 403 – klíč patří jinému zařízení, než jaké je v device_code. Použijte kód zařízení, ke kterému klíč patří.
• 400 – neznámý kód metriky, nebo prázdná zpráva (všechny senzory nedostupné).
• Data přicházejí, ale nepoužívají se – zkontrolujte, že je u zařízení zaškrtnuté Používat data pro lokalitu a že je vybrané v Zdrojích dat lokality.

Snímky obrazovky jsou z aplikace cheacha s ilustračními daty (včetně přístupového klíče). Názvy senzorů v konfiguraci jsou příklady – použijte ty své. Home Assistant je ochranná známka svého vlastníka.