Commandes d’interface standard

Vous consultez actuellement la documentation pour la dernière version (2.1.2). Pour accéder à une autre version, cliquez sur le bouton "Changer de version" situé dans le coin supérieur droit de la page.

■ Si vous n’êtes pas sûr de la version du produit que vous utilisez, veuillez contacter le support technique Mech-Mind pour obtenir de l’aide.

Cette section décrit les commandes d’interface standard utilisées dans les communications Mitsubishi MC entre un PLC MELSEC iQ-R Series et le système de vision Mech-Mind. Le PLC (le client) envoie des commandes au système de vision Mech-Mind (le serveur), et le système de vision Mech-Mind renvoie les données traitées au PLC.

send receive

Précautions

  • Unité de données :

    • L’unité des positions articulaires est le degré (°).

    • La pose de la bride du robot ou le TCP se compose de la position et de l’orientation. La position est représentée en coordonnées XYZ et mesurée en millimètres (mm) ; l’orientation est représentée en angles d’Euler et mesurée en degrés (°).

  • Point de vision et point de passage :

    • Point de vision : Un objet reconnu par Mech-Vision. Un point de vision contient des informations, notamment la pose de l’objet, l’étiquette, la vitesse, les dimensions et des données personnalisées.

    • Point de passage : Chaque point que le robot atteint lors du déplacement le long de la trajectoire planifiée. Un point de passage contient des informations, notamment la pose du robot, l’étiquette, le type de mouvement et la vitesse. Les points de passage peuvent être divisés en deux catégories :

      • Point de passage Vision Move : point de passage correspondant à l’Étape Vision Move.

      • Points de passage non Vision Move, qui désignent les points de passage correspondant aux étapes de type Move autres que l’Étape Vision Move.

Exécuter le projet Mech-Vision

Description

Cette commande déclenche l’exécution du projet Mech-Vision. Lorsque le projet Mech-Vision est en cours d’exécution, le système de vision déclenche la caméra pour capturer des images puis traite les images renvoyées avec des algorithmes afin de produire une série de points de vision ou de points de passage.

  • Point de vision : Un objet reconnu par Mech-Vision. Un point de vision contient des informations, notamment la pose de l’objet, l’étiquette, la vitesse, les dimensions et des données personnalisées.

  • Point de passage : Chaque point que le robot atteint lors du déplacement le long de la trajectoire planifiée. Un point de passage contient des informations, notamment la pose du robot, l’étiquette, le type de mouvement et la vitesse.

Séquence d’appel

Modules

cmd1

Paramètres d’entrée

Vision_Proj_Num

Ce paramètre spécifie l’identifiant de projet de Mech-Vision. Le type de données est Word [signé]. Vous pouvez consulter l’identifiant de projet d’un projet Mech-Vision dans la section Liste des projets de Mech-Vision. L’identifiant de projet est le nombre qui précède le nom du projet.

Req_Pose_Num

Ce paramètre spécifie le nombre attendu de points de vision ou de points de passage à obtenir à partir du projet Mech-Vision. Le type de données est Word [signé]. Plage de valeurs : 0 jusqu’au plus grand entier positif.

Si le projet Mech-Vision comporte une Étape Path Planning, ce paramètre spécifie le nombre attendu de points de passage. Sinon, il spécifie le nombre attendu de points de vision.
  • 0 : Obtenir tous les points de vision ou les points de passage du projet Mech-Vision.

  • Un entier positif : Obtenir le nombre spécifique de points de vision ou de points de passage du projet Mech-Vision.

    • Si le nombre total de points de vision ou de points de passage générés par le projet Mech-Vision est inférieur à la valeur du paramètre, cette commande obtiendra le nombre de tous les points de vision ou de points de passage.

    • Si le nombre total de points de vision ou de points de passage générés par le projet Mech-Vision est supérieur ou égal à la valeur du paramètre, cette commande obtiendra le nombre de points de vision ou de points de passage tel que spécifié par ce paramètre.

Robot_Pose_Type

Ce paramètre spécifie la manière dont la pose réelle du robot est envoyée au projet Mech-Vision. Le type de données est Word [signé]. Valeurs valides : 0, 1, 2 et 3. Le tableau suivant en décrit les détails.

Robot_Pose

Ce paramètre spécifie la pose du robot. Le type de données est FLOAT [simple précision](0..1,0..5). La structure de données de ce paramètre est un tableau à deux dimensions. Array[0] représente les positions articulaires du robot et Array[1] représente la pose de la bride du robot.

Le tableau suivant explique la relation entre les paramètres Robot_Pose_Type et Robot_Pose.

Robot_Pose_Type Robot_Pose Description Scénario applicable

0

[[0,0,0,0,0,0]],[0,0,0,0,0,0]]

La commande n’envoie pas la pose du robot au projet Mech-Vision.

Si l’Étape Path Planning est utilisée dans le projet Mech-Vision, le point de départ de la trajectoire planifiée sera le point d’origine défini dans l’outil de planification de trajectoire.

Ce paramétrage doit être utilisé si la caméra est montée en mode eye to hand et que le projet ne nécessite pas de capture d’images au préalable.

1

Positions articulaires et pose de bride actuelles du robot

Les positions articulaires et la pose de bride du robot doivent être saisies dans le projet Mech-Vision.

Ce paramétrage doit être utilisé lorsque la caméra est montée en mode eye in hand.

