O Codes

O-Codes sorgen für die Ablaufsteuerung in NC-Programmen. Jeder Satz hat eine zugehörige Nummer, die nach dem O verwendet wird. Es muss darauf geachtet werden, dass die O-Nummern richtig zugeordnet werden. O-Codes verwenden den Buchstaben O und nicht die Zahl Null als erstes Zeichen in der Nummer wie O100 oder o100. o-Codes werden auch manchmal o-Worte genannt und diese Begriffe sind austauschbar.

Nummerierte o-Codes müssen für jedes Unterprogramm eine eindeutige Nummer haben,

Kommentare in der gleichen Zeile wie das o-Wort sollten nicht verwendet werden, da sich das Verhalten in Zukunft ändern kann.

Das Verhalten ist undefiniert, wenn:

Unterroutinen beginnen mit oNNN sub und enden mit oNNN endsub. Die Zeilen zwischen oNNNsub und oNNN endsub werden nicht ausgeführt, bis das Unterprogramm mit oNNN call aufgerufen wird. Jede Subroutine muss eine eindeutige Nummer verwenden.

Weitere Informationen finden Sie in den Abschnitten G53, G0 und M2.

Innerhalb einer Subroutine kann o- return ausgeführt werden. Damit kehrt man sofort zum aufrufenden Code zurück, so als wäre man auf o- endsub gestoßen.

Weitere Informationen finden Sie in den Abschnitten Binäre Operatoren und Parameter.

o- Call nimmt bis zu 30 optionale Argumente auf, die als #1, #2 , …, #N an das Unterprogramm übergeben werden. Die Parameter von #N+1 bis #30 haben den gleichen Wert wie im aufrufenden Kontext. Bei der Rückkehr aus dem Unterprogramm werden die Werte der Parameter #1 bis #30 (unabhängig von der Anzahl der Argumente) auf die Werte zurückgesetzt, die sie vor dem Aufruf hatten. Die Parameter #1 - #30 sind lokal für das Unterprogramm.

Da 1 2 3 als die Zahl 123 geparst wird, müssen die Parameter in eckige Klammern gesetzt werden. Im Folgenden wird eine Unterroutine mit 3 Argumenten aufgerufen:

Unterprogrammkörper dürfen nicht verschachtelt werden. Sie dürfen erst aufgerufen werden, nachdem sie definiert wurden. Sie können von anderen Funktionen aufgerufen werden und können sich selbst rekursiv aufrufen, wenn dies sinnvoll ist. Die maximale Verschachtelungsebene eines Unterprogramms ist 10.

Unterprogramme können den Wert von Parametern oberhalb von #30 ändern und diese Änderungen werden für den aufrufenden Code sichtbar sein. Unterprogramme können auch den Wert von global named parameters (d.h. Parameter, deren Namen mit dem Unterstrich "_" beginnen) ändern.

Die while-Schleife hat zwei Strukturen: while/endwhile, und do/while. In beiden Fällen wird die Schleife verlassen, wenn die while Bedingung als falsch bewertet wird. Der Unterschied besteht darin, wann die Testbedingung erfüllt ist. Die do/while Schleife führt den Code in der Schleife aus und überprüft dann die Testbedingung. Die while/endwhile Schleife führt zuerst den Test durch.

Innerhalb einer while-Schleife wird mit o- break die Schleife sofort verlassen, und mit o- continue wird sofort zur nächsten Auswertung der while Bedingung übergegangen. Wenn sie immer noch wahr ist, beginnt die Schleife wieder von vorne. Wenn sie falsch ist, wird die Schleife verlassen.

Die if Bedingung besteht aus einer Gruppe von Anweisungen mit der gleichen o Nummer, die mit if beginnen und mit endif enden. Optionale elseif und else Bedingungen können zwischen dem beginnenden if und dem endenden endif stehen.

Wenn die if Bedingung als wahr bewertet wird, dann wird die Gruppe von Anweisungen nach der if bis zur nächsten Bedingungszeile ausgeführt.

Wenn die if Bedingung als falsch bewertet wird, werden die elseif Bedingungen der Reihe nach ausgewertet, bis eine als wahr bewertet wird. Wenn die elseif Bedingung wahr ist, werden die auf die elseif folgenden Anweisungen bis zur nächsten Bedingungszeile ausgeführt. Wenn keine der if oder elseif Bedingungen als wahr ausgewertet wird, werden die auf die else folgenden Anweisungen ausgeführt. Wenn eine Bedingung zu wahr ausgewertet wird, werden keine weiteren Bedingungen in der Gruppe ausgewertet.

Mehrere Bedingungen können durch elseif Anweisungen getestet werden, bis der else Pfad schließlich ausgeführt wird, wenn alle vorangegangenen Bedingungen falsch sind:

Mit repeat werden die Anweisungen innerhalb von repeat/endrepeat die angegebene Anzahl von Malen ausgeführt. Das Beispiel zeigt, wie Sie eine diagonale Reihe von Formen fräsen könnten, beginnend an der aktuellen Position.

Die o-Zahl kann durch einen Parameter und/oder eine Berechnung angegeben werden.

Weitere Informationen zur Berechnung von Werten finden Sie in den folgenden Abschnitten:

Um eine separate Datei mit einem Unterprogramm aufzurufen, geben Sie der Datei den gleichen Namen wie Ihrem Aufruf und fügen Sie ein sub und endsub in die Datei ein. Die Datei muss sich in dem Verzeichnis befinden, auf das PROGRAM_PREFIX oder SUBROUTINE_PATH in der INI-Datei verweist. Der Dateiname darf nur Kleinbuchstaben, Zahlen, Bindestriche und Unterstriche enthalten. Eine benannte Subroutinendatei kann nur eine einzige Subroutinendefinition enthalten.

In der aufgerufenen Datei müssen die oxxx sub und endsub enthalten sein und die Datei muss eine gültige Datei sein.

Unterprogramme können optional einen Wert durch einen optionalen Ausdruck in einer endsub oder return Anweisung zurückgeben.

Der Rückgabewert eines Unterprogramms wird im <_value> <gcode:predefined-named-parameters,predefined named parameter>> gespeichert, und der <_value_returned> vordefinierte Parameter wird auf 1 gesetzt, um anzuzeigen, dass ein Wert zurückgegeben wurde. Beide Parameter sind global und werden kurz vor dem nächsten Unterprogrammaufruf gelöscht.

Die folgenden Anweisungen führen zu einer Fehlermeldung und zum Abbruch des Interpreters:

Um diese Fehler zu nicht-fatalen Warnungen auf stderr zu machen, setzen Sie Bit 0x20 bei der Option [RS274NGC]FEATURE= in mask ini.