Автоматизация управления охранными системами Pandora™, PanDECT^® и Benish GUARD Force в Home Assistant.

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

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

🥇 Вдохновитель, оригинальный разработчик

Автомобиль тоже может быть частью умного дома. С помощью этого компонента вы сможете отслеживать состояние, управлять и автоматизировать свой автомобиль, если он оборудован охранной системой Pandora. После настройки ваши устройства Pandora™ и PanDECT^® автоматически добавятся в Home Assistant.

Компонент реализует доступ к API официального приложения Pandora, Pandora Connect, и реализует часть его функционала. Для настройки Вам следует использовать те же авторизационные данные, что вы используете на сайте Pandora (pro.p-on.ru), или в мобильном приложении Pandora Online / Connect / Pro.

На данный момент компонент поддерживает:

• Device Tracker: Местоположение автомобиля.
• Sensors: Температура, скорость, тахометр и т.д.
• Binary Sensors: Статусы открытия, движения, и т.д.
• Switches: Работа двигателя, активная охрана, и т.д.
• Lock: Постановка на охрану
• Number: Регулировка климатических систем
• Services: Команды, например: открыть/закрыть, завести/заглушить и др.

Компонент успешно протестирован и отработан на системах:

• PanDECT X-1700 BT
• PanDECT X-1900 BT
• Pandora DX-4G
• Pandora DX-4G S
• Pandora DX-4GL
• Pandora DX-90BT + NAV-10
• Pandora DX-9X LoRa + NAV-10
• Pandora DXL-4970
• Pandora DXL-5570
• Pandora NAV-08 (маячок)
• Pandora VX-4G GPS
• Сообщите о Вашем успехе!

Панель со всеми поддерживаемыми элементами

Вызов службы из панели разработчика

Карточка устройства (тёмная тема)

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

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

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

1. Скачайте архив с актуальной стабильной версией интеграции
2. Создайте папку (если не существует) custom_components внутри папки с конфигурацией Home Assistant
3. Создайте папку pandora_cas внутри папки custom_components
4. Извлеките содержимое скачанного архива в папку pandora_cas
5. Перезапустите сервер Home Assistant

Поддерживается базовый функционал конфигурации через веб-интерфейс Home Assistant. Конфигурация данным способов возможна без перезагрузки Home Assistant.

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

Чтобы активировать компонент, добавьте эти строки в файл configuration.yaml:

# Фрагмент файла configuration.yaml
pandora_cas:
  # Учётная запись на портале p-on.ru / pro.p-on.ru
  password: !secret YOUR_PASSWORD  # обязательно
  username: !secret YOUR_USERNAME  # обязательно

Компонент также поддерживает работу с несколькими учётными записями:

pandora_cas:
  # Первая учётная запись
  - username: !secret YOUR_USERNAME_1
    password: !secret YOUR_PASSWORD_1

    # Вторая учётная запись
  - username: !secret YOUR_USERNAME_2
    password: !secret YOUR_PASSWORD_2

Дополнительно имеется возможость (для всех вариантов конфигурации) использовать раздел устройств для управления включёнными объектами. Для этого:

1. Перейдите в раздел Настройки ⟶ Устройства (/config/devices/dashboard)
2. Найдите Ваше устройство (в колонке Интеграция будет написано Pandora Car Alarm System)
3. Нажмите на найденную строку с устройством
4. Прокрутите страницу вниз до обнаружения надписи +[N] скрытых объектов
5. Нажмите на данную надпись
6. Нажмите на любой из появившихся объектов
7. Во всплывающем окне, переместите переключатель Отображать объект в положение Вкл.
8. Нажмите на кнопку Обновить в нижнем правом углу всплывающего окна

Пример того, как выглядит наполненная страница для устройства модели X-1911BT (нажмите для увеличения):

Для привязки к автомобилю в имени объекта сенсоров используется идентификатор PANDORA_ID, в то время как в человеко-читаемом названии используется название автомобиля с сайта Pandora. Это сделано для того, чтобы при изменении названия автомобиля на сайте не менялись имена объектов, а значит не будет необходимости перенастраивать lovelace UI и автоматизации.

ВНИМАНИЕ!
При добавлении объектов, компонент в отдельных случаях проверяет поддержку функционала конечным устройством. Во избежание неожиданных ситуаций, Вы можете ознакомиться с таблицами поддержки на официальном сайте Pandora: ссылка на документ.

