QtDragon GUI

QtDragon und QtDragon_hd werden mit dem QtVCP-Framework entwickelt. Es ist die kreative Vision der Forum Persönlichkeit Persei8. Vieles davon basiert auf der hervorragenden Arbeit anderer in der LinuxCNC-Gemeinschaft. LinuxCNC’s Version ist von Persei8’s Github Versionen angepasst. Es ist in erster Linie für 3/4-Achsen-Maschinen wie Fräsmaschinen oder Router gedacht. Es funktioniert gut mit einem Touchscreen und/oder einer Maus. QtDragon unterstützt mehrere Möglichkeiten zum Antasten von Werkzeugen und zum Antasten von Werkstücken. Sie können LinuxCNC’s externe Offsets Fähigkeit verwenden, um automatisch die Spindel während einer Pause zu erhöhen. Wenn Sie die VersaProbe-Option und Remap-Code können Sie automatische Werkzeuglängen-Abtastung beim Werkzeugwechsel hinzuzufügen.

Wenn Ihre Konfiguration derzeit nicht für die Verwendung von QtDragon eingerichtet ist, können Sie sie ändern, indem Sie den Abschnitten der INI-Datei bearbeiten. Eine ausführliche Liste der Optionen finden Sie im Abschnitt Display der INI-Datei-Dokumentation.

QtDragon ist nicht in erster Linie für die Verwendung einer Tastatur zur Maschinensteuerung gedacht.
Es fehlen viele Tastenkombinationen, die zum Beispiel AXIS hat - aber Sie können eine Maus oder einen Touchscreen verwenden.
Der Einfachheit halber gibt es mehrere Tastenkombinationen zur Steuerung der Maschine.

Schaltflächen, die ankreuzbar sind, ändern ihre Textfarbe, wenn sie angekreuzt werden. Dies wird durch das Stylesheet/Thema gesteuert

QtDragon enthält eine virtuelle Tastatur für die Verwendung mit Touchscreens. Um die Tastatur zu aktivieren, markieren Sie das Kontrollkästchen Virtuelle Tastatur verwenden auf der Seite Einstellungen. Wenn Sie auf ein beliebiges Eingabefeld klicken, wie z.B. Sondenparameter oder Tooltabelleneinträge, wird die Tastatur angezeigt. Um die Tastatur auszublenden, führen Sie einen der folgenden Schritte aus:

Es ist zu beachten, dass bei der Verwendung der virtuellen Tastatur das Jogging der Tastatur deaktiviert ist.

Diese Pins sind spezifisch für den QtDragon-Bildschirm.
Es gibt natürlich viele weitere HAL-Pins, die für LinuxCNC angeschlossen werden müssen, um zu funktionieren.

Wenn Sie eine Aufforderung zum manuellen Werkzeugwechsel benötigen, fügen Sie diese Zeilen in Ihre Postgui-Datei ein.
QtDragon emuliert die hal_manualtoolchange HAL Pins - laden Sie nicht die separate HAL Komponente hal_manualtoolchange.

Auch wenn Sie keinen automatischen Werkzeugwechsler haben, sollten Sie sicherstellen, dass diese Pins in einer der HAL-Dateien angeschlossen sind:

Dieser Eingangspin sollte verbunden werden, um den Sondenstatus anzuzeigen.

Diese Pins sind Eingänge für die Spindel-VFD-Anzeige.
Die Volt- und Ampere-Pins werden zur Berechnung der Spindelleistung verwendet.

Dieser Bit-Pin ist ein Ausgang für die Spindelsteuerung, um sie anzuhalten.
Sie verbinden ihn mit spindle.0.inhibit.

Die Anzeige der Spindelgeschwindigkeit und die LED "Spindel auf Geschwindigkeit" (engl. spindle-at-speed) von QtDragon erfordern, dass spindle.0.speed-in mit dem Rückmeldesignal der Spindelgeschwindigkeit verbunden wird.
Als Rückmeldung kann ein Encoder oder VFD Feedback verwendet werden, solange das Feedback in Umdrehungen pro Sekunde (RPS) erfolgt.
Wenn keine Rückmeldung verfügbar ist, können Sie die Anzeige so einrichten, dass sie die angeforderte Geschwindigkeit zeigt, indem Sie die Pins wie folgt verbinden:

Dieser Bit-Ausgangspin kann angeschlossen werden, um einen Laser einzuschalten:

Dieser Float-Ausgangspin zeigt die Kameradrehung in Grad an:

