샘플 프로그램2:MM_S2_Vis_Basic

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

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

프로그램 소개

기능 설명

로봇이 Mech-Viz 프로젝트 실행을 트리거하고 경로 계획 결과를 획득하여 피킹 및 배치 작업을 수행합니다.

파일 경로

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

필요한 프로젝트

Mech-Vision와 Mech-Viz 프로젝트

사용 전제 조건

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

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

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

프로그램 설명

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

DEF MM_S2_Viz_Basic ( )
;---------------------------------------------------
; FUNCTION: trigger Mech-Viz project and get
; planned path
; 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)
   ;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
   ;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]
   ;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
END

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

sample2

아래 표는 위 프로그램에 대한 설명입니다. 명령어 이름의 링크를 클릭하면 해당 명령의 상세 설명을 확인할 수 있습니다.

워크플로 코드와 설명

좌표계 설정

   ;set current tool no. to 1
   BAS(#TOOL,1)
   ;set current base no. to 0
   BAS(#BASE,0)
  • BAS(#TOOL,1): 현재 선택한 툴 좌표계 번호는 1으로 설정합니다.

  • BAS(#BASE,0): 현재 선택한 기초 좌표계 번호는 0으로 설정합니다.

위의 두 명령어는 현재 선택한 툴 좌표계와 기초 좌표계를 설정한다는 것입니다.

Home포인트로 이동하기

   ;move to robot home position
PTP HOME Vel=100 % DEFAULT
  • PTP: 점에서 점까지 이동하는 방식입니다. 로봇은 TCP를 목표점까지 가장 빠른 경로로 이동시킵니다.

  • HOME: 목표점의 명칭, 즉 Home 포인트입니다.

    사용자는 티칭을 통해 Home 포인트를 미리 설정해야 합니다. 자세한 설명은 캘리브레이션 매뉴얼 중의 티치 펜던트를 통해 캘리브레이션 시작점을 설정하기 내용을 참조하세요.

  • Vel=100 %: 속도.

  • DEFAULT: 시스템에서 할당한 운동 데이터 세트의 기본 이름.

따라서, 이 명령어는 로봇이 점에서 점까지 이동 방식을 사용하여 티칭 Home포인트로 이동하는 것입니다.

통신 파라미터를 초기화하기

   ;initialize communication parameters (initialization is required only once)
   MM_Init_Socket("XML_Kuka_MMIND",873,871,60)

로봇이 MM_Init_Socket 명령어를 통해 XML_Kuka_MMIND.xml 파일의 구성 정보에 따라 비전 시스템과 TCP 프로토콜 통신 연결을 구축합니다.

XML_Kuka_MMIND.xml 파일에 관한 더 상세한 설명은 MM_Init_Socket 명령어 내용을 참조하세요.

카메라 이미지 캡처 위치로 이동하기

   ;move to image-capturing position
LIN camera_capture Vel=1 m/s CPDAT1 Tool[1] Base[0] 
  • LIN: 직선 이동 방식.

  • camera_capture: 목표점의 명칭, 즉 카메라 이미지 캡처 위치.

    티칭을 통해 카메라 이미지 캡처 위치를 미리 설정해야 합니다. 자세한 설명은 캘리브레이션 매뉴얼 중의 티치 펜던트를 통해 캘리브레이션 시작점을 설정하기 내용을 참조하세요.
  • Vel=1 m/s: 속도.

  • CPDAT1: 시스템에서 할당한 운동 데이터 세트의 기본 이름.

  • Tool[1]: 1번 툴 좌표계.

  • Base[0]: 0번 기초 좌표계.

따라서, 이 명령어는 로봇이 직선 이동 방식을 사용하여 티칭 카메라 이미지 캡처 위치로 이동하는 명령어입니다.

Mech-Viz 프로젝트 실행을 트리거하기

   ;trigger Mech-Viz project
   MM_Start_Viz(2,init_jps)
  • MM_Start_Viz:Mech-Viz 프로젝트 실행을 트리거하는 명령어.

  • 2: init_jps 변수로 표시된 관절 각도 데이터를 Mech-Viz 프로젝트에 전송합니다.

  • init_jps: 사용자가 자체 정의한 관절 각도(JPs) 데이터입니다. 피킹 경로를 계획할 때, Mech-Viz 프로젝트 중의 시뮬레이션된 로봇은 해당 관절 각도에서 시작하여 첫 번째 웨이포인트로 이동합니다.

따라서, 이 명령어는 로봇이 비전 시스템을 트리거하여 Mech-Viz 프로젝트를 실행한 후, Mech-Vision가 출력한 비전 결과를 기반으로 Mech-Viz는 로봇의 피킹 경로를 계획한다는 것을 나타냅니다.

계획 경로를 획득하기

   ;get planned path, 1st argument (1) means getting pose in JPs
   MM_Get_VizData(1,pos_num,vis_pos_num,status)
  • MM_Get_VizData: Mech-Viz가 계획한 경로를 획득하는 명령어.

  • 1: 획득한 웨이포인트의 포즈 유형을 관절 각도(JPs)로 지정합니다.

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

  • vis_pos_num: 이 변수는 비전 이동 웨이포인트(피킹 웨이포인트)의 경로 내 위치 번호를 저장합니다.

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

따라서, 이 명령어는 로봇이 Mech-Viz 프로젝트가 반환한 계회된 경로를 획득하는 명령어입니다.

반환된 계획 경로는 로봇의 메모리에 저장되며, 직접적으로 얻을 수 없습니다. 후속 작업인 "계획 경로를 저장하기"을 통해서만 접근할 수 있습니다.
   ;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
  • IF A THEN …​ ENDIF: 조건 A가 성립하면, 프로그램은 IF와 ENDIF 사이의 코드를 실행합니다.

  • <>: 같지 않음.

따라서, 위의 문장은 상태 코드 status가 2100일 경우 로봇이 모든 계획 경로를 성공적으로 획득했다는 것을 의미하며, 그렇지 않으면 비전 시스템에 이상이 발생한 것이며, 프로그램은 IF와 ENDIF 사이의 코드를 실행합니다. 사용자는 구체적인 비정상 상태 코드에 따라 적절한 처리를 수행할 수 있습니다. 이 샘플에서는 모든 비정상적인 상태 코드에 대해 같은 처리를 수행하며, 즉 halt 명령어를 사용하여 프로그램 실행을 일시 중단합니다.

계획 경로를 저장하기

   ;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])
  • MM_Get_Jps: 계획된 경로를 저장하는 명령어.

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

  • Xpick_point1: 이 변수는 첫 번째 웨이포인트의 관절 각도를 저장하는 것입니다.

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

  • toolid[1]: 이 변수는 첫 번째 비전 웨이포인트의 말단장치 번호를 저장하는 것입니다.

따라서, “MM_Get_Jps(1,Xpick_point1,label[1],toolid[1])”는 첫 번째 웨이포인트의 관절 각도, 레이블 및 말단장치 번호를 지정된 변수에 저장하는 명령어입니다.

이 샘플에서는 Mech-Viz가 계획한 경로가 세 개의 웨이포인트로 구성됩니다: 첫 번째는 피킹 접근 웨이포인트(Xpick_point1), 두 번째는 피킹 웨이포인트(Xpick_point2), 세 번째는 피킹 출발 웨이포인트(Xpick_point3)입니다. 사용자는 실제 Mech-Viz 프로젝트를 고려하여 계획된 경로를 저장해야 합니다.

피킹 시 접근(approach) 웨이포인트로 이동하기

   ;move to approach waypoint of picking
PTP pick_point1 Vel=50 % PDAT1 Tool[1] Base[0] 

로봇이 피킹 접근 웨이포인트로 이동합니다. 여기서 pick_point1는 앞서 언급한 Xpick_point1와 동일한 위치를 나타냅니다.

피킹 웨이포인트로 이동하기

   ;move to picking waypoint
PTP pick_point2 Vel=10 % PDAT2 Tool[1] Base[0] 

로봇이 피킹 웨이포인트로 이동합니다. 여기서 pick_point2은 앞서 언급한 Xpick_point2과 동일한 위치를 나타냅니다.

“DO 설정”을 통해 피킹을 수행하기

   ;add object grasping logic here, such as "$OUT[1]=TRUE"
   halt

로봇이 픽 포인트로 이동한 후, DO 명령어(예:“$OUT[1]=TRUE”)를 설정하여 말단 장치를 제어하고 피킹를 수행합니다. 사용자는 실제 상황에 맞게 DO 설정 작업을 추가해야 합니다.

halt는 프로그램의 실행을 일시 중지하는 것을 나타냅니다. 사용자가 DO 명령어를 설정하는 문장을 추가한 경우, 여기에서 halt 문장을 삭제할 수 있습니다.

피킹 출발(departure) 웨이포인트로 이동하기

   ;move to departure waypoint of picking
PTP pick_point3 Vel=50 % PDAT3 Tool[1] Base[0] 

로봇이 피킹 출발(departure) 웨이포인트로 이동합니다. 여기서 pick_point3은 앞서 언급한 Xpick_point3와 동일한 위치를 나타냅니다.

중간 웨이포인트로 이동하기

   ;move to intermediate waypoint of placing
PTP drop_waypoint CONT Vel=100 % PDAT2 Tool[1] Base[0]

로봇이 피킹 시 출발 웨이포인트와 배치의 접근 웨이포인트 사이의 특정 중간점으로 이동하합니다(drop_waypoint).

  • 중간 웨이포인트를 추가하면 로봇이 부드럽게 이동할 수 있으며, 불필요한 충돌을 방지할 수 있습니다. 사용자는 실제 상황에 맞게 여러 개의 중간 웨이포인트를 추가할 수 있습니다.

  • 사용자는 티칭을 통해 중간 웨이포인트를 미리 설정해야 합니다. 자세한 설명은 캘리브레이션 매뉴얼 중의 티치 펜던트를 통해 캘리브레이션 시작점을 설정하기 내용을 참조하세요.

배치 시 접근 웨이포인트로 이동하기

   ;move to approach waypoint of placing
LIN drop_app Vel=1 m/s CPDAT3 Tool[1] Base[0] 

로봇은 중간 웨이포인트에서 배치 시 접근 웨이포인트로 이동합니다(drop_app).

  • 배치 시 접근 웨이포인트를 추가하면 로봇이 이동 과정에 시나리오 물체(예: 빈)와 충돌하는 것을 방지할 수 있습니다.

  • 사용자는 티칭을 통해 배치 시 접근 웨이포인트를 미리 설정해야 합니다. 자세한 설명은 캘리브레이션 매뉴얼 중의 티치 펜던트를 통해 캘리브레이션 시작점을 설정하기 내용을 참조하세요.

배치 포인트로 이동하기

   ;move to placing waypoint
LIN drop Vel=0.3 m/s CPDAT4 Tool[1] Base[0] 

로봇이 배치 접근 포인트에서 배치 포인트로 이동합니다(drop).

  • 배치 포인트는 다른 워크스테이션, 지원 또는 장치와 안전 거리를 유지해야 하며, 로봇의 최대 확장 범위를 초과하지 않아야 합니다.

  • 사용자는 티칭을 통해 배치 웨이포인트를 미리 설정해야 합니다. 자세한 설명은 캘리브레이션 매뉴얼 중의 티치 펜던트를 통해 캘리브레이션 시작점을 설정하기 내용을 참조하세요.

“DO 설정”을 통해 배치를 수행하기

   ;add object releasing logic here, such as "$OUT[1]=FALSE"
   halt

로봇이 배치 포인트로 이동한 후, DO 명령어(예: “$OUT[1]=FALSE”)를 설정하여 말단 장치를 제어하고 배치를 수행합니다. 사용자는 실제 상황에 맞게 DO 설정 작업을 추가해야 합니다.

halt는 프로그램의 실행을 일시 중지하는 것을 나타냅니다. 사용자가 DO 명령어를 설정하는 문장을 추가한 경우, 여기에서 halt 문장을 삭제할 수 있습니다.

배치 출발 포인트로 이동하기

   ;move to departure waypoint of placing
LIN drop_app Vel=1 m/s CPDAT3 Tool[1] Base[0] 

로봇이 배치 포인트에서 배치 출발 포인트로 이동합니다(drop_app).

  • 배치 출발 포인트를 추가하면 로봇이 이동 과정에 시나리오 물체(예: 빈)와 충돌하는 것을 방지할 수 있습니다.

  • 사용자는 티칭을 통해 배치 출발 포인트를 미리 설정해야 합니다. 자세한 설명은 캘리브레이션 매뉴얼 중의 티치 펜던트를 통해 캘리브레이션 시작점을 설정하기 내용을 참조하세요.

Home포인트로 이동하기

   ;move back to robot home position
PTP HOME Vel=100 % DEFAULT

로봇이 배치 출발 포인트에서 다시 Home포인트로 이동합니다.

사용자는 티칭을 통해 Home 포인트를 미리 설정해야 합니다. 자세한 설명은 캘리브레이션 매뉴얼 중의 티치 펜던트를 통해 캘리브레이션 시작점을 설정하기 내용을 참조하세요.

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

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

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

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