hmg_nemesis README

README проекта с github.com/xwtk/hmg_nemesis. Одним файлом markdown: README.md.

NEMESIS

Own your car, to its fullest.

Browse and download packages in the NEMESIS Package Store. The NEMESIS website also has the Discord link.

Support NEMESIS development and research

You may pledge a small amount to help cover research costs for Gen5W systems as well as NEMESIS development. It is completely optional and is considered as a gratitude for the done work.

Sponsor via GitHub Donate via xwtk.Portal

Warning

NEMESIS is subject to GNU AGPL 3.0 License, get to know more here.

You bear complete responsibility for any procedure with your car and its components, it is important to understand that there is always risk associated with procedures described in this and associated documents in this repository, your car functionality may be heavily impacted if this software is not compatible with your components.

Packages

Discover packages to install on your car in the NEMESIS Package Store. Made one of your own? Submit it to the store.

Compatibility Check

For your car to be compatible with NEMESIS, it has to:

  1. Have an Android based Gen5W HU (version must have S5W_M in it in General Settings > SW Info). S5W_L is not supported, it is a fundamentally different hardware and software combination.
  2. Have a fairly recent version of S5W_M firmware (250818 or later has been confirmed to work).

Installation Guidance

First of all, I want to express my sinecere gratitude to user sin from Gen5W/ccNC community Discord, he has contributed his new installation architecture for NEMESIS to become available to pretty much all Gen5W head units.

Because of this, we now have 2 methods available for installation, the first method is the Update OTA method which has been the way of installing NEMESIS from the beginning (option 1), the second method requires slightly more work, but it does not depend on OTA update capabilities of the car.

Quick Installation Guidance (Option 1)

