[GUIDE] BMW MGU Store — полное руководство по установке для iDrive 7 / iDrive 8

BMW MGU Store — установка приложений на BMW iDrive 7 / iDrive 8 (полное руководство)​#

Всем привет!
Недавно я наткнулся на интересный проект с открытым исходным кодом для владельцев BMW, оснащённых мультимедийной системой MGU (iDrive 7 / iDrive 8).
Проект называется MGU Store. Он позволяет устанавливать, обновлять и удалять приложения прямо на головном мультимедийном устройстве BMW, используя репозитории GitHub, веб-ссылки или USB-флешку.
По сути, это App Store для системы iDrive вашего BMW, который позволяет управлять дополнительными приложениями и инструментами.
Официальный репозиторий GitHub:
https://github.com/robertnisipeanu/mgu-store
Лицензия: GPL-3.0

---

1. Что такое MGU Store?​#

MGU Store — проект с открытым исходным кодом, созданный для мультимедийных систем BMW на базе архитектуры MGU.
Он устанавливает на головное устройство несколько компонентов:

• MGU Store: основной интерфейс для просмотра и установки приложений.
• Updater: загружает и устанавливает запрошенные обновления.
• Deploy Tool: управляет установкой и позволяет откатываться к предыдущим версиям.
• App Privacy: управляет отображением приложений в отчётах, отправляемых с головного устройства в BMW.
• Renderer: обеспечивает графическую поддержку для приложений.
• Python: обеспечивает поддержку приложений, работающих непосредственно на головном устройстве.
• Internet Uplink: позволяет приложениям выходить в интернет через разные способы подключения.

Что с ним можно делать?​#

• Устанавливать приложения из репозиториев GitHub.
• Добавлять внешние источники приложений.
• Обновлять установленные приложения.
• Удалять приложения.
• Устанавливать приложения с USB-флешки.
• Управлять репозиториями и аккаунтами GitHub.
• Просматривать логи установки и искать причины ошибок.

2. Совместимость​#

Важно: iDrive 8 разработчик тестировал в эмуляторе, а не на реальном автомобиле. Не следует считать поддержку iDrive 8 равнозначной проверке на настоящем оборудовании.
Перед началом точно определите, какой мультимедийный блок установлен в вашем BMW.

3. Требования​#

Вам понадобится:

1. BMW с совместимым головным устройством MGU.
2. Ноутбук или ПК под управлением Windows 10/11, Linux или macOS.
3. Кабель ENET для первоначальной настройки SSH.
4. Root-доступ по SSH и соответствующий приватный ключ.
5. Установленный на компьютере OpenSSH.
6. Подключение к автомобилю через ENET или Wi-Fi — в зависимости от этапа установки.
7. Стабильное питание автомобиля во время установки.

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

4. Подготовка головного устройства — включение root-доступа по SSH​#

Это предварительный этап.
Для установки своих компонентов MGU Store требуется root-доступ по SSH к мультимедийному блоку.
Для этой процедуры используется следующий проект:
https://github.com/cauliflowermossgrape/idrive7-8-ssh-root
Этот проект позволяет включить SSH-доступ на блоках BMW MGU через подключение ENET.

Перед включением SSH​#

ОБЯЗАТЕЛЬНО: СДЕЛАЙТЕ РЕЗЕРВНУЮ КОПИЮ КОДИРОВКИ HU_MGU!
Операция прошивки, выполняемая инструментом SSH, может стереть кодировку головного устройства и определения CAFD. Сопряжения BMW Digital Key тоже могут быть удалены.
Перед началом обязательно сделайте резервную копию.

Подготовка​#

1. Скачайте проект idrive7-8-ssh-root с GitHub.
2. Подключите ноутбук к автомобилю кабелем ENET.
3. Переведите автомобиль в нужное диагностическое состояние и не давайте головному устройству выключиться.
4. Запустите приложение, следуя инструкциям разработчика.
5. Введите VIN автомобиля или дождитесь его автоматического определения.
6. Убедитесь, что головное устройство MGU определилось правильно.
7. Используйте функцию Flash + Enable только после проверки совместимости и подтверждения, что резервная копия у вас есть.
8. Дождитесь завершения операции и перезагрузки головного устройства.

После завершения инструмент создаст данные для SSH-подключения и приватный ключ.
Храните приватный ключ и данные для подключения в безопасном месте. С их помощью можно получить root-доступ к мультимедийному блоку.
Важно: прошивку следует выполнять только один раз для каждого головного устройства. Не прошивайте его повторно без необходимости. Для решения последующих проблем, связанных с SSH, предусмотрены функции восстановления, которые не требуют повторной прошивки.

