샘플 프로그램1:MM_S1_Vis_Basic

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

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

프로그램 소개

기능 설명

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

파일 경로

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

필요한 프로젝트

Mech-Vision 프로젝트

사용 전제 조건

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

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

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

프로그램 설명

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

NOP
'--------------------------------
'FUNCTION: trigger Mech-Vision
'project and get vision result
'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_VISDATA 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_POSE ARGF"1;71;61;62"
'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

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

sample1

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

워크플로 코드와 설명

변수 초기화

'clear I50 to I69
CLEAR I050 20
  • CLEAR: 데이터를 지우는 명령어.

  • I050: 번호가 50인 정수형 변수(I 변수)부터 데이터를 지우하도록 지정합니다.

  • 20: 지울 변수 개수를 20으로 지정합니다.

따라서, 이 명령은 정수형 변수 I050부터 I069까지(총 20개)를 0으로 지우는 명령입니다.

'initialize p variables
SUB P070 P070
SUB P071 P071
  • SUB: 뺄셈 명령어.

  • 첫 번째 P070: 피감수를 위치형 변수(P변수) P070으로 지정하는 동시에 뺄셈 연산 결과를 P070에 저장합니다.

  • 첫 번째 P070: 감수를 위치형 변수 P070으로 지정합니다.

따라서, 위의 두 명령어는 위치형 변수 P070과 P071을 0으로 설정하는 명령어입니다.

'set 100mm to z of P070
SETE P070 (3) 100000
  • SETE: 변수 데이터를 설정하는 명령어.

  • P070:설정하려는 데이터의 변수를 P070으로 지정합니다.

  • 3: 위치 변수의 세 번째 파라미터를 설정하도록 지정합니다(이 경우에는 P070의 Z축 데이터를 설정하는 것입니다).

  • 100000: 설정할 데이터를 지정합니다.

따라서, 위 명령어는 P070의 Z축 데이터를 100000μm로 (100mm) 설정하는 명령어입니다.

Home포인트로 이동하기

'move to robot home position
MOVJ C00000 VJ=50.00
  • MOVJ: 관절 각도 이동 명령어.

  • C00000: 티칭을 통해 로봇에 설정된 위치의 ID 번호.

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

    • 티칭을 통해 C00000를 설정한 후 로봇의 티칭 위치는 무조건 C00000에 기록됩니다. 이 티칭 위치는 수정할 수 없습니다.

    • 이 번호(C00000)는 티치 펜던트에 표시되지 않습니다.

  • VJ=50.00: 지정된 관절 속도. 관절 속도는 최대 속도의 비율로 표시됩니다.

따라서, 이 명령어는 로봇이 관절 각도 이동 방식을 사용하여 티칭 Home포인트로 이동하는 명령어입니다.

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

'initialize communication
'parameters (initialization is
'required only once)
CALL JOB:MM_INIT_SOCKET ARGF"192.168.170.22;50000;1"
  • CALL: 지정된 명령어(또는 프로그램)를 호출합니다.

  • JOB: 호출된 명령어(또는 프로그램)를 지정합니다.

  • MM_INIT_SOCKET: 통신을 초기화하는 명령어.

  • 티치 펜던트 화면에서, ARGF는 영어 괄호로 표시됩니다.

  • 192.168.170.22: IPC의 IP 주소.

  • 50000: IPC의 포트 번호.

  • 1: 통신 타임아웃 대기시간은 1분입니다.

로봇이 MM_INIT_SOCKET명령어를 통해 통신 대상(IPC)의 IP 주소(192.168.170.22), 포트 번호(50000), 타임아웃 대기시간(1분)을 지정합니다.

사용자는 실제 상황에 맞게 이 부분의 IPC IP 주소와 포트 번호를 수정하여, 비전 시스템에서 설정한 파라미터와 일치하도록 해야 합니다.

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

'move to image-capturing position
MOVJ C00001 VJ=50.00 PL=0
  • C00001: 로봇의 티칭 위치 번호. 티칭을 통해 C00001(카메라 이미지 캡처 위치)를 미리 설정해야 합니다. 자세한 설명은 캘리브레이션 매뉴얼 중의 티치 펜던트를 통해 캘리브레이션 시작점을 설정하기 내용을 참조하세요.

  • PL=0: 위치 수준은 0으로 지정합니다. 위치 수준( position level)은 로봇과 티칭 위치 간의 근접도를 나타냅니다. 값 범위는 0에서 8까지이며, 값이 작을수록 더 가까움을 나타냅니다.

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

통신 구축

'open socket connection
CALL JOB:MM_OPEN_SOCKET

로봇은 MM_OPEN_SOCKET명령어를 통해 비전 시스템과 TCP 프로토콜 통신 연결을 설정합니다.

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

'trigger NO.1 Mech-Vision project
CALL JOB:MM_START_VIS ARGF"1;0;2;30"
  • MM_START_VIS:Mech-Vision 프로젝트 실행을 트리거하는 명령어.

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

  • 0: 이 Mech-Vision 프로젝트는 모든 비전 포인토를 반환할 것으로 예상됩니다.

  • 2: 로봇의 현재 플랜지 포즈를 Mech-Vision으로 전송합니다.

  • 30: 번호가 30인 P 변수는 사용자 자체 정의 관절 각도 데이터를 저장하는 데 사용되며, 이 샘플에서는 해당 관절 각도 데이터가 실용적인 용도는 없습니다.

따라서, 이 명령어는 로봇이 비전 시스템에 실행 번호 1인 Mech-Vision 프로젝트를 트리거하여 Mech-Vision 프로젝트가 모든 비전 포인트를 반환할 것으로 예상하는 것을 나타냅니다.

