hadez' VAG Coding-Mania

Codierungen automatisieren mit VCDScripter

[hadez16]

Der VCDScripter

VCDScripter Oberfläche

Mit dem VCDScripter seid ihr in der Lage Vorgänge mit und innerhalb VCDS vollständig zu automatisieren. Neu-Deutsch würde man dies als One-Click-Lösung bezeichnen, die sich bereits bei Apps wie OBD11 etabliert haben.

Ständig wiederkehrende Codierungen und das Abarbeiten von textuell niedergeschrieben Schritten kann somit nachhaltig zum einen durchgeführt, und zum anderen mit anderen Menschen geteilt werden.

Zu diesem Zweck stellt der VCDScripter eine sehr simple und leicht zu verstehende Skript-Sprache bereit, die euch das manuelle Klicken und Eintragen von Werten etc. abnimmt.

Der prinzipielle Ablauf eines VCDScripts lautet

1. Öffne Steuergerät
2. Mache etwas im Steuergerät
3. Schließe Steuergerät

Das erstellte Skript lässt sich entweder direkt ausführen, in einer .vsf Datei abspeichern, oder in eine unabhängig ausführbare EXE-Datei konvertieren, die ihr an Menschen weitergeben könnt, die den VCDScripter nicht besitzen.

Auto-Vervollständigung

Der Skript-Editor selbst hilft euch mit einer automatischen Vervollständigung bei dem Erstellen von Skripten, zudem lassen sich über Rechtsklick vorgefertigte Befehl-Beispiele einfügen und im Menü-Band ein paar Beispiele in den Editor laden.

Ebenso werdet ihr zuverlässig darauf hingewiesen wenn ihr euch nicht an die korrekte Syntax haltet.

In der Summe gibt es derzeit 15 verfügbare Befehle, mit denen ihr VCDS steuern könnt:

• StartVCDS
• CreateAutoscan
• CreateAdpMap
• CreateAdpMapDump
• CreateHexAdpMap
• CreateHexAdpMapDump
• CheckForUnits
• TestPartNo
• TestComponent
• TestAdpChannel
• LoginToUnit
• ClearDTCs
• ClearAllDTCs
• OpenUnit
• CloseUnit
• ChangeCoding
• ChangeCodingInSub
• ChangeAdpChannel

Die Befehle sind ausführlich mit Beispielen in der ebenfalls verfügbaren Dokumentation beschrieben (siehe Downloads weiter unten).

Nutzungsbeispiel mit Weitergabe eines Skripts

Als vereinfachtes Beispiel möchten wir den Zeigertest sowie die Nachtankmenge im Tacho eines Fahrzeugs auf MQB-Basis freischalten.

Beispiel-Skript

Das Skript startet VCDS (Pflichtbefehl) und öffnet anschließend das Steuergerät 17 (Tacho).

Mit ChangeCoding ist es möglich auf die Codierung Einfluss zu nehmen. Der 1. Parameter innerhalb der Klammer gibt die zu setzenden Bits an, der 2. Parameter die Bits, die man deaktivieren möchte. Zur genauen Syntax bitte die Dokumentation sichten.

In diesem Fall aktivieren wir Byte 1 Bit 0 (Zeigertest), sowie Byte 10 Bit 4 (Nachtankmenge).

Anschließend wird das Steuergerät wieder geschlossen.

Damit ist der Vorgang beendet.

Wie bereits weiter oben angedeutet, hat man nun 3 Möglichkeiten:

Möglichkeiten

1. Das Skript direkt ausführen
2. Das Skript in eine .vsf Datei abspeichern (Speichern-Dialog)
3. Das Skript in eine unabhängig von VCDScripter ausführbare Datei schreiben

Beim Starten des Skripts muss VCDS geschlossen sein, das Interface mit dem Notebook sowie Fahrzeug verbunden sein, und die Zündung eingeschaltet sein.

