GWM RU: Haval в Home Assistant

Я сделал GWM RU, чтобы видеть состояние своего Haval и управлять им из Home Assistant. Интеграция работает через российское облако GWM: получает GPS, топливо, данные шин и статусы автомобиля, а также отправляет удалённые команды.

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

Репозиторий я назвал HAVAL_H3, а в Home Assistant интеграция отображается как GWM RU, с доменом gwm_ru. Здесь описываю версию 1.1.7. Подтверждённая в проекте конфигурация — Haval H3 и российское приложение GWM 2.3.1. Поддержку других моделей не обещаю: доступность функций зависит от облака и комплектации.

Что появляется в Home Assistant

Данные	Что можно вывести на панель
Состояние	Двигатель, центральный замок, двери, багажник, окна и люк
Топливо	Литры, проценты, запас хода и общий пробег
Шины	Давление, температура и отдельные предупреждения TPMS
Климат	Состояние климата, обогревов и передних сидений
Связь	Доступность TBOX, результат и история команд
Местоположение	GPS-сущность и карта поездок

Это обычные сущности Home Assistant: их можно использовать в стандартных карточках, уведомлениях и автоматизациях. Для каждой машины аккаунта создаётся отдельное устройство.

Список функций определяется по данным автомобиля. Наличие кнопки в примере конфигурации не доказывает, что соответствующее действие поддерживает конкретная машина.

Пульт и подготовка автомобиля

Я предусмотрел шесть карточек: основную, анимированный пульт в двух ориентациях, Studio в двух ориентациях и карту поездок. У каждой есть визуальный редактор и выбор автомобиля.

Мой горизонтальный пульт Studio: состояние автомобиля, управление и телеметрия.

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

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

Карточка поездок хранит GPS-точки локально в Home Assistant и при наличии использует Recorder для заполнения пропусков. Частота и полнота маршрута зависят от поступающих координат.

Подключение

1. В HACS добавьте https://github.com/roblencheg/HAVAL_H3 как пользовательский репозиторий категории Integration, если интеграция ещё не найдена в каталоге.
2. Установите GWM RU и полностью перезапустите Home Assistant.
3. Откройте Настройки → Устройства и службы → Добавить интеграцию → GWM RU.
4. Укажите телефон и пароль аккаунта GWM.
5. Для команд добавьте PIN из приложения и включите удалённое управление в настройках интеграции. По умолчанию оно выключено.

Для одновременной работы с мобильным приложением используйте отдельный аккаунт с доступом через «Поделиться автомобилем». Работа приложения и интеграции под одной учётной записью может приводить к завершению сессии.

Карточки добавляются через редактор Dashboard. В стандартном storage-режиме Lovelace ресурс регистрируется автоматически. Для ручной конфигурации, например, доступен такой тип:

type: custom:gwm-vehicle-remote-modern-horizontal-card
controls:
  - engine
  - climate
  - refresh
telemetry:
  - engine
  - fuel
  - range
confirm_controls: true

Автомобиль выбирается в визуальном редакторе. В ручных вызовах действий лучше явно указывать vin, entry_id или device_id, особенно при нескольких аккаунтах и машинах.

Задержки и состояние команд

Обновление состояния по умолчанию выполняется раз в 300 секунд, пауза между командами — 5 секунд. Показания зависят от связи автомобиля с облаком, поэтому панель не является прямой трансляцией данных из CAN-шины.

Топливо в процентах рассчитывается из литров и ёмкости бака, полученной от GWM. Если ёмкость неизвестна, процент не вычисляется. Подпись «На охране» означает закрытый центральный замок, а не отдельное подтверждение штатной сигнализации.

В 1.1.7 я добавил восстановление истёкшей сессии: после повторной авторизации исходный запрос повторяется один раз. Одновременные запросы используют восстановленную сессию. Для этого поведения в проекте есть тесты с имитацией облака; их результаты не выдаю за проверку команд на автомобиле.

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

Ещё два моих проекта решают соседние задачи: Cesar Smart ReadOnly получает статусы через другое облако, а H3 Telemetry выводит данные непосредственно на приборную панель.

Код и релиз

• Репозиторий и установка.
• Релиз 1.1.7.
• Исходники на момент публикации: manifest.json, const.py, services.py и документация карточек.