---

Зачем это нужно

Штатный бортовой компьютер BYD занижает расход на 10-30%. BYDMate берёт данные напрямую из BMS (energydata) и показывает реальное потребление. Плюс данные, которых нет в штатной системе: расход на стоянке, баланс ячеек, стоимость поездок, AI-аналитика.

Все основные функции (поездки, зарядки, автоматизации, локальные инсайты, офлайн голосовой агент) работают локально на DiLink и не требуют интернета. Облачные функции выключены по умолчанию и включаются только вручную вводом ключа. Что именно и когда уходит в сеть, описано в разделе «Данные и сеть».

---

Что нового

Главное, что появилось в BYDMate после версии 3.0.

Разделение экрана на прошивках UI7. После обновления прошивки экран делит сама машина: панели 1/3 и 2/3, разделитель и жест обмена родные, BYDMate только запускает выбранную пару приложений. Выбор механизма в настройках на таких прошивках не показывается, он там один.

Триггер «Клавиша руля». Любую клавишу руля можно повесить на своё действие: Автоматизация, добавить триггер, «Клавиша руля», нажать нужную клавишу в режиме обучения. Выключили или удалили правило, клавиша снова работает по заводу.

Память о водителе. Агент запоминает имя и устойчивые предпочтения, если сказать ему об этом. Фраза «забудь …» убирает один факт, список фактов и кнопка «Забыть всё» в Настройки → Голос-агент → Агент.

Подсказки навигатора на лобовое стекло (HUD). Манёвр, дистанция до него, улица, время прибытия и знак ограничения скорости выводятся на заводской проекционный дисплей. Ведение продолжается, даже когда навигатор свёрнут или выведен на приборку. Нужна комплектация с HUD. Подробнее в разделе «HUD».

Разделение экрана 1/3 + 2/3. Два приложения на экране одновременно: навигатор пошире, музыка или мессенджер поуже. Запуск с виджета, из автоматизации и голосом. Если окна BYDMate на вашей прошивке недоступны, есть режим «Родное разделение» силами самой прошивки. Подробнее в разделе «Разделение экрана».

Камеры слепых зон. По включённому поворотнику картинка с боковой камеры сама появляется на приборке или в окошке на экране. Если сзади-сбоку обнаружена машина, окно подсвечивается оранжевой рамкой.

Голосовой AI-агент по-русски. Распознавание речи работает прямо в машине, без интернета. Простые команды исполняются мгновенно, остальное решает AI-агент: читает данные машины, управляет кузовом и климатом, строит маршруты, запускает сценарии и отвечает голосом. Подробнее в разделе «Голосовой AI-агент».

Ручной расчёт запаса хода. Если автоматический расчёт по истории поездок не подходит, в настройках батареи можно задать свою таблицу расхода в зависимости от температуры батареи.

---

Возможности

---

Скриншоты

Dashboard

Вокруг SOC-кольца расположены четыре значения в стиле плавающего виджета: сверху длительность поездки, одометр и температура в салоне; снизу пробег текущей поездки, расчётный запас хода и расход текущей поездки со стрелкой тренда. Цвета и логика тренда такие же, как в плавающем виджете, поэтому информация читается одинаково и на главном экране, и поверх других приложений.

Ниже кольца: AI-инсайт, малая карточка здоровья батареи (SoH на Leopard 3, температура, 12V), два счётчика TRIP 1 и TRIP 2, последние поездки, фильтр периода. Каждый счётчик показывает пробег, расход в кВт·ч (включая стоянку), время в пути и стоимость с момента сброса. Долгое нажатие сбрасывает счётчик, касание открывает детали.

AI Инсайты

Анализ эффективности вождения — расход, тренды, батарея, рекомендации (локально или через LLM)

Здоровье батареи

Температура, SoH (на Leopard 3), 12V аккумулятор, баланс ячеек, напряжение

Поездки

Аккордеон Месяц > День > Поездка с фильтрами и цветовой индикацией расхода

Автоматизация

Правила КОГДА→ТОГДА, редактор условий и действий, настройки срабатывания

Настройки

Разделы: Голос-агент, Виджет, Дисплей, Разделение экрана, Авто и батарея, Места, Интеграции, Сервис и данные, Приложение

Разделение экрана

Две панели 1/3 и 2/3, виджет BYDMate поверх

---

Автоматизация

Вкладка Автоматизация позволяет создавать правила для автоматического управления автомобилем напрямую через системный интерфейс машины.

Принцип работы

КОГДА условие выполняется → ТОГДА выполнить команду.

Примеры:

• SOC < 20% → включить внутреннюю циркуляцию
• Скорость > 0 → закрыть шторку
• Температура за бортом < 0 → включить подогрев зеркал

Возможности

Логика

• AND — все условия должны выполняться
• OR — достаточно одного условия
• Только на P — правило срабатывает только когда авто на паркинге

---

Вывод на приборку

BYDMate умеет выводить выбранное приложение (по умолчанию навигацию) на приборную панель за рулём, чтобы карта и манёвры были перед глазами, а центральный экран оставался свободным.

Управление кнопкой руля

• Короткое нажатие выбранной кнопки переносит навигацию на приборку.
• Повторное короткое нажатие возвращает её на центральный экран.
• Удержание правой звезды работает штатно (меню машины), BYDMate его не перехватывает.

По умолчанию проекцию включает правая звезда. Кнопку можно переназначить, см. «Выбор кнопки» ниже.

Включение

Откройте Настройки → Дисплей и включите тумблер «Проекция на приборку». Приложение само активирует нужный сервис (нужна выполненная активация ADB при установке, см. «Установка») и само переводит приборку в режим проекции: за это отвечает тумблер «Сразу показывать на приборке», он включён по умолчанию. На головном устройстве вручную ничего настраивать не нужно.

После этого короткое нажатие выбранной кнопки руля (по умолчанию правая звезда) переносит выбранное приложение на приборку и обратно.

Если «Сразу показывать на приборке» выключить, приборку придётся один раз перевести в режим проекции самому: иконка проекции на главном экране головного устройства, затем кнопка IPC на появившейся карте. Выключать стоит, если после вывода на приборку с неё пропадает ADAS или штатный виджет и не возвращается сам (на части прошивок DiLink 5.0 экран проекции живёт внутри штатной мини-карты): с выключенным тумблером приложение не трогает режим приборки, это касается и камер слепых зон, а картинка видна в мини-карте.

Режимы проекции: «Заводской» и «Расширенный»

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

«Заводской» (по умолчанию). Приложение не меняет ни одной системной настройки: проекция работает через виртуальный дисплей (картинка зеркалится на приборку), ползунки подстройки окна работают точнее. Ставится и удаляется бесследно. Ограничение: голосовой агент и HUD не видят экран навигатора во время проекции, подсказки о манёврах агент берёт только из уведомления Навигатора.