Das als .vsf Datei gespeicherte Skript lässt sich später erneut in den VCDScripter laden um es weiter zu bearbeiten/abzuspeichern/auszuführen.

Ausführbare Skript-Datei

Veräußert man das Skript, und füllt im Idealfall das Autor- sowie Kommentar-Feld, so erhält man eine ausführbare Datei, die ohne VCDScripter das Skript auf einem Rechner ausführt, der nicht über VCDScripter verfügen muss.

Die "Unbekannte" was bei einem One-Click also letztlich durchgeführt wird, wie man dies von den OBD11-Anwendungen kennt, fällt hier also weg. Was ausgeführt werden würde bekommt der Benutzer nochmals angezeigt. Auf diesem Wege kann man Codierungen bereitstellen für Benutzer, die sich eher nicht trauen komplexe Schritte in VCDS durchzuführen o.ä.

Das Versiegeln eines Skripts

Speichert man ein Skript als .vsf Datei, bekommt man die Frage gestellt ob man das Skript versiegeln möchte.

Verneint man dies, wird das Skript ohne Weiteres als .vsf im angegebenen Ordner unter angegebenem Dateinamen abgespeichert.

Versiegelung

Bejaht man die Frage, so wird der Inhalt des Skripts mit einer eindeutigen Prüfsumme belegt. Somit ist bei einem erneuten Öffnen absolut sichergestellt, dass es sich um das Skript handelt, welches der Autor ursprünglich erstellt hat.

Stimmt die Prüfsumme nicht überein, wurde das Skript anderweitig verändert.

Diese Methodik dient der Vertrauensbindung gegenüber Dritten.

Prüfsumme

Hinweise und Einschränkungen

Folgende Hinweise:

• Die verwendeten Methoden zum Know-How Schutz lassen viele Virenscanner Alarm schlagen. Es ist kein schädlicher Code vorhanden! Virenscanner ausschalten oder bitte Ausnahme definieren.
• Dies trifft ebenso auf die veräußerten ausführbaren .exe Skripts zu!
• Unterstützt wird die Deutsche und Englische Version von VCDS
• Die Dokumentation enthält eine sehr viel genauere Beschreibung der Möglichkeiten und Befehle. Bitte zuerst lesen!
• Keine Software ist perfekt und alle Eventualitäten abzudecken ist unmöglich. Helft mir gerne, Probleme auszuräumen.
• Getestet für Windows 7 und Windows 10. Es muss mindestens das .NET Framework 4.5 installiert sein.
• VCDS muss im Standardpfad C:\Ross-Tech installiert sein
• Während das Skript läuft darf keine weitere Bedienung durch den Benutzer erfolgen bis das Skript beendet ist. Dies wird durch eine entsprechende Meldung verdeutlicht.

Folgende Einschränkungen gelten:

• Es werden lediglich HEX-V2 und HEX-NET unterstützt. Ein altes Interface führt zum Abbruch
• Kurze Codierungen werden nicht unterstützt und führen zum Abbruch
• Anpassungskanäle auf Kanalnummer-Basis werden nicht unterstützt und führen zum Abbruch
• Der Einsatz bei Fahrzeuge die keine automatische Steuergeräte-Erkennung unterstützten führt zum Abbruch
• Getestet und qualifiziert ist die Version lediglich für die angegebene VCDS-Version. Keine Garantie, Haftung oder Gewährleistung bei Problemen mit anderen Versionen

Beispiel Anhängerkupplung MQB-Plattform

Beispiel-Skript AHK MQB

Eine mögliche Lösung für eine automatisierte Freischaltung einer Anhängerkupplung an einem MQB-basierten Fahrzeug, die verschiedene Möglichkeiten und Befehle des VCDScripters aufzeigt, sieht man auf dem linken Bild.

Downloads

VCDScripter Version 1.8.0

(08.08.2019)

Neuerungen Version 1.8