Diese bit/s32/float-Pins beziehen sich auf externe Offsets, wenn sie verwendet werden:

Diese float-Ausgangspins spiegeln die aktuelle Jograte des Schiebers (in Maschineneinheiten) wider:

Diese float-Ausgangsstifte geben die aktuellen Schieberegler-Übersteuerungsraten wieder:

Diese Ausgangspins sind verfügbar, wenn Sie die Option Versa Probe INI einstellen. Sie können für auto-tool-length-probe bei Werkzeugwechsel verwendet werden - mit hinzugefügtem Remap-Code.

This input pin is available to toggle pause/resume of a running program.

Die mitgelieferten HAL-Dateien sind nur für die Simulation gedacht. Eine reale Maschine benötigt ihre eigenen HAL-Dateien. Der QtDragon-Bildschirm funktioniert mit 3 oder 4 Achsen mit einem Gelenk pro Achse oder 3 oder 4 Achsen in einer Gantry-Konfiguration (2 Gelenke auf 1 Achse).

Wenn Ihre Maschine einen manuellen Werkzeugwechsel erfordert, kann QtDragon ein Meldungsfenster anzeigen, um Sie anzuleiten. QtDragon emuliert die hal_manualtoolchange HAL Pins - laden Sie nicht die separate HAL Komponente hal_manualtoolchange. Dazu müssen Sie z.B. den richtigen HAL-Pin in der postgui HAL-Datei verbinden:

Der Bildschirm ist für den Anschluss an einen VFD gedacht, funktioniert aber auch ohne ihn.
Es gibt eine Reihe von VFD-Treiber in der LinuxCNC Distribution enthalten.
Es ist bis zu dem Endbenutzer, um die entsprechenden Treiber und HAL-Datei-Verbindungen nach seiner eigenen Maschine Setup liefern.

QtDragon can be set up to automatically raise and lower the Z axis and stop the spindle, when the program is paused.
You select the SPINDLE LIFT or NO SPINDLE LIFT button to select the option to raise the spindle in Z when paused.
Then when you press the PAUSE button the spindle will lift the amount set on the Settings tab and the spindle will stop.
Pressing RESUME will start the spindle and lower the spindle.
If you have the HAL pin spindle.0.at-speed connected to a driving pin, the spindle will not lower until the pin is true
You typically connect this to a timer or logic that detects the speed of the spindle.
If that pin is not connected to a driving pin, a dialog will pop up to warn you to wait for the spindle response.
The spindle will lower when you close that dialog.
The amount to raise is set in the Settings tab under the heading SPINDLE RAISE.
This line edit box can only be directly set when not in Auto mode.
The up/down buttons can be used to adjust the raise amount at any time, including when the spindle is already raised.
The button increments are 1 inch or 5 mm (depending on the units the machine is based on)

This optional behaviour requires additions to the INI and the QtDragon_postgui HAL file.

In der INI, unter der Überschrift AXIS_Z.

This reserves 20% of max velocity and max acceleration for the external offsets.
This will limit max velocity of the machine by 20%

In der Datei qtdragon_postgui.hal hinzufügen:

QtDragon_hd kann mit dem externen Programm G-code Ripper so eingestellt werden, dass es Höhenänderungen der Z-Ebene prüft und ausgleicht.

Z-Ebene Ausgleich ist ein Bett Nivellierung / Verzerrung Korrekturfunktion typischerweise in 3D-Druck oder Gravur verwendet. Es verwendet eine HAL Nicht-Echtzeit-Komponente, welche die externen Offsets Funktion von LinuxCNC verwendet. Die Komponente hat einen HAL-Pin, der einen Interpolationstyp spezifiziert, der entweder kubisch, linear oder am nächsten (0, 1, 2) sein muss. Wenn keine angegeben ist oder wenn eine ungültige Zahl angegeben ist, wird die Standardeinstellung kubisch sein.

Wenn Z LEVEL COMP aktiviert ist, liest die Kompensationskomponente eine Sondendaten-Datei, die probe_points.txt heißen muss. Die Datei kann jederzeit geändert oder aktualisiert werden, solange die Kompensation deaktiviert ist. Bei der nächsten Aktivierung wird die Datei erneut gelesen und die Kompensationskarte wird neu berechnet. Diese Datei sollte sich im Konfigurationsverzeichnis befinden.

Die Sondierungsdatei wird von einem Sondierungsprogramm erzeugt, das seinerseits von einem externen Python-Programm namens gcode_ripper erzeugt wird, das auf der Registerkarte "Dateimanager" über die Schaltfläche "G-code Ripper" aufgerufen werden kann.

