https://github.com/alryaz/hass-pik-intercom
ПИК Домофон для Home Assistant
https://github.com/alryaz/hass-pik-intercom
custom-component homeassistant intercom pik-group
Last synced: 5 months ago
JSON representation
ПИК Домофон для Home Assistant
- Host: GitHub
- URL: https://github.com/alryaz/hass-pik-intercom
- Owner: alryaz
- Created: 2021-09-16T14:53:14.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-03-17T13:05:15.000Z (over 1 year ago)
- Last Synced: 2025-03-31T09:51:14.436Z (6 months ago)
- Topics: custom-component, homeassistant, intercom, pik-group
- Language: Python
- Homepage:
- Size: 317 KB
- Stars: 54
- Watchers: 3
- Forks: 14
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
_«ПИК Домофон»_ для _Home Assistant_
==================================================
> Управление домофонами в экосистеме группы ПИК. Поддержка просмотра видеопотока и открытия дверей.
>
> Intercom management within PIK Group ecosystem. Video feed and door unlocking supported.
>
> [](https://github.com/custom-components/hacs)
> [](https://opensource.org/licenses/MIT)
> [](https://github.com/alryaz/hass-pandora-cas/graphs/commit-activity)
> 💵 **Пожертвование на развитие проекта**
> [](https://yoomoney.ru/to/410012369233217)
> [](https://www.tinkoff.ru/cf/3g8f1RTkf5G)
> [](https://www.sberbank.com/ru/person/dl/jc?linkname=3pDgknI7FY3z7tJnN)
> [](https://www.donationalerts.com/r/alryaz)
>
> 💬 **Техническая поддержка**
> [](https://telegram.dog/alryaz_ha_addons)
> **Библиотека API «ПИК Домофон»: [alryaz/pik-intercom-python](https://github.com/alryaz/pik-intercom-python)**
> **Интеграция для личного кабинета ЖКХ «ПИК Комфорт»: [alryaz/hass-pik-comfort](https://github.com/alryaz/hass-pik-comfort)**
## Скриншоты
Просмотр видеопотока домофона
Открытие двери у домофона
## Установка
> Также рекомендуется установить компонент [AlexxIT/WebRTC](https://github.com/AlexxIT/WebRTC).
> Он позволяет просматривать видеопотоки в реальном времени через окна браузера.
### Home Assistant Community Store
> 🎉 **Рекомендованный метод установки.**
1. Установите
HACS ([инструкция по установке на оф. сайте](https://hacs.xyz/docs/installation/installation/)).
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. Перейдите на [страницу последнего релиза](https://github.com/alryaz/hass-pik-intercom/releases/latest)
2. Нажмите на кнопку скачивания исходного кода (текст: _Source code (zip)_)
2. Для загрузки последней "превью"-версии (не стабильно, может не работать вовсе):
1. Перейдите по [ссылке скачивания исходного кода](https://github.com/alryaz/hass-pik-intercom/archive/refs/heads/main.zip)
2. Откройте папку `hass-pik-intercom-####` внутри загруженного архива (`####` - индекс версии интеграции).
3. Извлеките содержимое папки `custom_components` внутри архива в Вашу папку `custom_components` (из шага №0).
4. Перезапустите сервер _Home Assistant_.
## Настройка
[](https://my.home-assistant.io/redirect/config_flow_start/?domain=pik_intercom)
Нажмите на кнопку выше, или следуйте следующим инструкциям:
1. Откройте `Настройки` -> `Интеграции`
2. Нажмите внизу справа страницы кнопку с плюсом
3. Введите в поле поиска `PIK`
- Если интеграция не была найдена на данном этапе, перезапустите Home Assistant и очистите кеш браузера.
4. Выберите первый результат из списка
5. Следуйте инструкциям, описываемым на экране.
6. После завершения настройки начнётся обновление состояний объектов.
- **Вариант А:** Через _Интеграции_: [](https://my.home-assistant.io/redirect/config_flow_start/?domain=pik_intercom)
- **Вариант Б:** YAML (см. пример ниже)
### Пример конфигурации YAML
```yaml
pik_intercom:
# Номер телефона.
# Поддерживается свободный формат ввода.
username: 79876543210
# Пароль для входа
password: super_password
```
## Использование компонента
> ℹ️ Каждый объект компонента обладает атрибутом `id`, указывающим
> на внутренний идентификатор объекта.
>
> От данной информации можно отталкиваться в автоматизациях.
### Просмотр видео — платформа `camera`
На данный момент реализовано потоковое видео и получение снимков (JPEG).
Данная возможность является экспериментальной; при возникновении ошибок,
[создайте issue](https://github.com/alryaz/hass-pik-intercom/issues/new).
### Открытие дверей — платформа `button`
Компонент открывает доступ к нескольким объектам на платформе `button`, соответствующим
кнопкам открытия дверей, ассоциированных с домофоном.
Одним из объектов является `button.last_call_session_unlocker`. Данный объект
является вспомогательной абстракцией и позволяет выполнить открытие
домофонной двери, с панели которой был выполнен вызов.
Чтобы открыть дверь домофона, достаточно воспользоваться службой `button.press`.
Более подробно почитать про действия объекта типа «кнопка» возможно в
[официальной документации](https://www.home-assistant.io/integrations/button/).
### Время звонка — платформа `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](https://github.com/alryaz/hass-pik-intercom/issues/new).
Их загрузка не гарантируется компонентом.
## Отказ от ответственности
Данное программное обеспечение никак не связано и не одобрено ПАО «ПИК СЗ», владельца
торговой марки «ПИК Домофон». Используйте его на свой страх и риск. Автор ни при каких
обстоятельствах не несёт ответственности за порчу или утрату вашего имущества и возможного
вреда в отношении третьих лиц.
Все названия брендов и продуктов принадлежат их законным владельцам.