Ufanet Intercom для Home Assistant

Интеграция для управления домофонами Ufanet и просмотра видео с камер в Home Assistant.

Возможности

• 🔘 Кнопки открытия домофона — управление домофонами через кнопки в Home Assistant
• 📹 Камеры — просмотр видео с камер домофонов в реальном времени
• 🔐 Безопасное хранение — пароли и токены хранятся в защищенном хранилище Home Assistant
• 🔄 Автоматическое обновление токенов — интеграция автоматически обновляет токены доступа

Требования

• Home Assistant версии 2025.2.4 или выше
• Аккаунт Ufanet с доступом к домофонам
• Номер договора и пароль от личного кабинета Ufanet

Установка

Через HACS (рекомендуется)

1. Убедитесь, что HACS установлен и настроен
2. Перейдите в HACS → Интеграции
3. Нажмите на три точки в правом верхнем углу → Пользовательские репозитории
4. Добавьте репозиторий:
   • URL репозитория: https://github.com/adonixis/ufanet_intercom_ha
   • Тип: Интеграция
5. Найдите Ufanet Intercom в HACS и установите
6. Перезагрузите Home Assistant

Ручная установка

1. Скопируйте папку custom_components/ufanet в директорию custom_components вашего Home Assistant
2. Перезагрузите Home Assistant

Настройка

1. Перейдите в Настройки → Устройства и службы
2. Нажмите Добавить интеграцию
3. Найдите и выберите Ufanet Intercom
4. Введите:
   • Номер договора — номер вашего договора с Ufanet
   • Пароль — пароль от личного кабинета Ufanet
5. Нажмите Подтвердить

После успешной настройки интеграция автоматически:

• Найдет все доступные домофоны
• Создаст кнопки для открытия каждого домофона
• Создаст камеры для просмотра видео (если доступны)

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

Кнопки открытия домофона

После настройки для каждого домофона будет создана кнопка с именем домофона. Нажмите на кнопку, чтобы открыть дверь.

Кнопки можно использовать в:

• Автоматизациях
• Сценариях
• Панелях управления

Камеры

Камеры автоматически появляются в Home Assistant и доступны для:

• Просмотра в реальном времени
• Использования в автоматизациях
• Интеграции с другими компонентами

Пример использования в Lovelace:

type: picture-entity
entity: camera.ufanet_12345_camera_1
camera_image: camera.ufanet_12345_camera_1

Безопасность

• Пароли и токены хранятся в защищенном хранилище Home Assistant
• Токены автоматически обновляются при необходимости
• Данные не передаются третьим лицам

Устранение неполадок

Ошибка аутентификации

Если появляется ошибка "Invalid login or password":

• Проверьте правильность номера договора и пароля
• Убедитесь, что у вас есть доступ к домофонам в личном кабинете Ufanet

Камеры не отображаются

• Убедитесь, что у вашего аккаунта есть доступ к камерам
• Проверьте, что домофоны поддерживают видеонаблюдение
• Перезагрузите интеграцию в настройках

Домофоны не найдены

• Убедитесь, что у вашего аккаунта есть доступ к домофонам
• Проверьте подключение к интернету
• Попробуйте переустановить интеграцию

Разработка

Установка для разработки

1. Клонируйте репозиторий:

   git clone https://github.com/adonixis/ufanet_intercom_ha.git
   cd ufanet_intercom_ha

2. Установите зависимости:

   pip install -r requirements.txt

3. Скопируйте custom_components/ufanet в custom_components вашего Home Assistant

Структура проекта

custom_components/ufanet/
├── __init__.py          # Инициализация интеграции
├── api.py               # API клиент для работы с Ufanet
├── button.py            # Платформа кнопок
├── camera.py            # Платформа камер
├── config_flow.py       # Настройка через UI
├── const.py             # Константы
├── manifest.json        # Метаданные интеграции
└── strings.json         # Локализация

Поддержка

• 📝 Issues — сообщить о проблеме
• 💬 Discussions — обсуждения и вопросы

Лицензия

См. файл LICENSE для подробной информации.

Автор

@adonixis

---

Примечание: Эта интеграция не является официальным продуктом Ufanet и разработана независимым разработчиокм.