Der Sondenbildschirm wurde einem grundlegenden Test unterzogen, könnte aber noch einige kleinere Fehler aufweisen. Gehen Sie bei der Ausführung von Prüfroutinen äußerst vorsichtig vor, bis Sie mit der Funktionsweise vertraut sind. Die Prüfroutinen laufen, ohne die Haupt-GUI zu blockieren. Dies gibt dem Bediener die Möglichkeit, die DROs zu beobachten und die Routine jederzeit zu stoppen.

QtDragon verfügt über 2 Methoden zur Einstellung von Z0. Die erste ist eine Tastplatte, bei der eine Metallplatte mit bekannter Dicke auf das Werkstück gelegt wird, dann wird das Werkzeug abgesenkt, bis es die Platte berührt, wodurch das Messtastersignal ausgelöst wird. Der Z0-Wert des aktuellen Anwendersystems (G5x) wird auf die Messtasterhöhe - die eingegebene Blechdicke - eingestellt.

Bei der zweiten Methode wird ein Werkzeugeinstellgerät in einer festen Position und einer bekannten Höhe über dem Tisch verwendet, wo das Messtastersignal ausgelöst wird. Um Z0 auf die Oberseite des Werkstücks einzustellen, muss bekannt sein

Dieser Vorgang muss bei jedem Werkzeugwechsel durchgeführt werden, da die Werkzeuglänge nicht gespeichert wird.

Beim Antasten mit einem Tastsystem wird der Parameter Höhe vom Tisch bis zur Oberkante des Werkstücks nicht berücksichtigt und kann ignoriert werden, unabhängig davon, ob Sie den Tastplattenbetrieb mit einer auf 0 eingestellten Dicke oder eine Antastroutine verwenden. Er gilt nur für den Werkzeugeinrichter.

Sie können eine leitfähige Tastplatte oder etwas Gleichwertiges verwenden, um die Z-Position eines Werkzeugs automatisch anzutasten (die Benutzerkoordinate auf Null zu setzen). Vor dem Antasten muss ein Werkzeug geladen sein. Legen Sie auf der Registerkarte "Werkzeug" oder "Einstellungen" die Höhe der Tastplatte, die Such- und Antastgeschwindigkeit und den maximalen Antastabstand fest.

Legen Sie die Platte auf die Oberfläche, auf der Sie Z nullen möchten. Verbinden Sie das Eingangskabel des Messtasters mit dem Werkzeug (bei Verwendung einer leitfähigen Platte). Bewegen Sie das Werkzeug manuell innerhalb des maximalen Tasterabstandes. Drücken Sie die Taste "Tastplatte". Die Maschine tastet zweimal nach unten und der aktuelle Benutzer-Offset (G5X) wird am unteren Ende der Platte durch Berechnung der Tastplattenhöhe auf Null gesetzt.

QtDragon kann so eingestellt werden, dass es eine integrierte automatische Werkzeugmessung mit dem Versa Probe Widget und Remap-Code durchführt. Um diese Funktion zu nutzen, müssen Sie einige zusätzliche Einstellungen vornehmen und Sie können den angebotenen HAL-Pin verwenden, um Werte in Ihrer eigenen ngc-Remap-Prozedur zu erhalten.

Die Werkzeugmessung in QtDragon erfolgt in den folgenden Schritten:

Beim ersten gegebenen Werkzeugwechsel wird das Werkzeug vermessen und der Versatz wird automatisch auf die Blockhöhe eingestellt. Der Vorteil dieser Methode ist, dass Sie kein Referenzwerkzeug benötigen.

Die Reihenfolge der Ereignisse (unter Verwendung der Standarddateien):

Ein G-Code-Programm kann an jeder beliebigen Zeile gestartet werden, indem Sie im AUTO-Modus auf die gewünschte Zeile in der G-Code-Anzeige klicken. Es liegt in der Verantwortung des Bedieners sicherzustellen, dass sich die Maschine im gewünschten Betriebsmodus befindet. Es wird ein Dialogfeld angezeigt, in dem die Spindelrichtung und -geschwindigkeit voreingestellt werden können. Die Startlinie wird in dem Feld mit der Bezeichnung LINE neben der Taste CYCLE START angezeigt. Die Funktion "Von der Linie starten" kann auf der Einstellungsseite deaktiviert werden.

