Интеграция с Home Assistant

У Car 2 Home есть полноценная интеграция с Home Assistant, которая делает вашу машину настоящим участником умного дома, а не очередным источником данных. Она работает либо как нативный компонент Home Assistant (устанавливается через HACS и общается с приложением напрямую по WebSocket), либо как обычный клиент MQTT. Поддерживаются оба пути, выбирайте тот, что подходит вашей установке.

Нативный путь особенный тем, что не ограничивается публикацией датчиков. Ваш автомобиль отправляет события в шину событий Home Assistant: поездка началась, поездка закончилась, найден код неисправности, резкое ускорение, ЭБУ в сети. А значит, можно писать автоматизации, которые реагируют на моменты, а не только на числа, пересекающие порог.

Два пути, один результат

Интеграция с Home Assistant

Собственная интеграция Home Assistant, устанавливаемая через HACS. Home Assistant создаёт шестизначный код привязки, который вы вводите в приложении. Никаких токенов и никакого брокера. Обмен идёт в обе стороны по WebSocket: Home Assistant получает через приложение каждый датчик и каждое событие из машины и, пока приложение на связи, может менять настройки вроде режима синхронизации и запускать другие действия.

MQTT (любой брокер)

Если у вас уже работает Mosquitto, EMQX, HiveMQ или другой брокер, либо вы хотите, чтобы данные шли в Home Assistant или в другие инструменты вроде Node-RED, openHAB, ioBroker, Car 2 Home публикует те же датчики с полным автоопределением MQTT для Home Assistant. Разница в том, что путь MQTT несёт непрерывное состояние, а не события: такие вещи, как trip_started или dtc_found, существуют только в нативной интеграции.

Как установить

1. 1. Установите через HACS

   Откройте HACS в Home Assistant, добавьте Car 2 Home из списка интеграций и перезапустите Home Assistant. (Если HACS ещё нет, сначала установите его с hacs.xyz.)

2. 2. Добавьте интеграцию

   В Home Assistant зайдите в Настройки → Устройства и службы → Добавить интеграцию и найдите "Car 2 Home". Home Assistant создаст код привязки.

3. 3. Свяжите по шестизначному коду

   В приложении, в Настройки → Home Assistant → Интеграция, укажите публичный адрес вашего Home Assistant и код привязки. Готово.

4. 4. Выберите режим синхронизации

   Режим "Онлайн" передаёт телеметрию в реальном времени, пока вы за рулём. Режим "Только Wi-Fi" копит данные в приложении, пока вас нет дома, и выгружает их в тот момент, когда телефон подключается к сети Wi-Fi. Удобно, если у Home Assistant нет публичного адреса или вы бережёте мобильный трафик.

Что вы получаете

Каждый автомобиль в вашем гараже становится устройством в Home Assistant со своим набором сущностей. Имена строятся по образцу car2home_{brand}_{model}_{sensor}, с добавлением прозвища, которое вы дали машине, если оно задано, так что несколько автомобилей никогда не перепутаются. Сущности используют механизм RestoreSensor: они сохраняют последнее известное значение через перезапуски и не становятся недоступными только оттого, что двигатель заглушен.

• Стандартные датчики OBD-II: скорость, обороты, температура охлаждающей жидкости, уровень топлива, положение дросселя, лямбда и остальной каталог SAE J1979, который поддерживает ваша машина.
• Датчики конкретной марки и модели: расширенные PID, различающиеся по бренду и модели, находятся автоматически.
• Вычисляемые датчики: мгновенный расход, скользящий расход (окна 10, 50 и 100 км), мощность на колёсах, запас хода, пройденное расстояние.
• Местоположение: высота, точность и сущность device_tracker для автомобиля.
• TPMS: давление, температура и идентификатор датчика по каждому колесу.
• Состояние диагностики: лампа Check включена или выключена, число кодов, стоп-кадр, напряжение адаптера, ЭБУ в сети или нет, состояние связи с Home Assistant или MQTT.
• Манера вождения: текущие оценки безопасности и экономичности, счётчики резких событий, история по месяцам.

События в шине событий Home Assistant

Именно это отличает нативную интеграцию. Ваши автоматизации могут слушать отдельные моменты вместо того, чтобы опрашивать состояние.

• car2home_trip_started: срабатывает в момент начала поездки (запуск двигателя плюс движение). В данных идут идентификатор машины и место старта.
• car2home_trip_ended: срабатывает в конце поездки, с полной сводкой: расстояние, длительность, средняя и максимальная скорость, израсходованное топливо, адрес парковки.
• car2home_dtc_found: диагностическое сканирование завершилось и нашло коды. В данных идут режим сканирования и списки подтверждённых, ожидающих и постоянных кодов.
• car2home_harsh_event: обнаружено резкое ускорение, торможение или поворот. Полезно для уведомлений о безопасной езде, особенно с начинающими водителями.
• car2home_ecu_online / car2home_ecu_offline: срабатывает всякий раз, когда связь с ЭБУ появляется или пропадает, так что вы отличите "машина едет прямо сейчас" от "машина припаркована".

Примеры автоматизаций

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

• Открыть ворота гаража и включить свет у входа, когда вы въезжаете на свою улицу (геозона плюс trip_started).
• Сообщить семье адрес парковки и ссылку на карту в момент окончания поездки.
• Прислать оповещение в Telegram, когда сканирование находит коды, с числом подтверждённых, ожидающих и постоянных.
• Заранее охладить дом в момент, когда вы выезжаете из офиса (геозона работы плюс trip_started).

Совместимость и требования

• Home Assistant 2024.12 или новее.
• Работает с Nabu Casa Cloud, Cloudflare Tunnel, Tailscale или любым обратным прокси, которому вы уже доверяете.
• Несколько автомобилей: каждая машина в гараже появляется отдельным устройством Home Assistant, со своими сущностями и своей историей.
• Токены хранятся в связке ключей iOS или в Android Keystore, но не в настройках приложения.