Ce paramétrage est recommandé pour la plupart des scénarios, à l’exception de ceux impliquant des robots portiques.

2

Pose de bride actuelle du robot

La pose de bride du robot doit être saisie dans le projet Mech-Vision.

Ce paramétrage est recommandé pour les scénarios impliquant des robots portiques.

3

Positions articulaires personnalisées du robot

Cette commande envoie des positions articulaires personnalisées au projet Mech-Vision.

Ces positions articulaires seront envoyées à l’Étape Path Planning dans le projet Mech-Vision comme point de départ, à partir duquel le robot se déplacera de ce point de départ vers le premier point de passage de la trajectoire planifiée.

Ce paramétrage doit être utilisé si la caméra est montée en mode eye to hand et que le projet nécessite une capture d’images au préalable.

Start_Vis

Ce paramètre déclenche le démarrage du projet Mech-Vision lors d’un front montant. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 1102. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Exemple

cmd2

Lorsque Camera_User.Start_Vis est au front montant, le PLC déclenche l’exécution du projet Mech-Vision n° 1 et s’attend à ce que le projet Mech-Vision n° 1 envoie un point de vision ou un point de passage. En même temps, le PLC envoie les positions articulaires actuelles et la pose de bride du robot à Mech-Vision.

Obtenir le résultat de vision

Description

Cette commande obtient le résultat de vision, à savoir une série de points de vision, depuis Mech-Vision. La pose d’objet du point de vision (c’est-à-dire la sortie du port poses de l’Étape Output) sera automatiquement convertie en TCP du robot par le système de vision. Le processus est le suivant.

Si le premier port d’entrée de l’Étape Output est Points centraux d’objet, l’Étape Output convertira les points centraux d’objet en points de prise correspondants. Par conséquent, les poses d’objet obtenues en exécutant cette commande sont en fait des poses de points de prise, et non des poses de points centraux d’objet.
get tcp
  1. Convertir la pose de l’objet d’une représentation en quaternion en angles d’Euler.

  2. Faire pivoter la pose de l’objet autour de l’axe X de 180° pour orienter son axe Z vers le bas.

    convert tcp

Séquence d’appel

Cette commande doit être appelée après Exécuter le projet Mech-Vision.

Modules

cmd3

Paramètres d’entrée

Vision_Proj_Num

Ce paramètre spécifie l’identifiant de projet de Mech-Vision. Le type de données est Word [signé]. Vous pouvez consulter l’identifiant de projet d’un projet Mech-Vision dans la section Liste des projets de Mech-Vision. L’identifiant de projet est le nombre qui précède le nom du projet.

Get_VisData

Ce paramètre déclenche l’obtention du résultat de vision au front montant. Le type de données est Bit.

Start_Empty

Ce paramètre efface les données obtenues stockées dans Target Pose et Target Label. Ce paramètre prend effet lorsqu’il est activé. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 1100. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Par défaut, après l’envoi de cette commande par le robot, le système de vision renvoie le résultat dans un délai de 10 secondes. Si le système de vision ne renvoie aucun résultat dans un délai de 10 secondes, un code d’erreur de dépassement de délai est renvoyé. Pour modifier au besoin la durée d’expiration par défaut, accédez à Robot et Communication > Robot Communication Configuration  Suivant  Paramètres avancés dans la barre d’outils de Mech-Vision.

set vis time

Status_of_Pose_Sent

Ce paramètre spécifie si tous les points de vision sont obtenus. Le type de données est Word [signé]. La valeur est 0 ou 1.

  • 0 : Tous les points de vision ne sont pas obtenus.

  • 1 : Tous les points de vision sont obtenus.

Number_of_Pose_Sent

Ce paramètre stocke le nombre de points de vision renvoyés par Mech-Vision. Le type de données est Word [signé].

Target_Pose

Ce paramètre indique les poses de tous les points de vision dans le résultat de vision obtenu. Les poses sont des TCP. Le type de données est FLOAT [simple précision](0..39,0..5).

Target_Label

Ce paramètre indique les étiquettes de tous les points de vision dans le résultat de vision obtenu. Les étiquettes et les poses sont appariées un à un. Le type de données est Word [signé](0..39).

Exemple

cmd4

Lorsque Camera_User.Get_VisData est au front montant, cet exemple obtient le résultat de vision depuis le projet Mech-Vision n° 1.

Basculer la recette de paramètres Mech-Vision

Description

Cette commande déclenche Mech-Vision pour basculer la recette de paramètres utilisée par le projet. L’image ci-dessous montre comment basculer manuellement la recette de paramètres pour un projet Mech-Vision. Pour plus de détails sur les recettes de paramètres, consultez le guide recette de paramètres.

set recipe

Séquence d’appel

Cette commande doit être appelée avant Exécuter le projet Mech-Vision.

Modules

cmd5

Paramètres d’entrée

Vision_Proj_Num

Ce paramètre spécifie l’identifiant de projet de Mech-Vision. Le type de données est Word [signé]. Vous pouvez consulter l’identifiant de projet d’un projet Mech-Vision dans la section Liste des projets de Mech-Vision. L’identifiant de projet est le nombre qui précède le nom du projet.

Vision_Recipe_Num

Ce paramètre spécifie l’ID de la recette de paramètres dans le projet Mech-Vision. Le type de données est Word [signé]. Pour savoir comment afficher l’ID de la recette de paramètres, consultez Afficher l’ID de la recette de paramètres.

Switch_Recipe

