Commandes d’interface standard
Cette section décrit les commandes d’interface standard utilisées dans les communications Modbus TCP entre un PLC Siemens 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.
|
Ordre d’appel
-
Vous devez définir les paramètres Step avant de démarrer un projet Mech-Vision. Par conséquent, appelez Basculer la recette de paramètres de Mech-Vision ou Entrer 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 la(les) cible(s) de vision ou Obtenir la trajectoire planifiée dans Mech-Vision.
Modules
Paramètres d’entrée
Vision_Proj_Num
Ce paramètre spécifie l’identifiant de projet de Mech-Vision. The data type is INT. 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 indique le nombre de points de vision ou de points de passage que l’on s’attend à recevoir du projet Mech-Vision. The data type is INT. Valeurs valides : de 0 au plus grand entier positif.
| Si le projet Mech-Vision comporte une étape de planification de trajectoire (Path Planning Step), ce paramètre indique le nombre attendu de points de passage. Sinon, il indique le nombre attendu de points de vision. |
-
0 : Obtenir tous les points de vision ou 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 émis 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 points de passage.
-
Si le nombre total de points de vision ou de points de passage émis 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 spécifié par ce paramètre.
-
|
Robot_Pose_Type
Ce paramètre spécifie le type de pose du robot réel à envoyer au projet Mech-Vision. The data type is INT. Valeurs valides : 0, 1, 2 et 3. Le tableau suivant décrit les détails.
Robot_Pose
Ce paramètre spécifie la pose du robot. The data type is Array[0..1, 0..5] of Real. La structure de données de ce paramètre est un Array bidimensionnel, où 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 au projet Mech-Viz. Le robot simulé dans le projet Mech-Viz se déplacera depuis la position d’origine définie jusqu’au premier point de passage. |
Ce réglage est recommandé lorsque la caméra est montée en mode œil-vers-main. |
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 en entrée jusqu’au premier point de passage. |
Ce réglage est recommandé lorsque la caméra est montée en mode œil-dans-la-main. |
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é (positions articulaires personnalisées, au lieu des positions actuelles) au projet Mech-Viz. Le projet Mech-Viz utilise les positions articulaires en entrée pour planifier à l’avance la trajectoire suivante tant que le robot se trouve hors de la zone de capture de la caméra, comme illustré dans la figure suivante. Le robot simulé dans Mech-Viz se déplace des positions articulaires en entrée jusqu’au premier point de passage. |
Ce réglage est recommandé lorsque la caméra est montée en mode œil-vers-main. |
Start_Vision
Ce paramètre déclenche le démarrage du projet Mech-Vision lors d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Start_Vision au cycle de scrutation précédent. The data type is Bool. 1 indique que Start_Vision était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Start_Vision était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 1102 est renvoyé en cas d’exécution réussie de la commande. 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 sur un front montant, l’API (PLC) déclenche l’exécution du projet Mech-Vision n° 1 et attend que le projet Mech-Vision n° 1 envoie un point de vision ou un point de passage. En même temps, l’API envoie les positions articulaires actuelles et la pose de bride du robot à Mech-Vision.
Obtenir la(les) cible(s) de vision
Description
Cette commande obtient le résultat de vision, à savoir une série de points de vision, depuis Mech-Vision. La pose de l’objet du point de vision (à savoir 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 de l’objet, l’étape Output convertira les points centraux de l’objet en points de prise correspondants. Par conséquent, les poses d’objet obtenues en exécutant cette commande sont en réalité des poses de points de prise, et non des poses de points centraux de l’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.
Ordre 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. The data type is INT. 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 sur front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Get_VisData au cycle de scrutation précédent. The data type is Bool. 1 indique que Get_VisData était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Get_VisData était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 1100 est renvoyé en cas d’exécution réussie de la commande. 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 indique si tous les points de vision sont obtenus. The data type is INT. 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. The data type is INT.
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. The data type is Array[0..239] of Real.
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 une à une. The data type is Array[0..39] of Int.
Basculer la recette de paramètres de Mech-Vision
Description
Cette commande déclenche le basculement par Mech-Vision de 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, voir le guide recette de paramètres.
Ordre 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. The data type is INT. 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 indique l’ID de la recette de paramètres dans le projet Mech-Vision. The data type is INT. Pour plus de détails sur la façon de consulter l’ID de la recette de paramètres, voir 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 d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Switch_Recipe au cycle de scrutation précédent. The data type is Bool. 1 indique que Switch_Recipe était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Switch_Recipe était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 1107 est renvoyé en cas d’exécution réussie de la commande. 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 indiqué dans l’image ci-dessous. Pour plus de détails sur la planification de trajectoire (Path Planning), voir Planification de trajectoire.
| Définissez le paramètre Type de port de l’étape Output dans Mech-Vision sur Prédéfini (trajet robot). |
Ordre 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. The data type is INT. 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. The data type is INT. Valid values: 1 and 2.
-
1: Positions articulaires.
-
2: TCP.
| Les champs Request_Pose_Type et Robot_Pose_Type dans les modules MM_Start_Vis et MM_Start_Viz correspondent à la même variable Pose Type dans le bloc de données MM Modbus TCP Interface. Si vous définissez Request_Pose_Type et Robot_Pose_Type sur des valeurs différentes, les deux valeurs ne peuvent pas prendre effet en même temps. |
Get_VisData
Ce paramètre déclenche l’obtention de la trajectoire planifiée par Mech-Vision lors d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Get_VisData au cycle de scrutation précédent. The data type is Bool. 1 indique que Get_VisData était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Get_VisData était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 1103 est renvoyé en cas d’exécution réussie de la commande. 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 indique si tous les points de passage sont obtenus. The data type is INT. 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. The data type is INT. 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.
| Avant d’appeler Obtenir la trajectoire planifiée dans Mech-Vision, réglez Req_Pose_Num de Exécuter le projet Mech-Vision sur 0 pour 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. The data type is INT. 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. The data type is Array[0..239] of Real.
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 une à une. The data type is Array[0..39] of Int.
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 une à une. The data type is Array[0..39] of Int.
Obtenir la liste DO du préhenseur
Description
Cette commande obtient la liste des signaux de commande pour le préhenseur à vide multiséctions 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 de planification de trajectoire, cliquez sur Assistant de configuration. Dans Configuration globale, activez Dépalettisation de cartons.
-
Dans l’étape de planification de trajectoire, cliquez sur Assistant de configuration, puis double-cliquez sur le nom de l’outil robot. Dans la fenêtre contextuelle, sélectionnez Préhenseur à vide de dépalettisation pour Type d’outil, cliquez sur Configurer le préhenseur à vide de dépalettisation, puis configurez les signaux DO en fonction des besoins.
-
-
Configurer le projet Mech-Viz
-
Dans l’étape Vision Move de Mech-Viz, réglez Sélectionner la méthode de prise sur Dépalettisation de cartons.
-
Dans Mech-Viz, double-cliquez sur le nom de l’outil, sélectionnez Préhenseur à vide de dépalettisation pour Type d’outil, cliquez sur Configurer le préhenseur à vide de dépalettisation, puis configurez les signaux DO en fonction des besoins.
-
Ordre 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 l’API 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 de signaux DO. The data type is INT. Valeurs valides : de 0 au plus grand entier positif.
-
0 : Obtenir la liste de signaux DO depuis Mech-Viz.
-
Un entier positif : Obtenir la liste de 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. The data type is INT.
Get_DoList
Ce paramètre déclenche l’obtention des signaux DO du préhenseur lors d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Get_DoList au cycle de scrutation précédent. The data type is Bool. 1 indique que Get_DoList était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Get_DoList était à l’état bas au cycle de scrutation précédent.
Output Parameters
Vision_Proj_Num_O
Ce paramètre indique la source de la liste de signaux DO. The data type is INT.
Depalletize_Tool_Section_Count_O
Ce paramètre indique le nombre de sections du préhenseur à vide. The data type is INT.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Si la liste de signaux DO est obtenue avec succès depuis Mech-Viz, le code d’état est 2102. Si la liste de 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. The data type is Array[0..63] of Int.
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 du préhenseur planifiés pour ce tour. 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 mettra 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 tours de planification à partir du même résultat de vision. Les 64 signaux DO du préhenseur renvoyés par cette commande sont obtenus pendant tous les tours 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 tour de planification.
Par exemple, si le nombre de sections du préhenseur à vide est 4 et que la commande renvoie 64 signaux DO au total, chaque groupe de 4 signaux DO correspond à des signaux du préhenseur multiséctions obtenus lors de chaque tour de planification.
Premier tour de planification
Deuxième tour de planification
…
16e tour 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 du préhenseur planifiés pendant ce tour. 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 mettra 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 dans une boucle, Mech-Viz peut effectuer plusieurs tours de planification à partir du même résultat de vision. Les 64 signaux DO du préhenseur renvoyés par cette commande sont obtenus pendant tous les tours 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 tour de planification.
Par exemple, si le nombre de sections du préhenseur à vide est 4 et que la commande renvoie 64 signaux DO au total, chaque groupe de 4 signaux DO correspond à des signaux du préhenseur multiséctions obtenus lors de chaque tour de planification.
Premier tour de planification
Deuxième tour de planification
…
16e tour 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
-
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 se basant sur le résultat de vision émis par Mech-Vision.
| Cliquez avec le bouton droit sur le nom du projet dans le panneau des ressources de projet dans Mech-Viz et sélectionnez Chargement automatique du projet. |
Modules
Paramètres d’entrée
Robot_Pose_Type
Ce paramètre spécifie la manière dont la pose du robot réel est envoyée au projet Mech-Viz. Valeurs valides : 0, 1 et 2. Le tableau suivant décrit les détails. The data type is INT.
Robot_Pose
Ce paramètre spécifie la pose du robot. The data type is Array[0..1, 0..5] of Real. La structure de données de ce paramètre est un Array bidimensionnel, où 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 au projet Mech-Viz. Le robot simulé dans le projet Mech-Viz se déplacera depuis la position d’origine définie jusqu’au premier point de passage. |
Ce réglage est recommandé lorsque la caméra est montée en mode œil-vers-main. |
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 en entrée jusqu’au premier point de passage. |
Ce réglage est recommandé lorsque la caméra est montée en mode œil-dans-la-main. |
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é (positions articulaires personnalisées, au lieu des positions actuelles) au projet Mech-Viz. Le projet Mech-Viz utilise les positions articulaires en entrée pour planifier à l’avance la trajectoire suivante tant que le robot se trouve hors de la zone de capture de la caméra, comme illustré dans la figure suivante. Le robot simulé dans Mech-Viz se déplace des positions articulaires en entrée jusqu’au premier point de passage. |
Ce réglage est recommandé lorsque la caméra est montée en mode œil-vers-main. |
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’image pour le tour de planification suivant avant que le robot ne revienne dans la zone de capture d’image et la zone de prise, ce qui réduit le temps de cycle. L’image ci-dessous montre comment un robot fonctionne 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évus, surtout 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 à Mech-Viz la pose de capture d’image configurée par apprentissage. Ainsi, le robot réel peut déclencher le tour de planification suivant dans Mech-Viz lorsque le robot réel se trouve dans la zone de capture d’image, et le temps de cycle peut être raccourci.
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 lors d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Start_Viz au cycle de scrutation précédent. The data type is Bool. 1 indique que Start_Viz était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Start_Viz était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 2103 est renvoyé en cas d’exécution réussie de la commande. 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
Ordre 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 lors d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Stop_Viz au cycle de scrutation précédent. The data type is Bool. 1 indique que Stop_Viz était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Stop_Viz était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 2104 est renvoyé en cas d’exécution réussie de la commande. 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.
Ordre 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’étape « Branch by Msg » par son ID. The data type is INT. Valeurs valides : entiers positifs. L’ID de l’étape s’affiche 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 indique le port de sortie de l’étape Branch by Msg. The data type is INT. Valeurs valides : entiers positifs. Lorsque la valeur du paramètre est définie sur N, le projet Mech-Viz sort du port d’ID N-1 de l' Branch by Msg Step.
Set_Branch
Ce paramètre déclenche, sur front montant, la définition du port de sortie de l’étape Branch by Msg dans le projet Mech-Viz. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Set_Branch au cycle de scrutation précédent. The data type is Bool. 1 indique que Set_Branch était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Set_Branch était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 2105 est renvoyé en cas d’exécution réussie de la commande. 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 courant 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, notamment Move by Grid, Move by List, Custom Pallet Pattern et Predefined Pallet Pattern.
Ordre d’appel
Les étapes de type index sont souvent précédées d’une étape Branch by Msg. L’API doit appeler les commandes dans cet ordre : Exécuter le projet Mech-Viz, Définir l’index courant 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 de Current Index.
Modules
Paramètres d’entrée
Index_Name
Ce paramètre spécifie l’ID de l’étape de type index. The data type is INT. Valeurs valides : entiers positifs. L’ID de l’étape s’affiche 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 définit la valeur du paramètre Current Index des étapes de type index. The data type is INT. Valeurs valides : entiers positifs. Lorsque la valeur de ce paramètre est réglée sur N, l’index courant de l’étape correspondante est N-1.
Set_Index
Ce paramètre déclenche, sur front montant, la définition de la valeur de Current Index dans le projet Mech-Viz. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Set_Index au cycle de scrutation précédent. The data type is Bool. 1 indique que Set_Index était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Set_Index était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 2106 est renvoyé en cas d’exécution réussie de la commande. 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 lorsqu’il se déplace le long de la trajectoire planifiée. Un point de passage contient des informations incluant 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 :
|
Ordre 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. The data type is INT. Valid values: 1 and 2.
-
1: Positions articulaires.
-
2: TCP.
| Les champs Request_Pose_Type et Robot_Pose_Type dans les modules MM_Start_Vis et MM_Start_Viz correspondent à la même variable Pose Type dans le bloc de données MM Modbus TCP Interface. Si vous définissez Request_Pose_Type et Robot_Pose_Type sur des valeurs différentes, les deux valeurs ne peuvent pas prendre effet en même temps. |
Get_VizData
Ce paramètre déclenche l’obtention de la trajectoire planifiée par Mech-Viz lors d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Get_VizData au cycle de scrutation précédent. The data type is Bool. 1 indique que Get_VizData était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Get_VizData était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 2100 est renvoyé en cas d’exécution réussie de la commande. 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 indique si tous les points de passage sont obtenus. The data type is INT. 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. The data type is INT. 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. The data type is Array[0..239] of Real.
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 une à une. The data type is Array[0..39] of Int.
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 une à une. The data type is Array[0..39] of Int.
Entrer 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 taille de boîte dans l’étape Read Object Dimensions, comme illustré dans la figure suivante.
| 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. |
Ordre 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. The data type is INT. 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 entre 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. The data type is Array[0..2] of Real.
Set_Box_Dimension
Ce paramètre déclenche, sur front montant, l’entrée des dimensions de l’objet dans le projet Mech-Vision. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Set_Box_Dimension au cycle de scrutation précédent. The data type is Bool. 1 indique que Set_Box_Dimension était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Set_Box_Dimension était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 1108 est renvoyé en cas d’exécution réussie de la commande. 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 de l’étape Notify
Description
Lorsque le projet Mech-Vision ou 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 moment de l’appel de cette commande pour garantir la récupération réussie du message. De plus, après avoir reçu le message, l’API (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 au côté droit d’une autre étape. L’étape Output est utilisée dans l’exemple de l’image ci-dessous.
-
Sélectionnez Déclencher le flux de contrôle compte tenu de la sortie 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 Nom du service. 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.
-
Ordre d’appel
Cette commande doit être appelée juste après Exécuter le projet Mech-Vision ou Exécuter le projet Mech-Viz.
Modules
Paramètres d’entrée
Get_Notify
Ce paramètre déclenche l’obtention du message de l’étape Notify lors d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Get_Notify au cycle de scrutation précédent. The data type is Bool. 1 indique que Get_Notify était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Get_Notify était à l’état bas au cycle de scrutation précédent.
Exemple
Par exemple, le message défini dans l’étape « Notify » est 777, et l’API (PLC) obtient un message en mode automatique.
Dans cet exemple, lorsque “Camera_User”.Step_Num est réglé sur 3 en mode automatique, la valeur de “MM Modbus TCP Interface”.Notify n’est pas 777. Après l’activation de la commande “MM_Get_Custom_Notify”, lorsque la variable “Camera_User”.Get_Notify est sur un front montant, le programme récupère le message depuis l’étape “Notify”. Si la récupération du message réussit, la valeur de “MM Modbus TCP Interface”.Notify passe à 777. Sinon, si la valeur reste inchangée, l’automate (PLC) signalera une erreur après 3 secondes.
Obtenir l’état du projet
Modules
Paramètres d’entrée
Get_Status
Ce paramètre vérifie si le projet Mech-Vision est prêt lors d’un front montant. The data type is Bool.
Set_Edge
Ce paramètre représente l’état de Get_Status au cycle de scrutation précédent. The data type is Bool. 1 indique que Get_Status était à l’état haut au cycle de scrutation précédent, tandis que 0 indique que Get_Status était à l’état bas au cycle de scrutation précédent.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable destinée à stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 1101 est renvoyé en cas d’exécution réussie de la commande. 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.
Effacer les données cibles
Modules
Paramètres d’entrée
Start_Empty
Ce paramètre déclenche l’effacement des poses, des étiquettes et des ID d’outil obtenus. Ce paramètre prend effet lorsqu’il est activé. The data type is Bool.
Target_Pose
Ce paramètre indique les poses des points de passage ou points de vision obtenus. The data type is Array[0..239] of Real.
Target_Label
Ce paramètre indique les étiquettes des points de passage ou points de vision obtenus. The data type is Array[0..39] of Int.
Target_Tool_ID
Ce paramètre indique les ID d’outil des points de passage ou points de vision obtenus. The data type is Array[0..39] of Int.
Returned Data in the MM Modbus TCP Interface DB
Status Code
Ce paramètre indique le nom de la variable utilisée pour stocker le code d’état d’exécution de la commande. The data type is INT. Le code d’état 3103 est renvoyé en cas d’exécution réussie de la commande. 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.