Der Button LASER ON/OFF dient dazu, einen Ausgang ein- oder auszuschalten, der mit einem kleinen Laserkreuzprojektor verbunden ist. Wenn das Fadenkreuz über einem gewünschten Referenzpunkt auf dem Werkstück positioniert ist, kann die Taste REF LASER gedrückt werden, die dann die X- und Y-Offsets auf die in den Feldern LASER OFFSET auf der Seite Einstellungen angegebenen Werte setzt.

Über die Registerkarten kann der Benutzer die am besten geeigneten Informationen/Steuerelemente in den oberen drei Feldern auswählen. Wenn die Bildschirmtastatur eingeblendet ist und der Benutzer sie ausblenden, aber die aktuelle Registerkarte beibehalten möchte, kann er dies tun, indem er die aktuelle Registerkarte anzeigt. In QtDragon gibt es einen Splitter-Handle zwischen der G-Code-Textanzeige und der G-Code-Grafikanzeige. Mit diesem kann man die Größe zwischen den beiden Bereichen aufteilen. Dies kann in jedem Tab und in jedem Modus unterschiedlich eingestellt werden.

Nahezu alle Aspekte des Erscheinungsbildes der Benutzeroberfläche sind über die Stylesheet-Datei QtDragon.qss konfigurierbar. Die Datei kann manuell oder über das Stylesheet-Dialog-Widget in der GUI bearbeitet werden. Um diesen Dialog aufzurufen, drücken Sie F12 im Hauptfenster. Neue Stile können vorübergehend angewendet und dann in einer neuen qss-Datei gespeichert werden, oder die aktuelle qss-Datei überschreiben.

It is possible to create translation files for QtDragon to display in the language of the current locale.

Um eine Übersetzungsdatei zu erstellen und oder zu bearbeiten, muss LinuxCNC installiert sein und vor Ort ausgeführt werden.

Im Folgenden wird davon ausgegangen, dass das LinuxCNC git-Verzeichnis ~/linuxcnc-dev ist.

All language files are kept in ~/linuxcnc-dev/share/screens/qtdragon/languages.

The qtdragon.py file is a Python version of the GUI file used for translation purposes.

Die .ts-Dateien sind die Quelldateien für die Übersetzungen. Dies sind die Dateien, die für jede Sprache erstellt/bearbeitet werden müssen.

Die .qm-Dateien sind die kompilierten Übersetzungsdateien, die von pyqt verwendet werden.

The language is determined by an underscore plus the first two letters of the locale, for example if an Italian translation was being done then it would be _it. It will be referred to as _xx in this document, so qtdragon_xx.ts in this document would actually be qtdragon_it.ts for an Italian translation.

The default locale for QtDragon is _en which means that any translation files created as qtdragon_en.* will not be used for translations.

If any of the required utilities (pyuic5, pylupdate5, linguist) are not installed then the user will need to install the required development tools:

Wechseln Sie in das Sprachenverzeichnis:

Wenn Textänderungen an der grafischen Benutzeroberfläche vorgenommen wurden, führen Sie den folgenden Befehl aus, um die GUI-Python-Datei zu aktualisieren:

The user can either create a new translation source file for a non-existing language translation or modify an existing translation source file due to changes being made to some text in a QtDragon source file. If modifying an existing translation that has had no source file changes then this step is not required.

Erstellen oder bearbeiten Sie eine .ts-Datei:

Die Bearbeitung der Übersetzung erfolgt mit der Anwendung Linguist:

Es ist nicht notwendig, für jede Textzeichenfolge eine Übersetzung bereitzustellen. Wenn für eine Zeichenfolge keine Übersetzung angegeben ist, wird die ursprüngliche Zeichenfolge in der Anwendung verwendet. Der Benutzer muss auf die Länge der Zeichenketten achten, die in den Widgets erscheinen, da der Platz begrenzt ist. Wenn möglich, sollte die Übersetzung nicht länger als das Original sein.

Wenn die Bearbeitung abgeschlossen ist, speichern Sie die Datei:
Datei -> Speichern (engl. File -> Save)

Erstellen Sie dann die .qm-Datei:
Datei -> Freigabe (engl. File -> Release)

QtDragon will be translated to the language of the current locale on the next start so long as a .qm file exists in that language.

Users are welcome to submit translation files for inclusion into QtDragon. The preferred method is to submit a pull request from the users GitHub account as described in the contributing to LinuxCNC documentation. The only files required to be committed are qtdragon_xx.ts and qtdragon_xx.qm.

Ein allgemeiner Überblick über die Anpassung mitgelieferter Bildschirmmasken.