Ce paramètre déclenche le basculement de la recette de paramètres dans Mech-Vision lors de l’apparition d’un front montant. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 1107. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Exemple

cmd6

Lorsque Camera_User.Switch_Recipe est au front montant, cet exemple bascule la recette de paramètres utilisée vers la n° 2 dans le projet Mech-Vision n° 1.

Obtenir la trajectoire planifiée dans Mech-Vision

Description

Cette commande obtient la trajectoire planifiée par le projet Mech-Vision sous forme d’une série de points de passage. La trajectoire est planifiée par l’outil de planification de trajectoire, auquel vous pouvez accéder en cliquant sur Assistant de configuration comme illustré ci-dessous. Pour plus de détails sur la planification de trajectoire, consultez Path Planning.

Définissez le paramètre Type de port de l’Étape Output dans Mech-Vision sur Prédéfini (trajectoire robot).
get plan path step

Séquence d’appel

Cette commande doit être appelée après Exécuter le projet Mech-Vision.

Modules

cmd7

Paramètres d’entrée

Vision_Proj_Num

Ce paramètre spécifie l’identifiant de projet de Mech-Vision. Le type de données est Word [signé]. Vous pouvez consulter l’identifiant de projet d’un projet Mech-Vision dans la section Liste des projets de Mech-Vision. L’identifiant de projet est le nombre qui précède le nom du projet.

Request_Pose_Type

This parameter specifies the type of waypoint poses to be obtained. Le type de données est Word [signé]. Valid values: 1 and 2.

  • 1: Positions articulaires.

  • 2: TCP.

Get_VisData

Ce paramètre déclenche, au front montant, l’obtention de la trajectoire planifiée par Mech-Vision. Le type de données est Bit.

Start_Empty

Ce paramètre efface les données obtenues stockées dans Target Pose et Target Label. Ce paramètre prend effet lorsqu’il est activé. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 1103. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Par défaut, après l’envoi de cette commande par le robot, le système de vision renvoie le résultat dans un délai de 10 secondes. Si le système de vision ne renvoie aucun résultat dans un délai de 10 secondes, un code d’erreur de dépassement de délai est renvoyé. Pour modifier au besoin la durée d’expiration par défaut, accédez à Robot et Communication > Robot Communication Configuration  Suivant  Paramètres avancés dans la barre d’outils de Mech-Vision.

set vis time

Status_of_Pose_Sent

Ce paramètre spécifie si tous les points de passage sont obtenus. Le type de données est Word [signé]. La valeur est 0 ou 1.

  • 0 : Tous les points de passage ne sont pas obtenus.

  • 1 : Tous les points de passage sont obtenus.

Number_of_Pose_Sent

Ce paramètre stocke le nombre de points de passage renvoyés par le système de vision. Le type de données est Word [signé]. Par défaut, le système de vision peut envoyer au plus 20 points de passage. Ainsi, la valeur maximale par défaut de ce paramètre est 20. Pour modifier le nombre maximal par défaut de poses à obtenir à chaque fois au besoin, accédez à Configuration de la communication du robot  Suivant  Paramètres avancés dans la barre d’outils de Mech-Vision. La limite supérieure est 30.

set number
Avant d’appeler Obtenir la trajectoire planifiée dans Mech-Vision, définissez Req_Pose_Num de Exécuter le projet Mech-Vision sur 0 afin de réduire le nombre d’appels à Obtenir la trajectoire planifiée dans Mech-Vision. Si Req_Pose_Num de Exécuter le projet Mech-Vision est défini sur 1, un seul point de passage est obtenu à chaque appel de Obtenir la trajectoire planifiée dans Mech-Vision. Vous devez appeler la commande 105 plusieurs fois pour obtenir tous les points de passage.

Index_of_Vision_Picking_Point

Le numéro de séquence du point de passage Vision Move (le point de passage correspondant à l’étape Vision Move de l’outil de planification de trajectoire) dans le parcours. Le type de données est Word [signé]. Si le point de passage n’existe pas dans le parcours, la valeur de petameter est 0.

Si le parcours planifié se compose des points de passage suivants dans l’ordre : Fixed-Point Move_1, Fixed-Point Move_2, Vision Move et Fixed-Point Move_3, le numéro de séquence du point de passage Vision Move est 3.

Target_Pose

Ce paramètre indique les poses de tous les points de passage dans la trajectoire planifiée obtenue. Les poses sont des TCP ou des positions articulaires, selon la valeur de Request_Pose_Type. Le type de données est FLOAT [simple précision](0..39,0..5).

Target_Label

Ce paramètre indique les étiquettes de tous les points de passage dans la trajectoire planifiée obtenue. Les étiquettes et les poses sont appariées un à un. Le type de données est Word [signé](0..39).

Target_Tool_ID

Ce paramètre indique les IDs d’outil de tous les points de passage dans la trajectoire planifiée obtenue. Les IDs d’outil et les poses sont appariés un à un. Le type de données est Word [signé](0..39).

Exemple

cmd8

Lorsque Camera_User.Get_VisData est au front montant, cet exemple obtient la trajectoire planifiée depuis le projet Mech-Vision n° 1. Les points de passage sont représentés en positions articulaires.

Obtenir la liste des DO du préhenseur

Description

