Commandes d’interface standard
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.
Aperçu des commandes
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.
|
Séquence d’appel
-
Vous devez définir les paramètres des étapes avant de démarrer un projet Mech-Vision. Par conséquent, appelez Basculer la recette de paramètres Mech-Vision ou Saisir les dimensions de l’objet dans le projet Mech-Vision avant d’appeler Exécuter le projet Mech-Vision.
-
Le système de vision n’obtient des points de vision et des points de passage qu’après l’exécution d’un projet Mech-Vision. Par conséquent, appelez Exécuter le projet Mech-Vision avant d’appeler Obtenir le résultat de vision, Obtenir la trajectoire planifiée dans Mech-Vision ou Obtenir les données personnalisées Mech-Vision.
Modules
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
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. |
-
Convertir la pose de l’objet d’une représentation en quaternion en angles d’Euler.
-
Faire pivoter la pose de l’objet autour de l’axe X de 180° pour orienter son axe Z vers le bas.
Séquence d’appel
Cette commande doit être appelée après Exécuter le projet Mech-Vision.
Modules
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 > dans la barre d’outils de Mech-Vision.
|
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).
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.
Séquence d’appel
Cette commande doit être appelée avant Exécuter le projet Mech-Vision.
Modules
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.
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). |
Séquence d’appel
Cette commande doit être appelée après Exécuter le projet Mech-Vision.
Modules
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 > dans la barre d’outils de Mech-Vision.
|
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 à dans la barre d’outils de Mech-Vision. La limite supérieure est 30.
| 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).
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.
-
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.
-
-
Configurer le projet Mech-Viz
-
Dans l’Étape Vision Move de Mech-Viz, définissez Select Picking Method sur Box depalletizing.
-
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.
-
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
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é.
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.
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é.
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.
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
-
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.
|
| 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
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).
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
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.
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.
Arrêter le projet Mech-Viz
Séquence d’appel
Cette commande doit être appelée après Exécuter le projet Mech-Viz.
Modules
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.
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.
Séquence d’appel
Cette commande doit être appelée après Exécuter le projet Mech-Viz.
Modules
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.
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.
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
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.
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 :
|
Séquence d’appel
Cette commande doit être appelée après Exécuter le projet Mech-Viz.
Modules
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 > dans la barre d’outils de Mech-Vision.
|
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 à dans la barre d’outils de Mech-Vision. La limite supérieure est 30.
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).
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. |
Séquence d’appel
Cette commande doit être appelée avant Exécuter le projet Mech-Vision.
Modules
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.
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 :
-
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.
-
Sélectionnez Trigger Control Flow Given Output dans le panneau des paramètres de l’Étape Output.
-
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.
-
-
Pour une Étape Notify dans le projet Mech-Viz :
-
Connectez l’Étape Notify à une Étape appropriée dans le flux de travail.
-
Dans le panneau des paramètres de l’Étape Notify, sélectionnez Standard Interface. Entrez un entier positif pour Message, par exemple 1000.
-
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
Exemple
Par exemple, le message défini dans l’Étape Notify est 777, et le PLC obtient un message en mode automatique.
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
Modules
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.