Example Program 9: MM_S9_Viz_RunInAdvance

You are currently viewing the documentation for the latest version (2.1.0). To access a different version, click the "Switch version" button located in the upper-right corner of the page.

■ If you are not sure which version of the product you are currently using, please feel free to contact Mech-Mind Technical Support.

Program Introduction

Description

The Mech-Viz project is triggered when the robot performs picking. Then, the camera is started by the Branch by Msg Step of the project when the robot performs placing to plan the next path, shortening the cycle time.

File path

You can navigate to the installation directory of Mech-Vision and Mech-Viz and find the file by using the Communication Component/Robot_Interface/KUKA/sample/MM_S9_Viz_RunInAdvance path.

Project

Mech-Vision and Mech-Viz projects

The Mech-Viz project requires that the Branch by Msg Step be configured beforehand.

Prerequisites

This example program is provided for reference only. Before using the program, please modify the program according to the actual scenario.

Program Description

This part describes the MM_S9_Viz_RunInAdvance example program.

The only difference between the MM_S9_Viz_RunInAdvance example program and the MM_S5_Viz_SetBranch example program is that MM_S9_Viz_RunInAdvance can plan the next path (this code of this feature is bolded). As such, only the feature of planning the next path is described in the following part. For information about the parts of MM_S9_Viz_RunInAdvance that are consistent with those of MM_S5_Viz_SetBranch, see Example Program 5: MM_S5_Viz_SetBranch.
DEF  MM_S9_Viz_RunInAdvance ( )
;---------------------------------------------------
; FUNCTION: trigger Mech-Viz project then set
; branch and get planned path, trigger Mech-Viz
; project and set branch in advance during
; pick&place process
; 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 Mech-Viz project
   MM_Start_Viz(2,init_jps)
   ;set branch exit port
   MM_Set_Branch(1,1)
LOOP
   ;get planned path, 1st argument (1) means getting pose in JPs
   MM_Get_VizData(1,pos_num,vis_pos_num,status)
   ;check whether planned path has been got from Mech-Viz successfully
   IF status<> 2100 THEN
      ;add error handling logic here according to different error codes
      ;e.g.: status=2038 means no point cloud in ROI
      halt
   ENDIF
   ;save waypoints of the planned path to local variables one by one
   MM_Get_Jps(1,Xpick_point1,label[1],toolid[1])
   MM_Get_Jps(2,Xpick_point2,label[2],toolid[2])
   MM_Get_Jps(3,Xpick_point3,label[3],toolid[3])
   ;follow the planned path to pick
   ;move to approach waypoint of picking
PTP pick_point1 Vel=50 % PDAT1 Tool[1] Base[0]
   ;move to picking waypoint
PTP pick_point2 Vel=10 % PDAT2 Tool[1] Base[0]
   ;add object grasping logic here, such as "$OUT[1]=TRUE"
   halt
   ;trigger Mech-Viz project but not to trigger camera capturing
   MM_Start_Viz(2,init_jps)
   ;move to departure waypoint of picking
PTP pick_point3 Vel=50 % PDAT3 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 CPDAT3 Tool[1] Base[0]
   ;set branch exit port and trigger camera capturing when robot moves out of camera’s field of view
   MM_Set_Branch(1,1)
   ;move to placing waypoint
LIN drop Vel=0.3 m/s CPDAT4 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 CPDAT3 Tool[1] Base[0]
   ;move back to robot home position
PTP HOME Vel=100 % DEFAULT
ENDLOOP
END

The workflow corresponding to the above example program code is shown in the figure below.

sample9

The following part describes the feature of planning the next path.

Feature Code and description

Plan the next path in advance by looping (picking→triggering the next round of path planning→placing)

LOOP
    ...
ENDLOOP

The above code indicates that the program loops through the code between LOOP and ENDLOOP.

;get planned path, 1st argument (1) means getting pose in JPs
MM_Get_VizData(1,pos_num,vis_pos_num,status)

The above code indicates that the robot obtains the planned path from Mech-Viz by running the MM_Get_VizData command.

;save waypoints of the planned path to local variables one by one
MM_Get_Jps(1,Xpick_point1,label[1],toolid[1])
MM_Get_Jps(2,Xpick_point2,label[2],toolid[2])
MM_Get_Jps(3,Xpick_point3,label[3],toolid[3])

The above code indicates that the robot stores the planned path in the specified variable by running the MM_Get_Jps command. This example program assumes that Xpick_point1, Xpick_point2, and Xpick_point3 are the approach waypoint of picking, the picking waypoint, and the departure waypoint of picking respectively.

   ;follow the planned path to pick
   ;move to approach waypoint of picking
PTP pick_point1 Vel=50 % PDAT1 Tool[1] Base[0]
   ;move to picking waypoint
PTP pick_point2 Vel=10 % PDAT2 Tool[1] Base[0]
   ;add object grasping logic here, such as "$OUT[1]=TRUE"
   halt

The above code indicates that the robot moves to the approach waypoint of picking and then to the picking waypoint, and then the DO command (such as “$OUT[1]=TRUE”) is run to control the tool to perform picking.

;trigger Mech-Viz project but not to trigger camera capturing
MM_Start_Viz(2,init_jps)
  • MM_Start_Viz: The command to trigger the Mech-Viz project to run.

  • 2: Send the joint positions represented by the snap_jps variable to the Mech-Viz project.

  • init_jps: Custom joint positions that should be taught beforehand. The joint positions will be sent to the Mech-Viz project as the start point for the next round of planning. As such, if the robot is located outside the image-capturing region, the Mech-Viz project can be triggered in advance to plan the path of the next round.

The above code indicates that the robot runs the MM_Start_Viz command to start the Mech-Viz project again. Now that the robot has obtained the planned picking path of this round and has moved to the picking waypoint, you can start the Mech-Viz project in advance to plan the path of the next round instead of waiting for the placing to complete and then starting the Mech-Viz project.

Once the Mech-Viz project is executed, the project will wait for the MM_Set_Branch command to set the exit port for the Branch by Msg Step. In addition, the Visual Recognition Step (which performs image capturing) was set on a branch of the Branch by Msg Step, so the camera does not perform image capturing at this time point.
   ;move to departure waypoint of picking
PTP pick_point3 Vel=50 % PDAT3 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 CPDAT3 Tool[1] Base[0]

The above code indicates that the robot moves to the departure waypoint of picking (pick_point3), the intermediate waypoint (drop_waypoint), and then the approach waypoint of placing (drop_app).

;set branch exit port and trigger camera capturing when robot moves out of camera's field of view
MM_Set_Branch(1,1)

In the above example, the robot sets the exit port of the Branch by Msg Step with the MM_Set_Branch command. On this exit port, the Visual Recognition Step will be executed. Then, Mech-Viz will plan the next picking path in advance based on the vision result.

   ;move to placing waypoint
LIN drop Vel=0.3 m/s CPDAT4 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 CPDAT3 Tool[1] Base[0]
   ;move back to robot home position
PTP HOME Vel=100 % DEFAULT

In the above example, the robot moves to the placing waypoint (drop), performs placing (for example, $OUT[1]=FALSE), and then moves to the departure waypoint of placing (drop_app) and then the home position.

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.