Cette commande obtient la liste des signaux de commande pour le préhenseur à vide multi-sections depuis le projet Mech-Vision ou Mech-Viz. Avant d’utiliser cette commande, vous devez effectuer les configurations suivantes dans Mech-Vision ou Mech-Viz.

  • Configurer le projet Mech-Vision

    • Dans l’Étape Path Planning, cliquez sur Assistant de configuration. Dans Configuration globale, activez Dépalettisation de cartons.

      vision move vis
    • Dans l’Étape Path Planning, cliquez sur Assistant de configuration, puis double-cliquez sur le nom de l’outil du robot. Dans la fenêtre contextuelle, sélectionnez Préenseur à vide pour dépalettisation pour Type d’outil, cliquez sur Configurer le préhenseur à vide pour dépalettisation, puis configurez les signaux DO selon les besoins.

      sucker vis
  • Configurer le projet Mech-Viz

    • Dans l’Étape Vision Move de Mech-Viz, définissez Select Picking Method sur Box depalletizing.

      vision move viz
    • Dans Mech-Viz, double-cliquez sur le nom de l’outil, sélectionnez Préenseur à vide pour dépalettisation pour Type d’outil, cliquez sur Configurer le préhenseur à vide pour dépalettisation, puis configurez les valeurs de signaux DO selon les besoins.

      sucker viz

Séquence d’appel

Cette commande doit être appelée avant la commande Obtenir la trajectoire planifiée dans Mech-Vision ou Obtenir la trajectoire planifiée dans Mech-Viz. Cela signifie que le PLC doit obtenir la trajectoire planifiée puis obtenir les signaux DO du préhenseur du point de passage Vision Move.

Modules

cmd9

Paramètres d’entrée

Vision_Proj_Num

Ce paramètre spécifie la source de la liste des signaux DO. Le type de données est Word [signé]. Plage de valeurs : 0 jusqu’au plus grand entier positif.

  • 0 : Obtenir la liste des signaux DO depuis Mech-Viz.

  • Un entier positif : Obtenir la liste des signaux DO depuis Mech-Vision. L’entier positif est l’ID du projet Mech-Vision.

Depalletize_Tool_Section_Count

Ce paramètre indique le nombre de sections du préhenseur à vide. Le type de données est Word [signé].

Get_DoList

Ce paramètre déclenche l’obtention des signaux DO du préhenseur au front montant. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande a obtenu avec succès la liste des signaux DO du projet Mech-Viz, le code d’état est 2102. Si la liste des signaux DO est obtenue avec succès depuis Mech-Vision, le code d’état est 1106. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

DO_LIST

Ce paramètre indique les 64 signaux DO renvoyés par cette commande. Le type de données est Word [signé](0..63).

Les signaux DO renvoyés par cette commande varient en fonction du projet déployé.

  • Signaux DO du préhenseur planifiés par le projet Mech-Vision

    • Dans Configuration globale de l’outil de planification de trajectoire, si Planifier tous les résultats de vision est désactivé, cette commande renvoie 64 signaux DO de préhenseur qui sont planifiés lors de ce cycle. Les signaux DO valides sont des entiers non négatifs allant de 0 à 999. Les signaux DO invalides sont -1, qui sert d’espace réservé.

      plan all vis off

      Par exemple, les signaux DO valides dans le tableau ci-dessous sont 1, 3, 5 et 6, ce qui signifie que le robot définira les valeurs de ces signaux DO sur ON.

      1er

      2e

      3e

      4e

      5e

      6e

      7e

      8e

      63e

      64e

      1

      3

      5

      6

      -1

      -1

      -1

      -1

      -1

      -1

    • Dans Configuration globale de l’outil de planification de trajectoire, si Planifier tous les résultats de vision est activé, Mech-Vision peut effectuer plusieurs cycles de planification en se basant sur le même résultat de vision. Les 64 signaux DO du préhenseur renvoyés par cette commande sont obtenus au cours de tous les cycles de planification. Dans ce cas, vous pouvez utiliser le nombre de sections du préhenseur à vide pour différencier les signaux DO du préhenseur obtenus lors de chaque cycle de planification.

      plan all vis on

      Par exemple, si le nombre de sections du préhenseur à vide est de 4 et que la commande renvoie 64 signaux DO au total, chaque groupe de 4 signaux DO correspond aux signaux du préhenseur à vide multi-sections obtenus lors de chaque cycle de planification.

      Premier cycle de planification

      Deuxième cycle de planification

      16e cycle de planification

      1er

      2e

      3e

      4e

      5e

      6e

      7e

      8e

      61e

      62e

      63e

      64e

      1

      3

      4

      -1

      1

      4

      -1

      -1

      -1

      -1

      -1

      -1

  • Signaux DO du préhenseur planifiés par le projet Mech-Viz

    • Si Réutiliser le résultat de vision n’est pas sélectionné pour l’Étape Vision Move, cette commande renvoie 64 signaux DO de préhenseur planifiés lors de ce cycle. Les signaux DO valides sont des entiers non négatifs allant de 0 à 999. Les signaux DO invalides sont -1, qui sert d’espace réservé.

      vision move off

      Par exemple, les signaux DO valides dans le tableau ci-dessous sont 1, 3, 5 et 6, ce qui signifie que le robot définira les valeurs de ces signaux DO sur ON.

      1er

      2e

      3e

      4e

      5e

      6e

      7e

      8e

      63e

      64e

      1

      3

      5

      6

      -1

      -1

      -1

      -1

      -1

      -1

    • Si Réutiliser le résultat de vision est sélectionné pour l’Étape Vision Move et que l’Étape Vision Move est utilisée en boucle, Mech-Viz peut effectuer plusieurs cycles de planification en se basant sur le même résultat de vision. Les 64 signaux DO du préhenseur renvoyés par cette commande sont obtenus au cours de tous les cycles de planification. Dans ce cas, vous pouvez utiliser le nombre de sections du préhenseur à vide pour différencier les signaux DO du préhenseur obtenus lors de chaque cycle de planification.

      vision move on

      Par exemple, si le nombre de sections du préhenseur à vide est de 4 et que la commande renvoie 64 signaux DO au total, chaque groupe de 4 signaux DO correspond aux signaux du préhenseur à vide multi-sections obtenus lors de chaque cycle de planification.

      Premier cycle de planification

      Deuxième cycle de planification

      16e cycle de planification

      1er

      2e

      3e

      4e

      5e

      6e

      7e

      8e

      61e

      62e

      63e

      64e

      1

      3

      4

      -1

      1

      4

      -1

      -1

      -1

      -1

      -1

      -1

