Интеграция с 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. Выберите режим синхронизации

   Режим «Онлайн» передаёт телеметрию в реальном времени, пока вы едете. Режим «Дом» копит данные в приложении, пока вас нет, и выгружает их, как только телефон возвращается в вашу сеть: удобно, когда Home Assistant доступен только из дома. Приложение выбирает адрес по текущему соединению, поэтому дома берёт локальный, а в дороге удалённый.

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

Каждый автомобиль в вашем гараже становится в Home Assistant устройством со своим набором сущностей. Имена следуют шаблону car2home_{brand}_{model}_{sensor}, с прозвищем, которое вы дали машине, если оно задано, поэтому две машины одной модели никогда не пересекутся. Какие датчики экспортировать, решаете вы, так что список остаётся настолько коротким или настолько полным, насколько вам нужно. Выбор делается на экране «Датчики, поддерживаемые автомобилем» в приложении: датчик экспортируется, пока он активен и его переключатель HA/MQTT включён.

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

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

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

• car2home_trip_started: срабатывает в момент начала поездки (запуск двигателя плюс движение). В данных идут идентификатор машины и место старта.
• car2home_trip_ended: срабатывает в конце поездки, с полной сводкой: расстояние, длительность, средняя и максимальная скорость, израсходованное топливо, адрес парковки.
• car2home_parking_detected: срабатывает при парковке и несёт место, время и дистанцию поездки, остаток топлива и запас хода. На него вешают автоматизации «я дома».
• 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, но не в настройках приложения.