비전 결과 획득하기

'get vision result from NO.1
'Mech-Vision project
CALL JOB:MM_GET_VISDATA ARGF"1;51;52"
  • MM_GET_VISDATA:비전 결과를 획득하는 명령어.

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

  • 51: 번호가 51인 I 변수입니다. 이 변수는 획득한 비전 포인트의 개수를 저장하는 것입니다.

  • 52: 번호가 52인 I 변수입니다. 이 변수는 명령어 실행 상태 코드를 저장하는 것입니다.

따라서, 이 명령어는 로봇이 Mech-Vision 프로젝트 1이 반환한 비전 결과를 획득하는 명령어입니다.

반환된 비전 결과는 로봇의 메모리에 저장되므로, 사용자는 직접적으로 비전 결과를 얻을 수 없으며, 이후 "비전 결과 저장"을 통해서만 접근할 수 있습니다.
'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
  • IFTHENEXP A …​ ENDIF: 조건 A가 성립하면, 프로그램은 IFTHENEXP와 ENDIF 사이의 코드를 실행합니다.

  • <>: 같지 않음.

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

통신을 종료하기

'close socket connection
CALL JOB:MM_CLOSE_SOCKET

로봇은 MM_CLOSE_SOCKET 명령어를 통해 비전 시스템과 TCP 프로토콜 통신 연결을 끊깁니다.

비전 결과를 저장하기

'save first vision point data to
'local variables
CALL JOB:MM_GET_POSE ARGF"1;71;61;62"
  • MM_GET_POSE:비전 결과를 저장하는 명령어.

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

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

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

  • 62: 번호가 62인 I 변수입니다. 이 변수는 첫 번째 비전 포인트의 말단장치 번호를 저장하는 것입니다.

따라서, 이 명령어는 첫 번째 비전 포인트의 말단장치 포즈, 라벨 및 말단장치 번호를 각각 지정된 변수로 전송하는 명령어입니다.

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

'move to intermediate waypoint of
'picking
MOVJ C00002 VJ=50.00

이 전체 명령어는 로봇이 관절 각도 이동 방식을 사용하여 이미지 캡처 위치와 피킹 접근 웨이포인트 사이의 특정 중간 웨이포인트로 이동합니다.

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

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

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

'move to approach waypoint of
'picking
SFTON P070
MOVL P071 V=166.6 PL=0
SFTOF
  • FTON P070: 지정된 오프셋(P070, Z축 데이터 100mm)을 기반으로 평행이동을 시작합니다.

  • MOVL P071 V=166.6 PL=0: 직선 운동을 지정합니다. 즉, 로봇이 P071에서 P070만큼 이동하여 위치 오프셋으로 직선 이동하며, TCP 속도는 166.6mm/s이고, 위치 수준은 0입니다.

  • SFTOF: 평행이동을 종료합니다.

따라서, 이 명령어는 로봇이 피킹 웨이포인트(P071) 위로 100mm 직선 이동하는 것을 나타냅니다.

피킹 접근 포인트 추가는 로봇이 이동 중에 시나리오 물체(예: 빈)와 충돌하는 것을 방지할 수 있습니다. 사용자는 실제 상황에 맞게 Z축 방향의 오프셋값( "SETE P070 (3) 100000")을 수정하여 접촉 과정에서 충돌이 발생하지 않도록 할 수 있습니다.

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

'move to picking waypoint
MOVL P071 V=50.0 PL=0

로봇은 직선 이동 방식으로 피킹 접근 웨이포인트에서 피킹 웨이포인트로 이동합니다.

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

'add object grasping logic here,
'such as DOUT OT#(1) ON
PAUSE

로봇이 피킹 웨이포인트로 이동한 후, DO 명령어(예: "DOUT OT#(1) ON")를 설정하여 말단 장치를 제어하고 피킹를 수행합니다. 사용자는 실제 상황에 맞게 DO 설정 작업을 추가해야 합니다.

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

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

'move to departure waypoint of
'picking
SFTON P070
MOVL P071 V=166.6 PL=0
SFTOF

로봇이 피킹 웨이포인트 위로 100mm 이동합니다. 즉 피킹 시 출발(departure) 웨이포인트로 이동합니다.

피킹 출발 웨이포인트를 추가는 로봇이 이동 중에 시나리오 물체(예: 빈)와 충돌하는 것을 방지할 수 있습니다. 사용자는 실제 상황에 맞게 Z축 방향의 오프셋값( “SETE P070 (3) 100000”)을 수정하여 출발 과정에서 충돌이 발생하지 않도록 할 수 있습니다.

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

'move to intermediate waypoint of
'placing
MOVJ C00003 VJ=50.00

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

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

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

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

'move to approach waypoint of
'placing
MOVL C00004 V=166.6 PL=0

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

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

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

배치 웨이포인트로 이동하기

'move to placing waypoint
MOVL C00005 V=50.0 PL=0

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

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

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

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

'add object releasing logic here,
'such as DOUT OT#(1) OFF
PAUSE

로봇이 배치 웨이포인트로 이동한 후, DO 명령어(예: "DOUT OT#(1) OFF")를 설정하여 말단 장치를 제어하고 배치를 수행합니다. 사용자는 실제 상황에 맞게 DO 설정 작업을 추가해야 합니다.

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

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

'move to departure waypoint of
'placing
MOVL C00006 V=166.6 PL=0

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

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

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

Home포인트로 이동하기

'move back to robot home position
MOVJ C00007 VJ=50.00

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

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

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

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

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

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