# Services d’Objet de vision

## Services communs

L’Objet de vision fournit les services communs suivants :

Code du service | Nom du service | Description du service
--- | --- | ---
05 Hex | Réinitialisation | Réinitialise l’Objet de vision.
0E Hex | Get_Attribute_Single | Renvoie le contenu de l’attribut spécifié.
10 Hex | Set_Attribute_Single | Modifie la valeur de l’attribut spécifié.

### Service Réinitialisation

Le service Réinitialisation permet de remettre à zéro et de désactiver le système de déclenchement d’acquisition dans l’Objet de vision. Il désactive et efface également le système de mise en mémoire tampon des résultats d’inspection dans l’Objet de vision.

## Services spécifiques à un Objet

L’Objet de vision fournit les services spécifiques à un objet suivants :

Code du service | Nom du service | Description du service
--- | --- | ---
32 Hex | Acquérir | Déclenche une seule acquisition.
33 Hex | Réservé | Obsolète.
34 Hex | SendNativeCmd | Envoie une commande du mode natif au système de vision In-Sight.
35 Hex | GetInspectionResults | Obtient l’attribut InspectionResults.
36 Hex | Transférer les données utilisateur | Transfère les données dans une partie de la mémoire tampon des données utilisateur.
37 Hex | Set User Data | Invite le système de vision à conserver la mémoire tampon des données utilisateur dans le fichier Données utilisateur. Le système de vision In-Sight obtient alors l’accès aux données utilisateur.

### Service Acquérir

Le service Acquérir de l’Objet de vision déclenche une acquisition si le système d’acquisition est prêt à acquérir une image. Si l’acquisition ne peut pas être déclenchée, le bit Missed Acquisition de AcqStatusRegister est activé jusqu’à la prochaine acquisition réussie.

Si la commande échoue, le service Acquérir renvoie un code d’erreur spécifique au vendeur 1F.

### Service SendNativeCmd

Le service SendNativeCmd (0x34) envoie toute chaîne de commande du mode natif documentée au système de vision In-Sight. Les données de la demande SendNativeCmd doivent inclure la chaîne de commande du mode natif à envoyer au système de vision. Les données de réponse contiennent la chaîne de caractères résultat de la commande du mode natif. Pour plus d’informations, consultez la rubrique Commandes du mode natif.

### Format des données de la demande SendNativeCmd

Nom | Type | Description
--- | --- | ---
Commande | CHAÎNE | La commande du mode natif à traiter.

### Format des données de la réponse SendNativeCmd

Nom | Type | Description
--- | --- | ---
Résultat | CHAÎNE | La chaîne de caractères résultat de la commande du mode natif.

Si la commande échoue, le service renvoie l’un des codes d’erreur suivants, spécifiques au vendeur :

Code d’erreur | Description | Code de retour du mode natif
--- | --- | ---
1 | Mauvaise commande | -
4 | Pas de réponse – Le système est trop occupé | -
100 | Command Failed | 0
101 | La commande ne peut pas être exécutée | -1
102 | -2
103 | -3
104 | -4
105 | -5
106 | -6

### Service GetInspectionResults

Le service GetInspectionResults (code 0x35) lit les données de l’attribut InspectionResults de l’Objet de vision.

### Format des données de la demande GetInspectionResults

Nom | Type | Description
--- | --- | ---
Taille | UINT | Le nombre d’octets à lire de l’attribut InspectionResults.
Offset | UINT | Détermine le premier octet de l’attribut InspectionResults à lire.

### Format des données de la réponse GetInspectionResults

Nom | Type | Description
--- | --- | ---
InspectionResults | STRUCTURE de | Les résultats de la dernière inspection.
InspectionID | UINT | Compteur d’inspections.
InspectionResultCode | UINT | Code de résultat d’inspection défini dans la fonction WriteResultsBuffer.
InspectionResults | Tableau d’octets | Résultats de la dernière inspection.

### Commande Transférer les données utilisateur

Cette commande est utilisée pour transférer les données dans une partie de la mémoire tampon des données utilisateur. La mémoire tampon des données utilisateur est conservée avec le champ Données utilisateur lorsque la commande Set User Data est exécutée.

### Format de la demande de commande Transférer les données utilisateur

Nom | Type | Description
--- | --- | ---
Taille | UINT | Le nombre d’octets à écrire du champ Données utilisateur.
Offset | UINT | Détermine le premier octet du champ Données utilisateur à écrire.
Données | Tableau d’octets | Données utilisateur à écrire dans le champ Données utilisateur.

### Commande Set User Data

Le PLC utilise cette commande pour inviter le système de vision à conserver la mémoire tampon des données utilisateur dans le fichier Données utilisateur. Le système de visionobtient alors l’accès aux données utilisateur.

Si cette connexion aux données utilisateur supplémentaire n’est pas nécessaire et que le comportement des communications est identique à celui impliquant les assemblages d’E/S, la commande Set User Data peut être ignorée en procédant comme suit :

1. Ouvrez le composant In-Sight Spreadsheet, puis sélectionnez votre système de vision.

2. Ouvrez l’utilitaire Industrial Ethernet.

3. Dans la liste déroulante Sélectionner protocole, sélectionnez EtherNet/IP.

4. Cochez la case Activer le contournement des données utilisateur.

5. Cliquez sur Redémarrage pour fermer la boîte de dialogue Configuration Internet industriel et redémarrer votre système de vision.

### Fonctions EtherNet/IP

Les fonctions suivantes du composant Feuille de calcul peuvent envoyer ou recevoir des données entre le composant In-Sight Spreadsheet et la pile EtherNet/IP :

- ReadUserDataBuffer

- WriteResultsBuffer

- GetBufferData