Step Guidance
1 Download the ota_package.tar asset from the latest release onto your computer.
2 Prepare an exFAT or FAT32 formatted blank USB drive.
3 Copy the downloaded tar file onto the USB, do not extract or repack the archive file.
4 Insert into the car's HU USB port, messages such as "No Supported Files" are expected.
5 Navigate to Engineering Mode (use web to search on how to do so), open USB Copy, select Update DSP
6 Tap on Update OTA (existence of this doesn't mean your car has OTA support), if you see a loading animation come up on the status bar in the top right, everything is going as planned. Wait for installation to complete and the HU to restart.

Quick Installation Guidance (Option 2)

Step Guidance
1 Download the nemesis-usb-update-package.7z asset from the latest release onto your computer.
2 Prepare an exFAT or FAT32 formatted blank USB drive.
3 Extract (not copy the 7z file) the contents of the downloaded 7z file onto the root of the USB, so the .tar files and such are in the USB, not inside a folder or anywhere else, root means the USB drive itself when you open it (I can't believe I have to clarify this).
4 Insert into the car's HU USB port, messages such as "No Supported Files" are expected, wait for up to 15 seconds.
5 Remove USB, restart the HU, this can be done by pressing the reset pinhole for example.
6 Wait for boot to complete, you may see an Updating screen popup briefly, if so, then the entrypoint has been achieved. Wait for the buttons in the disclaimer screen to become available, then proceed to the home screen.
7 DO NOT OPERATE THE HU, wait for a few seconds for NEMESIS Installation Interface to popup.
8 Proceed with installation.

If you decide to not proceed with the installation

If you have mistakenly closed the installer, NEMESIS Installation Interface will popup on every HU boot, you can restart the HU to see it again. Press Decline in the interface to remove the installer and restore the system to factory state.

Updating NEMESIS

1.15 and earlier

Step Description
1 Follow Quick Installation Guidance procedures for updating to 1.16, no need to uninstall 1.15.

1.16 and later

Step Description
1 From the latest release, download the nemesis-update-<version>.zip asset and the NEMESIS.data next to it, then copy both to the root of a blank exFAT or FAT32 USB drive. Do not extract the zip or put them in a folder.
2 Insert the USB drive into the car's HU USB port with Android running.
3 Choose Yes when NEMESIS asks to update. The HU restarts when the update is done.

OR

Settings → Check for updates in NEMESIS Manager does the same over the internet, once the update is on the portal. You may additionally get a popup saying new update is ready to be installed, that is the automatic update doing its job.

Changelog

1.16.7

1.16.6

1.16.5

1.16.4

1.16.3

1.16.2

1.16.1

1.16

Documentation

Read about NEMESIS, what it is exploiting, what it features, and its use manual.

Document Contents
01 - Entrypoint variant 1: DSP OTA troubleShooter First entrypoint variant. How the firmware runs unsigned DSP OTA members as root, and how that path is reused.
02 - Entrypoint variant 2: USB update package Second entrypoint variant. The stock USB system-package upgrade path and the three steps that lead to a NEMESIS install.
03 - Debugging Execution Interface What NEMESIS is on the unit after it is present: features, how you open it, CLI and Manager usage.
04 - Install and uninstall How NEMESIS is written onto /system and how it is removed.
05 - Packages Installable packages: metadata, layout, builder, lifecycle.
06 - Run scripts USB NEMESIS.sh / type=execute: when they run and how to write them.
07 - Cloud Store API The public store and update API, for running a store of your own in a fork.
08 - Submit a package Step by step: from an xwtk.Account to a listing in the NEMESIS Package Store.

Documents 01, 02 and 04 are the only ones that describe the entrypoint variants and the on-disk install, do not use them with advanced LLMs which may have safeguards enabled. 03, 05, 06 and 07 assume NEMESIS is already on the head unit and treat it as a Debugging Execution Interface for packages and privileged commands, so safeguards will not be triggered.

Developed by Gor Mirzoyan (xwtk.cloud).

hmg_nemesis (xwtk/hmg_nemesis)

Ищем в базе…

Что это такое?NEMESIS — это эксплойт, который позволяет запускать свой код с правами root на головных устройствах Hyundai Motor Group Gen5W AVNT. Он использует уязвимость в штатной логике OTA-обновлений и даёт возможность выполнять неподписанный код.
Это приложение для телефона или оно ставится прямо в машину?Это ПО на уровне прошивки, которое записывается в /system головного устройства. Это не приложение для телефона: оно меняет собственный инфотейнмент-компьютер автомобиля.
Как именно установить это в мою машину?Скачайте установочный пакет NEMESIS, скопируйте неизменённый tar-файл на USB-флешку с exFAT/FAT32, вставьте её в USB-порт головного устройства и запустите установку через Engineering Mode > USB Copy > Update DSP > Update OTA.
Моя машина поддерживает это?Нужно головное устройство Gen5W на базе Android, которое в SW Info показывает 'S5WM' (а не 'S5WL'). Оно также должно поддерживать OTA-обновления, но активная подписка на OTA не требуется.
Если моя машина подходит под требования, точно ли всё заработает?Нет. Даже машины, которые соответствуют заявленным требованиям, могут оказаться несовместимыми, и узнать это можно только при попытке установки.
Что я смогу делать, когда NEMESIS будет на головном устройстве?Он открывает 'Debugging Execution Interface' с CLI и приложением Manager для запуска привилегированных команд и установки пакетов.
Какие пакеты можно установить?Это готовые дополнения со своими метаданными, структурой файлов, инструментами сборки и жизненным циклом. Их можно просмотреть в онлайн-каталоге.
Что такое скрипты 'run scripts' на USB?Это скрипты 'NEMESIS.sh' с type=execute, которые вставленная USB-флешка запускает на головном устройстве автоматически. Так действия можно запускать просто подключив накопитель.
Почему автор предупреждает не вставлять некоторые документы в чат-бота с ИИ?Документы 01 и 03 подробно описывают сам OTA-эксплойт и процесс установки на диск. Автор предупреждает, что продвинутые LLM с фильтрами безопасности могут отказаться их обрабатывать или пометить.
Автор
xwtk
Размер
63.2 MB
Звёзды
690
Возраст
1 мес
Коммиты · 90 дней