Manual Upgrade
Der Manual upgrade ist ein sehr wichtiger Schritt, wenn der Anwender offline erstellte Programme auf die VKRC-Steuerung laden möchte.
Dieser Vorgang behebt automatisch KRL-Syntaxwarnungen und löst viele Systemabhängigkeiten auf.
Derzeit gibt es keine offizielle Dokumentation des erzeugten Programmquelltextes; der gesamte Bearbeitungsprozess in unserem Editor ist das Ergebnis von Reverse Engineering.
Wir tun alles, damit die Programme dem VKRC-Standard und der VKRC-Syntax entsprechen, dennoch können natürlich Fehler auftreten.
Daher sollten alle Programme mit der Option Manual upgrade auf den Roboter geladen werden.

Mithilfe der von Kuka bereitgestellten Software ist es uns jedoch gelungen, die Funktionalität der Robotersteuerung in unseren Editor zu integrieren.
Um diese neue Funktion zu nutzen, muss die spezielle Software KUKA.WorkVisual VSS Standard in der neuesten Version installiert werden.

Nach der Installation muss eventuell der Pfad zur ausführbaren Datei WoV Script Runner (wvsr.exe) angegeben werden.
Diese Option befindet sich in den Editor-Einstellungen für die VKRC-Steuerung. Ist sie leer, nimmt DReS wvsr.exe aus dem Ordner von WorkVisual.exe (Pfad von WorkVisual in denselben Einstellungen).
Der Anwender kann festlegen, ob der Manual upgrade beim Speichern der Datei ausgeführt werden soll (Run WoV manual upgrade on file save). Ist WorkVisual installiert und wird wvsr.exe beim ersten Start von DReS gefunden, ist diese Option standardmäßig eingeschaltet; eine eigene Auswahl in den Einstellungen bleibt erhalten.
Mit dieser Option startet der WoV Script Runner einmal im Hintergrund einige Sekunden nach dem Start von DReS (der Start dauert etwa 7 s) und läuft weiter, bis DReS geschlossen wird. Jedes Speichern dauert dann nur etwa 50 ms länger.
Meldet der KUKA-Codegenerator einen Fehler, zeigt DReS ihn in einer Meldung an und behält das von DReS gespeicherte Programm (ohne Manual upgrade) – ein fehlgeschlagener Manual upgrade ersetzt das Programm nie durch leere Dateien. Wenn der Script Runner beendet wird oder nicht antwortet, wird er beim nächsten Speichern neu gestartet.

Dateien mit TPVW unter 8.3 und Tech-Befehlen
Der KUKA-Codegenerator schreibt die Tech-Befehle im Format 8.3 um (CN= P1..P10), während der Dateikopf bei der alten Version bleibt (z. B. 8.1.8). Deshalb fragt DReS bei eingeschalteter Option Run WoV manual upgrade on file save nach, bevor eine Datei mit TPVW unter 8.3, die Tech-Befehle enthält, geschrieben wird (Frage Manual upgrade):
• Yes – der Manual upgrade wird ausgeführt,
• No – die Datei bleibt so, wie DReS sie gespeichert hat (ohne Manual upgrade),
• Cancel – es wird nichts gespeichert (Statusleiste: Save cancelled.).
Mit Do not show this message again (until the program is closed) gilt die Antwort für jedes weitere Speichern, bis DReS geschlossen wird.
Die Standardantwort wird in Settings > VKRC, Registerkarte Manual Upgrade, Option File with TPVW below 8.3 and Tech commands festgelegt: Ask (Standard), Run the manual upgrade oder Save without the manual upgrade.
Editor-API: die Befehle save und save_all haben den Parameter manualUpgrade81 (true = Manual upgrade ausführen, false = überspringen); ohne ihn entscheidet die Einstellung. Wird die Frage durch die API geschlossen, gilt das als Cancel: die Datei wird nicht gespeichert (saved:false), und der error nennt die Parameter (manualUpgrade81 / manualUpgradeCommented: true / false answers this question). (Vorher galt das Schließen als No, und die Datei wurde gespeichert.)

Dateien mit auskommentierten Folds
Der KUKA-Codegenerator löscht auskommentierte Folds (;;FOLD ..., siehe Ausgewählten Text kommentieren / auskommentieren): Bewegungspunkte (auch ihre Koordinaten in der .dat-Datei), SCHRITT (Makroschritt), Trigger (Makrotrigger) und VExpert-Folds. Deshalb fragt DReS bei eingeschalteter Option Run WoV manual upgrade on file save nach, bevor eine Datei mit auskommentierten Folds geschrieben wird (Frage Manual upgrade, sie nennt die Anzahl der kommentierten Folds (points, SCHRITT, Trigger, VExpert)):
• Save – speichern und den Manual upgrade ausführen (die auskommentierten Folds werden gelöscht),
• Save without manual upgrade – die Datei ohne Manual upgrade speichern, die auskommentierten Folds bleiben,
• Cancel – es wird nichts gespeichert.
Mit Do not show this message again (until the program is closed) gilt die Antwort für jedes weitere Speichern, bis DReS geschlossen wird.
Die Standardantwort wird in Settings > VKRC, Registerkarte Manual Upgrade, Option File with commented folds (vorher File with commented points) festgelegt: Ask (Standard), Run the manual upgrade oder Save without the manual upgrade.
Editor-API: die Befehle save und save_all haben den Parameter manualUpgradeCommented (true = Manual upgrade ausführen, die auskommentierten Folds werden gelöscht; false = ohne ihn speichern); ohne ihn entscheidet die Einstellung. Wird die Frage durch die API geschlossen, gilt sie als Cancel: die Datei wird nicht gespeichert (saved:false), der error nennt den Parameter.



Nach der Konfiguration wird der Manual upgrade beim Speichern automatisch ausgeführt. DReS führt den WoV Script Runner im Hintergrund aus, es öffnet sich kein Fenster. Nur ein Fehler wird in einer Meldung angezeigt.

Sie können eigene csx-Skripte schreiben, um die Funktionalität des Editors zu erweitern, und sie mit wvsr.exe -executescript -scriptpath=<Skript.csx> in der Windows-Eingabeaufforderung ausführen.
Die Dokumentation der Skriptschnittstelle erzeugt der Script Runner selbst: wvsr.exe -docu -directory=<Ordner>.
Wir unterstützen Sie gern dabei.