WeGo 도서관AgileX PiPER 로봇팔 — 운용 설명서버전 2026.11.17PDF 다운로드
OPERATOR MANUAL
운용 설명서

AgileX PiPER
로봇팔

6자유도 · 가반 하중 1.5 kg

안전 수칙과 사양, 전기 인터페이스와 표시등, 원점 · 특이 자세 · 영점, 기계 설치, CAN 연결과 첫 전원 투입, 드래그 티칭, 호스트 소프트웨어 ArmRobotUA, 유지 보수와 치수 도면까지 AgileX 공식 사용 설명서를 한국어로 옮겼습니다.

한국어판 · 2026.11.17WeGo Robotics · go.support@wego-robotics.com

이 설명서에 대하여

로봇AgileX PiPER 6자유도 로봇팔 (2-Finger 그리퍼 · 티칭 그리퍼 선택)
근거 문서AgileX PIPER Product User Manual (EN) V1.0 2025.06 (agilexsupport.yuque.com, 2026-08-25 판)
함께 보는 책AgileX PiPER 사용 가이드 (ArmRobotUA 따라 하기 · 텔레오퍼레이션 · 영점 학습 · Python SDK · ROS · MoveIt2)
판한국어판 · 2026.11.17
문의go.support@wego-robotics.com

본문은 AgileX 공식 사용 설명서를 옮긴 것이며, 장 순서는 WeGo 설명서 형식에 맞췄습니다 (안전 수칙을 2장으로). 펌웨어와 ArmRobotUA 버전에 따라 화면과 기능이 달라질 수 있습니다.

© WeGo Robotics. AgileX, PiPER는 AgileX Robotics의 상표입니다. 표지의 PiPER 이미지는 AgileX가 공개한 URDF 메시로 렌더링한 것이고, 본문 그림은 AgileX 사용 설명서의 그림입니다.

목차

CONTENTS
  1. 01소개와 사양
  2. 02중요 안전 수칙
  3. 03전기 인터페이스
  4. 04좌표계 · 특이 자세 · 영점
  5. 05작업 공간과 설치
  6. 06CAN 연결과 전원 투입
  7. 07드래그 티칭
  8. 08호스트 소프트웨어 ArmRobotUA
  9. 092차 개발과 CAN 프로토콜
  10. 10유지 보수와 비상 대응
  11. 부록치수 도면
CHAPTER01

소개와 사양

PiPER는 교육 · 연구, 소비자용 응용, 산업 자동화를 위해 설계된 6자유도 로봇팔입니다. 가반 하중은 1.5 kg이며, 휴머노이드 로봇 · 자동 조립 · 자동 운반 같은 연구와 산업 응용에 알맞습니다. 문서

회전 관절 여섯 개로 폭넓고 유연하게 움직이며, 정밀도와 반복성이 높습니다. 모듈식 설계로 정비와 업그레이드가 쉽고, 직관적인 사용자 화면으로 전문가가 아니어도 빠르게 시작할 수 있습니다. 과학 연구 · 교육 · 자동차 제조 · 전자 조립 · 식품 가공 · 실험실 자동화 · 의료 장비 조작 같은 분야에 널리 쓸 수 있습니다.

구성품 문서

표 1. 구성품 목록
이름수량
6자유도 로봇팔1
USB-to-CAN 모듈1
전원 어댑터1
마이크로 USB 케이블1
전원 · 통신 케이블1
베이스 고정 나사4
베이스 고정 렌치1

성능 사양 문서

표 2. PiPER 사양
항목사양
자유도6
가반 하중1.5 kg
무게4.2 kg
반복 정밀도±0.1 mm
작업 반경626.75 mm
정격 전압DC 24 V (최소 동작 전압 24 V, 최대 26 V)
소비 전력최대 ≤ 120 W · 평균 ≤ 40 W
재질알루미늄 합금 프레임 · 플라스틱 외장
컨트롤러내장형
통신 방식CAN
제어 방식드래그 티칭 · 오프라인 궤적 · API · 호스트 소프트웨어
외부 인터페이스전원 × 1 · CAN × 1
베이스 고정 치수70 mm × 70 mm · M5 × 4
작동 환경온도 −20 ~ 50 °C · 습도 25 ~ 85 % (결로 없음)
소음< 60 dB
설치AgileX 전 제품과 호환
관절 동작 범위J1 ±154° · J2 0° ~ 195° · J3 −175° ~ 0° · J4 −102° ~ 102° · J5 −75° ~ 75° · J6 ±120°
관절 최대 속도J1 180°/s · J2 195°/s · J3 180°/s · J4 · J5 · J6 225°/s
참고 · 사양 값

