样例程序14:MM_S14_Vis_GetUserData

程序简介

功能说明

机器人在获取视觉结果时,同时获取Mech-Vision工程输出的自定义数据。

文件路径

Mech-Vision和Mech-Viz软件安装目录下Communication Component/Robot_Interface/YASKAWA/sample/MM_S14_Vis_GetUserData

所需工程

Mech-Vision工程(输出步骤需添加自定义端口

使用前提

  1. 已完成标准接口通信配置

  2. 已完成自动标定

此样例程序仅是示例程序。用户需根据实际情况在此基础上进行修改,请勿直接使用该程序。

程序解读

以下为MM_S14_Vis_GetUserData样例程序的代码及相关解释说明。

与MM_S1_Vis_Basic样例相比,本样例仅修改了如下加粗部分的代码。因此,下文不再重复解释与MM_S1_Vis_Basic样例相同部分的代码(详情请参考MM_S1_Vis_Basic样例说明)。
NOP
'--------------------------------
'FUNCTION: trigger Mech-Vision
'project and get vision result
'and custom data using
'command 110
'Mech-Mind, 2023-12-25
'--------------------------------
'clear I50 to I69
CLEAR I050 20
'initialize p variables
SUB P070 P070
SUB P071 P071
'set 100mm to z of P070
SETE P070 (3) 100000
'move to robot home position
MOVJ C00000 VJ=50.00
'initialize communication
'parameters (initialization is
'required only once)
CALL JOB:MM_INIT_SOCKET ARGF"192.168.170.22;50000;1"
'move to image-capturing position
MOVJ C00001 VJ=50.00 PL=0
'open socket connection
CALL JOB:MM_OPEN_SOCKET
'trigger NO.1 Mech-Vision project
CALL JOB:MM_START_VIS ARGF"1;0;2;30"
'get vision result from NO.1
'Mech-Vision project
CALL JOB:MM_GET_DYDATA ARGF"1;51;52"
'check whether vision result has
'been got from Mech-Vision
'successfully
IFTHENEXP I052<>1100
	'add error handling logic here
	'according to different error
	'codes
	'e.g.: I052=1003 means no point
	'cloud in ROI
	'e.g.: I052=1002 means no
	'vision result
	 PAUSE
ENDIF
'close socket connection
CALL JOB:MM_CLOSE_SOCKET
'save first vision point data to
'local variables
CALL JOB:MM_GET_DYPOSE ARGF"1;71;61;61"
'received custom data is saved
'from R061
'R061 = offset_x;
'R062 = offset_y;
'R063 = offset_z;
'move to intermediate waypoint of
'picking
MOVJ C00002 VJ=50.00
'move to approach waypoint of
'picking
SFTON P070
MOVL P071 V=166.6 PL=0
SFTOF
'move to picking waypoint
MOVL P071 V=50.0 PL=0
'add object grasping logic here,
'such as DOUT OT#(1) ON
PAUSE
'move to departure waypoint of
'picking
SFTON P070
MOVL P071 V=166.6 PL=0
SFTOF
'move to intermediate waypoint of
'placing
MOVJ C00003 VJ=50.00
'move to approach waypoint of
'placing
MOVL C00004 V=166.6 PL=0
'move to placing waypoint
MOVL C00005 V=50.0 PL=0
'add object releasing logic here,
'such as DOUT OT#(1) OFF
PAUSE
'move to departure waypoint of
'placing
MOVL C00006 V=166.6 PL=0
'move back to robot home position
MOVJ C00007 VJ=50.00
END

上述样例程序代码对应的流程如下图所示。

sample14

下表是对加粗代码的逻辑解读。用户单击指令名称的超链接便可查看该指令的详细说明。

流程 代码及说明

获取视觉结果(包含自定义数据)

'get vision result from NO.1
'Mech-Vision project
CALL JOB:MM_GET_DYDATA ARGF"1;51;52"
对于Mech-Vision工程而言,自定义数据是指Mech-Vision自定义端口输出的数据。
  • MM_GET_DYDATA:获取视觉结果的指令。通过该指令获取的视觉点,除了包含位姿和标签外,还将包含自定义数据,而通过MM_GET_VISDATA指令获取的视觉点将不包含自定义数据。

  • 1:Mech-Vision工程编号。

  • 51:编号为51的I变量,该变量保存视觉系统返回的视觉点个数。

  • 52:编号为52的I变量,该变量保存指令执行的状态码。

因此,整条指令表示机器人获取Mech-Vision工程1返回的视觉结果(其中包含自定义数据)。

由于返回的视觉结果保存在机器人内存中,此时用户无法直接获取到视觉结果的自定义数据,必须通过后续“转存视觉结果”才可访问。

转存视觉结果(包含自定义数据)

'save first vision point data to
'local variables
CALL JOB:MM_GET_DYPOSE ARGF"1;71;61;61"
  • MM_GET_DYPOSE:转存视觉结果的指令。该指令除了转存位姿和标签外,还转存自定义数据,而MM_GET_POSE指令只能转存位姿、标签和末端工具编号,无法转存自定义数据。另外,MM_GET_DYPOSE指令会将视觉点的自定义数据从机器人内存中转存至指定变量。

  • 1:将转存第一个视觉点。

  • 71:编号为71的P变量,该变量将保存第一个视觉点的工具位姿,即抓取点的工具位姿。

  • 第一个61:编号为61的I变量,该变量将保存第一个视觉点对应的标签。

  • 第二个61:编号从61开始的R变量,第一个视觉点对应的自定义数据将从R061开始依次进行保存。

因此,整条指令表示将第一个视觉点的工具位姿、标签和自定义数据分别转存至指定变量。

'received custom data is saved
'from R061
'R061 = offset_x;
'R062 = offset_y;
'R063 = offset_z;

上述注释部分仅是伪代码,用户通过变量R061、R062、R063便可获取到某个视觉点的三个自定义数据。

自定义数据的含义可由用户自己定义,例如,上述三个自定义数据可以表示机器人在移动到抓取点时在XYZ各轴的偏置。

我们重视您的隐私

我们使用 cookie 为您在我们的网站上提供最佳体验。继续使用该网站即表示您同意使用 cookie。如果您拒绝,将使用一个单独的 cookie 来确保您在访问本网站时不会被跟踪或记住。