README.md

«ПИК Домофон» для Home Assistant

Управление домофонами в экосистеме группы ПИК. Поддержка просмотра видеопотока и открытия дверей.

Intercom management within PIK Group ecosystem. Video feed and door unlocking supported.

💵 Пожертвование на развитие проекта

💬 Техническая поддержка

Библиотека API «ПИК Домофон»: alryaz/pik-intercom-python

Интеграция для личного кабинета ЖКХ «ПИК Комфорт»: alryaz/hass-pik-comfort

Скриншоты

Просмотр видеопотока домофона

Открытие двери у домофона

Установка

Также рекомендуется установить компонент AlexxIT/WebRTC. Он позволяет просматривать видеопотоки в реальном времени через окна браузера.

Home Assistant Community Store

🎉 Рекомендованный метод установки.

1. Установите HACS (инструкция по установке на оф. сайте).
2. Добавьте репозиторий в список дополнительных:
   1. Откройте главную страницу HACS.
   2. Откройте раздел Интеграции (Integrations).
   3. Нажмите три точки сверху справа (допонительное меню).
   4. Выберите Пользовательские репозитории.
   5. Скопируйте https://github.com/alryaz/hass-pik-intercom в поле вводавыберите Интеграция (Integration) в выпадающем списке -> Нажмите Добавить (Add).
   6. Выберите Интеграция (Integration) в выпадающем списке.
   7. Нажмите Добавить (Add).
3. Найдите PIK Intercom (ПИК Домофон) в поиске по интеграциям.
4. Установите последнюю версию компонента, нажав на кнопку Установить (Install).
5. Перезапустите сервер Home Assistant.

Вручную

⚠️ Внимание! Данный вариант не рекомендуется в силу сложности поддержки установленной интеграции в актуальном состоянии.

0. (предварительно) Создайте (если отсутствует) папку custom_components внутри папки с конфигурацией Вашего Home Assistant.
1. Скачайте архив с интеграцией:
   1. Для загрузки последней стабильной версии:
      1. Перейдите на страницу последнего релиза
      2. Нажмите на кнопку скачивания исходного кода (текст: Source code (zip))
   2. Для загрузки последней "превью"-версии (не стабильно, может не работать вовсе):
      1. Перейдите по ссылке скачивания исходного кода
2. Откройте папку hass-pik-intercom-#### внутри загруженного архива (#### - индекс версии интеграции).
3. Извлеките содержимое папки custom_components внутри архива в Вашу папку custom_components (из шага №0).
4. Перезапустите сервер Home Assistant.

Настройка

Нажмите на кнопку выше, или следуйте следующим инструкциям:

1. Откройте Настройки -> Интеграции
2. Нажмите внизу справа страницы кнопку с плюсом
3. Введите в поле поиска PIK
   • Если интеграция не была найдена на данном этапе, перезапустите Home Assistant и очистите кеш браузера.
4. Выберите первый результат из списка
5. Следуйте инструкциям, описываемым на экране.
6. После завершения настройки начнётся обновление состояний объектов.

• Вариант А: Через Интеграции:
• Вариант Б: YAML (см. пример ниже)

Пример конфигурации YAML

pik_intercom:
  # Номер телефона.
  # Поддерживается свободный формат ввода.
  username: 79876543210

  # Пароль для входа
  password: super_password

Использование компонента

ℹ️ Каждый объект компонента обладает атрибутом id, указывающим на внутренний идентификатор объекта.

От данной информации можно отталкиваться в автоматизациях.

Просмотр видео — платформа camera

На данный момент реализовано потоковое видео и получение снимков (JPEG).

Данная возможность является экспериментальной; при возникновении ошибок, создайте issue.

Открытие дверей — платформа button

Компонент открывает доступ к нескольким объектам на платформе button, соответствующим кнопкам открытия дверей, ассоциированных с домофоном.

Одним из объектов является button.last_call_session_unlocker. Данный объект является вспомогательной абстракцией и позволяет выполнить открытие домофонной двери, с панели которой был выполнен вызов.

Чтобы открыть дверь домофона, достаточно воспользоваться службой button.press. Более подробно почитать про действия объекта типа «кнопка» возможно в официальной документации.

Время звонка — платформа sensor

Объекты с идентификаторами sensor.last_call_session_<...>_at являются отражением временных меток, заданных последней зарегистрированной сессии звонка:

• Created At — время создания записи о вызове
• Updated At — последние обновление данных о звонке
• Finished At — время завершения вызова (ответом, сбросом, или по времени)

N.B. Существует вероятность перехода объектов в состояние unavailable («недоступно»), если API не выдаст информацию о звонке. Необходимо учитывать это в автоматизациях.

Статус звонка — платформа binary_sensor

Объект с идентификатором binary_sensor.last_call_session_active отражает текущее состояние звонка в дверь.

Если производится звонок в дверь, объект меняет своё состояние с off на on. По завершению звонка объект возвращает своё состояние с on на off.

N.B. Существует вероятность перехода объект в состояние unavailable («недоступно»), если API не выдаст информацию о звонке. Необходимо учитывать это в автоматизациях.

Последний звонок в дверь — платформа sensor

Объект обладает ID: sensor.last_call_session

Компонент предоставляет информацию о последнем зарегистрированном в системе звонке.

Счётчики — платформа sensor

Компонент позволяет получить информацию о зарегистрированных счётчиках (пока что только ГВС/ХВС).

N.B. Если Вы обладаете счётчиками другого типа, создайте issue. Их загрузка не гарантируется компонентом.

Отказ от ответственности

Данное программное обеспечение никак не связано и не одобрено ПАО «ПИК СЗ», владельца торговой марки «ПИК Домофон». Используйте его на свой страх и риск. Автор ни при каких обстоятельствах не несёт ответственности за порчу или утрату вашего имущества и возможного вреда в отношении третьих лиц.

Все названия брендов и продуктов принадлежат их законным владельцам.