위 값은 AgileX가 정해진 시험 환경에서 측정한 결과입니다. 환경과 사용 방법에 따라 달라질 수 있습니다.

그리퍼 사양 (선택) 문서

표 3. 2-Finger 그리퍼 · 티칭 그리퍼 사양
항목2-Finger 그리퍼티칭 그리퍼
무게500 g550 g
정밀도±0.5 mm±0.5 mm
열림 · 닫힘 거리0 ~ 100 mm0 ~ 100 mm
전원 전압DC 24 VDC 24 V
소비 전력최대 ≤ 50 W · 종합 ≤ 30 W최대 < 50 W · 종합 < 30 W
접촉면 재질고무고무
컨트롤러내장형내장형
통신 방식CANCAN
제어 방식드래그 티칭 · 오프라인 궤적 · API · 호스트 소프트웨어
외부 인터페이스전원 × 1 · CAN × 1
설치 방식플랜지 설치
작동 환경온도 −20 ~ 50 °C · 습도 25 ~ 85 % (결로 없음)
소음< 60 dB

Modified DH 파라미터 문서

표 4. PiPER Modified DH (길이 mm)
Linkdaαθ offset
1123000
20.00.0−π/2−172.22/180 · π
30.0285.030−102.78/180 · π
4250.75−21.98π/20
500−π/20
6910.0π/20
CHAPTER02

중요 안전 수칙

장치를 처음 쓰기 전에 반드시 읽고 이해해야 하는 안전 정보입니다. 이 설명서의 조립 지침을 모두 따르고, 경고 표시가 붙은 글에 특히 주의하십시오. 문서

경고 · 경고 표시의 뜻

⚠ 표시는 피하지 않으면 사람이 다치거나 장비가 심각하게 손상될 수 있는 위험한 상황을 뜻합니다.

경고 · 개조와 오작동

로봇팔이 손상 · 변경 · 개조되었으면 AgileX는 책임지지 않습니다. 프로그램 오류나 로봇팔 오작동으로 로봇팔이나 다른 장비에 생긴 손해에도 책임지지 않습니다.

경고 · 모드를 바꿀 때 (MIT · 티칭 → 호스트 제어)

새 펌웨어에서는 메인 컨트롤러에 MIT 처리가 적용되어 있습니다. MIT 모드(티칭 모드)를 쓴 뒤 호스트 제어 모드로 바꾸려면 다음 순서를 따르십시오.

  1. 로봇팔을 손으로 영점에 되돌리고, 티칭 버튼을 짧게 눌러 끕니다.
  2. 호스트 소프트웨어에 연결해 Disable한 뒤 다시 Enable합니다.

영점이 아닌 자세에서는 절대 모드를 바꾸지 마십시오. Disable되면서 팔이 갑자기 떨어지거나 비정상적으로 움직일 수 있습니다.

책임의 한계

이 설명서의 안전 정보는 AgileX 로봇팔의 보증이 아닙니다. 모든 안전 지침을 지켜도 로봇팔이 부상이나 손상을 일으킬 수 있습니다.

이 설명서는 로봇팔 응용 시스템 전체의 설계 · 설치 · 운용이나, 시스템 안전에 영향을 줄 수 있는 모든 주변 장비를 다루지 않습니다. 전체 시스템의 설계와 사용은 로봇팔을 설치하는 나라의 표준과 규정이 정한 안전 요구 사항을 따라야 합니다. 통합 업체와 최종 고객은 관련 규정과 법을 지켜 로봇팔 응용 시스템 전체에 중대한 위험이 없도록 할 책임이 있습니다. 이 책임에는 다음 항목이 포함되며, 이에 한정되지 않습니다.

유효성과 책임

  • 로봇팔 시스템 전체의 위험성 평가를 합니다.
  • 위험성 평가에서 정한 다른 기계용 안전장치를 연결합니다.
  • 소프트웨어와 하드웨어를 포함한 로봇팔 시스템 전체의 설계 · 설치가 정확한지 확인합니다.
  • 관련 규정과 법에 따라 안전성 평가를 하여, 개발한 로봇팔이 실제 응용에서 중대한 위험이 없도록 합니다.
  • 장비를 조작하기 전에 잠재적인 안전 위험을 알아 둡니다.
  • 사용자가 어떤 안전 조치도 바꾸지 않게 합니다.
  • 위험성 평가서와 이 설명서를 포함한 모든 문서를 기술 파일로 모아 둡니다.

환경

  • 처음 쓰기 전에 이 설명서를 읽고 기본 조작과 사용 지침을 이해하십시오.
  • 비교적 트인 곳에서 쓰십시오. 로봇팔에는 자동 장애물 회피 센서가 없습니다.
  • 주위 온도가 −20 ~ 50 °C인 곳에서 쓰십시오.
  • 방진 · 방수 등급은 별도 주문이 아니면 IP22입니다.