Exemple

cmd10

Lorsque Camera_User.Get_DoList est au front montant, la liste des signaux DO renvoyée par Mech-Viz sera stockée dans DO_LIST.

Obtenir les données personnalisées Mech-Vision

Description

Cette commande obtient les données à partir du(des) port(s) personnalisé(s) de l’Étape « Output » dans Mech-Vision. Un appel de commande enregistre toutes les données des ports de l’Étape Output dans le registre spécifié.

Sélectionnez l’étape Output, définissez Type de port sur Custom, puis cliquez sur Ouvrir l’éditeur pour accéder à la fenêtre de configuration du port personnalisé. La section Customized Keys de la fenêtre affiche des noms de ports personnalisés, tels que customeData1 et customeData2, comme illustré dans la figure suivante.

  1. Les données de sortie provenant de Predefined Keys, telles que poses, labels, sizes, offsets, ne sont pas des données personnalisées.

  2. Vous devez définir le Type de port de l’étape Output sur Custom et sélectionner le port poses dans la section Predefined Keys de Mech-Vision.

custom data
Le nombre de ports personnalisés ne peut pas dépasser 10. Les données personnalisées obtenues sont triées par ordre alphabétique sensible à la casse des ports.

Séquence d’appel

Cette commande doit être appelée après Exécuter le projet Mech-Vision.

Modules

cmd11

Paramètres d’entrée

Vision_Proj_Num

Ce paramètre spécifie l’identifiant de projet de Mech-Vision. Le type de données est Word [signé]. Vous pouvez consulter l’identifiant de projet d’un projet Mech-Vision dans la section Liste des projets de Mech-Vision. L’identifiant de projet est le nombre qui précède le nom du projet.

Get_VisData

Ce paramètre déclenche, au front montant, l’obtention des données personnalisées de Mech-Vision. Le type de données est Bit.

Start_Empty

Ce paramètre efface les données obtenues stockées dans Target Pose et Target Label. Ce paramètre prend effet lorsqu’il est activé. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 1100. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Status_of_Pose_Sent

Ce paramètre spécifie si tous les points de vision sont obtenus. Le type de données est Word [signé]. La valeur est 0 ou 1.

  • 0 : Tous les points de vision ne sont pas obtenus.

  • 1 : Tous les points de vision sont obtenus.

Number_of_Pose_Sent

Ce paramètre stocke le nombre de points de vision renvoyés par Mech-Vision. Le type de données est Word [signé].

Target_Pose

Ce paramètre indique les poses de tous les points de vision dans le résultat de vision obtenu. Les poses sont des TCP. Le type de données est FLOAT [simple précision](0..39,0..5).

Target_Label

Ce paramètre indique les étiquettes de tous les points de vision dans le résultat de vision obtenu. Les étiquettes et les poses sont appariées un à un. Le type de données est Word [signé](0..39).

Custom_Vision_Output

Ce paramètre indique les données personnalisées de chaque point de vision dans le résultat de vision obtenu. Les données personnalisées et les poses sont appariées un à un. Le type de données est FLOAT (simple précision)(0..39,0..9).

Exemple

cmd12

Lorsque Camera_User.Get_VisData est au front montant, cet exemple obtient les données personnalisées depuis le projet Mech-Vision n° 1.

Exécuter le projet Mech-Viz

Description

Cette commande déclenche l’exécution du projet Mech-Viz. Mech-Viz planifie la trajectoire de mouvement du robot en fonction du résultat de vision produit par Mech-Vision.

Cliquez avec le bouton droit sur le nom du projet dans le panneau des ressources du projet dans Mech-Viz et sélectionnez Autoload Project.

Modules

cmd13

Paramètres d’entrée

Robot_Pose_Type

Ce paramètre spécifie la manière dont la pose réelle du robot est envoyée au projet Mech-Viz. Valeurs valides : 0, 1 et 2. Le tableau suivant en décrit les détails. Le type de données est Word [signé].

Robot_Pose

Ce paramètre spécifie la pose du robot. Le type de données est FLOAT [simple précision](0..1,0..5). La structure de données de ce paramètre est un tableau à deux dimensions. Array[0] représente les positions articulaires du robot et Array[1] représente la pose de la bride du robot.

Le tableau suivant explique la relation entre les paramètres Robot_Pose_Type et Robot_Pose.

Robot_Pose_Type Robot_Pose Description Scénario applicable

0

[[0,0,0,0,0,0]],[0,0,0,0,0,0]]

