initial aubox skeleton: web-UI, kirin DLOAD, firmware library

- FastAPI Web-UI auf 127.0.0.1:8080 mit Geräte-Live-Erkennung,
  sandboxed File-Browser, Firmware-Library (SQLite + Auto-Identifikation)
- Huawei update.app Parser: extrahiert Hardware-ID, Section-Layout,
  BOOT/SYSTEM-Vorhandensein direkt aus den Headern
- Kirin Download-Mode: hisi-idt-Protokoll-Implementation gegen pyusb
- USB-Erkennung für Huawei (DLOAD/Fastboot-D), Google, MediaTek, Qualcomm EDL
- Huawei-P10-Lite-Workflow (eRecovery + Testpoint-DLOAD-Pfade)
- Docker-Compose mit USB-Passthrough (Major 189) für Re-Enumeration
- udev-Regeln + Setup-Script für Debian/Ubuntu/Pi-OS

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Stefan Hacker
2026-04-26 12:09:39 +02:00
parent d0386b3c53
commit fb3534553b
35 changed files with 1883 additions and 0 deletions
+59
View File
@@ -0,0 +1,59 @@
# Loader-Files
Hier kommen die hersteller-signierten Stage-Loader rein, ohne die im
Kirin-Download-Mode nichts geht. Diese Dateien sind **nicht** im
Repo — du musst sie selbst beschaffen. Drei Wege:
## Aus einer passenden update.app extrahieren (sauberster Weg)
Eine update.app ist ein Container, in dem alle Partitions-Images +
einige Loader liegen. Werkzeug: `splituapp` oder `Huawei Update Extractor`.
```bash
pip install splituapp
splituapp -f update.app
```
In den extrahierten Files suchst du nach:
- `xloader.img` / `hisi-sec_usb_xloader.bin`
- `fastboot.img` -> wird zu `fastboot.bin`
- Manche Builds: `usb_loader.bin` separat
Vorteil: signiert + zur Hardware passend. Garantiert kompatibel.
## Aus Tool-Distributionen rausziehen
Tools wie HCU-Client, DC-Unlocker, manche Octopus-Plugins liefern
Loader-Sets im Installer mit. In `<install>/loaders/` oder
`<install>/data/`. Nach Filenamen wie oben suchen. Hash gegen einen
update.app-Auszug abgleichen, falls möglich — du willst kein
manipuliertes Binary auf den Phone-eMMC schreiben.
## Aus Forum-Mirrors
XDA-WAS-LX1-Threads, hovatek-Forum, 4PDA-Threads. Risiko: Manipuliert.
Immer SHA-256 gegen mehrere Quellen prüfen. Wenn nur eine Quelle, lass
es sein und nimm den update.app-Weg.
## Erwartete Struktur
```
loaders/
└── kirin/
└── kirin960_lite/ # für Kirin 658 (P10 Lite)
├── hisi-sec_usb_xloader.bin
├── usb_loader.bin
└── fastboot.bin # optional
```
Pro SoC eigenes Unterverzeichnis. Wenn du später z.B. einen Kirin 970
hinzufügst: `loaders/kirin/kirin970/`.
## Rechtliches
Diese Loader-Files sind urheberrechtlich Huawei. Aus *eigenen
Geräten*-Firmware extrahieren ist in DE/EU für private Reparatur
unproblematisch (Recht auf Reparatur, EU 2024/1799). Weiterverbreiten
ist es nicht — also: nicht ins Repo committen, nicht öffentlich
spiegeln. Das `loaders/`-Verzeichnis steht deshalb in `.gitignore`.
View File