样例程序2：MM_S2_Viz_Basic
程序解读
以下为MM_S2_Viz_Basic样例程序的代码及相关解释说明。
1: !-------------------------------- ;
2: !FUNCTION: trigger Mech-Viz ;
3: !project and get planned path ;
4: !Mech-Mind, 2023-12-25 ;
5: !-------------------------------- ;
6: ;
7: !set current uframe NO. to 0 ;
8: UFRAME_NUM=0 ;
9: !set current tool NO. to 1 ;
10: UTOOL_NUM=1 ;
11: !move to robot home position ;
12:J P[1] 100% FINE ;
13: !initialize communication ;
14: !parameters(initialization is ;
15: !required only once) ;
16: CALL MM_INIT_SKT('8','127.0.0.1',50000,5) ;
17: !move to image-capturing position ;
18:L P[2] 1000mm/sec FINE ;
19: !trigger Mech-Viz project ;
20: CALL MM_START_VIZ(2,10) ;
21: !get planned path, 1st argument ;
22: !(1) means getting pose in JPs ;
23: CALL MM_GET_VIZ(1,51,52,53) ;
24: !check whether planned path has ;
25: !been got from Mech-Viz ;
26: !successfully ;
27: IF R[53]<>2100,JMP LBL[99] ;
28: !save waypoints of the planned ;
29: !path to local variables one ;
30: !by one ;
31: CALL MM_GET_JPS(1,60,70,80) ;
32: CALL MM_GET_JPS(2,61,71,81) ;
33: CALL MM_GET_JPS(3,62,72,82) ;
34: !follow the planned path to pick ;
35: !move to approach waypoint ;
36: !of picking ;
37:J PR[60] 50% FINE ;
38: !move to picking waypoint ;
39:J PR[61] 10% FINE ;
40: !add object grasping logic here, ;
41: !such as "DO[1]=ON" ;
42: PAUSE ;
43: !move to departure waypoint ;
44: !of picking ;
45:J PR[62] 50% FINE ;
46: !move to intermediate waypoint ;
47: !of placing ;
48:J P[3] 50% CNT100 ;
49: !move to approach waypoint ;
50: !of placing ;
51:L P[4] 1000mm/sec FINE Tool_Offset,PR[2] ;
52: !move to placing waypoint ;
53:L P[4] 300mm/sec FINE ;
54: !add object releasing logic here, ;
55: !such as "DO[1]=OFF" ;
56: PAUSE ;
57: !move to departure waypoint ;
58: !of placing ;
59:L P[4] 1000mm/sec FINE Tool_Offset,PR[2] ;
60: !move back to robot home position ;
61:J P[1] 100% FINE ;
62: END ;
63: ;
64: LBL[99:vision error] ;
65: !add error handling logic here ;
66: !according to different ;
67: !error codes ;
68: !e.g.: status=2038 means no ;
69: !point cloud in ROI ;
70: PAUSE ;上述样例程序代码对应的流程如下图所示。
下表为上述程序的逻辑解读。用户单击指令名称的超链接便可查看该指令的详细说明。
| 流程 | 代码及说明 | ||
|---|---|---|---|
设置坐标系 |
因此，上述两条指令表示，设置当前所选的用户坐标系和工具坐标系。 |
||
移动到Home点 |
因此，整条指令表示机器人以关节角移动方式移动至示教的Home点。
|
||
初始化通信参数 |
因此，整条指令表示，机器人通过MM_INIT_SKT指令指定通信对象（工控机）的IP地址、端口号以及超时等待时间，从而与视觉系统建立连接。
|
||
移动到拍照点 |
因此，整条指令表示机器人以直线移动方式移动至示教的拍照点，速度为1000mm/sec。
|
||
触发运行Mech-Viz工程 |
因此，整条指令表示机器人触发视觉系统运行Mech-Viz工程，然后Mech-Viz基于Mech-Vision输出的视觉结果规划机器人的抓取路径。 |
||
获取规划路径 |
因此，整条指令表示机器人获取Mech-Viz工程返回的规划路径。
因此，上述语句表示，当状态码R[53]为2100时，则机器人成功获取到规划路径；否则视觉系统发生异常，程序跳转到LBL[99]处执行。以下为LBL[99]处的代码。 用户可根据具体异常状态码做相应的处理。此样例中对所有异常状态码做了相同处理，即通过PAUSE指令停止程序的执行。 |
||
转存规划路径 |
因此，“CALL MM_GET_JPS(1,60,70,80)”整条指令表示将第一个路径点的关节角、标签和末端工具编号分别转存至指定寄存器。
|
||
移动到抓取接近点 |
机器人移动到抓取接近点（即PR[60]所表示的位置）。 |
||
移动到抓取点 |
机器人移动到抓取点（即PR[61]所表示的位置）。 |
||
设置DO执行抓取 |
机器人移动到抓取点后，通过设置DO指令（例如“DO[1]=ON”），控制末端工具进行抓取。用户需根据实际场景增加设置DO的操作。
|
||
移动到抓取离开点 |
机器人移动到抓取离开点（即PR[62]所表示的位置）。 |
||
移动到中间过渡点 |
因此，整条指令表示机器人以关节角移动方式移动至抓取离开点与放置接近点之间的某个过渡点。
|
||
移动到放置接近点 |
|
||
移动到放置点 |
机器人从放置接近点移动到放置点。 |
||
设置DO执行放置 |
机器人移动到放置点后，通过设置DO指令（例如“DO[1]=OFF”），控制末端工具进行放置。用户需根据实际场景增加设置DO的操作。
|
||
移动到放置离开点 |
机器人移动到放置点上方的某处，即到达放置离开点。
|
||
移动到Home点 |
机器人从放置离开点重新移动到Home点。 |