Cette commande n’a pas besoin d’envoyer la pose du robot à Mech-Viz. Le robot simulé dans le projet Mech-Viz se déplacera du point d’origine défini vers le premier point de passage.

Ce paramétrage est recommandé lorsque la caméra est montée en mode eye to hand.

1

Positions articulaires et pose de bride actuelles du robot

Dans cette commande, le robot envoie ses positions articulaires et sa pose de bride actuelles au projet Mech-Viz. Le robot simulé dans Mech-Viz se déplace des positions articulaires d’entrée vers le premier point de passage.

Ce paramétrage est recommandé lorsque la caméra est montée en mode eye in hand.

2

Positions articulaires du point de départ de la trajectoire planifiée

Dans cette commande, le robot envoie les positions articulaires d’un point enseigné (les positions articulaires personnalisées, et non les positions actuelles) au projet Mech-Viz. Le projet Mech-Viz utilise les positions articulaires d’entrée pour planifier à l’avance la trajectoire suivante pendant que le robot n’est pas dans la zone de capture d’image, comme illustré dans la figure suivante. Le robot simulé dans Mech-Viz se déplace des positions articulaires d’entrée vers le premier point de passage.

Ce paramétrage est recommandé lorsque la caméra est montée en mode eye to hand.

Si la caméra est montée en mode eye to hand, l’option 2 est recommandée pour Robot_Pose_Type. Pourquoi ?

En mode eye to hand, la caméra peut effectuer la capture d’images pour le cycle de planification de trajectoire suivant avant que le robot ne retourne dans la zone de capture d’image et de prise, réduisant ainsi le temps de cycle. L’image ci-dessous illustre le fonctionnement d’un robot dans la zone de dépose.

Si Robot_Pose_Type est défini sur 1, le robot enverra la pose actuelle à Mech-Viz. Il est possible que le robot réel se déplace vers d’autres positions avant d’atteindre le premier point de passage. Cependant, le robot simulé se déplace directement vers le premier point de passage du projet Mech-Viz à partir de la pose envoyée par le robot. Par conséquent, il peut y avoir un décalage entre les trajectoires du robot réel et du robot simulé. Ce décalage peut potentiellement entraîner des risques de sécurité imprévisibles, en particulier si une collision est détectée sur la trajectoire du robot simulé.

En revanche, si Robot_Pose_Type est défini sur 2, le robot enverra la pose de capture d’image définie par apprentissage à Mech-Viz. Ainsi, le robot réel peut déclencher le cycle suivant de planification de trajectoire dans Mech-Viz lorsque le robot réel est dans la zone de capture d’image et le temps de cycle peut être réduit.

En conclusion, Robot_Pose_Type doit être défini sur 2 pour les projets en mode eye to hand.

robot example

Start_Viz

Ce paramètre déclenche l’exécution du projet Mech-Viz au front montant. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 2103. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Exemple

cmd14

Lorsque Camera_User.Start_Viz est au front montant, cet exemple exécute le projet Mech-Viz correspondant et envoie les positions articulaires actuelles et la pose de bride du robot à Mech-Viz.

Arrêter le projet Mech-Viz

Description

Cette commande arrête le projet Mech-Viz.

Séquence d’appel

Cette commande doit être appelée après Exécuter le projet Mech-Viz.

Modules

cmd15

Paramètres d’entrée

Stop_Viz

Ce paramètre déclenche l’arrêt du projet Mech-Viz au front montant. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 2104. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Exemple

cmd16

Lorsque Camera_User.Stop_Viz est au front montant, cet exemple arrête le projet Mech-Viz.

Définir le port de sortie pour l’Étape Branch by Msg dans Mech-Viz

Description

Cette commande définit le port de sortie pour l’Étape Branch by Msg. Lorsque l’étape suivante est une Étape Branch by Msg, le projet Mech-Viz attendra que cette commande spécifie le port de sortie.

set branch

Séquence d’appel

Cette commande doit être appelée après Exécuter le projet Mech-Viz.

Modules

cmd17

Paramètres d’entrée

Branch_Name

Ce paramètre spécifie l’ID de l’Étape Branch by Msg. Le type de données est Word [signé]. La valeur est un entier positif. L’ID de l’étape est affiché dans le panneau des paramètres de l’Étape. Par exemple, l’ID de l’Étape dans l’image ci-dessus est 1.

Branch_Exit_Port

Ce paramètre spécifie l’ID du port de sortie de l’Étape Branch by Msg. Le type de données est Word [signé]. La valeur est un entier positif. Lorsque la valeur du paramètre est définie sur N, le projet Mech-Viz sort du port avec un ID de N-1 de the Branch by Msg Step.

Set_Branch

Ce paramètre déclenche, au front montant, la définition du port de sortie de l’Étape Branch by Msg dans le projet Mech-Viz. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 2105. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Exemple

cmd18

Lorsque Camera_User.Set_Branch est au front montant, le projet Mech-Viz emprunte le port 0 de l’Étape Branch by Msg n° 1.

Définir l’index actuel dans Mech-Viz

Description

Cette commande définit la valeur du paramètre Current Index des étapes de type Index. Les étapes de type Index sont des étapes qui incluent la section Index, telles que Move by Grid, Move by List, Custom Pallet Pattern et Predefined Pallet Pattern.

set index

Séquence d’appel

