샘플 프로그램14: MM_S14_Vis_GetUserData

현재 최신 버전 (2.1.2)에 대한 매뉴얼을 보고 계십니다. 다른 버전에 액세스하려면 페이지 오른쪽 상단 모서리에 있는 '버전 전환' 버튼을 클릭하세요.

■ 현재 사용하고 있는 제품의 버전이 확실하지 않은 경우에는 언제든지 당사 기술 지원팀에 문의하시기 바랍니다.

프로그램 소개

기능 설명

로봇은 비전 결과를 얻을 때 동시에 Mech-Vision 프로젝트에서 출력된 사용자 정의 데이터를 획득합니다.

파일 경로

Mech-Vision 및 Mech-Viz의 설치 디렉토리로 이동하여 통신 구성 요소/Robot_Interface/KUKA/sample/MM_S14_Vis_GetUserData 경로를 사용하여 파일을 찾을 수 있습니다.

필요한 프로젝트

Mech-Vision 프로젝트 (하나 이상의 사용자 정의 포트출력 스텝에 추가해야 합니다).

사용 전제 조건

  1. 표준 인터페이스 통신 구성이 완료됩니다.

  2. 자동 캘리브레이션이 완료됩니다.

이 샘플 프로그램은 참고용으로 제공됩니다. 사용자는 실제 상황에 맞춰 이 내용을 바탕으로 수정해야 하며, 해당 프로그램을 그대로 사용하지 않도록 하십시오.

프로그램 설명

다음에는 MM_S14_Vis_GetUserData 샘플 프로그램의 코드와 관련 설명입니다.

MM_S1_Vis_Basic 샘플과 비하면, 이 샘플은 아래와 같이 굵게 표시된 코드 부분만 수정되었습니다. 따라서, MM_S14_Vis_GetUserData의 MM_S1_Vis_Basic과 일치하는 부분은 다시 설명하지 않습니다. (일치하는 부분에 대한 정보는 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

위 샘플 프로그램 코드에 해당하는 워크플로는 아래 그림에 표시되어 있습니다.

sample14

아래 표는 굵게 표시된 코드의 설명입니다. 명령어 이름의 링크를 클릭하면 해당 명령의 상세 설명을 확인할 수 있습니다.

워크플로 코드와 설명

비전 결과 획득하기(사용자 정의 데이터가 포함됨)

;get vision result from NO.1 Mech-Vision project
MM_Get_Dy_Data(1,pos_num,status)
Mech-Vision프로젝트에 대해 사용자 정의 데이터는 Mech-Vision가 포트에서 출력된 데이터를 자체 정의한다는 것입니다.
  • MM_Get_Dy_Data:비전 결과를 획득하는 명령어. 이 명령어를 통해 획득된 비전 포인트는 포즈와 레이블, 사용자 정의 데이터가 포함되지만, MM_Get_VisData 명령어를 통해 획득된 비전 포인트는 사용자 정의 데이터가 포함되지 않습니다.

  • 1: Mech-Vision 프로젝트 번호.

  • pose_num: 이 변수는 비전 시스템이 반환한 비전 포인트의 개수를 저장합니다.

  • status: 이 변수는 명령어 실행 상태 코드를 저장하는 것입니다.

따라서, 이 명령어는 로봇이 Mech-Vision 프로젝트 1이 반환한 비전 결과를 획득하는 명령어입니다(사용자 정의 데이터가 포함됨).

반환된 비전 결과는 로봇의 메모리에 저장되므로, 사용자는 직접적으로 비전 결과의 사용자 정의 데이터를 얻을 수 없으며, 이후 "비전 결과 저장"을 통해서만 접근할 수 있습니다.

비전 결과를 저장하기(사용자 정의 데이터가 포함됨)

;save first vision point data to local variables
MM_Get_DyPose(1,Xpick_point,label)
  • MM_Get_DyPose:비전 결과를 저장하는 명령어. 이 명령어는 포즈와 레이블 외에도 사용자 정의 데이터를 저장합니다. 그러나 MM_Get_Pose 명령어는 포즈, 레이블 및 말단장치 번호만 저장할 수 있으며, 사용자 정의 데이터를 저장할 수 없습니다. 또한, MM_Get_DyPose 명령어는 로봇 메모리에 저장된 비전 포인트의 사용자 정의 데이터를 MM_UserData 전역 배열에 저장합니다.

  • 1: 첫 번째 비전 포인트가 저장됩니다.

  • Xpick_point: 이 변수는 첫 번째 비전 포인트의 말단장치 포즈, 즉 피킹 웨이포인트의 말단장치 포즈를 저장하는 것입니다.

  • label: 이 변수는 첫 번째 비전 포인트의 레이블을 저장하는 것입니다.

따라서 이 명령어는 첫 번째 비전 포인트의말단장치 포즈, 레이블 및 사용자 정의 데이터를 지정된 변수에 저장한다는 것입니다.

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

위의 코드는 비전 포인트(피킹 웨이포인트)의 3개 사용자 정의 데이터 MM_UserData[1], MM_UserData[2], MM_UserData[3]을 각각 offset_x, offset_y, offset_z에 할당하는 것입니다.

offset_x, offset_y, offset_z의 의미는 사용자가 직접 정의할 수 있으며, 예를 들어 이 세 값은 로봇이 피킹 웨이포인트로 이동할 때 X, Y, Z 축에서의 오프셋을 나타낼 수 있습니다.

이 페이지가 도움이 되었습니까?

다음 방법을 통해 피드백을 보내주실 수 있습니다:

저희는 귀하의 개인정보를 소중히 다룹니다.

당사 웹사이트는 최상의 사용자 경험을 제공하기 위해 쿠키를 사용하고 있습니다. "모두 수락"을 클릭하시면 쿠키 사용에 동의하시는 것이며, "모두 거부"를 클릭하시면 이 웹사이트 방문 시 귀하의 정보가 추적되거나 기억되지 않도록 단일 쿠키만 사용됩니다.