점검

  • 로봇팔에 눈에 띄는 이상이 없는지 확인하십시오.
  • 쓰는 동안 배선이 제대로 연결되어 있는지 확인하십시오.

조작

  • 작동 중에는 주변 공간을 넉넉히 비워 두십시오.
  • 로봇팔이 보이는 곳에서 조작하십시오.
  • 최대 가반 하중은 1.5 kg입니다. 하중이 1.5 kg을 넘지 않게 하십시오.
  • 장비에 이상이 생기면 2차 손상을 막기 위해 즉시 사용을 멈추십시오.
  • 이상이 생기면 기술 담당자에게 연락하고, 직접 고치지 마십시오.
  • IP 등급에 맞는 환경에서 쓰십시오.

경고 ⚠

  • 로봇팔과 공구 · 엔드 이펙터가 언제나 바르게, 단단히 고정되어 있어야 합니다.
  • 로봇팔 작업 공간에 들어가야 할 때는 보안경을 착용하십시오.
  • 로봇팔이 자유롭게 움직일 공간을 확보하십시오.
  • 위험성 평가에서 정한 안전 조치를 갖추십시오.
  • 헐렁한 옷을 입고 조작하지 말고, 긴 머리는 묶으십시오.
  • 손상되었거나 이상이 있는 로봇팔은 쓰지 마십시오.
  • 호스트 소프트웨어에 오류 메시지가 뜨면 즉시 비상 정지하고 기술 담당자에게 연락하십시오.
  • 작동 중에는 머리 · 얼굴 등 몸을 로봇팔과 로봇팔이 닿는 범위에서 멀리 두십시오.
  • 로봇팔을 절대 개조하지 마십시오. 개조는 예측할 수 없는 위험을 만듭니다.
  • 로봇팔을 영구 자기장에 두지 마십시오. 강한 자기장은 로봇팔을 손상시킬 수 있습니다.
  • 로봇팔은 작동 중 열이 납니다. 작동 중이나 멈춘 직후에는 만지지 마십시오. 전원을 끄고 한 시간 동안 식히십시오.
  • 여러 기계를 함께 연결하면 위험이 커지거나 새로 생길 수 있습니다. 설치 전체의 위험성 평가를 하십시오. 서로 다른 안전 · 비상 정지 성능 수준이 필요하면 언제나 가장 높은 수준을 고르십시오. 설치에 쓰는 모든 장비의 설명서를 읽고 이해하십시오.
  • 로봇팔은 만 18세 미만이거나 완전한 행위 능력이 없는 사람이 쓰기에 적합하지 않습니다.
CHAPTER03

전기 인터페이스

PiPER는 6자유도 로봇팔이며, 끝단 가반 하중은 1.5 kg입니다. 경량 설계로 비교적 높은 가반 하중을 유지하면서도 빠르게 움직이며, 체화 지능 연구에서 실제 환경 데이터를 모으는 데 널리 쓸 수 있습니다. 문서

그림 1. PiPER 관절 J1 ~ J6, 티칭 버튼, 전기 패널 (AgileX 문서)

전기 패널 문서

그림 2. 전기 패널과 항공 커넥터 (AgileX 문서)
번호이름번호이름
1전원 · 통신 포트4전원 +
2상태 표시등5전원 −
3J1 · J2 연결 포트6CAN-H
7CAN-L
참고 · 항공 커넥터

빨간 점을 케이블의 빨간 점에 맞춥니다. 커넥터에서 무늬가 있는 부분은 힘을 주면 뒤로 밀립니다. 끼울 때는 빨간 점이 아래를 향하게 해 튀어나온 점에 맞춘 뒤 곧게 밀어 넣고, 뺄 때는 무늬가 있는 부분을 누른 채 당깁니다.

그림 3. 항공 커넥터 끼우기 (AgileX 문서)

전기 패널 상태 표시등 (2번)

표 5. 전기 패널 표시등
표시등상태
녹색 깜박임로봇팔이 정상 작동 중입니다.
녹색 켜짐메인 컨트롤러에 전원이 정상적으로 들어가지 않았습니다. 다시 꽂으십시오.
빨간색 깜박임로봇팔이 비정상이거나 업그레이드 모드에 들어간 상태입니다. 업그레이드 모드가 아니면 고장을 점검해야 합니다.

끝 관절 티칭 표시등

표 6. 끝 관절 티칭 표시등
표시등상태
꺼짐드래그 티칭이 멈췄거나 드래그 기록이 끝난 상태
녹색 켜짐드래그 티칭 궤적을 기록하는 상태
녹색 깜박임드래그 티칭 궤적을 재생하는 상태