«Расширенный». Навигатор запускается отдельным окном прямо на дисплее приборки, поэтому голосовой агент и HUD видят маршрут во время проекции. Для этого приложение включает системную настройку оконного режима (enable_freeform_support). Режим включается только через диалог с объяснением, после включения нужна однократная перезагрузка головного устройства (долгое зажатие колёсика громкости). Новый режим применяется при следующем выводе на приборку.

Как вернуть заводские настройки. Переключите режим обратно на «Заводской»: приложение сразу вернёт системную настройку к заводскому значению, а перезагрузка ДиЛинка полностью завершит возврат. После этого система в том же состоянии, что и до установки BYDMate.

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

Если вы пользовались проекцией в версиях до 3.7, при обновлении прежнее поведение сохранится автоматически: режим останется «Расширенный». У тех, кто проекцию не включал, приложение системные настройки не трогает вообще.

Выбор кнопки

По умолчанию проекцию включает правая звезда руля. Если этой кнопки нет или удобнее другая, под тумблером нажмите «Изменить» и нажмите нужную кнопку на руле, приложение её запомнит. Назначить можно любую кнопку руля, которую видит система. Системные кнопки (громкость, питание и т.п.), обзор 360 и карусель приборки назначить нельзя.

Какое приложение проецировать

По умолчанию на приборку выводится Яндекс.Навигатор. Под тумблером включения есть выбор приложения: можно указать любое установленное (другой навигатор, медиаплеер и т.д.). Новый выбор применяется при следующем нажатии кнопки.

Размер и положение окна

В разделе Настройки → Дисплей → «Размер окна на приборке» пять ползунков. Если на вашей машине проекция и так занимает всю приборку (например, Leopard 3), настраивать ничего не нужно: значения по умолчанию дают прежний полноэкранный режим.

• Ширина и Высота (20-100%) - размер окна в процентах от приборки. Уменьшенное окно освобождает место, штатная приборка просвечивает вокруг.
• Сдвиг по горизонтали (0-100%) - положение окна: 0 - левый край, 50 - центр, 100 - правый край. Действует, только когда ширина меньше 100%.
• Сдвиг по вертикали (0-100%) - то же по вертикали: 0 - верх, 50 - центр, 100 - низ.
• Масштаб (50-150%) - крупность интерфейса проецируемого приложения: чем меньше значение, тем мельче надписи и тем больше карты помещается в окне.

Изменения применяются сразу, прямо во время проекции - двигайте ползунок и смотрите на приборку.

Машины с мини-окном на приборке (Sea Lion 07 и похожие)

На части моделей штатная приборка показывает проекцию не на весь экран, а в фиксированной зоне (на Sea Lion 07 - правая треть). Полноэкранное окно там обрезается. Решение: уменьшить окно и сдвинуть его в видимую зону ползунками выше.

Проверенные владельцем Sea Lion 07 значения: ширина 32%, высота 92%, сдвиг по горизонтали 100%, сдвиг по вертикали 6%, масштаб 90%.

Вывести окно на весь экран приборки на таких машинах не получится: зону показа задаёт прошивка панели, и она не управляется.

Как это устроено

Проекция работает в одном из двух режимов, описанных выше. В «Заводском» BYDMate создаёт виртуальный дисплей и зеркалит в него выбранное приложение, не меняя настроек системы. В «Расширенном» приложение запускается отдельным окном прямо на дисплее приборной панели, поэтому голосовой агент и HUD видят маршрут во время проекции. Чтобы перехватывать кнопки руля, приложение включает собственный сервис специальных возможностей (accessibility). Он работает только при включённом тумблере и нужен исключительно для выбранной кнопки. Прошивку и саму машину это не меняет, всё обратимо.

---

HUD

Если в машине есть заводской проекционный дисплей, BYDMate выводит на лобовое стекло подсказки Яндекс Навигатора: значок манёвра, дистанцию до него, название улицы и время прибытия. Отдельным тумблером включается знак ограничения скорости, он передаётся числом. Пока Навигатор предупреждает о камере, вместо стрелки манёвра показывается значок камеры и расстояние до неё. Ведение продолжается, даже когда Навигатор свёрнут или выведен на приборку; Яндекс Карты работают источником подсказок наравне с Навигатором.

Включается в Настройки → Дисплей, раздел «HUD (проекционный дисплей)»: тумблер «Навигация на HUD» и отдельно «Знак скорости под стрелкой». Подсказки идут по штатному каналу самого HUD, поэтому нужна комплектация с проекционным дисплеем. Если такого канала на машине нет, приложение честно пишет об этом в настройках и функцию не включает.

---

Камеры слепых зон

При включённом поворотнике BYDMate сам показывает картинку с боковой камеры: левый поворотник выводит левую камеру на приборку, правый показывает окошко на главном экране. Если датчик видит машину сзади-сбоку, окно подсвечивается оранжевой рамкой.

Включается в Настройки → Дисплей, раздел «Слепые зоны» (по умолчанию выключено). Там же настраиваются порог скорости, ниже которого камера не показывается, ширина окошка и его положение: кнопка «Настроить положение» показывает пустое окошко, которое перетаскивается пальцем туда, где будет камера. Если левая камера на приборке мешает, включите там же «Обе камеры на главный экран»: обе картинки будут показываться на планшете, приборка не трогается. Нужна комплектация с круговым обзором.

---

Голосовой AI-агент

Полноценный русский голосовой помощник внутри BYDMate. Речь распознаётся прямо на головном устройстве, без интернета: нейросеть GigaAM v3 слушает и понимает по-русски. Простые команды исполняются мгновенно локальным разбором, всё остальное решает AI-агент: языковая модель с 32 инструментами, которая сама читает данные машины, управляет функциями кузова, строит маршруты, запускает сценарии и отвечает голосом.

Почему русский, и только русский

Штатный голосовой помощник BYD уже нативно работает с английским и китайским. Делать ещё один английский помощник бессмысленно. BYDMate закрывает то, чего в машине нет вообще: русский язык. Поэтому распознавание речи, разбор команд и голоса озвучки заточены именно под русский, английская версия агента не планируется.

Как включить

1. Настройки → Голос-агент → Распознавание речи: скачайте модель распознавания (226 МБ, один раз, хранится локально).
2. Включите тумблер «Голосовые команды», приложение запросит разрешение на микрофон.
3. Быстрые команды уже работают. Для полного агента включите тумблер «Голосовой AI-агент».
4. Агенту нужен ключ языковой модели (раздел «Интеграции»). Для голосового диалога важна скорость ответа, поэтому рекомендуемый вариант: OpenRouter с быстрой моделью, например Gemini Flash (платно, но доли цента за запрос). Бесплатная альтернатива: ключ z.ai с моделью glm-4.7-flash, работает, но отвечает заметно медленнее. Третий вариант: свой OpenAI-совместимый сервер. Можно задать резервное подключение: если основное не отвечает, агент переключится сам.
5. По желанию включите «Ответы агента» и скачайте голос озвучки (обычный 18-21 МБ, либо улучшенный Марк или Софья 145 МБ), иначе агент отвечает текстом на экране.

