# Services des Vision-Objekts

## Allgemeine Services

Das Vision-Objekt stellt die folgenden allgemeinen Services bereit:

Service-Code | Service-Name | Beschreibung des Service
--- | --- | ---
05 Hex | Reset | Setzt das Vision-Objekt zurück.
0E Hex | Get_Attribute_Single | Gibt den Inhalt des angegebenen Attributs zurück.
10 Hex | Set_Attribute_Single | Ändert den Wert des angegebenen Attributs.

### Reset-Service

Der Reset-Service setzt das System zum Auslösen einer Aufnahme im Vision-Objekt zurück und deaktiviert es. Außerdem wird das System zum Puffern der Inspektionsergebnisse im Vision-Objekt deaktiviert und sein Inhalt gelöscht.

## Objektspezifische Services

Das Vision-Objekt stellt die folgenden objektspezifischen Services bereit:

Service-Code | Service-Name | Beschreibung des Service
--- | --- | ---
32 Hex | Acquire | Löst eine einzelne Aufnahme aus.
33 Hex | Reserved | Veraltet
34 Hex | SendNativeCmd | Sendet einen Native Mode-Befehl an das In-Sight Vision-System.
35 Hex | GetInspectionResults | Ruft das Attribut „InspectionResults“ ab.
36 Hex | Transfer User Data | Überträgt Daten in einen Teil des Benutzerdaten-Haltepuffers.
37 Hex | Set User Data | Fordert das Vision-System auf, den Benutzerdaten-Haltepuffer im Feld „Benutzerdaten“ zu speichern, wodurch das In-Sight Vision-System auf die Benutzerdaten zugreifen kann.

### Acquire-Service

Der Acquire-Service des Vision-Objekts lässt eine Aufnahme auslösen, wenn das Aufnahmesystem bereit ist, ein Bild aufzunehmen. Wenn die Aufnahme nicht ausgelöst werden kann, wird das Bit „Missed Acquisition“ in AcqStatusRegister bis zur nächsten erfolgreichen Aufnahme gesetzt.

Wenn der Befehl fehlschlägt, gibt der Acquire-Service den anbieterspezifischen Fehlercode 1F zurück.

### SendNativeCmd-Service

Der SendNativeCmd-Service (0x34) sendet eine dokumentierte Native Mode-Befehlszeichenkette an das In-Sight Vision-System. Die Anforderungsdaten für SendNativeCmd müssen die Native Mode-Befehlszeichenkette enthalten, die an das Vision-System gesendet werden soll. Die Antwortdaten enthalten das Zeichenkettenergebnis des Native Mode-Befehls. Weitere Informationen finden Sie unter Native Mode-Befehle.

### Format der Anforderungsdaten für SendNativeCmd

Name | Typ | Beschreibung
--- | --- | ---
Command | STRING | Der Native Mode-Befehl, der verarbeitet werden soll.

### Format der Antwortdaten für SendNativeCmd

Name | Typ | Beschreibung
--- | --- | ---
Ergebnis | STRING | Das Zeichenkettenergebnis des Native Mode-Befehls.

Wenn der Befehl fehlschlägt, gibt der Service einen der folgenden anbieterspezifischen Fehlercodes zurück:

Error Code | Beschreibung | Native Mode-Rückgabecode
--- | --- | ---
1 | Fehlerhafter Befehl | –
4 | Keine Antwort – das System ist zu beschäftigt. | –
100 | Command Failed | 0
101 | Befehl kann nicht ausgeführt werden. | -1
102 | -2
103 | -3
104 | -4
105 | -5
106 | -6

### GetInspectionResults-Service

Der GetInspectionResults-Service (Code 0x35) liest Daten im Attribut „InspectionResults“ des Vision-Objekts.

### Format der Anforderungsdaten für GetInspectionResults

Name | Typ | Beschreibung
--- | --- | ---
Size | UINT | Die Anzahl der zu lesenden Bytes im Attribut „InspectionResults“.
Offset | UINT | Gibt das erste zu lesende Byte im Attribut „InspectionResults“ an.

### Format der Antwortdaten für GetInspectionResults

Name | Typ | Beschreibung
--- | --- | ---
InspectionResults | STRUCT of | Die Ergebnisse der letzten Inspektion.
InspectionID | UINT | Inspektionszähler
InspectionResultCode | UINT | Inspektionsergebniscode, der in der Funktion „WriteResultsBuffer“ festgelegt ist.
InspectionResults | ARRAY of BYTE | Die Ergebnisse der letzten Inspektion.

### Befehl „Transfer User Data“

Dieser Befehl wird verwendet, um Daten in einen Teil des Benutzerdaten-Haltepuffers zu übertragen. Wenn dann der Befehl „Set User Data“ ausgegeben wird, wird der Inhalt des Benutzerdaten-Haltepuffers an das Feld „Benutzerdaten“ übertragen.

### Format der Anforderungsdaten für den Befehl „Transfer User Data“

Name | Typ | Beschreibung
--- | --- | ---
Size | UINT | Die Anzahl der zu schreibenden Bytes im Feld „Benutzerdaten“.
Offset | UINT | Gibt das erste Byte des Felds „Benutzerdaten“ an, das geschrieben werden soll.
Data | ARRAY of BYTE | Die Benutzerdaten, die in das Feld „Benutzerdaten“ geschrieben werden sollen.

### Befehl „Set User Data“

Die SPS verwendet diesen Befehl, um das Vision-System aufzufordern, den Benutzerdaten-Haltepuffer im Feld „Benutzerdaten“ zu speichern, damit das Vision-System auf die Benutzerdaten zugreifen kann.

Wenn dieser zusätzliche Handshake „User Data“ nicht erforderlich ist und das Kommunikationsverhalten das gleiche ist wie bei der Assembly-E/A, kann der Befehl „Set User Data“ mit dem folgenden Verfahren umgangen werden:

1. Öffnen Sie die In-Sight Spreadsheet und wählen Sie Ihr Vision-System aus.

2. Öffnen Sie das Hilfsprogramm Industrial Ethernet.

3. Wählen Sie in der Dropdownliste „Protokoll auswählen“ die Option „EtherNet/IP“ aus.

4. Aktivieren Sie das Kontrollkästchen Umgehen der Benutzerdaten aktivieren.

5. Klicken Sie auf Neu starten, um das Dialogfeld „Konfiguration von Industrial Ethernet“ zu schließen und Ihr Vision-System neu zu starten.

### EtherNet/IP-Funktionen

Die folgenden Tabellenfunktionen können Daten zwischen der In-Sight Spreadsheet und dem EtherNet/IP-Stapel senden oder empfangen:

- ReadUserDataBuffer

- WriteResultsBuffer

- GetBufferData