끝 관절 예비 인터페이스 문서

전원 인터페이스는 위가 +, 아래가 −이고, 통신 인터페이스는 왼쪽이 H, 오른쪽이 L입니다.

그림 4. 끝 관절 예비 인터페이스 (AgileX 문서)

메인 컨트롤러 CAN 종단 저항 스위치 문서

메인 컨트롤러의 CAN 종단 저항 스위치는 주로 리더 팔 하나가 팔로워 팔 여러 대를 제어할 때 씁니다. 팔 하나만 쓸 때는 바꿀 필요가 없습니다.

  • 공장 기본값은 1번 ON(아래), 2번 OFF(위)이며, 이때 저항은 60 Ω입니다.
  • 팔이 두 대를 넘으면 한 팔만 1번 ON(아래) · 2번 OFF(위)로 두고, 나머지 팔은 1 · 2번 모두 OFF(위)로 둡니다.
그림 5. CAN 종단 저항 스위치 (AgileX 문서)
CHAPTER04

좌표계 · 특이 자세 · 영점

원점과 사용자 좌표계, 피해야 할 특이 자세, 관절 영점의 위치를 설명합니다. 문서

원점

PiPER 원점 좌표계의 (x 0, y 0, z 0) 위치는 아래 그림과 같습니다.

그림 6. 원점 좌표계 (AgileX 문서)

사용자 좌표계

사용자 좌표계는 로봇팔 베이스 좌표계입니다.

그림 7. 사용자 좌표계 = 베이스 좌표계 (AgileX 문서)

특이 자세

  • 손목 특이 자세: J4와 J6이 같은 축에 있을 때
  • 팔꿈치 특이 자세: J1과 J4가 같은 축에 있을 때
  • 어깨 특이 자세: J5와 J6 축의 교점이 J1 축 위에 있을 때
  • 경계 특이 자세: 팔 끝이 최대 작업 범위에 있을 때
그림 8. 손목 특이 자세
그림 9. 팔꿈치 특이 자세
그림 10. 어깨 특이 자세
그림 11. 경계 특이 자세
그림 12. 경계 특이 자세
그림 13. 경계 특이 자세의 좌표

영점

관절의 영점은 그림과 같은 자세입니다. J1은 교정 눈금이 맞은 위치, J2 · J3은 Disable 상태에서 팔이 자연스럽게 놓인 위치, J5는 J6 축이 J4 축과 일직선이 되는 위치가 영점입니다.

영점 좌표: X = 56.128, Y = 0, Z = 213.266, RX = 0, RY = 85.0, RZ = 0

그림 14. 영점 자세 (AgileX 문서)
CHAPTER05

작업 공간과 설치

작업 공간과 끝단 가반 하중 곡선, 베이스 · 끝단 · 책상 설치, 관절 영점 표시, 설치 방식 설정을 설명합니다. 문서

작업 공간과 가반 하중

그림 15. 작업 공간 (AgileX 문서)
그림 16. 끝단 가반 하중 곡선 (AgileX 문서)

베이스 설치

베이스는 나사로 고정합니다. 베이스에 M5 나사 구멍 네 개가 있고, 부속품에 M5 나사 네 개와 육각 공구가 들어 있습니다. 구멍 간격은 70 mm입니다. 이동 장비나 고정면에 붙일 때는 70 mm 간격으로 구조를 설계하십시오.

그림 17. 베이스 설치 도면 (AgileX 문서)

끝단 설치 (그리퍼 · 티칭 그리퍼)

끝단에는 플랜지로 다른 공구를 달 수 있습니다. 선택 부속품으로 2-Finger 그리퍼와 티칭 그리퍼가 있습니다.

  1. 로봇팔을 설치대에 고정합니다.그리퍼 · 티칭 그리퍼 · 플랜지 부속품(플랜지와 볼트)을 꺼냅니다.
  2. 제한 볼트를 끼웁니다.J6 모터를 마주 보고 왼쪽 위에 제한 볼트(M3 × 4, 머리 지름 4.5)를 끼웁니다.
    그림 18. J6 제한 볼트 위치 (AgileX 문서)
  3. 플랜지를 고정합니다.플랜지의 제한 홈을 제한 볼트에 맞춘 뒤 M3 × 8 육각 렌치 볼트(접시머리) 6개로 고정합니다.
    그림 19. 플랜지 고정 (AgileX 문서)
  4. 그리퍼를 끼웁니다.그리퍼와 티칭 그리퍼의 뒤 덮개는 오삽입 방지 구조입니다. 끼운 뒤 M3 × 14 육각 렌치 볼트(접시머리)로 고정합니다.
  5. 케이블을 연결합니다.부속품의 전원 · 통신 케이블을 J6과 그리퍼에 꽂습니다.
  6. 전원과 CAN을 연결합니다.항공 케이블을 로봇팔에 연결하고, USB-to-CAN 모듈을 항공 케이블에 연결합니다(노란색 선은 CAN-H, 파란색 선은 CAN-L). USB 케이블로 모듈을 컴퓨터에 연결하고, 항공 케이블과 어댑터를 연결한 뒤 어댑터 전원을 넣습니다.
  7. J6 영점을 맞춥니다.베이스 표시등이 녹색으로 천천히 깜박이면 호스트 소프트웨어를 실행합니다. 로봇팔과 통신이 되면 그리퍼를 그림의 한계 위치까지 돌린 뒤 J6 관절의 영점을 설정합니다. 설정이 끝나면 로봇팔을 Enable하고 호스트 소프트웨어로 J6을 영점에 돌린 뒤, J6과 그리퍼의 영점 표시가 맞는지 확인합니다.
    그림 20. J6과 그리퍼의 영점 표시 (AgileX 문서)