Как разговаривать

• Нажмите голосовую кнопку на руле. На Leopard 3 она распознаётся из коробки, на других моделях любую кнопку можно обучить в настройках (перехват кнопки требует службы специальных возможностей, она включается автоматически).
• На экране появляется пилюля-индикатор «Слушаю». Её можно перетащить в любое место экрана, позиция запоминается. В пилюле видны последние реплики: «Ты:» и «Агент:».
• Говорите обычными фразами. Сессия непрерывная: после ответа агента можно сразу говорить дальше, кнопку повторно нажимать не нужно.
• Сессия завершается сама после 30 секунд тишины, с отдельным звуковым сигналом. Ограничения на длительность разговора нет: пока идёт диалог, агент слушает. Короткие сигналы подтверждают приём команды и сообщают об ошибке.
• Перебивание по имени. Если задать агенту имя (поле «Имя агента» в настройках), то во время его ответа достаточно произнести это имя: агент замолчит и снова слушает. Имя в начале фразы отбрасывается («Штурман, открой окна» понимается как «открой окна»). Важно: это не «горячее слово» как у Алисы, без нажатия кнопки агент микрофон не слушает. По умолчанию имя пустое и перебивание неактивно.

Что умеет агент

У агента 32 инструмента. Примеры фраз:

Машина и климат

• «Сколько заряда?», «Какая температура за бортом?», «Какой запас хода?» (живое состояние машины)
• «Открой окна», «Включи подогрев сиденья», «Поставь климат на 22» (полный каталог из 81 команды, см. ниже)
• «Сделай музыку громче», «Потише» (громкость медиа)

Поездки, зарядки, статистика

• «Покажи поездки за неделю», «Сколько я проехал за месяц?»
• «Когда я последний раз заряжался?»
• «Запиши зарядку на 30 киловатт-часов за 200 рублей» (ручная запись в журнал зарядок)
• «Какой у меня средний расход?»

Навигация и места

• «Поехали домой», «Поехали на работу», «Поехали на дачу» (сохранённые места)
• «Найди зарядки рядом»
• «Хватит ли заряда до Казани?», «Сколько ехать до аэропорта?»
• «Запомни это место как дача», «Какие места сохранены?»
• «Выведи навигацию на приборку», «Убери с приборки» (проекция Яндекс Навигатора)

Медиа и приложения

• «Включи мою волну», «Включи джаз» (Яндекс Музыка)
• «Включи на ютубе лекции по истории»
• «Открой навигатор», «Открой камеры», «Открой регистратор», «Открой браузер» и другие приложения по русским именам

Автоматизация

• «Запусти сценарий домой», «Какие у меня сценарии?»
• «Выключи автоматизацию прогрева»
• «Создай сценарий: когда приезжаю домой, открывай окна» (агент сам собирает правило из триггера и действий)

Интернет

• «Какая погода?», «Какая погода в Москве завтра?»
• «Поищи в интернете, когда выйдет обновление DiLink»

Управление машиной: каталог из 81 команды

Безопасность: открытие окон блокируется на скорости выше 120 км/ч, люка выше 80 км/ч, отпирание дверей выше 30 км/ч; передний багажник открывается только на стоящей машине.

Быстрые команды без агента и без интернета

Типовые формулировки исполняются локальным разбором мгновенно, без языковой модели и без сети: окна (включая «приоткрой окно водителя»), температура климата (включая «сделай теплее» и «холоднее»: агент читает текущую уставку и сдвигает на градус), громкость, подогрев и вентиляция сидений уровней 1-3. Всё, что локальный разбор не понял уверенно (отрицания, уровни сидений 4-5, передний багажник, свободные формулировки), передаётся AI-агенту. Если агент выключен или ключ не задан, такие фразы получают отказ, а быстрые команды продолжают работать.

Полный список того, что понимает локальный разбор:

Ключи: что вводить, а что не обязательно

Все ключи вводятся в приложении и хранятся локально, в коде и в репозитории секретов нет.

Голоса

Офлайн-голоса (работают без интернета, скачиваются по одному):

Марк и Софья (движок Supertonic) звучат заметно естественнее обычных, но весят больше и делят один архив: скачав любого, второго уже не докачиваете. Скорость и живость интонации настраиваются слайдерами, рядом кнопка «Прослушать пример».

Онлайн-голоса (опционально, звучат естественнее): Gemini и OpenAI через ключ OpenRouter, MiniMax через свой ключ (три способа подключения: официальный API, fal.run, replicate). Офлайн-подмены нет: если онлайн-голос не отвечает или падает, реплика остаётся текстом в пилюле-орбе, но не проговаривается.

Про громкость: ответы агента идут через голосовой канал BYD (тот же, что у штатных подсказок), его громкость регулируется системной настройкой голоса. Команда «сделай громче» меняет громкость музыки, а не голоса агента. Если агент кажется тихим или громким, крутите системную громкость голоса.

От чего зависит скорость ответа

Агент работает в три шага, и задержка копится на каждом.

1. Речь в текст. Целиком на устройстве, без сети. Скорость упирается в процессор головы.
2. Понимание фразы. Быстрые команды разбираются локальным парсером и исполняются почти мгновенно. Всё остальное уходит в языковую модель: сколько она думает плюс пинг до провайдера. Это и есть основная задержка. Gemini Flash через OpenRouter отвечает за доли секунды, бесплатная glm-4.7-flash заметно медленнее.
3. Озвучка ответа. Офлайн-голоса лёгкие и быстрые, но время всё равно занимают. Онлайн-голоса медленнее: они тоже зависят от пинга.

Нужна максимальная скорость: выключите тумблер «Ответы агента». Озвучки не будет, реплика останется текстом на экране, а работать будут только первые два шага. Быстрые команды при этом исполняются вообще без интернета.

Характер агента

В настройках выбирается один из трёх характеров ответов (по умолчанию «Штурман») и род агента (мужской или женский), от этого зависят формулировки и устные реплики. Там же задаётся имя для перебивания.

Приватность

• Звук с микрофона не покидает машину: распознавание речи полностью офлайн.
• В облако (к LLM-провайдеру) уходит только текст: ваша фраза и данные, которые агент достал инструментами для ответа.
• Голосовой журнал (последние 50 распознаваний с результатами, для самодиагностики) живёт только в оперативной памяти и не сохраняется на диск. Экран журнала: Настройки → Голос-агент → «Голосовой журнал», там видно, как фраза была распознана, куда ушла и чем закончилась.
• Для проверки агента без микрофона есть текстовый чат (отладочный экран в настройках).

