Files
2026-08-03 13:48:52 +02:00

66 lines
3.2 KiB
Markdown

# RTC5 Mini Control
Kleine C#/.NET-WinForms-Testapp fuer eine SCANLAB RTC5-Karte.
## Voraussetzungen
- Windows 11
- RTC5-Treiber installiert
- .NET 8 Desktop SDK oder Visual Studio Community mit ".NET desktop development"
- RTC5-Dateien/DLLs aus dem SCANLAB-SDK, typischerweise:
- `RTC5DLLx64.dll`
- `RTC5DAT.dat`
- `RTC5RBF.rbf`
- `RTC5OUT.out`
Im Feld `RTC-Dateien` in der App den Ordner mit diesen Dateien auswaehlen. Wenn kein Korrekturfile angegeben wird, wird die RTC5 mit der internen 1:1-Korrektur initialisiert. Optional kann eine `.ct5`-Datei von SCANLAB angegeben werden.
Die GUI ist in eine linke Seitenleiste und eine grosse Vorschauflaeche aufgeteilt. In der Seitenleiste trennen Tabs `Grundeinstellungen`, `Manuell` und `Prozess`.
Der Button `Stop / Laser aus` sitzt fest oben in der Seitenleiste und bleibt in jedem Tab erreichbar.
## CSV-Format
```csv
0,0
1,0
1,1
2,1
2,2
```
Koordinaten sind Millimeter. Eine Leerzeile bedeutet: der naechste Koordinatenwechsel wird als `jump_abs` mit Laser aus ausgefuehrt. Fortlaufende Zeilen werden als `mark_abs` verarbeitet.
Optionales Format `X,Y,Z` wird ebenfalls akzeptiert; `Z` wird ignoriert.
## Wichtige Startwerte
- `Kalib. bits/mm`: Umrechnung von mm in RTC-Koordinaten. Typisch 1000 bis 100000.
- `Laser Mode`: Default `0`. Fuer andere Laserarten ggf. gemaess SCANLAB-Handbuch anpassen.
- `Laser Control`: Basis-Hex-Wert, Default `0x0`.
- `LASERON low-aktiv / invertiert`: setzt intern die Low-Active-Bits `0x18`, wie in SCANLABs CO2/YAG-Demos beschrieben.
- `Jump Speed`, `Mark Speed`: Werte in RTC-Einheiten `bits/ms`.
Die Buttons `LASERON an/aus` steuern den Laser-Ausgang direkt ueber `laser_signal_on()` und `laser_signal_off()`. Beim ersten Einschalten fragt die App nach einer Bestaetigung.
## Zusatzfunktionen
- `Home 0,0`: springt mit Laser aus auf X/Y `0,0`.
- `Wiederholungen`: fuehrt dieselbe CSV-Datei ein- oder mehrfach aus. Standard ist `1`.
- `Job abbrechen nach aktueller Wiederholung`: beendet einen laufenden Mehrfachjob geordnet nach dem aktuellen Durchlauf.
- `Skalierung`: multipliziert alle CSV-X/Y-Koordinaten vor Vorschau und Ausfuehrung. Default ist `1`.
- `X-Achse umkehren`, `Y-Achse umkehren`: spiegelt die CSV-Koordinaten fuer andere Koordinatensysteme.
- `CSV ohne Laser`: faehrt die CSV-Koordinaten ohne Markierbewegungen ab.
- `Geometrie-Vorschau`: zeichnet die CSV-Kontur bei Bedarf; grosse Dateien werden fuer die Anzeige ausgeduennt.
- In der Vorschau: `Fit` oder Doppelklick passt alles ein, `Ctrl+Mausrad` zoomt um den Mauszeiger, Ziehen verschiebt die Ansicht.
- `Tabellenvorschau anzeigen`: blendet die Koordinatentabelle optional ein. Standardmaessig bleibt sie ausgeblendet.
- `Grenzcheck`: prueft vor CSV-Start, ob alle Punkte innerhalb der angegebenen X/Y-Grenzen liegen.
- Nach der letzten ausgefuehrten CSV-Wiederholung springt die App mit Laser aus auf X/Y `0,0`.
- `Einstellungen speichern`: schreibt die aktuellen Einstellungen nach `%AppData%\Rtc5MiniControl\settings.json` und laedt sie beim naechsten Programmstart wieder.
## Bauen
```powershell
dotnet build .\Rtc5MiniControl.csproj -c Release
```
Falls `dotnet --info` keine SDKs zeigt, muss zuerst das .NET 8 SDK oder Visual Studio Community installiert werden.