책상 설치 모듈

책상 설치 모듈은 기본 구성에 들어 있지 않은 선택 부속품입니다. 따로 구매하려면 문의하십시오. 치수는 아래 그림과 같습니다. 로봇팔을 쓰기 전에 단단히 고정하십시오.

그림 21. 책상 설치 모듈 치수 (AgileX 문서)

관절 영점 표시

그림 22. 관절 영점 표시 (AgileX 문서)
그림 23. 관절 영점 표시 (AgileX 문서)

설치 방식 설정

설치 방식에 따라 설정을 바꿔야 합니다. 호스트 소프트웨어의 설정에서 설치 위치에 맞는 설치 방식을 고르십시오.

그림 24. 설치 방식 설정 (AgileX 문서)
CHAPTER06

CAN 연결과 전원 투입

CAN 선을 USB-to-CAN 모듈에 연결하고, 순서대로 전원을 넣습니다. 문서

CAN 연결

CAN 케이블을 꺼내 CAN_H와 CAN_L 선을 USB-to-CAN 모듈에 연결하고, 모듈을 노트북의 USB 포트에 꽂습니다.

그림 25. CAN 연결도 (AgileX 문서)
주의 · 기본 어댑터가 아닌 전원

기본 어댑터가 아닌 전원을 쓰면 입력 전압은 26 V를 넘지 않아야 하고 전류는 10 A 이상이어야 합니다.

끝 관절 전기 연결

끝 관절에는 XT30 2+2 인터페이스가 있으며, 전원 · CAN 핀 배치는 아래 그림과 같습니다. 전압 24 V, 최대 전류 2 A입니다.

그림 26. 끝 관절 XT30 2+2 (AgileX 문서)
경고 · 끝 관절 CAN

끝 관절 CAN 통신은 AgileX 장비만 지원합니다. 다른 CAN 장치를 허가 없이 연결하면 통제할 수 없는 손상이 생길 수 있으므로 절대 연결하지 마십시오.

처음 전원 넣기

처음 전원을 넣을 때는 A ~ G 순서를 따릅니다.

그림 27. 전원 연결도 A ~ G (AgileX 문서)
  1. A의 J2 연결 포트를 먼저 꽂습니다.
  2. 항공 커넥터 B의 CAN 선을 연결합니다.
  3. C의 XT30 커넥터를 맞춰 끼웁니다.
  4. 항공 커넥터 D를 빨간 점이 아래로 가게 끼웁니다.
  5. 어댑터 E를 연결합니다.
  6. 전원을 확인합니다.어댑터 E의 AC 플러그가 제대로 꽂혀 전원이 들어오는지 확인하고, 전기 패널 표시등이 녹색으로 깜박일 때까지 기다립니다.
  7. USB 케이블을 컴퓨터에 꽂습니다.
참고 · 항공 커넥터 방향

빨간 점의 방향을 아래 케이블의 빨간 점에 맞춥니다. 무늬가 있는 부분은 힘을 주면 뒤로 밀립니다. 끼울 때는 빨간 점을 튀어나온 점에 맞춰 곧게 밀어 넣고, 뺄 때는 무늬가 있는 부분을 누른 채 당깁니다.

그림 28. 항공 커넥터 (AgileX 문서)
CHAPTER07

드래그 티칭

드래그 티칭 상태는 J5와 J6 사이의 버튼 표시등으로 알 수 있습니다. 문서