Отключение штатного помощника BYD

Внизу раздела «Голос-агент» есть тумблер, который отключает штатный голосовой помощник BYD, чтобы он не просыпался параллельно с агентом. Полностью обратимо, применяется после перезагрузки машины (и включение, и выключение). По умолчанию выключено.

Требования

• Место на диске: модель распознавания 226 МБ плюс голос озвучки (обычный 18-21 МБ, либо улучшенный Марк/Софья 145 МБ на двоих). Итого примерно от 245 до 370 МБ.
• Интернет: нужен только AI-агенту (языковая модель), погоде, поиску и онлайн-голосам. Распознавание речи, быстрые команды и офлайн-голоса работают без сети.
• Разрешения: микрофон (запрашивается при включении) и служба специальных возможностей для кнопки руля (включается автоматически).
• Проверено на Leopard 3 (DiLink 5.0). Голосовая кнопка руля из коробки настроена под Leopard 3, на других моделях обучите свою кнопку в настройках.

Память о водителе

Скажите агенту, как вас зовут или что вы обычно предпочитаете, и он будет помнить это между разговорами. «Забудь …» убирает один факт. Список фактов и кнопка «Забыть всё»: Настройки → Голос-агент → Агент. Факты хранятся только на головном устройстве и уходят лишь в запрос к выбранной вами языковой модели.

---

Плавающий виджет

Компактный overlay 260×108 dp поверх других приложений — видно на карте, в медиа, в BYD-приложениях.

Что показано

Семь полей в 3 строки. Цвета: иконки серые, значения белые. Рамка и SOC% подсвечиваются цветом статуса (SOC или 12V — что хуже).

Верхняя строка (мелким, 13sp):

• ⏱ Длительность текущей поездки — N мин или X ч Y мин (напр. 47 мин, 1 ч 12 мин). Старт — момент включения зажигания, конец — выключение. Простои с включённой машиной (стоишь с кондиционером, пассажир вышел купить воды, светофор) входят в поездку — пока электрика жива, счётчик не сбрасывается
• 🚗 Температура в салоне — °C

Центральная строка (крупно, главные значения):

• SOC % (18sp bold, цветной) — заряд тяговой батареи. Зелёный > 50%, жёлтый 20–50%, красный < 20%
• ~N км (28sp белым) — расчётный запас хода: SOC × ёмкость батареи ÷ baseline-расход × 100. Тильда подчёркивает что это оценка, не показания БК. Подробнее про то, как считается baseline-расход, ниже в разделе «Запас хода»
• X.X ↓ (18sp, цветной по тренду) — расход текущей поездки, кВт·ч/100км, со стрелкой тренда (см. ниже)

Нижняя строка (мелким, 13sp):

• 🔋 Температура батареи — °C
• ⚡ 12V — напряжение бортовой сети, В. Норма 12.5–14.7 В, < 12.0 В = жёлтый, < 11.7 В = красный

Расход и стрелка тренда (правый блок)

Цифра справа — расход текущей поездки в кВт·ч/100км. Считается как энергия, потраченная с момента включения зажигания, делённая на пройденные с того же момента километры. По мере движения цифра сходится к тому значению, которое в итоге запишется в историю поездок: что видно в виджете в момент остановки, то и попадёт в карточку поездки.

Первые 2 километра виджет плавно переходит со среднего расхода прошлой поездки на расход текущей: до 300 м показывает прошлое значение, с 300 м до 2 км линейно подмешивает текущее, после 2 км показывает только текущее. Так не пугают резкие 50–60 кВт·ч/100км из холодного старта и разгона: пока поездка короткая, за основу берётся уже устоявшийся средний расход прошлой поездки, и только когда дистанция становится представительной, цифра уходит на собственный расход.

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

Запас хода ~N км считается по смеси: 50% веса берётся от последней завершённой поездки, 30% от предпоследней и 20% от той, что была до неё (короткие поездки до 3 км в расчёт не идут — это не репрезентативный пробег). Когда едешь длинную дорогу, к этой смеси добавляется ещё расход за последние 10 км текущей поездки: его доля растёт от нуля на первых трёх километрах до половины к 25 километрам. Так прогноз быстро подхватывает смену стиля (городской хвост перед трассой, обратно с трассы в город), но не дёргается на коротких заездах и стоянках с климатом.

Это автоматический расчёт. Если он вам не подходит, в Настройки → Авто и батарея → «Способ расчёта запаса хода» есть метод «Ручной»: своя таблица из 5 точек, температура батареи от +20 до -20 °C и расход при ней, опционально с запасом хода на 100% заряда.

Стрелка тренда появляется после 2 км пробега и сравнивает скользящее 25-километровое среднее с твоим обычным стилем (среднее по последним 10 поездкам):

• ↓ зелёная — едешь экономнее обычного
• → белая (стрелка прямая) — в пределах обычного
• ↑ жёлтая — расход выше обычного

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

Что такое «поездка» для этой цифры. Один цикл зажигания: включил → выключил. Стоянка с включённым кондиционером внутри поездки учитывается естественно — лишние кВт·ч попадают в общий знаменатель. Короткие блипы (светофор, переподключение) не раскалывают поездку на две. Если DiLink прибьёт приложение посреди трассы — после рестарта счёт продолжается с реального момента включения зажигания, а не с нуля.

Управление

• Обычный тап — открыть BYDMate
• Долгий тап (1.5 сек) — скрыть до следующего открытия BYDMate
• Перетащить в корзину — выключить совсем
• Включение, прозрачность, сброс позиции — в Настройки → Виджет

---

Разделение экрана

Два приложения на экране одновременно: одно занимает две трети, второе треть. Типичная пара - навигатор пошире, музыка или мессенджер поуже. Стороны меняются местами, приложения - на ходу, выбранная пара запоминается.

Включение

1. Откройте Настройки → Разделение экрана и включите тумблер «Разделение экрана 1/3 + 2/3».
2. Если под тумблером появилась надпись про перезагрузку - один раз перезагрузите головное устройство (долгое зажатие колёсика громкости). А если у вас уже включён режим проекции «Расширенный», перезагрузка не нужна: всё необходимое уже работает.

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

Механизм разделения

В настройках, под тумблером, выбирается, чем делить экран: «Окна BYDMate» (по умолчанию) или «Родное разделение».

• Окна BYDMate - те самые 1/3 и 2/3 с пилюлей управления, описанные ниже.
• Родное разделение - делит экран сама прошивка машины. Этот вариант работает и там, где окна BYDMate недоступны (DiLink 5.1). Вид зависит от прошивки: где поддерживаются трети, открываются панели 1/3 и 2/3, на остальных экран делится пополам, а второе приложение выбирается системным окном.

