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 是一种漏洞利用程序,借助现代汽车集团 Gen5W AVNT 车机原厂 OTA 更新逻辑中的缺陷,让你能以 root 权限运行自己的代码,实现未签名代码执行。
这是手机应用,还是要装进汽车本身?它是固件级软件,会被写入车机的 /system 目录,而不是手机应用,它修改的是汽车自带的信息娱乐电脑。
我到底要怎样给车装上它?下载 NEMESIS 安装包,将未经修改的 tar 文件复制到 exFAT/FAT32 格式的 U 盘中,插入车机(HU)的 USB 接口,然后依次通过 Engineering Mode > USB Copy > Update DSP > Update OTA 触发安装。
我的车支持这个吗?你需要一台基于 Android 的 Gen5W 车机,并且在 SW Info 中显示 “S5WM”(而非 “S5WL”),同时必须支持 OTA 更新,无需有效的 OTA 订阅。
只要符合要求,我的车就一定能用吗?不能保证。即便符合所列要求的车辆,仍可能被判定为不兼容,只有实际尝试安装才能知道。
NEMESIS 装到车机后,我能做什么?它会提供一个 “Debugging Execution Interface”(调试执行接口),包含命令行界面(CLI)和 Manager 应用,用于运行特权命令和安装软件包。
可以安装哪些软件包?这些是预先制作好的扩展组件,各自带有元数据、文件结构、构建工具和生命周期管理,可通过在线目录浏览。
USB “运行脚本”是什么?插入 U 盘后会自动在车机上运行的 “NEMESIS.sh” 脚本(type=execute),只需插上 U 盘即可触发相应操作。
作者为什么警告不要把某些文档粘贴到 AI 聊天机器人中?文档 01 和 03 详细描述了原始 OTA 漏洞利用及写入磁盘的安装过程,作者警告带有安全过滤机制的高级大语言模型可能会拒绝处理或将其标记。
作者
xwtk
大小
63.2 MB
星标
690
时长
1个月
提交 · 90 天