Les étapes de type Index sont souvent précédées d’une Étape Branch by Msg. Le PLC doit appeler les commandes dans cet ordre : Exécuter le projet Mech-Viz, Définir l’index actuel dans Mech-Viz et Définir le port de sortie pour l’Étape Branch by Msg dans Mech-Viz. Ceci afin de garantir que Mech-Viz dispose de suffisamment de temps pour définir la valeur Current Index.

Modules

cmd19

Paramètres d’entrée

Index_Name

Ce paramètre spécifie l’ID de l’Étape de type Index. Le type de données est Word [signé]. La valeur est un entier positif. L’ID de l’étape est affiché dans le panneau des paramètres de l’Étape. Par exemple, l’ID de l’Étape dans l’image ci-dessus est 3.

Index_Counter

Ce paramètre spécifie l’index actuel pour une Étape de type Index. Le type de données est Word [signé]. La valeur est un entier positif. Lorsque la valeur de ce paramètre est définie sur N, l’index actuel de l’Étape correspondante est N-1.

Set_Index

Ce paramètre déclenche, au front montant, la définition de la valeur Current Index dans le projet Mech-Viz. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 2106. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Exemple

cmd20

Lorsque Camera_User.Set_Index est au front montant, cet exemple définit la valeur Current Index sur 3 pour l’Étape dont l’ID est 5 dans le projet Mech-Viz.

Obtenir la trajectoire planifiée dans Mech-Viz

Description

Cette commande obtient la trajectoire planifiée par le projet Mech-Viz sous forme d’une série de points de passage.

Point de passage : Chaque point que le robot atteint lors du déplacement le long de la trajectoire planifiée. Un point de passage contient des informations, notamment la pose du robot, l’étiquette, le type de mouvement et la vitesse. Les points de passage peuvent être divisés en deux catégories :

  • Point de passage Vision Move : point de passage correspondant à l’Étape Vision Move.

  • Points de passage non Vision Move, qui désignent les points de passage correspondant aux étapes de type Move autres que l’Étape Vision Move.

Séquence d’appel

Cette commande doit être appelée après Exécuter le projet Mech-Viz.

Modules

cmd21

Paramètres d’entrée

Request_Pose_Type

This parameter specifies the type of waypoint poses to be obtained. Le type de données est Word [signé]. Valid values: 1 and 2.

  • 1: Positions articulaires.

  • 2: TCP.

Get_VizData

Ce paramètre déclenche, au front montant, l’obtention de la trajectoire planifiée par Mech-Viz. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 2100. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Par défaut, après l’envoi de cette commande par le robot, le système de vision renvoie le résultat dans un délai de 10 secondes. Si le système de vision ne renvoie aucun résultat dans un délai de 10 secondes, un code d’erreur de dépassement de délai est renvoyé. Pour modifier au besoin la durée d’expiration par défaut, accédez à Robot et Communication > Robot Communication Configuration  Suivant  Paramètres avancés dans la barre d’outils de Mech-Vision.

set viz time

Status_of_Pose_Sent

Ce paramètre spécifie si tous les points de passage sont obtenus. Le type de données est Word [signé]. La valeur est 0 ou 1.

  • 0 : Tous les points de passage ne sont pas obtenus.

  • 1 : Tous les points de passage sont obtenus.

Number_of_Pose_Sent

Ce paramètre stocke le nombre de points de passage renvoyés par le système de vision. Par défaut, le système de vision envoie au plus 20 points de passage à la fois. Par conséquent, la valeur maximale par défaut de ce paramètre est 20. Pour modifier le nombre maximal par défaut de poses à obtenir à chaque fois au besoin, accédez à Configuration de la communication du robot  Suivant  Paramètres avancés dans la barre d’outils de Mech-Vision. La limite supérieure est 30.

set number

Index_of_Vision_Picking_Point

Le numéro de séquence du point de passage Vision Move (c.-à-d., le point de passage correspondant à l’étape Vision Move dans le projet Mech-Viz) dans le trajet. Le type de données est Word [signé]. Si le point de passage n’existe pas dans le trajet, la valeur petameter est 0.

Si le trajet planifié se compose des points de passage suivants dans cet ordre: Fixed-Point Move_1, Fixed-Point Move_2, Vision Move et Fixed-Point Move_3, le numéro de séquence du point de passage Vision Move est 3.

Target_Pose

Ce paramètre indique les poses de tous les points de passage dans la trajectoire planifiée obtenue. Les poses sont des TCP ou des positions articulaires, selon la valeur de Request_Pose_Type. Le type de données est FLOAT [simple précision](0..39,0..5).

Target_Label

Ce paramètre indique les étiquettes de tous les points de passage dans la trajectoire planifiée obtenue. Les étiquettes et les poses sont appariées un à un. Le type de données est Word [signé](0..39).

Target_Tool_ID

Ce paramètre indique les IDs d’outil de tous les points de passage dans la trajectoire planifiée obtenue. Les IDs d’outil et les poses sont appariés un à un. Le type de données est Word [signé](0..39).

Exemple

cmd22

Lorsque Camera_User.Get_VizData est au front montant, cet exemple obtient la trajectoire planifiée depuis le projet Mech-Viz. Les points de passage sont représentés en TCP.

Saisir les dimensions de l’objet dans le projet Mech-Vision

Description

Cette commande saisit dynamiquement les dimensions de l’objet dans le projet Mech-Vision. Les dimensions de l’objet sont les valeurs des paramètres Paramètres de dimensions de boîte dans l’Étape Read Object Dimensions.