표 7. 티칭 버튼 표시등
표시등상태
꺼짐드래그 티칭이 멈췄거나 드래그 기록이 끝났습니다.
녹색 켜짐궤적을 기록하는 드래그 티칭 모드입니다.
녹색 깜박임궤적을 재생하는 드래그 티칭 모드입니다.
그림 29. 표시등 꺼짐
그림 30. 표시등 녹색

버튼 조작

  • 한 번 누르기: 누를 때마다 궤적 기록을 시작하거나 멈춥니다.
  • 두 번 누르기: 궤적 재생 모드를 켭니다.

순서

  1. 표시등이 꺼져 있으면 한 번 누릅니다.녹색이 켜지면 팔을 손으로 끌어 궤적 기록을 시작합니다.
  2. 기록한 궤적이 있고 표시등이 꺼져 있으면 두 번 누릅니다.녹색이 500 ms마다 깜박이며 기록한 궤적을 재생합니다.
  3. 표시등이 켜져 있으면 기록 중입니다.한 번 누르면 꺼지며 기록이 끝납니다. 재생하려면 2단계를 따릅니다.
  4. 표시등이 깜박이면 재생 중입니다.
경고 · 드래그 티칭 주의 사항
  • 궤적을 재생하는 동안 로봇팔과 안전거리를 지켜 다치지 않게 하십시오.
  • 기록 모드에 들어갈 때마다 전에 기록한 궤적은 지워집니다. 재생할 때는 가장 최근에 기록한 궤적을 씁니다.
  • 최대 기록 시간은 3분이며, 이를 넘는 궤적은 무효입니다.
  • 드래그 티칭을 마치면 표시등이 꺼졌는지(드래그 티칭이 멈췄는지) 확인하십시오.
  • 호스트 제어나 명령 제어로 바꾸려면 표시등이 꺼진 상태에서 호스트 소프트웨어로 대기(standby) 모드로 바꾼 뒤 CAN 모드로 바꾸십시오. 명령 제어도 같습니다.
  • 링크 모드나 드래그 티칭 모드에서 CAN 제어 모드로 바꿀 때는 반드시 로봇팔을 아래 그림의 영점에 둔 뒤 바꾸십시오.
그림 31. 로봇팔 영점 자세 (AgileX 문서)
CHAPTER08

호스트 소프트웨어 ArmRobotUA

ArmRobotUA는 Windows 7 이상에서 쓰는 호스트 소프트웨어입니다. 이 소프트웨어로 로봇팔을 조작하고 피드백 데이터를 읽을 수 있습니다. 처음 따라 하는 순서는 PiPER 사용 가이드 3장을 보십시오. 문서

내려받기: AgileX 사용 설명서의 링크 (Dropbox, ArmRobotUA_V1.6.0.260617_beta-1.exe, 2026-08-25 판 기준)

그림 32. ArmRobotUA
그림 33. 호스트 조작 화면
표 8. 화면 기능 영역
번호이름번호이름
1로봇팔 통신 버튼7조작 기능 영역
2메뉴83D 시뮬레이션 모델
3속도 비율 설정9궤적 라이브러리
4로봇팔 Enable 버튼10관절 상태
5로봇팔 비상 정지 버튼11로봇팔 상태 표시줄
6창 크기 · 닫기 버튼

통신

setting에서 언어를 바꿉니다.

그림 34. 언어 설정

창 왼쪽 위의 통신 버튼을 누르면 [Connect Robot] 창이 뜹니다. 이 창은 PC에 연결된 CAN 장치를 자동으로 찾아 보여 줍니다. 여기서 고른 CAN 장치를 직접 연결하거나 해제할 수 있습니다. 연결되면 버튼에 CAN 장치의 온라인 상태가 실시간으로 표시됩니다.

그림 35. 로봇팔 통신 버튼
그림 36. 온라인
그림 37. 오프라인

메뉴 · 속도 · Enable · 비상 정지

세로 메뉴: 창 왼쪽의 항목을 누르면 그 항목의 패널로 바뀝니다. 고른 항목은 배경이 하늘색이 됩니다.

그림 38. 세로 메뉴

속도 비율: CAN 장치에 연결한 뒤 창 위쪽에서 로봇팔 이동 속도를 정합니다. 값은 로봇팔 최대 속도에 대한 비율입니다.

그림 39. 속도 비율 설정

Enable 버튼: 창 위쪽의 버튼은 여섯 관절의 현재 상태를 보여 주며, 누르면 여섯 관절의 상태가 한꺼번에 반대로 바뀝니다.

그림 40. Disable 상태
그림 41. Enable 상태

비상 정지 버튼: 누르면 로봇팔이 모든 움직임을 즉시 멈춥니다. 다시 누르면(Restore) 쓸 수 있으며, Enable한 뒤 다시 움직일 수 있습니다.

그림 42. E-STOP
그림 43. Restore