На прошивках с новым интерфейсом UI7 выбор механизма не появляется: там разделение выполняет сама машина, панели 1/3 и 2/3 родные, перезагрузка головного устройства для включения не нужна.

Запуск

Три способа. Значок «?» рядом с заголовком секции в настройках напоминает о них прямо в машине.

• С виджета (самый удобный). В настройках, в разделе «Тап по виджету», включите «Зонирование тапов», а в пункте «Действие левого тапа» выберите «Запускать разделение экрана». Теперь тап по левой трети виджета открывает разделение, повторный тап закрывает.
• Из автоматизаций. В правилах есть три действия: «Разделение экрана», «Закрыть разделение экрана» и «Переключить разделение экрана». Можно, например, включать разделение при старте навигации.
• Голосом. Скажите агенту «включи разделение экрана».

Первый запуск и выбор приложений

При первом запуске приложение спросит, что показывать: сначала выбирается приложение для широкой части (2/3), затем для узкой (1/3). Пара запоминается, следующий запуск открывает её сразу. Сменить приложения можно через пилюлю или в настройках; там же есть «Сбросить последнюю пару».

Пилюля управления

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

Как это уживается с остальным

• Если поверх разворачивается что-то полноэкранное (задний ход, камеры, видео), разделение закрывается само. Вернуть его можно любым обычным способом - тапом по виджету или голосом.
• Кнопка «Назад» из BYDMate возвращает к разделению.
• Если запустить штатное разделение экрана DiLink, наше корректно завершится - два разделения одновременно не работают.

---

Зарядки

Вкладка Зарядки автоматически ведёт журнал реальных пополнений заряда: список зарядок по месяцам, статистика за период и за всё время, фильтры AC и DC. Не каждое подключение пистолета становится записью: запись создаётся только если SoC реально вырос. Если кто-то ткнул пистолет и вынул через минуту, в журнал ничего не попадёт.

Что засчитывается как зарядка

Запись пишется, если за время сессии у машины выросла либо ёмкость батареи, либо SoC. BYDMate пробует три источника данных по очереди и берёт первое пригодное значение:

1. Прирост ёмкости в кВт·ч, если бортовая система сообщила обновлённое значение.
2. Прирост SoC за активную сессию, переведённый в кВт·ч по текущей ёмкости батареи.
3. Грубая оценка по дельте SoC от полной номинальной ёмкости, если первые два варианта пустые.

Если BYDMate работает в момент зарядки, запись появляется сразу. Если подключение случилось до запуска приложения или машина уехала в глубокий сон, BYDMate догоняет запись на следующем старте, как только увидит, что SoC прыгнул вверх по сравнению с тем, что было до зарядки. Поэтому даже offline-зарядки в гараже попадают в журнал.

Как определяется AC или DC

Тип зарядки определяется по двум сигналам, по приоритету:

1. Тип разъёма от бортовой системы: gun-state 2 = AC, 3 или 4 = DC. На некоторых моделях BYD значение приходит не всегда, тогда работает следующий пункт.
2. Средняя мощность сессии: больше 15 кВт = DC, иначе AC. AC-зарядка физически не выдаёт больше 11 кВт, DC-станции стартуют от 22 кВт (CCS slow), поэтому порог 15 кВт уверенно разделяет два режима.

На вкладке Зарядки три фильтра: «Все», «AC», «DC».

Ручное добавление и редактирование

Если запись не появилась автоматически или цифры выглядят странно:

• Кнопка + зарядка в шапке вкладки: добавить сессию вручную с указанием даты, длительности, кВт·ч, тарифа.
• Долгое нажатие на запись: открывается меню «Изменить» / «Удалить». В режиме редактирования можно поправить любое поле уже сохранённой зарядки.

Функция в активном тестировании. На Leopard 3 пишется стабильно. На других моделях BYD автоматика может сработать неточно: например, бортовая система не сообщит мощность или тип разъёма, тогда AC и DC может определиться неправильно. В таких случаях правьте записи вручную и при возможности присылайте логи в Issues.

---

Здоровье батареи (SoH)

SoH (State of Health) — это процент «здоровья» тяговой батареи, который рассчитывает сама бортовая система автомобиля по своим внутренним алгоритмам.

На BYD Leopard 3 (Fangchengbao Bao 3) BYDMate берёт это значение напрямую из бортовой системы и показывает в карточке батареи на Главной. Это реальный SoH от машины, а не оценка по разнице SoC: BYDMate просто читает то, что пишет себе сама машина.

На других моделях BYD доступ к этому значению пока не подтверждён, поэтому SoH там не отображается. Остальные ячейки карточки (температура батареи, 12V, разброс ячеек, сопротивление изоляции) работают на всех поддерживаемых моделях.

Тап по карточке открывает экран «Техника»: напряжение и ток тяговой батареи, доступная мощность батареи, лимиты BMS на заряд и разряд, разброс ячеек, температуры моторов и инверторов, климат, давление и температура шин, история SoH и пробега. У каждого параметра есть значок «?» с подсказкой простым языком. Если машина не отдаёт параметр, строка показывает «-», пустые карточки скрываются.

Если в вашей машине SoH доступен и вы хотите помочь добавить поддержку, заведите Issue с указанием модели и года выпуска.

---

SoH и автоматическая запись зарядок (Leopard 3)

SoH и автоматическая запись зарядок на Leopard 3 работают автоматически, отдельно ничего включать не нужно. BYDMate читает значения напрямую от бортовой системы автомобиля, как только активна беспроводная ADB-отладка.

1. Убедитесь, что ADB-отладка активна (см. раздел «Установка»).
2. SoH появится в карточке батареи на Главной, а зарядки начнут записываться автоматически с реальными значениями кВт·ч.

На Leopard 3 эти функции протестированы. На других моделях BYD доступ к этим данным не подтверждён, тогда SoH и точная мощность зарядок могут не появиться, но остальные функции BYDMate работают как обычно.

---

Если у вас не Leopard 3

BYDMate разрабатывается и тестируется на BYD Leopard 3 (Fangchengbao Bao 3). На других моделях BYD большинство функций тоже работает, но есть отличия. Перед первым запуском проверьте:

• История поездок: на Leopard 3 (Fangchengbao Bao 3) BYDMate читает поездки из встроенной BMS-базы energydata. На моделях без этой базы (Song, Yuan и аналоги) поездки теперь записываются нативно, фоновым опросом параметров машины (источник NATIVE_POLLING), так что список больше не пустой. Расход в таких поездках считается по дельте SoC, поэтому он чуть грубее, чем на Leopard 3, где данные берутся из BMS.
• Ёмкость батареи: по умолчанию 72.9 кВт·ч под Leopard 3. Зайдите в Настройки → Авто и батарея и поставьте свою ёмкость. Например, Atto 3 = 60.5 кВт·ч, Seal AWD = 82.5 кВт·ч, Han EV = 85.4 кВт·ч. Без этого расчёт запаса хода и стоимости поездок будет неточным.
• SoH: показывается только на Leopard 3. На других моделях карточка «Здоровье батареи» работает без поля SoH.
• Зарядки: алгоритм AC и DC проектировался под Leopard 3. На других моделях запись может появиться с задержкой или с неточной мощностью, особенно для DC. Используйте ручное добавление и редактирование, если автоматика промахнулась.
• Автоматизация и плавающий виджет: работают одинаково на любой модели, потому что используют системный интерфейс машины.