• Zwingende Voraussetzung: VCDS Version 19.6.1
• Anpassungen an neuen Abbild-Dialog
• Neue Befehle CreateHexAdpMap, CreateHexAdpMapDump, CreateAdpMapDump

• Qualifiziert und getestet gegen VCDS Versionen 19.6.X (Deutsch & Englisch)
• Download ZIP (entpacken, "Starte VCDScripter" klicken oder VCDScripter.exe)
• Download Dokumentation (deutsch)
• Video VCDScripter

(MD5 Hash ZIP: 22edb846fecbe235232d6c99e33fd1fb)

Wer gut findet wie ich meine Freizeit opfere, dem stelle ich die Möglichkeit einer Spende bereit: https://paypal.me/hadez16Tools

[nirvananils]

Wie immer ein geniales Tool von dir. Werde es in der nächsten Zeit ein paar mal probieren. Aber das schreiben der ersten Scripte war sehr intuitiv

[Achsmanschette50035]

Interesting article! Thank you for sharing them! I hope you will continue to have similar posts to share with everyone! I believe a lot of people will be surprised to read this article!

Web: Thesis writing help

[joe102]

leider funktioniert der Downloadlink momentan nicht. Danke

[hadez16]

Habe es korrigiert! Danke!

[ce junkey]

Leider Funktioniert der Downloadlink momentan nicht. Schade

[hadez16]

Download-Link korrigiert!

[Spannungsprüfer132295]

I'm really appreciate for your work and share it. Thanks a lot!!!

[Fensterheber137599]

Hallo,

frage wo kann man das Programm laden?

Danke für die Bemühungen und das tolle Programm.

[hadez16]

Ganz unten im Artikel steht der Link "Download ZIP"

[Audi483]

Hallo hadez16,

leider funktioniert der Downloadlink nicht. Danke für die Info. Gruss

[hadez16]

Also bei mir funktioniert er??

[Audi483]

danke, probiere ich daheim mal.

[Turboschlumpf50875]

Nice Program m8....Fantastic Ideeer, if you do it right, it will make your life esier

Got some Ideers to your next version:

1 - Please fix the "SAVE" funktion, so it use a default filename when choosing NEW.

2 - Please fix the "SAVE" funktion, reuse the file name when using "OPEN". Now it is useing the previus filename used, to easey to save/delete previus file.

3 - FIX problem when using TAB or SPACE in front of CODEs.

-------------------------------------------------

StartVCDS()

OpenUnit("09")

........ChangeCodingInSub("RLFS","0:2","")

........LoginToUnit("31347")

........ChangeAdpChannel("ENG116962-ENG116384-Leuchte26NSL LA72-Dimming Direction GH 26","minimize")

ChangeAdpChannel("ENG116962-ENG116381-Leuchte26NSL LA72-Lichtfunktion G 26","Lichthupe generell")

CloseUnit()

-------------------------------------------------

I cant move the line above "CoseUnit", ("ChangeAdpChannel") with out getting errors, when Compiling.

All In all nice program....hope to see more updates from you

[matze950]

Hi, ich wollte den scripter gestern mal ausprobieren, allerdings sagt er das ich kein v2 Interface besitze. Allerdings hab ich ein v2 von Auto intern was auch im Verbindungstest korrekt angezeigt wird. Aktuellste Version is auch drauf, starten tut ers auch richtig. Hätte schonmal jemand das Problem?

[hadez16]

Hey @matze950

schick mir doch bitte einmal einen Screenshot deiner VCDS Einstellungen.

Wir können gerne via PN schreiben, dann gehen wir der Sache nach.

[matze950]

Hab dir ne Mail geschrieben nachdem man via pn keine Bilder verschicken kann

[webschiff]

Gibt es eine Möglichkeit die .au3 Dateien zu bekommen um das Programm um weitere Befehle/Funktionen zu erweitern? Z.B.: Kanäle direkt zum Kodieren auswählen...

[hadez16]

Generell ist das mein geistiges Eigentum.