Lorsque vous utilisez cette commande, une seule Étape Read Object Dimensions est autorisée dans le projet Mech-Vision. Sinon, le système de vision renverra une erreur.
read object dimensions

Séquence d’appel

Cette commande doit être appelée avant Exécuter le projet Mech-Vision.

Modules

cmd23

Paramètres d’entrée

Vision_Proj_Num

Ce paramètre spécifie l’identifiant de projet de Mech-Vision. Le type de données est Word [signé]. Vous pouvez consulter l’identifiant de projet d’un projet Mech-Vision dans la section Liste des projets de Mech-Vision. L’identifiant de projet est le nombre qui précède le nom du projet.

External_Input_Box_Dimension

Ce paramètre saisit la longueur, la largeur et la hauteur de l’objet dans le projet Mech-Vision. La longueur, la largeur et la hauteur sont mesurées en millimètres (mm). Ces valeurs sont lues par l’Étape Read Object Dimensions et définies pour les paramètres Longueur sur l’axe X, Longueur sur l’axe Y et Longueur sur l’axe Z. Le type de données est FLOAT [simple précision](0..2).

Set_Box_Dimension

Ce paramètre déclenche, au front montant, la saisie des dimensions de l’objet dans le projet Mech-Vision. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 1108. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Exemple

cmd24

Lorsque Camera_User.Set_Box_Dimension est au front montant, cet exemple définit External_Input_Box_Dimension sur les dimensions de l’objet lues par l’Étape Read Object Dimensions dans le projet Mech-Vision.

Obtenir le message depuis l’Étape Notify

Description

Lorsque le projet Mech-Vision ou le projet Mech-Viz exécute l’Étape Notify, le système de vision renvoie le message prédéfini dans l’Étape Notify.

Lorsque l’Étape Notify est exécutée dans le projet Mech-Vision ou Mech-Viz, le message reste dans le tampon du système de vision pendant seulement trois secondes. Par conséquent, vous devez prendre en compte le minutage de l’appel de cette commande pour garantir la récupération réussie du message. De plus, après réception du message, le PLC doit effacer les données dans le registre.

Avant d’envoyer cette commande, effectuez les réglages suivants pour l’Étape Notify :

  • Pour une Étape Notify dans le projet Mech-Vision :

    1. Connectez l’Étape Notify sur le côté droit d’une autre Étape. L’Étape Output est utilisée dans l’exemple de l’image ci-dessous.

      notify 1
    2. Sélectionnez Trigger Control Flow Given Output dans le panneau des paramètres de l’Étape Output.

      notify 5
    3. Dans le panneau des paramètres de l’Étape Notify, saisissez Standard Interface Notify (la valeur ne peut pas être modifiée) pour Service Name. Entrez un entier positif pour Message, par exemple 1001.

      notify 2
  • Pour une Étape Notify dans le projet Mech-Viz :

    1. Connectez l’Étape Notify à une Étape appropriée dans le flux de travail.

      notify 3
    2. Dans le panneau des paramètres de l’Étape Notify, sélectionnez Standard Interface. Entrez un entier positif pour Message, par exemple 1000.

      notify 4

Séquence d’appel

Cette commande doit être appelée après Exécuter le projet Mech-Vision ou Exécuter le projet Mech-Viz.

Modules

cmd25

Paramètres d’entrée

Get_Notify

Ce paramètre déclenche, au front montant, l’obtention du message de l’Étape Notify. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Notify

Ce paramètre stocke le message de l’Étape Notify. Seuls les messages entiers positifs sont pris en charge pour le moment. Le type de données est Word [signé].

Exemple

Par exemple, le message défini dans l’Étape Notify est 777, et le PLC obtient un message en mode automatique.

cmd26

Dans cet exemple, lorsqueCamera_User.Step_Num est défini sur 3 en mode automatique, la valeur de MM_Camera.Notify n’est pas 777. Après l’activation de MM_Get_Custom_Notify lorsque la variable Camera_User.Get_Notify est au front montant, le programme récupère le message depuis l’Étape Notify. Si la récupération du message a réussi, la valeur de MM_Camera.Notify passe à 777. Si la valeur reste inchangée, le PLC affichera une erreur après 3 secondes.

Obtenir l’état du projet

Description

Cette commande vérifie si le projet Mech-Vision est prêt.

Modules

cmd27

Paramètres d’entrée

Get_Status

Ce paramètre vérifie au front montant si le projet Mech-Vision est prêt. Le type de données est Bit.

Données renvoyées par l’étiquette globale MM_Camera

Status_Code

Ce paramètre stocke le code d’état de cette commande. Le type de données est Word [signé]. Si la commande est exécutée avec succès, le code d’état est 1101. Si l’exécution d’une commande échoue, un code d’erreur spécifique est renvoyé. Pour plus de détails, voir Codes d’état et résolution des problèmes.

Exemple

cmd28

Lorsque Camera_User.Get_VisData est au front montant, cet exemple vérifie si le projet Mech-Vision est prêt.

Cette page est-elle utile ?

Veuillez nous indiquer comment améliorer :

Nous accordons de l’importance à votre vie privée

Nous utilisons des cookies pour vous offrir la meilleure expérience possible sur notre site web. En continuant à utiliser le site, vous reconnaissez accepter l’utilisation des cookies. Si vous refusez, un cookie unique sera utilisé pour garantir que vous ne soyez pas suivi ou reconnu lors de votre visite sur ce site.