Если что-то не работает или показывает странное, заведите Issue с указанием модели машины и версии прошивки DiLink - и приложите каталог параметров вашей машины: Настройки → Сервис и данные → «Сохранить каталог fid'ов». Файл fid-dump-….txt появится в папке Download. Внутри только технические идентификаторы параметров - без VIN, без геолокации, без личных данных.

Зачем это нужно. У разных моделей BYD наборы параметров различаются: команда, которая на Leopard 3 включает обдув сиденья, на Song может иметь другой номер или отсутствовать. Именно поэтому часть функций на других машинах не срабатывает. Каталог с вашей машины показывает, как параметры называются и нумеруются именно на вашей прошивке - и мы чиним по этим данным, а не вслепую.

---

Целевое устройство

---

Как работает

BYD energydata (BMS SQLite)  →  HistoryImporter    →  Room DB  →  Compose UI
autoservice (системный Binder) →  TrackingService   ↗     ↓
Android LocationManager     →  TripTracker (GPS)    ↗   LocalInsightEngine / OpenRouter
autoservice (запись команд)  ←  AutomationEngine   ←  Rules (Room DB)

Без OBD-адаптера и без стороннего D+. BYDMate читает данные и управляет машиной напрямую через системный сервис autoservice (тот же, что использует штатная система BYD) под shell-доступом по беспроводной ADB.

---

Данные и сеть

Без введённых ключей наружу уходят только проверка обновлений (GitHub) и тайлы карты при просмотре маршрута поездки, а также скачивание голосовых моделей по явному запросу пользователя (github.com). API-ключи хранятся локально в базе приложения и никуда не передаются, кроме самого провайдера.

---

Установка

1. Активация ADB

Без ADB BYDMate работает как офлайн-журнал поездок: история из штатной базы, карта маршрута, CSV-экспорт, AI-инсайты по уже накопленным данным.

Включённая ADB-отладка нужна для всего, что читает или пишет параметры машины: живые показатели в виджете и на дашборде (SOC, запас хода, температуры, 12V), SoH, автоматический журнал зарядок, автоматизация, вывод на приборку, разделение экрана, подсказки на HUD, камеры слепых зон, управление машиной голосом и запись логов.

Эти фичи включаются автоматически, отдельный переключатель не нужен. При первом запуске BYDMate DiLink один раз покажет диалог «Allow ADB debugging» — нажмите Allow и поставьте галочку «Always allow from this computer», чтобы он не спрашивал заново.

• DiLink 3 / 4 — ADB можно активировать самостоятельно: установите BydDevelopmentTools, зайдите в Настройки → Version Management, 10 раз тапните по тексту Reset to factory default, активируйте Debug Mode when USB is Connected и Wireless adb debug switch. На обновлённых прошивках DiLink 3/4 ADB может быть так же закрыт, как на DiLink 5 — тогда придётся идти по пути ниже.

• DiLink 5.0 — ADB-отладка заблокирована и открывается только удалённо из Китая. Сделать это можно через продавцов на TaoBao (поиск по DiLink 5.0, ~40 ¥ внутри Китая / ~80 ¥ извне, оплата через AliPay). Продавец удалённо открывает инженерное меню по присланному QR-коду, после чего ADB включается штатно.

  Пошаговая инструкция: PDF-гайд (русский) — приложен в репозитории.

ADB отключается после каждой перезагрузки

На прошивках DiLink с лета 2026 (сборки «2606») порт ADB закрывается при каждой перезагрузке головного устройства, и все функции управления машиной перестают работать до ручного включения ADB. Для таких машин в Настройках → Система машины есть тумблер «Восстанавливать ADB после перезагрузки» (по умолчанию выключен): приложение поднимает ADB заново через встроенную в Android беспроводную отладку. Рядом с тумблером есть значок «?» с подробным объяснением, а под ним строка состояния.

Что нужно знать:

• Wi-Fi в машине должен быть включён и подключён к сети (домашней, к раздаче с телефона, любой). Без Wi-Fi Android не даёт включить беспроводную отладку, обойти это нельзя.
• При первом включении на каждой новой сети на экране появится системный диалог «Allow wireless debugging on this network?»: отметьте «Always allow on this network» и нажмите ALLOW. Поэтому удобнее всегда использовать одну и ту же сеть.
• Один раз, пока ADB ещё работает, приложение выдаёт себе системное разрешение WRITE_SECURE_SETTINGS (одной командой через ADB). Без него включить беспроводную отладку нельзя: строка состояния покажет «Нужна активация».
• После загрузки приложение само повторяет попытки, пока Wi-Fi подключён, и реагирует на разблокировку экрана. Обычно ADB возвращается через 10–30 секунд после того, как машина подключилась к Wi-Fi. Удобнее всего, если раздача с телефона уже включена к моменту запуска машины.
• Если на вашей прошивке ADB и так переживает перезагрузку, включать тумблер не нужно: строка состояния покажет «Не требуется».
• Проверено на DiLink 5.0 (Song L) с прошивкой августа 2026.

2. DiPlus (D+) больше не нужен

Начиная с версии 3.0.0 BYDMate работает напрямую с системой машины и не требует стороннего приложения D+ (迪加). Все данные читаются и команды отправляются через системный сервис автомобиля.

Если вы пользовались прежними версиями и устанавливали D+, после проверки работы BYDMate его можно удалить с DiLink.

3. Установка BYDMate

1. Скачайте BYDMate APK из Releases
2. Перенесите на DiLink: через USB-флешку, по сети, или через ADB (adb install BYDMate.apk)
3. Разрешите установку из неизвестных источников, если потребуется

4. Первый запуск

1. Откройте BYDMate — появится мастер настройки
2. Выдайте разрешения на локацию и хранилище. По мере включения функций приложение попросит ещё: микрофон для голосового агента, камеру для камер слепых зон, контакты для звонков по имени, показ поверх других приложений для виджета и уведомлений, доступ к статистике использования для определения активного приложения Постоянное уведомление BYDMate в шторке убрать нельзя (Android требует его для работы в фоне), но его можно сделать тихим: Настройки → Сервис и данные → «Тихое уведомление в шторке».
3. Укажите тарифы на электроэнергию (для расчёта стоимости поездок)
4. В Автоматизации доступен вид действия "Охранный режим": включает или отключает охранный режим BYD (Centuri/Sentry) напрямую через системную настройку, минуя диалог подтверждения штатного приложения

