Repository navigation
Behebt Rückstände nach Deinstallationen, die auf ein In-App-Update folgen (A5), und prüft weitere ME7-Prüfsummen –
nur als Prüfung, ohne Korrektur. Keine untersuchte Originaldatei erreicht eine vollständige Checksummenabdeckung;
es gibt keine Flashfreigabe. Release Notes Deutsch/Englisch: RELEASE_NOTES_1.20.1.md.
Installation und Update (A5: Rückstände nach In-App-Update und Deinstallation)
- Deinstallation nach Inventar: Der Deinstaller entfernt zusätzlich genau die Programmdateien, die laut
RUNTIME_INVENTORY.jsonausgeliefert wurden, innerhalb des Programmordners liegen und unverändert sind (SHA-256).
Eigene, unbekannte und veränderte Dateien sowie Verknüpfungen und Junctions bleiben stehen und werden im
Deinstallationsprotokoll genannt. Keine pauschale Löschregel. - Installer-Installationen werden per Installer aktualisiert: „Jetzt nach Updates suchen“ lädt bei einer
Installation mit Installer den geprüftenECU-Studio-AI-<version>-setup.exe(SHA-256 aus dem Release) und führt
ihn mit Sicherung und automatischem Zurücksetzen aus. Portable ZIP-Kopien behalten den bisherigen Weg. - Apps & Features zeigt nach jedem Update die tatsächlich installierte Version.
- Update-Sicherung ohne pauschale Löschregel: Bis 1.20.0 löschte der Deinstaller
ECU-Studio-AI.backupund
ECU-Studio-AI.update-stagingneben dem Programmordner vollständig ([UninstallDelete],filesandordirs), auch
eine dort liegende einzige Kopie einer veränderten oder eigenen Datei. Ab 1.20.1 gibt es keine
[UninstallDelete]-Regel mehr. Beide Ordner werden vor dem Programmordner Datei für Datei bereinigt
(uninstall_cleanup.ps1 -Mode Leftover). Entfernt werden nur unveränderte Inventardateien, byte-gleiche Kopien von
Dateien im Programmordner und Deinstallationsprogramm/-protokoll dieser Anwendung (AppId geprüft). Alles andere
bleibt erhalten; Junctions werden nicht verfolgt. Weil Inno Setup die alten Regeln imunins000.datbestehender
Installationen behält und nach dem Code ausführt, werden beide Ordner vorher in….erhaltenumbenannt; die alten
Regeln finden dann nichts mehr (in der Installer-QA, Modus Repair, gemessen). Scheitert eine Umbenennung (z. B.
Datei darin geöffnet), bricht die Deinstallation ab, bevor sie etwas entfernt; eine bereits erfolgte Umbenennung
wird zurückgenommen. Erzwungen geprüft im Release-Workflow und in der Installer-QA (Modus Blocked). - Updater ohne pauschales Löschen: Bis 1.20.0 löschte der Updater (
updater.ps1) eine vorhandene
ECU-Studio-AI.backup,ECU-Studio-AI.update-staging,ECU-Studio-AI.update-failedund
ECU-Studio-AI.restore-swapvollständig, bevor er sie neu anlegte. Ab 1.20.1 wird kein bereits vorhandener Ordner
mehr als Ganzes gelöscht:- Sicherung und Staging werden in einen freien Namen
….erhalten[-N]umbenannt. Nach einem Fehler oder Rollback
werden sie zurückbenannt. Nach Erfolg werden sie mit denselben Regeln wie beim Deinstallieren Datei für Datei
bereinigt (uninstall_cleanup.ps1 -Mode Leftover, vorher per SHA-256 gegen das Inventar geprüft). Eigene und
veränderte Dateien bleiben in….erhalten. - Die gescheiterte neue Version eines Rollbacks kommt in einen freien Ordner
….update-failed[-N]und wird gegen
die wiederhergestellte Installation ebenso Datei für Datei bereinigt. Vorhandene.update-failed- und
.restore-swap-Ordner werden nie wiederverwendet oder entfernt. - Ganz entfernt werden nur Ordner, die derselbe Lauf selbst angelegt hat (entpacktes Update, unvollständige
Sicherungskopie). Verknüpfungen und Junctions werden dabei nicht verfolgt. - Lässt sich eine vorhandene Sicherung nicht umbenennen (z. B. Datei darin geöffnet), bricht das Update ab, bevor
es etwas verändert (Exit 2). - Geprüft unter anderem für Installer- und ZIP-Weg, vorhandene Sicherung, gesperrte Datei und Rollback.
- Sicherung und Staging werden in einen freien Namen
- Grenze: Das In-App-Update von 1.20.0 auf 1.20.1 führt noch der Updater von 1.20.0 aus. Er ersetzt eine
bereits vorhandeneECU-Studio-AI.backupvollständig. Liegen dort eigene oder veränderte Dateien, installiere
1.20.1 stattdessen mit dem InstallerECU-Studio-AI-1.20.1-setup.exe; er fasst die Sicherung nicht an. Ab 1.20.1
gilt der neue Updater. - Grenze: Updates, die noch der Updater von 1.20.0 oder älter ausführt (auch 1.20.0 → 1.20.1), laufen über den
alten Weg und behalten den alten Deinstaller. Er lässt nach einer Deinstallation drei neue Dateien zurück:
_internal\app\ecu_studio\core\firmware_signatures.py,_internal\app\ecu_studio\core\me7_checksums.pyund
_internal\uninstall_cleanup.ps1. Abhilfe ist eine Reparaturinstallation: den Installer
ECU-Studio-AI-1.20.1-setup.exeeinmal über die Installation ausführen (nach einer Deinstallation: ausführen und
erneut deinstallieren). Das nächste Update durch 1.20.1 oder neuer behebt es ebenfalls. Den Programmordner nicht als
Ganzes von Hand löschen. Nachweis auf Windows Server 2022 und 2025:
Release-Checkliste 1.20.0, A5.
Checksummen & Integrität
- Weitere ME7-Prüfsummen, nur Prüfung: ROMSYS (Startup, Parameterseite, Programmseiten), CRC-Tabelle,
Hauptdaten-Prüfsumme und Hauptprogramm-Prüfsumme. Eigene Umsetzung nach dem quelloffenen ME7Sum. Am Original
gemessen (ME7.5: alle Werte reproduziert), nicht unabhängig validiert. Keine Korrektur; der Status bleibt
„Unvollständige Prüfung“. Hauptdaten-CRC32 und indirekte CRC-Blöcke bleiben als ungeprüft ausgewiesen. - Korrektur verweigert, wenn sie Stimmendes verfälschen würde: Die Vorschau rechnet das Ergebnis vorab nach.
Würde eine Korrektur eine bisher stimmende Prüfsumme falsch machen, wird sie mit Begründung verweigert. - Ehrlicher Status nach Korrektur: Bleiben nicht korrigierbare Prüfsummen falsch, warnt die Vorschau. Die Datei
bleibt danach „Unterstützt und ungültig“ statt „unvollständig“. - Signaturstatus getrennt und streng: Herstellersignaturen in der Firmware haben sechs Status: gültig, ungültig,
Struktur erkannt, erwartet, nicht unterstützt, unbekannt. „Gültig“ und „ungültig“ gibt es nur nach einer echten
kryptographischen Prüfung (Ed25519 oder RSA-PKCS#1 v1.5/SHA-256) mit einem Schlüssel aus einem ausdrücklich
angegebenen Vertrauensspeicher, nie mit einem Schlüssel aus der Datei. Getrennt von Authenticode und
GitHub-Attestations. Signaturen werden nur geprüft, nie erzeugt, verändert oder entfernt. Für keine Familie ist
bisher eine Signatur lokalisiert oder ein OEM-Schlüssel vorhanden; belegt ist die Architektur mit synthetischen
Testschlüsseln. - Details: Checksummen und Integrität.
Release und Tests
- Sichererer Release-Workflow: Titel immer „ECU Studio AI vX.Y.Z“, Release-Text auf Deutsch und Englisch,
Versionsprüfung von EXE, ZIP und Installer, Installer-, Update- und Deinstallationstest auf Windows Server 2022 und
2025, Prüfung von Assets und SHA-256 vor und nach dem Veröffentlichen, Herkunftsnachweis, Firmware-Guard und
Modellsperre. Probeläufe (release-dry-run/**) veröffentlichen nie. - Kennfelderkennung unverändert: 15 reale Vergleichspaare, 14 synthetische Fälle und der Negativ-Benchmark ohne
Unterschied zu 1.20.0.
English
1.20.1 fixes files left behind by an uninstall that follows an in-app update (A5). It also checks further ME7
checksums, but as checks only, without correction. No original file examined so far reaches complete checksum
coverage. ECU Studio AI still never approves a file for flashing.
Bug fixes
-
A5 – uninstall after an in-app update: the uninstaller also removes exactly the program files that meet all
three conditions:- shipped according to
RUNTIME_INVENTORY.json; - inside the program folder;
- unchanged (SHA-256).
In this additional cleanup the user's own, unknown and changed files stay, and so do links and junctions. They are
listed in the uninstall log. There is no blanket delete rule. Files the installer itself installed are removed by
the uninstaller as before. - shipped according to
-
Update backup on uninstall: up to 1.20.0 the uninstaller deleted the folders
ECU-Studio-AI.backupand
ECU-Studio-AI.update-stagingnext to the program folder completely. They can hold the only copy of a changed or
own file, though. From 1.20.1 every file there is checked on its own. Only these are removed:- unchanged program files according to the folder's inventory;
- byte-identical copies (SHA-256) of files in the program folder;
- this application's uninstaller and uninstall log.
Everything else stays and is listed in the uninstall log. The folder is then named
ECU-Studio-AI.backup.erhalten
(orECU-Studio-AI.update-staging.erhalten), so that the old delete rule, which the uninstall log of older
installations still contains, does not reach it either.If one of the two folders cannot be renamed, for example because a file in it is open, the uninstallation stops
before it removes anything and says so. Close the programs that use files from that folder, then uninstall again. -
The updater no longer deletes existing folders as a whole: up to 1.20.0 the updater deleted an existing update
backup (ECU-Studio-AI.backup) and other work folders next to the program folder completely before creating them
again. From 1.20.1:- An existing backup is only renamed.
- If the update fails, the backup gets its name back. If the update succeeds, the backup is cleaned file by file
with the same rules as on uninstall. Your own and changed files stay inECU-Studio-AI.backup.erhalten. - If a file in the backup is open, the update stops without changing anything.
- On a rollback, the failed new version is also cleaned file by file, not deleted.
-
Update through the verified installer:
- Installations made with the installer download the installer
ECU-Studio-AI-<version>-setup.exeon "Check for
updates now". Its SHA-256 checksum is verified against the release. - The installer runs with a backup and rolls back automatically on failure.
- Portable ZIP copies update as before.
- Installations made with the installer download the installer
-
Version shown in Windows: after an update from 1.20.1 on, "Apps & Features" shows the version that is actually
installed.
New features
- Further ME7 checksums, check only: ROMSYS (startup, parameter page, program pages), CRC table, main data
checksum, main data CRC32 and main program checksum.- Own implementation following the open-source ME7Sum.
- Measured on one ME7.5 original: 8 of 8 stored values reproduced. Not independently validated.
- No correction. The status stays "incomplete check" at best.
- The background checksums were already checked by 1.20.0 as multipoint entries; they are not counted twice.
- Extended integrity states: the "not checked" list follows what is actually present in the file. On ME7.5, for
example, the main data CRC32 and indirect CRC blocks stay explicitly open. - Architecture for signature verification: manufacturer signatures in the firmware have six separate states:
valid, invalid, structure detected, expected, unsupported, unknown.- "Valid" and "invalid" only result from a real cryptographic check (Ed25519 or RSA-PKCS#1 v1.5 with SHA-256) with
a key from an explicitly given trust store. A key taken from the file itself never counts. - OEM signatures are kept separate from Authenticode and GitHub attestations.
- Signatures are only checked, never created, changed or removed.
- No trusted OEM key is available for any ECU family yet, so nothing changes in how real files are shown.
- "Valid" and "invalid" only result from a real cryptographic check (Ed25519 or RSA-PKCS#1 v1.5 with SHA-256) with
Improvements
- Protection against conflicting checksum corrections: the correction preview fully recomputes the result in
advance.- If a correction would break a checksum of another method that currently matches, it is refused with a reason.
- If checksums that cannot be corrected stay wrong, the preview warns. The file then stays "supported and
invalid". - The preview therefore takes about twice as long (for example ME7.5: 139 → 305 ms).
- Safer release workflow:
- The title is always "ECU Studio AI vX.Y.Z", the release text is in German and English.
- Version check of EXE, ZIP and installer.
- Installer, update and uninstall test on Windows Server 2022 and 2025.
- Assets and SHA-256 values are checked before and after publishing, plus a build provenance attestation.
- Firmware guard and model lock; dry runs never publish.
- Tests and validation:
- new tests for the uninstall inventory, the ME7 checks (with a second, simple implementation), the signature
states (synthetic keys only) and the release workflow; - map detection is unchanged from 1.20.0: 15 real comparison pairs, 14 synthetic cases and the negative benchmark
show no difference.
- new tests for the uninstall inventory, the ME7 checks (with a second, simple implementation), the signature
Known limitations
- Transition for old in-app updates: the update from 1.20.0 to 1.20.1 via "Check for updates now" is still
carried out by the 1.20.0 updater.- This old path keeps the 1.20.0 uninstaller. It does not know three new files and leaves them behind in the
program folder%LOCALAPPDATA%\Programs\ECU-Studio-AIafter an uninstall:_internal\app\ecu_studio\core\firmware_signatures.py_internal\app\ecu_studio\core\me7_checksums.py_internal\uninstall_cleanup.ps1
- Recommended: repair installation. Run
ECU-Studio-AI-1.20.1-setup.exefrom this release once over the
existing installation. After that, uninstalling removes all program files. Projects, settings and your own files
are kept. The next update carried out by 1.20.1 or later also completes the transition. - Already uninstalled? Run the same installer once and uninstall again. The three files are then recognised as
unchanged program files and removed. - The 1.20.0 updater also replaces an existing update backup (
ECU-Studio-AI.backup) completely. If it holds your
own or changed files, install 1.20.1 withECU-Studio-AI-1.20.1-setup.exeinstead of "Check for updates now".
The installer does not touch the backup. - Please do not delete the program folder as a whole by hand. It may contain your own or changed files.
- This old path keeps the 1.20.0 uninstaller. It does not know three new files and leaves them behind in the
- No complete checksum coverage: no original file examined reaches "valid". ME7, EDC16 and EDC17 stay
"incomplete". A successful partial check does not confirm that the whole file is intact. - New ME7 methods not independently validated: measured on a single original of undocumented origin. The main
data CRC32 did not occur on any original and is unverified; indirect CRC blocks are not supported. - EDC17CP09: 3 of 11 structures are still unconfirmed. EDC16 and EDC17 corrections stay locked.
- No verified OEM signatures: no manufacturer signature is cryptographically verified for any family.
- No automatic flash approval: even a corrected file is not automatically ready to flash.
- No Authenticode signature: the EXE is not code-signed; Windows may warn on first start.
- TriCore code detection (architecture check of the map detection) is still experimental.
Installation: ECU-Studio-AI-1.20.1-windows-x64.zip entpacken und ECU-Studio-AI.exe starten, oder den
Installer ECU-Studio-AI-1.20.1-setup.exe ausführen. Bestehende Installationen finden das Update unter „Einstellungen → Jetzt nach Updates suchen“ (automatisch nur, wenn eingeschaltet).
Windows-Warnung beim ersten Start: Die EXE ist noch nicht code-signiert. Bei „Der Computer wurde durch Windows
geschützt“ auf „Weitere Informationen“ → „Trotzdem ausführen“ klicken. Echtheit prüfen: SHA-256 gegen die
.sha256-Datei, Build-Herkunft mit gh attestation verify <datei> --repo PCTestAdmin/ECU-Studio-AI.
Installation: unzip ECU-Studio-AI-1.20.1-windows-x64.zip and start ECU-Studio-AI.exe, or run the
installer ECU-Studio-AI-1.20.1-setup.exe. Existing installations find the update under "Settings → Check for
updates now" (automatically only if enabled).
Windows warning on first start: the EXE is not code-signed yet. On "Windows protected your PC" click "More info"
→ "Run anyway". Verify authenticity: SHA-256 against the .sha256 file, build provenance with
gh attestation verify <file> --repo PCTestAdmin/ECU-Studio-AI.