Programme d’exemple 14: MM_S14_Vis_GetUserData

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.

Présentation du programme

Description

Lorsque le robot obtient le résultat de vision, il obtient également les données de sortie personnalisées du projet Mech-Vision.

Chemin du fichier

Vous pouvez accéder au répertoire d’installation de Mech-Vision et Mech-Viz et trouver le fichier en utilisant le chemin Communication Component/Robot_Interface/KUKA/sample/MM_S14_Vis_GetUserData.

Projet

projet Mech-Vision (un ou plusieurs ports personnalisés doivent être ajoutés à l’étape Sortie)

Prérequis

Ce programme d’exemple est fourni à titre de référence uniquement. Avant d’utiliser le programme, veuillez le modifier en fonction du scénario réel.

Description du programme

Cette partie décrit le programme d’exemple MM_S14_Vis_GetUserData.

Comparé au programme d’exemple MM_S1_Vis_Basic, ce programme ne contient que la modification suivante (le code de cette modification est en gras). Par conséquent, seule la modification est décrite dans la partie suivante. Pour des informations sur les parties de MM_S14_Vis_GetUserData qui sont identiques à celles de MM_S1_Vis_Basic, voir Programme d’exemple 1: MM_S1_Vis_Basic.
DEF MM_S14_Vis_GetUserData ( )
;---------------------------------------------------
; FUNCTION: trigger Mech-Vision project and get
; vision result and custom data using command 110
; Mech-Mind, 2023-12-25
;---------------------------------------------------
   ;set current tool no. to 1
   BAS(#TOOL,1)
   ;set current base no. to 0
   BAS(#BASE,0)
   ;move to robot home position
PTP HOME Vel=100 % DEFAULT
   ;initialize communication parameters (initialization is required only once)
   MM_Init_Socket("XML_Kuka_MMIND",873,871,60)
   ;move to image-capturing position
LIN camera_capture Vel=1 m/s CPDAT1 Tool[1] Base[0]
   ;trigger NO.1 Mech-Vision project
   MM_Start_Vis(1,0,2,init_jps)
   ;get vision result from NO.1 Mech-Vision project
   MM_Get_Dy_Data(1,pos_num,status)
   ;check whether vision result has been got from Mech-Vision successfully
   IF status<> 1100 THEN
      ;add error handling logic here according to different error codes
      ;e.g.: status=1003 means no point cloud in ROI
      ;e.g.: status=1002 means no vision result
      halt
   ENDIF
   ;save first vision point data to local variables
   MM_Get_DyPose(1,Xpick_point,label)
   ;save received custom data
   offset_x=MM_UserData[1]
   offset_y=MM_UserData[2]
   offset_z=MM_UserData[3]
   ;calculate pick approach point based on pick point
   tool_offset={X 0,Y 0,Z -100,A 0,B 0,C 0}
   Xpick_app=Xpick_point:tool_offset
   ;move to intermediate waypoint of picking
PTP pick_waypoint CONT Vel=50 % PDAT1 Tool[1] Base[0]
   ;move to approach waypoint of picking
LIN pick_app Vel=1 m/s CPDAT2 Tool[1] Base[0]
   ;move to picking waypoint
LIN pick_point Vel=0.3 m/s CPDAT3 Tool[1] Base[0]
   ;add object grasping logic here, such as "$OUT[1]=TRUE"
   halt
   ;move to departure waypoint of picking
LIN pick_app Vel=1 m/s CPDAT2 Tool[1] Base[0]
   ;move to intermediate waypoint of placing
PTP drop_waypoint CONT Vel=100 % PDAT2 Tool[1] Base[0]
   ;move to approach waypoint of placing
LIN drop_app Vel=1 m/s CPDAT4 Tool[1] Base[0]
   ;move to placing waypoint
LIN drop Vel=0.3 m/s CPDAT5 Tool[1] Base[0]
   ;add object releasing logic here, such as "$OUT[1]=FALSE"
   halt
   ;move to departure waypoint of placing
LIN drop_app Vel=1 m/s CPDAT4 Tool[1] Base[0]
   ;move back to robot home position
PTP HOME Vel=100 % DEFAULT
END

Le flux de travail correspondant au code du programme d’exemple ci-dessus est illustré dans la figure ci-dessous.

sample14

Le tableau ci-dessous décrit le code en gras. Vous pouvez cliquer sur l’hyperlien du nom de commande pour afficher sa description détaillée.

Fonctionnalité Code et description

Obtenir le résultat de vision (y compris les données personnalisées)

;get vision result from NO.1 Mech-Vision project
MM_Get_Dy_Data(1,pos_num,status)
Pour un projet Mech-Vision, les données personnalisées correspondent aux données sorties par les ports personnalisés du projet Mech-Vision.
  • MM_Get_Dy_Data: La commande permettant d’obtenir le résultat de vision. Les points de vision obtenus par cette commande contiennent des données personnalisées en plus des poses et des étiquettes, tandis que les points de vision obtenus par la commande MM_Get_Dy_Data ne contiennent pas de données personnalisées.

  • 1: L’ID du projet Mech-Vision.

  • pose_num: La variable qui stocke le nombre de points de vision renvoyés par le système de vision.

  • status: La variable qui stocke le code d’état d’exécution de la commande.

L’ensemble de l’instruction indique que le robot obtient le résultat de vision du projet Mech-Vision avec un ID de 1. Le résultat de vision inclut des données personnalisées.

Le résultat de vision renvoyé est enregistré dans la mémoire du robot et ne peut pas être obtenu directement. Pour accéder aux données personnalisées du résultat de vision, vous devez enregistrer le résultat de vision à l’étape suivante.

Stocker le résultat de vision (y compris les données personnalisées)

;save first vision point data to local variables
MM_Get_DyPose(1,Xpick_point,label)
  • MM_Get_DyPose: La commande permettant de stocker le résultat de vision. Cette commande stocke des données personnalisées en plus des poses et des étiquettes. Cependant, MM_Get_Pos ne peut stocker que les poses, les étiquettes et les ID d’outil et ne peut pas stocker de données personnalisées. De plus, MM_Get_DyPose enregistre les données personnalisées des points de vision qui ont été stockées dans la mémoire du robot dans le tableau global MM_UserData.

  • 1: Le premier point de vision est stocké.

  • Xpick_point: La variable qui stocke le TCP du premier point de vision, c’est-à-dire le TCP du point de passage de prise.

  • label: La variable qui stocke l’étiquette correspondant au premier point de vision.

L’ensemble de l’instruction enregistre le TCP, l’étiquette et les données personnalisées du premier point de vision dans les variables spécifiées.

;save received custom data
offset_x=MM_UserData[1]
offset_y=MM_UserData[2]
offset_z=MM_UserData[3]

Le code ci-dessus affecte les données personnalisées MM_UserData[1], MM_UserData[2] et MM_UserData[3], qui représentent trois points de vision (points de passage de prise), respectivement à offset_x, offset_y et offset_z.

Vous pouvez définir les significations de offset_x, offset_y et offset_z. Par exemple, ils peuvent représenter le décalage du robot sur chaque axe du repère XYZ lorsqu’il se déplace vers le point de passage de prise.

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.