5. Фоновая работа

Важно: отключите "Disable background Apps" для BYDMate, иначе DiLink будет убивать приложение:

DiLink > Settings > General > Disable background Apps > BYDMate = OFF

6. Настройка (опционально)

В Настройках можно изменить:

• Ёмкость батареи — по умолчанию 72.9 кВт·ч (Leopard 3)
• Тарифы — домашний (AC) и быстрая зарядка (DC), валюта
• Пороги расхода — границы для цветовой индикации (зелёный/жёлтый/красный)

---

Система машины

В Настройки → Сервис и данные → Система машины два пункта, которые меняют поведение самой машины, а не приложения.

Колёсико громкости на руле. Тумблер, при котором нажатие ставит воспроизведение на паузу и продолжает его, а не переключает источник звука. Нужен после обновления прошивки, где нажатие стало менять источник. По умолчанию выключено.

Язык интерфейса машины. Только на прошивках UI7. Кнопка открывает скрытый штатный диалог BYD с полным списком языков, включая русский, украинский и польский. Язык меняет сама прошивка, приложение ничего не записывает. У части владельцев на русском перестаёт работать автопарковка, тогда верните English той же кнопкой.

---

AI Инсайты

Карточка на дашборде анализирует вашу статистику за последние 7 дней (сравнение с предыдущими 7) и показывает заголовок, краткий вывод, таблицу метрик и до 5 рекомендаций. Работает без интернета в режиме по умолчанию.

Два режима

Переключатель «Источник анализа» в Настройках → Интеграции. В локальном режиме доступна кнопка «Обновить инсайт» для ручного пересчёта. Автообновление — раз в день (результат кэшируется на устройстве).

Откуда берутся данные

Всё считается из локальной базы Room — без GPS, маршрутов и персональных идентификаторов:

• Поездки — км, кВт·ч, средний расход, скорость, короткие поездки (< 5 км), лучшая/худшая по расходу, стоимость
• Простой с мотором — кВт·ч и часы (idle_drains)
• Ночной простой — сессии, начавшиеся в 22:00–06:00
• Зарядки — AC/DC кВт·ч, число сессий, цена за кВт·ч, общая стоимость за неделю
• 12V — текущее напряжение и тренд за неделю (история до 7 дней)
• Ячейки — разброс max−min в мВ из live-данных машины
• Температура — средняя наружная по поездкам

Минимум для анализа: не менее 5 поездок за последние 7 дней. Иначе карточка покажет «Мало данных для анализа».

Как устроена карточка

1. Заголовок и summary — одно главное сообщение недели. Выбирается правилом с наивысшим приоритетом (см. ниже).
2. Dynamics — таблица «неделя к неделе»: расход, поездки, % коротких поездок, средняя дистанция, простой с мотором, ночной простой (только в локальном режиме).
3. Рекомендации — до 5 bullets из подходящих правил, отсортированных по важности.

Логика локального движка — LocalInsightEngine.kt: детерминированные пороги + шаблоны строк (local_insight_* в strings.xml). Тексты локализованы на 6 языков (ru / en / zh / pt / pl / be).

Приоритет заголовка (локальный режим)

Что важнее — то и в заголовке. Первое сработавшее правило с большим priority:

Рекомендации (bullets)

Параллельно проверяется набор правил; в карточку попадают до 5 самых приоритетных. Примеры тем:

Полный список правил и порогов — в LocalInsightEngine.kt и тестах LocalInsightEngineTest.kt.

Облачный режим (OpenRouter)

Опционально: вместо шаблонов текст генерирует LLM. Настройка:

1. Зарегистрируйтесь на OpenRouter (бесплатно)
2. В личном кабинете OpenRouter создайте API Key (раздел Keys)
3. В BYDMate: Настройки → Интеграции → режим «OpenRouter (облако)»
4. Вставьте API-ключ в поле «OpenRouter API Key»
5. Нажмите «Выбрать модель» — откроется список LLM (есть бесплатные)
6. Нажмите «Сохранить и получить инсайт»

В облачном режиме на сервер уходит только агрегированная статистика (те же метрики, что для локальных правил) — без GPS и маршрутов. Запрос раз в день, ответ кэшируется локально. Таблица dynamics строится так же, как в локальном режиме; от LLM приходят заголовок, summary и формулировки рекомендаций.

---

ABRP — Live телеметрия

BYDMate может отправлять живые показатели машины в A Better Route Planner (ABRP) через официальный Iternio Telemetry API. ABRP использует эти данные, чтобы план маршрута и оценка остатка хода обновлялись по реальному состоянию батареи, а не по средним табличным значениям.

Функция опциональная, выключена по умолчанию и включается вручную в Настройках.

Как получить токен

ABRP использует «Generic Live Data Token» — отдельный токен на каждую машину в гараже:

1. Откройте abetterrouteplanner.com и войдите в аккаунт.
2. Перейдите в гараж и откройте машину, на которой хотите видеть live-данные. Машина должна быть сохранена в гараж, иначе токен не появится.
3. Шестерёнка «Настройки автомобиля» → раздел «Данные» → кнопка «Подключить актуальные данные».
4. В списке провайдеров выберите «Generic» и нажмите «Привязать». Появится длинная строка-токен — это и есть User Token.

Если в списке нет «Generic»: смените код модели машины в гараже ABRP на любую популярную модель BYD (например, BYD Atto 3 или BYD Seal), сохраните, и Generic появится. После привязки токена код модели можно вернуть обратно.

Настройка в BYDMate

1. Настройки → Интеграции → раздел «ABRP — телеметрия».
2. Вставьте полученный токен в поле «Токен живых данных из ABRP».
3. Опционально: код модели ABRP (если знаете точный код своей машины из библиотеки ABRP) и интервал отправки (5–120 сек, по умолчанию 12 сек — рекомендуемое значение Iternio).
4. Нажмите «Сохранить ABRP», затем включите переключатель «Живые данные → A Better Route Planner». Без сохранённого токена переключатель остаётся неактивным.
5. ABRP-приложение на DiLink (или браузер на телефоне) теперь будет видеть актуальный SOC, мощность, температуры, заряд.

Что отправляется

Только агрегированные показатели машины, без идентификаторов:

• SOC — текущий процент заряда тяговой батареи
• Speed — скорость, км/ч
• Power — текущая мощность тяги (отрицательная при зарядке, как требует Iternio)
• Battery / cabin / exterior temp — температуры батареи, салона и за бортом
• Capacity — номинальная ёмкость батареи
• Odometer — пробег, км
• Tire pressures — давление в шинах (4 колеса)
• is_charging / is_parked — флаги состояния
• is_dcfc / kwh_charged — тип зарядной станции (DC vs AC) и количество кВт·ч в текущей сессии
• soh — реальный SoH батареи (Leopard 3)

