Files
buryan-infra/ops/homeassistant/INTEGRATIONS.md
buryan-agent 60f30fff8e HA: 24 интеграции и 34 сущности, включая сервисы и устройства
Через config flow добавлены Radarr, Sonarr, Lidarr, Jellyfin, SpeedTest и
Google Cast; ping-датчики для всех устройств с IP (13). Итого 24 интеграции,
34 сущности (sensor 14, binary_sensor 14).

Найден формат схемы config flow: плоский список полей, подстановка по name.

Не поддались: Paperless (API 200, но интеграция cannot_connect), nmap_tracker
(не создаёт сущности), Immich/Nextcloud/Uptime Kuma (нужны ключи), Gitea и
Frigate (нет интеграций в core). VIDAA: открытого API нет — только DLNA или
HACS-компонент.
2026-10-20 16:28:50 +03:00

3.5 KiB
Raw Permalink Blame History

Home Assistant: что подключено и как

Доступ к API

Токена не было (доверенные сети не покрывали наш адрес). Токен подписывается ключом из .storage/auth — как это делает сам HA:

jwt = HS256({"iss": <refresh_token_id>, "iat": …, "exp": …}, jwt_key)

Скрипт ha_token.py запускается внутри CT 106, кладёт токен в /root/.ha-token. Срок — год (HA проверяет только exp).

Подключённые интеграции (24)

Интеграция Что даёт
Radarr диск, очередь, здоровье, список фильмов
Sonarr очередь, ближайшие эпизоды, здоровье
Lidarr очередь, диск
Jellyfin медиатека
Google Cast телевизоры как media_player (когда включены)
SpeedTest скорость интернета
Ping × 13 присутствие устройств
Nmap Tracker загружен, но сущности не создаёт

Сущностей: 34 (sensor 14, binary_sensor 14, calendar, todo, person, zone…).

Подключение через config flow

POST /api/config/config_entries/flow        {"handler": "radarr"}
POST /api/config/config_entries/flow/{id}   {"url": "...", "api_key": "..."}

Схема приходит плоским списком: [{"type":"string","name":"url",…}]. Подставлять значения надо по name, иначе HA отвечает required key not provided.

Что не получилось

  1. Paperless-NGX. API работает: /api/status/ → 200, версия 3.3.2, токен принят. Но интеграция HA отвечает cannot_connect при любых вариантах URL и verify_ssl. Причина не найдена; Paperless доступен из контейнера HA (проверено wget).
  2. Immich, Nextcloud, Uptime Kuma — нужны свои ключи/пароли.
  3. Gitea, Frigate, Prowlarr — нет официальных интеграций в HA core.
  4. nmap_tracker — не создаёт сущности ни из YAML (платформа убрана), ни через config flow (интеграция loaded, трекеров 0).

Присутствие устройств

Ping-датчики добавлены для всех не-контейнерных устройств, у которых есть IP. Сейчас их 13: оба телевизора, две колонки, роутеры, Proxmox, Tuya, PlayStation, ПК, телефон, lwip0.

Выключенные устройства в инвентаре имеют адрес 0.0.0.0, поэтому добавить их в HA нельзя — появится адрес, появится датчик.

VIDAA (Hisense)

У VIDAA нет открытого API. Варианты:

  • DLNA — телевизор принимает медиа по сети; интеграция dlna_dmr добавится, когда ТВ включён и отвечает.
  • HACS-компонент vidaa — управление по локальному протоколу, требует установки HACS (сейчас его нет).
  • ADB и Android TV команды не подойдут — это не Android.