5. Проверка SSH-подключения​#

После включения SSH нужно проверить связь с головным устройством.
Откройте командную строку, PowerShell или терминал Linux.
Проверьте, установлен ли OpenSSH:
ssh -V
Если команда выводит информацию о версии OpenSSH, клиент установлен.
Подключитесь с помощью приватного ключа, созданного на предыдущем шаге:
ssh -i "path/to/mgu_root_key" root@MGU_IP_ADDRESS
Пример:
ssh -i ~/.ssh/mgu_root_key root@172.16.222.97
IP-адрес должен совпадать с адресом, указанным в инструменте SSH, или адресом используемого сетевого подключения. В примере выше указан стандартный адрес точки доступа автомобиля из документации, а не универсальный адрес.
При успешной аутентификации у вас появится доступ к терминалу мультимедийного блока.
Не переходите к установке, пока root-доступ не заработает как следует.

6. Установка MGU Store в Windows​#

Теперь можно перейти непосредственно к установке.
В репозитории MGU Store есть установщик PowerShell, который автоматически скачивает официальный установочный скрипт и запускает его.

Шаг 1 — подключение к автомобилю​#

Подключите ноутбук к точке доступа BMW или используйте подключение ENET, если оно настроено для доступа по SSH.
Убедитесь, что мультимедийный блок доступен по сети.

Шаг 2 — запуск PowerShell​#

Запустите PowerShell.
Перед запуском установщика рекомендуется проверить скачанный скрипт и ознакомиться с его содержимым.
Официальная команда установки:
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/robertnisipeanu/mgu-store/main/deploy/install.ps1))) first-install --identity $HOME\.ssh\mgu_root_key
Если приватный ключ хранится в другом месте, замените путь к нему в SSH-команде.

Шаг 3 — завершение установки​#

Установщик:

• Найдет мультимедийный блок.
• Установит SSH-подключение.
• Выполнит аутентификацию с помощью приватного ключа.
• Передаст необходимые компоненты.
• Установит MGU Store и дополнительные компоненты.
• Подготовит систему к работе.

В конце установщик может спросить, хотите ли вы перезагрузить головное устройство:
Restart the head unit now? [y/N]
Введите:
y
Мультимедийный блок перезагрузится.
После перезагрузки значок MGU Store должен появиться в меню приложений автомобиля.

7. Установка MGU Store в Linux​#

Для пользователей Linux в проекте есть установщик на основе shell-скрипта.
Он скачивает установочный скрипт по HTTPS и взаимодействует с мультимедийным блоком по SSH.

Шаг 1 — проверка зависимостей​#

Откройте терминал и выполните:

Шаг 2 — установка MGU Store​#

Официальная команда:
curl -fsSL https://raw.githubusercontent.com/robertnisipeanu/mgu-store/main/deploy/install.sh | sh -s -- first-install --identity ~/.ssh/mgu_root_key
Если ваш закрытый ключ хранится в другом месте, измените соответствующим образом параметр --identity.

Шаг 3 — завершение установки​#

Дождитесь завершения установки.
Когда появится запрос на перезагрузку:
Restart the head unit now? [y/N]
Подтвердите, введя y.
После перезагрузки проверьте, появился ли MGU Store в меню приложений.
Техническое примечание: Использование Linux не означает, что приложения устанавливаются через прямое HTTP-соединение с BMW. Для загрузки установщика используется HTTPS, а сама установка выполняется через SSH.

8. Использование MGU Store​#

После установки интерфейс разделён на четыре основных раздела.

Store​#

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

Установленные​#

Здесь отображаются все установленные приложения.
Доступны следующие функции:

• Обновить
• Обновить всё
• Удалить

USB​#

Позволяет устанавливать приложения и обновления с USB-флешки.
Это особенно удобно для автомобилей без доступа к интернету.

Настройки​#

Здесь находятся основные параметры:

• Управление источниками.
• Подключение к Wi-Fi.
• Аккаунты GitHub.
• Доступ с телефона.
• Проверка обновлений.
• Перезагрузка мультимедийного блока.

9. Добавление репозитория GitHub​#

Одна из самых интересных возможностей — добавление внешних источников приложений.
Порядок действий:

1. Откройте Settings.
2. Выберите Add source.
3. Введите название репозитория или URL GitHub.
4. Выберите тип версии, за которой хотите следить.

Для репозитория GitHub можно выбрать:

• Релизы
• Теги
• Ветки

