/pandora-cas

Home Assistant custom component for Pandora Car Alarm System

Primary LanguagePythonMIT LicenseMIT

Home Assistant custom component for Pandora Car Alarm System

hacs_badge Donate

Русский | English

Pandora

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

Компонент использует неофициальный API, полученный в результате reverse engineering, к официальному сайту Pandora https://p-on.ru. Функциональность компонента, в целом, повторяет функциональность, доступную на сайте или в мобильном приложении. Для настройки Вам следует использовать те же авторизационные данные, что вы используете на сайте Pandora.

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

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

Установка

  1. Установите HACS
  2. Перейдите в раздел HACS -> Integrations
  3. Нажмите кнопку "+", расположенную в нижней правой части экрана
  4. Наберите "Pandora" для поиска компонента
  5. Установите компонент Pandora Car Alarm System
  6. Перезапустите Home Assistant

Настройка

  1. Перейдите в раздел Настройки -> Интеграции
  2. Обновите кэш браузера комбинацией Shift+F5
  3. Наберите "Pandora" для поиска интеграции
  4. Выберите Pandora Car Alarm System
  5. Введите логин, пароль, а также частоту обновления информации с сайта p-on.ru
  6. При необходимотсти задайте помещение для автомобиля
  7. Устройства и сенсоры добавятся в Home Assistant
  8. При необходимости, в настройках интеграции выберите единицы измерения топлива, источник данных для одометра и его начальные значения. Для актуализации изменений сенсоров потребуется перезапуск Home Assistant.

Device Tracker

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

Sensors

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

Объект Назначение Примечание
sensor.PANDORA_ID_mileage Пробег км
sensor.PANDORA_ID_fuel_level Уровень топлива % или L
sensor.PANDORA_ID_cabin_temperature Температура салона °C
sensor.PANDORA_ID_engine_temperature Температура двигателя °C
sensor.PANDORA_ID_ambient_temperature Уличная температура °C
sensor.PANDORA_ID_balance Баланс СИМ-карты
sensor.PANDORA_ID_speed Скорость км/ч
sensor.PANDORA_ID_engine_rpm Обороты двигателя ?
sensor.PANDORA_ID_gsm_level Уровень сигнала GSM 0 - 3
sensor.PANDORA_ID_battery_voltage Напряжение аккумулятора В
binary_sensor.PANDORA_ID_connection_state Связь с автомобилем есть / нет
binary_sensor.PANDORA_ID_engine_state Статус двигателя запущен / заглушен
binary_sensor.PANDORA_ID_moving Статус движения в движении / без движения
binary_sensor.PANDORA_ID_lock Статус охраны под охраной / снят с охраны
binary_sensor.PANDORA_ID_coolant_heater Статус предпускового подогревателя включен / выключен
binary_sensor.PANDORA_ID_left_front_door Левая передняя дверь открыта / закрыта
binary_sensor.PANDORA_ID_right_front_door Правая передняя дверь открыта / закрыта
binary_sensor.PANDORA_ID_left_back_door Левая задняя дверь открыта / закрыта
binary_sensor.PANDORA_ID_right_back_door Правая задняя дверь открыта / закрыта
binary_sensor.PANDORA_ID_trunk Багажник открыт / закрыт
binary_sensor.PANDORA_ID_hood Капот открыт / закрыт
binary_sensor.PANDORA_ID_parking Стояночный тормоз (МКПП) или Parking (АКПП)
binary_sensor.PANDORA_ID_brakes Педаль тормоза нажата / отпущена

Команды

Для команд обязательно нужно указывать идентификатор PANDORA_ID. Система должна понять какой именно автомобиль должен выполнить команду, если их несколько.

Внимание! Через 10с после отправки команды будет произведена серия принудительных обновлений состояния автомобиля для более точной фиксации изменения состояния.

Команда Действие Примечание
pandora_cas.lock Поставить под охрану
pandora_cas.unlock Снять с охраны Может быть запрещено настройками блока сигнализации
pandora_cas.start_engine Запустить двигатель
pandora_cas.stop_engine Остановить двигатель
pandora_cas.turn_on_ext_channel Активировать доп. канал См. пример использования
pandora_cas.turn_off_ext_channel Деактивировать доп. канал

Примеры использования команд

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

  - badges: []
    cards:
      - hold_action:
          action: call-service
          service: pandora_cas.start_engine
          service_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

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

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

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