Befehl start_control_#
Important
Expert-Funktion
Die Verwaltung der Kontrollkameras (Control Camera) ist eine Expert-Funktion: Sie erfordert Kenntnisse in Cognex VisionPro und C#-Skripten und richtet sich an erfahrene Anwender. Informationen zum Expert-Modus finden Sie unter Worum es sich handelt und wann es benötigt wird.
Note
Voraussetzungen
Der Befehl start_control_ erfordert eine konfigurierte Kontrollkamera und ein geladenes VisionPro-Skript. Siehe Kontrollkameras. Verfügbar ab Softwareversion v0.24.
Mit dem Befehl start_control_ kann der Roboter eine Sichtprüfung mit einer Kontrollkamera anfordern. Der Roboter kann einen Textparameter anhängen, den FlexiVision an das VisionPro-Skript weiterleitet.
Befehlsformat#
start_control_<Parameter>
Der abschließende Unterstrich des Präfixes ist zwingend erforderlich. Der Parameter kann leer sein oder Zahlen, Buchstaben und weitere Unterstriche enthalten.
Vom Roboter gesendeter Befehl |
Von VisionPro empfangener Text |
Verhalten des Beispielskripts |
|---|---|---|
|
|
Führt beide PMRedLines aus |
|
|
Führt nur PMRedLine 1 aus |
|
|
Führt nur PMRedLine 2 aus |
|
|
Benutzerdefinierter Parameter: erfordert eine eigene Logik im Skript |
Important
Der Parameter wird als Text behandelt. FlexiVision misst Werten wie ABC_123 keine Bedeutung bei: Das VisionPro-Skript des Kunden muss sie interpretieren.
Note
Auch start_control_ 1 wird als Parameter "1" gelesen: Leerzeichen am Anfang und am Ende werden entfernt. Um Mehrdeutigkeiten zu vermeiden, wird empfohlen, start_control_1 ohne Leerzeichen zu senden.
Das Präfix start_control_ wird nicht an das Skript übergeben: Es kommt nur der darauffolgende Teil an (zum Beispiel "2" bei start_control_2).
Der Befehl kann auch ohne verbundenen Roboter über die HMI mit Test Tool ausgeführt werden; in diesem Fall wird das Ergebnis in der HMI angezeigt, aber nicht über TCP übertragen.
Antwort an den Roboter#
Die Antwort ist die vom VisionPro-Skript erzeugte Zeichenfolge Output_String. Das nachstehend gezeigte Format ist das des Beispielskripts und kann an das vom Roboter benötigte Protokoll angepasst werden.
Situation |
Beispiel für Output_String |
|---|---|
Objekt gefunden |
|
Kein Objekt gefunden |
|
Beide Tools ausgeführt |
|
Nicht vorgesehener Parameter |
|
Fehler bei Tool 2 |
|
Für jedes ausgeführte Tool wird nur das erste erkannte Objekt verwendet. Werden beide Tools ausgeführt, werden den Antworten die Präfixe 1: und 2: vorangestellt und durch | getrennt.
Note
XundYwerden im Koordinatensystem angegeben, das im VisionPro-Tool konfiguriert ist (Pixel oder kalibrierte Einheiten): Sie sind nicht automatisch in Millimetern.Rzwird in Grad angegeben.Drei Dezimalstellen; als Dezimaltrennzeichen wird immer der Punkt verwendet, unabhängig von der Windows-Sprache.
Not_Found und Fehler#
Not_Found ist kein Fehler: Es zeigt an, dass das Tool ausgeführt wurde, aber kein Objekt gefunden hat. Fehler der Kontrollskripte beginnen immer mit dem Präfix #Error_Control_; Kamerafehler können separat mit dem Präfix #Error_Camera gemeldet werden. Erzeugt mindestens ein Tool einen Ausführungsfehler, schreibt das Skript den Fehler an den Anfang der Antwort (im Beispiel hat Tool 1 Vorrang).
Die vollständige Liste der Meldungen und der empfohlenen Maßnahmen finden Sie unter Fehlerbehebung – Kontrollkameras.
Beispiele für den Datenaustausch#
Fall A – nur Locator 2
Vom Roboter gesendeter Befehl: start_control_2. VisionPro empfängt Input_Control = "2", führt CogPMRedLineTool2 aus, liest X, Y und Rz des ersten Ergebnisses und erzeugt die Textantwort. Das Display zeigt den Datensatz von Tool 2.
Fall B – zwei Locators
Gesendeter Befehl: start_control_. VisionPro empfängt eine leere Zeichenfolge und führt beide Tools aus. Die Antwort enthält zwei Abschnitte, einen pro Locator. Der Bilddatensatz stammt von Tool 1, sofern im Skript nichts anderes festgelegt ist.
Fall C – anwendungsspezifischer Parameter
Gesendeter Befehl: start_control_ABC_123. Der Parameter erreicht VisionPro, ohne von FlexiVision interpretiert zu werden. Das Beispielskript antwortet #Error_Control_INVALID_CONTROL; um ihn als echten Befehl zu verwenden, muss die entsprechende Logik im C#-Skript ergänzt werden.
Tip
Die vollständige Liste der Roboterbefehle finden Sie unter Kommunikationsprotokoll Roboter–Vision.