Du kannst mir aber sehr gerne deine Vorschläge unterbreiten und ggf. kann ich die dann einarbeiten?

[hadez16]

@RedBull4Me

check out Version 1.5

I did review the syntax checker and added the takeover of the currently opened file to the save dialog...

[Tomy 69]

Kann man das Programm auch auf Deutsch umstellen?

[hadez16]

@Tomy 69

Das Programm ist automatisch deutsch wenn ein deutsches Windows erkannt wird.

Was hast du denn?

[Tomy 69]

Windows 8.1 Deutsch.

[hadez16]

Das ist sehr komisch.

Könntest du mal die Powershell öffnen und "Get-Culture" eingeben? Steht da nicht "de-DE" als Name?

[Brummi_aufAchse]

Kann ich mit dem Scripter das Coding meines Wagens auslesen und speichern und ggf später wieder aufspielen.?

Kann notwendig sein, wenn der Freundliche einen Soll/Ist Abgleich durchgeführt hat.

Wenn ich dann mit einem Klick mein eigenes Coding wieder aufspielen kann, wäre das hilfreich.

[hadez16]

@Brummi_aufAchse

Dazu brauchst du den Scripter eigentlich garnicht..

Erstell mit VCDS einen Auto-Scan sowie CSV Abbilder aller Steuergeräte, dann hast du alles gesichert.

Etwas in Massen zurückzuspielen ist nicht so einfach wie du es dir erhoffst.

[Standspurpirat134000]

Gibt es eine Möglichkeit den Laneassist so zu ändern das er beim Motorstart den Zustand wie beim Abstellen annimmt (was mir am liebsten wäre) ?

Oder das er bei jedem Motorstart aus ist?

Denn jetzt ist es bei meinem Seat Tarraco so das er sich bei Jedem Motorstart wieder aktiviert (und das ständige manuelle abstellen nervt).

Ansonsten top Arbeit! Danke!

[Fensterheber134330]

Dickes Lob für diese außergewöhnliche Arbeit!

Ich würde mir on top wünschen, den VCDs Installationspfad anpassen zu können, da ich u.a. dienstlich nich auf C: installieren darf.

Gruß

Vatte

[Achsmanschette136564]

Hi.

Thank you for great work. Appreciated very much.

My Windows 10 built in antivirus says Trojan:Win32/Wacatac.C!ml infected for version 1.8? Can you check?

Kind regards,

Kim / Denmark

[hadez16]

That is normal to some extend.

The mechanisms for software protection, that is llikely used by some virus manufactors, is detected as some kind of evil.

I can assure that there is no bad stuff in there

[Achsmanschette136564]

Will you update this for the latest beta version of VCDS?

[hadez16]

Beta Versions are neither installed in VCDS-DRV folder nor in VCDS.

The Scripter tries to find a VCDS installation in one of those folders.

Beta is not supported.

[HolzFichte]

Danke. Geht auch bei 21.3

[rooster9011]

Hi,

habe die 21.3.0 Version von VCDS und beim VCDScripter unten sehe ich "VCDS installation not detected".

Bild

• Error
  (702 mal aufgerufen)

[hadez16]

Unter welchem Pfad hast du VCDS denn installiert?

[rooster9011]

Hi, wie beschrieben:

Bild

• Ross
  (607 mal aufgerufen)

[hadez16]

Hast du ein Original??

[WildeSau87]

hat jemand schon einiges für den 4G an Script erstellt? wäre generell cool wenn wir alle das teilen würden

[spitfire2003]

Hab versucht die 30 Farben Ambiente über den scripter laufen zu lassen beim Passat b8 mi 2018 funktionert fast gut nur am Ende rotwert 26 -28 muss irgendwo ein Fehler sein weil er ein Kanal nicht findet und dann das ganze abbricht. Hab gerade auch gesehen die Checksumme fehlt….

Bild

• 712f5b71-0557-4550-a0b6-75b0e1a8aa64
  (555 mal aufgerufen)