창 버튼: 오른쪽 위의 세 버튼은 최소화 · 최대화 · 닫기입니다.

그림 44. 창 크기 · 닫기 버튼

조작 기능 영역

창 가운데가 조작 기능 영역이며, 세로 메뉴에 따라 내용이 바뀝니다. 아래는 관절을 직접 움직이는 동작 제어 영역입니다.

그림 45. 동작 제어 영역

동작 제어

관절은 아래에서 위로 Joint 1 ~ Joint 6이며, 조작 막대의 여섯 관절 설정에 대응합니다. 각도를 직접 넣거나 +/− 버튼으로 관절을 움직입니다 (단위 °).

그림 46. 관절 각도

아래 세 버튼은 ① 영점 복귀, ② 불러오기, ③ 보내기입니다. ①은 공장 초기 자세 각도를 보내고, ②는 여섯 관절의 현재 각도를 입력 칸에 채우며, ③은 입력 칸의 여섯 관절 각도를 로봇팔에 보냅니다.

그림 47. 관절 버튼

아래는 조명 제어 영역입니다. 관절 조명판이 달려 있으면 여섯 관절의 조명을 제어할 수 있습니다. 위쪽의 관절 번호는 조작할 조명판을, RGB 채널 값은 각 채널의 밝기를 나타내고, 아래 막대는 계산된 실제 색을 보여 줍니다. Confirm을 누르면 조명판에 적용됩니다.

그림 48. 조명 제어 영역

연동 제어 (Linkage)

주의 · 단독 사용은 Slave 모드

로봇팔을 단독으로 쓸 때(리더 · 팔로워 텔레오퍼레이션이 아닐 때)는 먼저 Slave 모드로 설정해야 합니다. Master 모드로 되어 있으면 제어할 수 없으니, 호스트 소프트웨어로 Slave 모드로 되돌린 뒤 조작하십시오.

두 팔을 연동하려면 이 화면에서 Master · Servant 상태와 오프셋 값을 정합니다.

그림 49. 연동 제어 영역

그리퍼 제어 (그리퍼가 있을 때만)

그리퍼의 Enable 상태, 토크 값 등을 정합니다. 오른쪽에 그리퍼 피드백 값이 표시됩니다.

그림 50. 그리퍼 설정 영역

관절 설정

여섯 관절의 최대 · 최소 각도, 최대 속도, 최대 가속도를 정합니다. 순서는 [Edit] → [Save]입니다.

그림 51. 관절 설정 영역

속도 설정

팔 끝의 최대 선속도 · 각속도와 최대 선가속도 · 각가속도를 정합니다. [초기화] 버튼을 누르면 공장 설정으로 돌아갑니다.

그림 52. 끝단 속도 설정 영역
그림 53. 초기화

충돌 등급

여섯 관절의 충돌 등급을 1 ~ 8로 정합니다. 순서는 [Edit] → [Save]입니다.

그림 54. 충돌 등급 설정 영역

모터 설정

여섯 관절 모터의 상태(Enable · Disable)를 바꾸고, 영점을 설정하고, 오류를 해제합니다.

그림 55. 모터 설정

업그레이드

  1. 정보 표시 영역(1)을 확인합니다.노드 정보 같은 글이 나오면 정상적으로 업그레이드 상태에 들어간 것입니다.
  2. [Load Software Package](5)를 누릅니다.제공받은 펌웨어(.bin)를 고르면 정보 영역(4)에 펌웨어 정보가 표시됩니다.
  3. [Start Upgrade](6)를 누르고 진행 막대(2)가 끝날 때까지 기다립니다.보통 2 ~ 3분 걸립니다.
그림 56. 업그레이드 영역

3D 시뮬레이션 모델

창 오른쪽은 로봇팔의 실시간 3D 모델입니다. 왼쪽 위에 현재 좌표와 여섯 관절 각도가 표시됩니다. 아래 세 버튼은 ① 도움말(3D 영역 사용법), ② 시점 복원, ③ 설정(호스트 소프트웨어 파라미터)입니다.

그림 57. 3D 시뮬레이션 모델

궤적 라이브러리 (TraceLib)

세로 메뉴 아래의 [TraceLib]을 누르면 창이 뜹니다. 이 창에서 로봇팔 동작 궤적을 만들고 편집해 실행할 수 있습니다.

그림 58. 궤적 라이브러리 창
그림 59. 궤적 라이브러리 창
  • ① Import: PC의 궤적 라이브러리 로그 파일을 불러옵니다.
  • ② Create: 새 동작 궤적을 만듭니다.
  • ③ Delete: 고른 궤적을 지웁니다.
  • ④ Send: 고른 궤적을 보내 한 번 · 여러 번 · 반복 실행합니다.
  • ⑤ Export: 고른 궤적을 PC로 내보냅니다.

