🏠 Home Assistant — посібник з підключення

Відкрийте в браузері на тому ж комп’ютері, з якого відкриваєте Home Assistant:

Має з’явитися текст JSON із "online": true і вимірами: power, voltage, current, pf, freq_hz, relay.

Відкрийте configuration.yaml (у File editor: значок папки → configuration.yaml) і додайте в кінець файлу блок нижче. Якщо секція rest: у файлі вже є, додайте елемент у неї, а не другу таку саму секцію.

rest:
  - resource: http://192.168.0.200:8000/live
    scan_interval: 10
    sensor:
      - name: "PowerTrace power"
        value_template: "{{ value_json.power | float(none) }}"
        unit_of_measurement: "W"
        device_class: power
        state_class: measurement
      - name: "PowerTrace voltage"
        value_template: "{{ value_json.voltage | float(none) }}"
        unit_of_measurement: "V"
        device_class: voltage
        state_class: measurement
      - name: "PowerTrace current"
        value_template: "{{ value_json.current | float(none) }}"
        unit_of_measurement: "A"
        device_class: current
        state_class: measurement
      - name: "PowerTrace power factor"
        value_template: "{{ value_json.pf | float(none) }}"
        device_class: power_factor
        state_class: measurement
      - name: "PowerTrace frequency"
        value_template: "{{ value_json.freq_hz | float(none) }}"
        unit_of_measurement: "Hz"
        device_class: frequency
        state_class: measurement
    binary_sensor:
      - name: "PowerTrace relay"
        value_template: "{{ (value_json.relay or {}).on | default(false) }}"
        device_class: power

• Налаштування → Інструменти → YAML → Перевірити конфігурацію (або адреса /config/tools/yaml). Має з’явитися «Конфігурація не завадить запуску Home Assistant!».
• Там же натисніть Перезапустити → Перезапустити Home Assistant. Навіть без перевірки це безпечно: з помилкою в конфігу Home Assistant не перезапуститься і покаже її.
• Інструменти → Стани, у фільтрі введіть powertrace.

Графіки, епізоди й аналіз Power Trace стандартними картками Home Assistant не відтворити, але саму панель можна додати як окрему сторінку:

1. Налаштування → Інформаційні панелі → Додати інформаційну панель (або адреса /config/lovelace/dashboards)
2. Оберіть Веб-сторінка
3. URL: http://<адреса Power Trace>:8000/index.html
4. Назва Power Trace, значок mdi:flash; щоб пункт був у бічному меню, лишіть показ на бічній панелі увімкненим

У /live лічильника кВт·год немає, але Home Assistant може порахувати енергію з потужності:

1. Налаштування → Пристрої та сервіси → Помічники → Створити помічника → Інтегральний датчик (або адреса /config/helpers)
2. Вхідний датчик sensor.powertrace_power, Метод інтеграції — «Правило трапеції», Метричний префікс — k, Одиниця часу — «Години»
3. Адреса /config/energy → блок Електрична мережа → Додати з’єднання до мережі → оберіть створений сенсор

Стовпчики з’являться після завершення першої повної години. У нашій перевірці за годину вийшло 92 Вт·год проти 91 у Power Trace; при різких змінах навантаження різниця може бути більшою. Точна енергія — у самому Power Trace.

Лічильник живиться від тієї ж мережі, тож без світла він замовкає, і сенсори з кроку 2 стають «невідомо». На цьому можна побудувати автоматизацію: потужність «невідома» 5 хвилин — світла немає; число повернулось — світло з’явилось. Правити configuration.yaml не треба.

1. Налаштування → Автоматизації та сцени → Додати автоматизацію → Створити нову автоматизацію, далі ⋮ → Редагувати YAML.
2. Замініть вміст блоком нижче й збережіть.

alias: "Power Trace: світло зникло / з’явилось"
mode: queued
triggers:
  - trigger: state
    entity_id: sensor.powertrace_power
    to: [unknown, unavailable]
    for: { minutes: 5 }
    id: lost
  - trigger: state
    entity_id: sensor.powertrace_power
    from: [unknown, unavailable]
    id: back
actions:
  - choose:
      - conditions: [{ condition: trigger, id: lost }]
        sequence:
          - action: persistent_notification.create
            data:
              notification_id: powertrace_power
              title: Power Trace
              message: >-
                ⚡ Світло зникло о {{ as_local(trigger.to_state.last_changed).strftime('%H:%M') }}
                (або лічильник випав з Wi-Fi)
      - conditions:
          - { condition: trigger, id: back }
          - condition: template
            value_template: >-
              {{ (trigger.to_state.last_changed - trigger.from_state.last_changed).total_seconds() >= 300 }}
        sequence:
          - action: persistent_notification.create
            data:
              notification_id: powertrace_power
              title: Power Trace
              message: >-
                ✅ Світло з’явилось о {{ as_local(trigger.to_state.last_changed).strftime('%H:%M') }},
                не було {{ ((trigger.to_state.last_changed - trigger.from_state.last_changed).total_seconds() / 60) | round(0) | int }} хв

Тоді вбудована панель з http://-адресою не завантажиться: Home Assistant сам напише, що не може показати iframe з http. Потрібна https-адреса Power Trace. Найпростіше отримати її через Tailscale — і для Power Trace, і для Home Assistant, якщо в нього https ще немає:

1. На машині з Power Trace увімкніть tailscale serve --bg http://127.0.0.1:8000 (на Raspberry Pi — через sudo), див. посібник Tailscale. Power Trace стане доступний як https://<ім’я>.<ваш tailnet>.ts.net.
2. Якщо в Home Assistant https ще немає: Налаштування → Застосунки → Встановити додаток → Tailscale, у його конфігурації в «Share Home Assistant with Serve or Funnel» оберіть serve і збережіть. Поки що не запускайте.
3. Налаштування → Система → Мережа → HTTP-сервер → Зворотний проксі (або адреса /config/network): увімкніть Довіряти X-Forwarded-For, у Довірені проксі додайте 127.0.0.1, натисніть Зберегти → Зберегти та перезапустити. Після перезапуску підтвердьте нові налаштування, інакше за кілька хвилин Home Assistant поверне старі.
4. Запустіть застосунок Tailscale і підтвердьте вхід за посиланням з його журналу. Home Assistant стане доступний як https://homeassistant.<ваш tailnet>.ts.net.
5. У веб-сторінці Power Trace (крок 4) вкажіть URL https://<ім’я Power Trace>.<ваш tailnet>.ts.net/index.html.

• Працює в межах домашньої мережі: пристрій, на якому ви дивитесь Home Assistant, має бачити Power Trace. Поза домом — лише через Tailscale.
• Якщо Home Assistant відкривається через https://, вбудовуйте Power Trace за https-адресою — див. розділ вище.
• Колектор оновлює виміри приблизно раз на хвилину, тож частіше опитувати немає потреби.
• Коли Power Trace офлайн, числові сенсори стають «невідомо», а стан реле показує «вимкнено».
• Окремої інтеграції чи MQTT з автовиявленням поки немає.

Сенсори «недоступні». Найчастіше в блоці лишилась адреса з прикладу. Перевірте адресу й мережу: відкрийте /live з машини Home Assistant. На запити за публічним ім’ям Power Trace відповідає 403 — використовуйте IP-адресу, ім’я .local, .lan чи ім’я з Tailscale.

Замість панелі — повідомлення про http. Home Assistant відкрито через https:// — див. розділ про https.

Помилка конфігурації. Найчастіше — відступи в YAML або друга секція rest:.

Потрібна інтеграція з MQTT і автовиявленням? Напишіть нам — так ми зрозуміємо, чи варто її робити.