Spécifications du protocole

La communication avec EYE+ XTD se fait à l’aide d’un simple protocole ASCII basé sur du texte. Le client envoie une commande, EYE+ XTD répond par un code d’état suivi d’un message.

Important

La commande ASCII doit être suivie d’un caractère de fin de ligne unique tel que spécifié dans la section Configuration TCP/IP. Par défaut, le caractère utilisé est LF (c’est-à-dire \n, code ASCII 0x0A). Depuis le Terminal TCP, le caractère est automatiquement envoyé et n’a pas besoin d’être spécifié.

Commande EYE+ XTD

La commande doit être écrite en minuscules avec des séparations soulignées (par exemple get_parameter). Un espace doit être placé entre la commande et le paramètre et entre le paramètre et la valeur. Reportez-vous à la section Commandes pour toutes les commandes disponibles.

  • sans paramètre ni valeur

    <command>\n
    
  • avec paramètre mais sans valeur

    <command>␣<parameter>\n
    
  • avec paramètre et valeur

    <command>␣<parameter>␣<value>\n
    

Réponse EYE+ XTD

EYE+ XTD répond à la commande de chaque client en utilisant un code pour informer le client de l’état de la commande. La réponse se déroule toujours de la même manière :

<response_code>␣<further information>\n

Si la réponse contient plus d’une ligne, le nombre de lignes est ajouté après <response_code>.

<response_code>␣<n>␣<further information>\n
<further information>\n
...
<further information>\n
Tableau 20 Codes de réponse

<response_code> (ASCII)

Signification

200

La commande a été exécutée avec succès

201 <n>

La commande a été exécutée avec succès et contient <n> lignes dans l’output

4xx

Erreur du client

5xx

Erreur du serveur (c’est-à-dire EYE+ XTD)

Codes d’erreur

En cas d’erreur, le code d’erreur est suivi d’une description unique de l’erreur.

Codes d’erreur du client

401

La commande reçue est inconnue

402

L’argument donné n’est pas valable pour cette commande

403

Le système n’es pas en état de production

Assurez-vous qu’une recette a été lancée en production.

404

Le paramètre donné n’existe pas

405

Une commande get_part est déjà active, probablement par le biais d’une connexion différente

406

La transition demandée vers un autre état du système n’est pas autorisée

407

L’identifiant de la recette n’a pas été trouvé dans le système

Assurez-vous que vous avez utilisé le bon identifiant de recette et que la recette est valide pour la production.

408

La recette n’est pas prête à être utilisée en production

Éditez la recette et complétez l’assistant d’apprentissage.

409

Le système n’est pas dans un état valide

410

Aucune licence valide trouvée

Assurez-vous qu’une licence valide a été installée.

411

Toutes les connexions simultanées internes sont utilisées

Réduisez le nombre de connexions simultanées au protocole TCP/IP.

416

Pas assez de points enregistrés pour effectuer l’étalonnage main-œil

Vous devez enregistrer 4 points de vision et 4 points robot avant de procéder à l’étalonnage.

417

Le point demandé n’est pas défini

Vous devez enregistrer le point d’étalonnage au moins une fois avant d’exécuter get_calibration_point.

419

Commande non valide pour le type de recette

Les commandes liées à un type de recette différent ne sont pas prises en charge avec la recette actuelle.

Codes d’erreur du serveur

501

Le délai s’est écoulé pendant la recherche de pièces valables

Vérifiez que le nombre de pièces sur la plateforme est correct et que la plateforme n’est ni vide ni trop remplie.

503

Le délai s’est écoulé alors que le système attendait que can_take_image devienne vrai (true)

504

Aucune pièce n’a été trouvée lors de la dernière analyse d’image

510

get_part a été interrompu par un stop/abandon, très probablement reçu sur une autre connexion

515

Erreur lors de l’allumage ou de l’extinction de l’éclairage frontal

Les journaux du système peuvent contenir plus d’informations.

516

La caméra n’est pas connectée

Les journaux du système devraient contenir plus d’informations. Vérifiez le câblage. Le voyant doit être vert.

519

Aucun étalonnage disponible

Vous devez calculer l’étalonnage main-œil avant de le sauvegarder ou de l’utiliser.

520

Pas de correspondance du point de prise

Aucune correspondance trouvée lors de la dernière analyse d’image.

596

Erreur interne liée à la production

Les journaux du système devraient contenir plus d’informations sur le problème.

597

Erreur interne liée à la vision

Les journaux du système devraient contenir plus d’informations sur le problème.

599

Erreur interne liée au système

Les journaux du système devraient contenir plus d’informations sur le problème.