Cesar Smart: мониторинг автомобиля в Home Assistant

Я сделал Cesar Smart ReadOnly, чтобы получать данные Cesar Smart в Home Assistant: состояние двигателя и охраны, двери, температуры, топливо, пробег, напряжение аккумулятора и местоположение.

Управляющие команды я намеренно не добавлял. Через интеграцию нельзя открыть автомобиль, запустить двигатель или подать звуковой сигнал. Её задача — передать показания в домашнюю панель и автоматизации.

Здесь описываю версию 0.1.13. Для подключения я использую облачный API мобильного приложения Cesar Smart. Интеграция неофициальная.

Откуда берутся показания

Получение данных я вынес в общий координатор. Он запрашивает статусы устройства, при включённой опции дополняет их расширенной информацией об автомобиле, отдельно обновляет координаты и баланс SIM-карты.

Источник	Базовый интервал в коде
Статусы автомобиля	60 секунд
Местоположение	300 секунд
Расширенная информация	300 секунд
Баланс SIM-карты при включённом опросе	3600 секунд

Интервалы можно менять в настройках. Кроме опроса я добавил WebSocket: события инициируют обновление статусов или передают новые координаты. Периодический опрос оставил отдельным механизмом, чтобы получение данных не зависело только от WebSocket.

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

Установка и сущности

В HACS откройте пользовательские репозитории.
Добавьте https://github.com/roblencheg/cesar-smart-hass с типом Integration.
Установите интеграцию и перезапустите Home Assistant.
В Настройки → Устройства и службы → Добавить интеграцию выберите Cesar Smart ReadOnly.
Введите данные аккаунта Cesar Smart и выберите машину, если их несколько.

YAML для подключения не требуется. Опции WebSocket и интервалов доступны в настройках интеграции.

Данные распределены между обычными сенсорами, бинарными сенсорами и device_tracker. Например, напряжение аккумулятора можно вывести графиком, открытые двери — индикаторами, местоположение — на карте Home Assistant. Набор заполненных полей зависит от автомобиля и того, что возвращает Cesar Smart.

На этих сущностях можно построить уведомление о выезде из домашней зоны или контроль напряжения аккумулятора. Готовые автоматизации я в интеграцию не включал: условия и проверку свежести данных нужно настроить под свой сценарий.

Баланс SIM-карты

Сенсор SIM Balance по умолчанию отключён в реестре сущностей Home Assistant. Чтобы показать его, откройте сущности устройства и включите этот сенсор. Видимость сенсора и опрос баланса — разные настройки.

Для случая, когда значение остаётся unknown, я добавил два диагностических действия:

cesar_smart.force_refresh с include_balance: true — запросить обновление с балансом;
cesar_smart.balance_probe — отдельно проверить ответ сервиса баланса и обновить данные.

При нескольких подключениях укажите соответствующий entry_id согласно описанию действия в HA.

В версии 0.1.13 я исправил разбор ответа, в котором значение приходит внутри списка — data[0].balance1.balance. Также добавил извлечение валюты и времени обновления. Поэтому unknown не обязательно означает отсутствие денег на SIM: возможны отсутствие данных, другой формат ответа или ошибка запроса.

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

Почему здесь нет управления

Режим только для чтения я закрепил в структуре проекта: подключаются сенсоры, бинарные сенсоры и трекер. В API-клиенте нет методов отправки управляющих команд. Отдельный набор тестов проверяет, что командные платформы и методы не появились.

Служебные действия обновления и диагностики обращаются к данным. Они не являются запуском двигателя или управлением охраной.

Для управления автомобилем у меня есть GWM RU. Эта интеграция работает через другое облако и отдельную учётную запись GWM. Показания двух интеграций могут различаться по составу и времени обновления; автоматически объединять их в один достоверный статус без учёта источника не стоит.

Исходники

Репозиторий и инструкция установки.
Релиз 0.1.13.
Исходники на момент публикации: координатор, сенсор баланса, API-клиент и tests/test_no_commands.py.