궤적을 두 번 누르면 하위 메뉴가 열려 내용을 편집할 수 있고, 마우스 오른쪽 버튼으로 추가 · 삭제 · 수정 · 조회할 수 있습니다.

그림 60. TraceLib 하위 메뉴

관절 상태와 로봇팔 상태

창 왼쪽 아래의 관절 상태 버튼을 누르면 [Joint Status] 창이 뜨며 여섯 관절의 상태를 실시간으로 보여 줍니다. 버튼도 관절 상태에 따라 실시간으로 바뀝니다.

그림 61. 관절 상태 창
그림 62. 정상 (Normal)
그림 63. 비정상 (Abnormal)

창 오른쪽 아래의 상태 표시줄은 로봇팔 상태를 실시간으로 보여 줍니다.

그림 64. 로봇팔 상태 표시줄
CHAPTER09

2차 개발과 CAN 프로토콜

Python SDK와 ROS1 · ROS2 드라이버 패키지로 2차 개발을 할 수 있습니다. 자세한 내용은 AgileX GitHub를, 따라 하는 순서는 PiPER 사용 가이드 7 ~ 10장을 보십시오. 문서

표 9. 개발 자료 (AgileX 문서)
내용주소
SDKgithub.com/agilexrobotics/piper_sdk
SDK 데모github.com/agilexrobotics/piper_sdk/tree/master/demo
SDK UIgithub.com/agilexrobotics/Piper_sdk_ui
ROS1 Noeticgithub.com/agilexrobotics/Piper_ros/tree/ros-noetic-no-aloha
ROS2 Humblegithub.com/agilexrobotics/Piper_ros/tree/ros-humble-no-aloha
URDFgithub.com/agilexrobotics/piper_ros/tree/noetic/src/piper_description/urdf
MoveIt2github.com/agilexrobotics/piper_ros/tree/humble/src/piper_moveit
MoveItgithub.com/agilexrobotics/piper_ros/tree/noetic/src/piper_moveit
Gazebogithub.com/agilexrobotics/piper_ros/tree/noetic/src/piper_sim/piper_gazebo
Isaac Simgithub.com/agilexrobotics/piper_isaac_sim

CAN 프로토콜

로봇팔에는 개발용 CAN 인터페이스가 있어, 이 인터페이스로 명령을 보내 로봇팔을 제어할 수 있습니다. CAN 통신은 CAN 2.0B 표준을 따르고, 통신 속도는 1000 k이며, 메시지는 MOTOROLA(MSB) 형식입니다. CAN 명령으로 개발하려면 AgileX 기술 지원팀에 CAN 프로토콜 설명서를 요청하십시오.

CHAPTER10

유지 보수와 비상 대응

로봇팔이 오래 높은 성능을 유지하려면 정기적으로 정비해야 합니다. 모든 정비는 이 설명서의 지시를 엄격히 따라야 합니다. 문서

정비

정비는 로봇팔의 전원을 끄고 영점에 되돌린 뒤 합니다. 전원을 끈 뒤 다음 작업을 합니다.

  • 청소: 물티슈나 물에 살짝 적신 천으로 표면의 먼지 · 때 · 기름을 닦습니다.
  • 나사 조임: 풀린 나사가 없는지 확인합니다.
  • 모터 점검: 모터와 구조 부품에 손상 · 변형이 없는지 봅니다.
  • 케이블 점검: 전원 케이블과 CAN 케이블이 단단히 연결되었는지, 피복이 상하지 않았는지 봅니다.

비상 대응

전원 차단

비상 시에는 항공 커넥터를 뽑아 바로 전원을 끊을 수 있습니다.

경고 · 전원을 끊으면 팔이 떨어집니다

전원이 꺼지면 로봇팔이 Disable되어 갑자기 떨어질 수 있습니다. 로봇팔과 주변 장비가 손상되거나 사람이 다치지 않게 대비하십시오. 전원을 뽑는 것은 비상 조치일 뿐이며, 부상을 막는 안전장치가 아닙니다.

비상 정지

호스트 소프트웨어에 연결되어 있으면 제어 화면의 일시 정지 버튼으로 로봇팔을 멈추거나 다시 움직일 수 있습니다.

APPENDIX

치수 도면

AgileX 사용 설명서의 치수 도면입니다. 단위는 mm입니다. 문서

그림 65. 영점 자세
그림 66. 로봇팔 투상도
그림 67. 티칭 그리퍼를 단 로봇팔
그림 68. 2-Finger 그리퍼를 단 로봇팔
그림 69. 베이스
그림 70. 팔 끝