После добавления источника приложения из этого репозитория могут появиться в Store.
Будьте осторожны с неизвестными источниками. Устанавливайте приложения только из репозиториев, которым доверяете.

10. Установка приложений без интернета — USB​#

MGU Store также поддерживает установку без подключения к интернету.
Для этого метода требуется Node.js 18 или новее.
На компьютере подготовьте установщик mgu-install.js из официального репозитория.
Команда для подготовки USB-накопителя:
node mgu-install.js usb-repo /media/USB
Замените /media/USB на фактический путь монтирования USB-флешки.
Команда подготовит USB-накопитель с последней доступной версией репозитория MGU Store.
Можно также указать дополнительные источники:
node mgu-install.js usb-repo /media/USB github:owner/repo
После подготовки:

1. Безопасно извлеките USB-флешку.
2. Подключите её к USB-порту автомобиля.
3. Откройте в MGU Store раздел USB.
4. Выберите нужное приложение.
5. Следуйте инструкциям по установке.

В документации также описан способ первоначальной установки с USB для головного устройства, на котором MGU Store ещё не установлен:
node mgu-install.js first-install --from /media/USB/mgu-repo/mgu-store --identity ~/.ssh/mgu_root_key

11. Подключение телефона к MGU Store​#

Ещё одна полезная возможность — управлять Store со смартфона.
Порядок действий:

1. Откройте Settings.
2. Перейдите в Phone access.
3. Включите On.
4. Отсканируйте появившийся QR-код.
5. Откройте страницу управления на телефоне.

Там доступны:

• Добавленные источники.
• Доступные приложения.
• Установленные приложения.
• Ошибки.
• Журналы установки.
• Аккаунты и источники GitHub.

Советую отключить доступ с телефона, когда закончите управлять Store.

12. Подключение мультимедийного блока к интернету​#

MGU Store поддерживает несколько способов подключения к интернету:

• Wi-Fi / точка доступа смартфона.
• USB-адаптер Ethernet.
• USB-модем LTE.
• USB-модем Android.
• Персональная точка доступа iPhone через USB.

После успешного подключения в Store должен отображаться статус Online.
Обратите внимание: некоторые конфигурации Wi-Fi могут не поддерживаться. В частности, это касается сетей только с WPA3 на отдельных блоках iDrive 7 с беспроводным оборудованием Broadcom.

13. Частые проблемы и способы их решения​#

MGU Store не появляется после установки

• Проверьте, завершилась ли установка без ошибок.
• Убедитесь, что головное устройство перезагрузили.
• Проверьте логи установщика.

Не удаётся подключиться по SSH

• Проверьте подключение ENET или Wi-Fi.
• Проверьте IP-адрес.
• Проверьте путь к приватному ключу.
• Проверьте, запущена ли служба SSH.

Отказано в доступе (publickey)
Убедитесь, что используете правильный приватный ключ, созданный инструментом активации SSH.
Приложению требуется перезапуск
Некоторые изменения применяются только после перезапуска головного устройства. Если требуется перезапуск, MGU Store отображает статус Restart pending.
Не удаётся установить с USB

• Проверьте структуру папок на USB-накопителе.
• Убедитесь, что репозиторий скопирован правильно.
• Проверьте, поддерживает ли приложение вашу версию iDrive.

---

14. Важные рекомендации​#

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

Неправильные изменения могут повлиять на работу мультимедийной системы или потребовать дополнительных процедур восстановления.

15. Полезные ссылки​#

Основной проект — MGU Store:
https://github.com/robertnisipeanu/mgu-store
Активация root-доступа по SSH для MGU:
https://github.com/cauliflowermossgrape/idrive7-8-ssh-root
Официальная документация:
https://github.com/robertnisipeanu/mgu-store#readme
Руководство по разработке приложений:
https://github.com/robertnisipeanu/mgu-store/blob/main/docs/PUBLISHING.md

---

Заключение​#

MGU Store — интересный проект для владельцев BMW, которые хотят расширить возможности мультимедийной системы и не ограничиваться только оригинальными приложениями BMW.
Возможность устанавливать приложения с GitHub, управлять внешними репозиториями и обновлять компоненты прямо через интерфейс автомобиля даёт немало свободы.
Проект имеет открытый исходный код, а за его разработкой можно следить прямо на GitHub.
Если вы проверяли MGU Store на своей BMW, расскажите в комментариях о модели автомобиля, годе выпуска, версии iDrive и общих впечатлениях.
Удачного кодинга и приятного знакомства с возможностями вашей BMW!