Что НЕ отправляется

• GPS-координаты не передаются. ABRP запускается как отдельное приложение Android прямо на DiLink и читает геопозицию из ОС сам. Дублировать координаты через сторонний канал не нужно — это лишь утечка позиции на чужой сервер.
• Не отправляются: VIN, идентификатор устройства, история поездок, маршруты, пользовательские настройки.

Как ABRP считает остаток хода

ABRP подбирает прогноз на основе модели машины из своей библиотеки + телеметрии: текущий SOC, температура батареи, скорость движения, ветер, профиль дороги, перепады высот. Свой собственный «расчётный остаток хода» BYDMate в ABRP не передаёт — у ABRP есть собственный, более точный расчёт под конкретный маршрут, в котором учитывается погода и рельеф.

Вебхук: те же данные на свой сервер

Тот же JSON, что уходит в ABRP, можно отправлять POST-запросом на свой адрес: Home Assistant, Node-RED, свой скрипт на VPS. Ничего не хранится в очереди: если сервер недоступен, точка теряется, следующая попытка через минуту.

Настройка

1. Настройки → Интеграции → раздел «Вебхук — телеметрия».
2. URL: только https://. Обычный http:// не пройдёт (Android блокирует незашифрованный трафик, разрешён он только для localhost). Если сервер без сертификата, поставьте перед ним Caddy или nginx с Let's Encrypt, либо туннель вроде Cloudflare Tunnel.
3. Секрет (необязательно): строка, которая уйдёт в заголовке Authorization: Bearer <секрет>. По нему сервер отличает вашу машину от чужих запросов.
4. «Отправлять координаты на вебхук»: по умолчанию выключено. Включайте только если сервер ваш: в JSON добавятся lat, lon, heading.
5. Нажмите «Сохранить вебхук», затем включите переключатель «Живые данные → свой сервер».

Что приходит

POST <ваш URL>, Content-Type: application/json, одна точка в теле:

{"utc":1756040000,"soc":67,"speed":52.0,"power":18.4,"batt_temp":29.0,"ext_temp":24.5,
 "capacity":72.9,"odometer":12345.6,"cabin_temp":22.0,
 "tire_pressure_fl":2.5,"tire_pressure_fr":2.5,"tire_pressure_rl":2.4,"tire_pressure_rr":2.4,
 "is_charging":0,"is_parked":0,"soh":98.5,"car_model":"byd:leopard3"}

Поля и единицы те же, что в Iternio Telemetry API: utc в секундах, power в кВт (как отдаёт машина), температуры в °C, давление шин в бар, odometer в км. Поля без данных (например, speed на стоянке или kwh_charged вне зарядки) просто отсутствуют. Ритм: раз в секунду в движении, раз в 8 секунд на зарядке, раз в 30 секунд на стоянке. Ответ сервера не разбирается, важен только статус 2xx; после ошибки следующая попытка через 60 секунд.

Вебхук работает независимо от ABRP: можно включить только его, только ABRP или оба.

---

Сборка из исходников

# Требуется: JDK 17, Android SDK 34
git clone https://github.com/AndyShaman/BYDMate.git
cd BYDMate
./gradlew assembleDebug

---

Стек технологий

• Kotlin 2.1 + Jetpack Compose + Material 3
• Room (SQLite) + Hilt (DI) + OkHttp
• osmdroid (OpenStreetMap) + Coroutines/Flow
• Min SDK 29 / Target SDK 29 / Compile SDK 34

---

Что делать при ошибках

Если что-то не работает, действуйте по шагам — в большинстве случаев проблема решается первым же пунктом, а если нет, вы поможете нам быстро её найти.

1. Перезагрузите головное устройство. Зажмите колёсико громкости и держите, пока экран не уйдёт в перезагрузку. Часть функций (например, разделение экрана) включает системный флаг, который применяется только при загрузке — без перезагрузки функция выглядит «сломанной», хотя всё в порядке.

2. Запишите логи. Настройки → раздел «Сервис и данные» → кнопка «Запись логов». Воспроизведите проблему (нажмите то, что не работает), затем нажмите «Остановить запись». Файл bydmate_logs_<дата>.txt появится в папке Download (запись останавливается сама через 2 часа, если забыли).

3. Сохраните каталог fid'ов. Настройки → раздел «Сервис и данные» → кнопка «Сохранить каталог fid'ов». Файл fid-dump-<дата>.txt появится в Download. У разных моделей BYD разные каталоги команд — по этому файлу мы адаптируем приложение под вашу машину.

4. Отправьте нам. Создайте задачу в GitHub Issues и приложите: модель машины и поколение DiLink, версию BYDMate, что нажимали и что ожидали увидеть, файлы из шагов 2–3.

Типовые случаи:

• Не работает разделение экрана или проекция на приборку — перезагрузите головное устройство (шаг 1).
• Команда выполняется, но машина не реагирует (окна, люк, климат) — скорее всего, у вашей модели другой каталог команд: пришлите логи и каталог fid'ов (шаги 2–4).
• После обновления что-то сломалось — перезагрузите головное устройство; если не помогло, пришлите логи.

---

Благодарности

• BYD Trip Info (org.jayb.bydapp) by jayb — оригинальное приложение для DiLink, вдохновение для BYDMate
• DiPlus (迪加) by Van Design — приложение-мост к данным автомобиля, использовалось в ранних версиях BYDMate (с 3.0.0 больше не требуется)
• Weather data by Open-Meteo.com
• @klimuts - подсказал механизм auto_container для вывода навигатора на приборку
• @RBGboost - реверс протокола SOME/IP заводского HUD и исходная реализация YandexHUD. Вывод подсказок Яндекс Навигатора на проекционный дисплей в BYDMate - его код и его заслуга. Поблагодарить можно в Telegram: @RBGboost
• byd-turnsignal-cameraview by sunlixWhyNotAvailable — открытое исследование интерфейсов камер и окон DiLink, на котором основана функция камер слепых зон при поворотнике. Реализация в BYDMate написана с нуля, но его разбор сэкономил недели реверс-инжиниринга — спасибо!
• danijar2000 — фикс проекции 2GIS на приборку (2GIS завершался при переносе на дисплей приборки)

---

Поддержать проект

Проект некоммерческий, делаю как хобби. Если захочется поблагодарить, реквизиты в SUPPORT.md. Если нет, всё равно спасибо за доверие.

---

Лицензия

PolyForm Noncommercial 1.0.0 — исходный код открыт, только некоммерческое использование. См. LICENSE для деталей.

Copyright (C) 2026 AndyShaman

---

English version: README.en.md