ПРЕДУПРЕЖДЕНИЕ!
Общее количество различных объектов, доступных в компоненте, в скором времени перевалит за 40. Ввиду этого, по умолчанию отключены объекты, встречающиеся наиболее редко, такие как:

• Состояние зарядки и температура аккумулятора гибридных/электрических автомобилей
• Состояние поднятости стёкол и давление в шинах (TPMS), получаемые по CAN-шине

Такие объекты помечаются символом "⚠" в таблицах ниже. Если Вы уверены, что Ваш автомобиль вкупе с установленной на нём системой поддерживают данные функции, то Вы можете включить перечисленные объекты следуя инструкции выше.

¹ Данный объект содержит полный перечень свойств, получаемых в момент обновления состояния автомобиля, и тем самым может быть запросто использован для template-выражений.
² Компонент не тестировался для праворульных транспортных средств. Может возникнуть ситуация, что из коробки данные сенсоры перепутаны местами.

³ Состояние не остслеживается

Для каждого автомобиля будет создан объект device_tracker.pandora_PANDORA_ID, где PANDORA_ID уникальный идентификатор автомобиля в системе Pandora. Доступны все обычные действия для Device Tracker: отслеживание местоположения на карте, трекинг пути, контроль зон и т.д.

Пример отображения маркера на карте (цвет, поворот)

Объект обладает следующими атрибутами:

За период наблюдения компонентом за автомобилем могут происходить некоторые события, чьи свойства не позволяют сделать из них удобные к использованию объекты платформ sensor, binary_sensor и пр. Ввиду этого, для поддержки дополнительных событий введены два новых внутренних делегата:

Данное событие делегирует информацию из системы Pandora прямиком в Home Assistant. Следующие данные будут доступны при получении события:

Код типа события является строкой, которая поверхностно описывает смысл события (на английском языке). Полным списком кодов (кодификатором) возможно обзавестись в файле api.py проекта.

Для всех команд будут выполняться события-уведомители. Данные события содержат следующие данные:

Ключевые команды включения/выключения определённых функций вынесены в отдельные переключаемые объекты (пр. switch и lock). Если же имеется потребность выступить за рамки предопределённых конфигураций, существуют два способа передать дополнительные команды на охранную систему.

Для именованого способа требуется вызов службы в формате pandora_cas.<Постфикс>:

# Именованый способ вызова команд
- action: call-service
  service: pandora_cas.start_engine
  data:
    device_id: 1231234123

Для универсального способа идентификаторы команд (command_id) обязательно должны быть числовыми:

# Универсальный способ вызова команд
- action: call-service
  service: pandora_cas.remote_command
  data:
    device_id: 1234141243
    command_id: 1

Для справки, ниже представлена таблица доступных к выполнению команд ( сгруппированых по смысловому признаку):

Вкладка с кнопкой запуска двигателя

  - badges: [ ]
    cards:
      - hold_action:
          action: call-service
          service: pandora_cas.start_engine
          data:
            id: 1234567890
        icon: 'mdi:fan'
        name: Запуск двигателя
        show_icon: true
        show_name: true
        tap_action:
          action: more-info
        type: button
    icon: 'mdi:car'
    panel: false
    path: honda_pilot
    title: Honda Pilot

Автоматизация включения доп. канала по событию с условиями. Подробнее см. пример использования.

# Фрагмент файла automations.yaml
- id: switch_on_pilot_seat_heaters
  alias: Включить подогрев сидений
  trigger:
    platform: state
    entity_id: binary_sensor.1234567890_engine_state
    to: 'on'
  condition:
    - condition: time
      after: 05:58:00
      before: 06:12:00
      weekday:
        - mon
        - tue
        - wed
        - thu
        - fri
  action:
    service: pandora_cas.turn_on_ext_channel
    data_template:
      id: 1234567890

Конфигурация существует трёх видов:

• Карточка ( содержит только графическое изображение транспортного средства)
• Стек ( карточка + элементы управления + сенсоры)
• Панель ( карта по левую сторону, стек по правую)

Чтобы подготовить собственную конфигурацию, выполните следующие действия:

1. Открыть папку с подготовленными конфигурациями
2. Выбрать файл с желаемым типом конфигурации
3. Скопировать содержимое файла в текстовый редактор
4. Заменить все вхождения REPLACE_WITH_PANDORA_ID на идентификатор автомобиля (device_id на сенсорах)

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

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