본문으로 건너뛰기

로봇 제어 화면

Start session 화면에서 s 를 누르면 이 화면으로 넘어옵니다. 여기서 s 를 한 번 더 누르면 스택이 기동되고, 기동이 끝나면 아래처럼 채워집니다.

기동된 Robot Control 화면. 위쪽 줄에 plem / Session · 1 robot 제목과 EtherCAT 마스터 수·도메인, 왼쪽 위 ROBOTS 칸에 ballet_1, 그 아래 줄 ● TRAJ indy7_v3, 그 아래 JOINT MOVE 칸, 가운데 LOG · ballet_1 칸에 GRIP rg6 칩과 기동 로그, 오른쪽 SYSTEM 칸에 EtherCAT eth0·슬레이브 점 7/7·WKC·TRAJ·NORMAL·CPU·Memory·Domain·Controller·Workspace, WEB · ballet-1.local 아래 Pendant :8080/web·Lab :8080/lab, 맨 아래 상태줄(Running · 1 robot, ballet_1: Ready to move)과 그 아래 키 줄이 있다.

영역내용
위쪽 줄화면 이름(Session · N robots), EtherCAT 마스터 수, ROS 도메인, 설치 버전. 버전 옆 ↑0.x.y 는 새 버전이 있다는 뜻입니다(업데이트)
ROBOTS (왼쪽 위)기동한 로봇 목록. 로봇마다 두 줄로, 이름과 그 아래 연결 점·모드·모델
JOINT MOVE (왼쪽 아래)관절 목표 입력과 저장 자세로 이동
LOG (가운데)그리퍼·F/T 센서 칩, 스택 로그와 로봇 이벤트
SYSTEM (오른쪽)EtherCAT, 모드, 안전 상태, 슬레이브, CPU·메모리, ROS 도메인, 컨트롤러, 워크스페이스, 웹 주소
상태줄 (아래 첫 줄)지금 무엇이 참인지 한 문장(아래 목록)
키 줄 (맨 아래)지금 누를 수 있는 키. 키 글자만 색이 있습니다

상태줄에 나오는 문장입니다.

  • Not running — press s to start: 스택이 꺼져 있습니다.
  • 초록 ● Running · N robots: 뒤에 고른 로봇의 모드가 글로 붙습니다. Brakes on · Ready to move · FreeDrive · move by hand · Stopping · Error 이고, 로봇 목록과 같은 색입니다.
  • 정지 중: 주황 스피너와 진행 단계가 나옵니다(스택 정지).
  • 굵은 빨강 ■ P-STOP on <로봇>: 보호 정지입니다.
  • 굵은 빨강 ✖ EtherCAT link down · <로봇>: 고른 로봇의 연결이 끊겼습니다. 다른 로봇의 버스가 끊기면 그 로봇이 P-STOP 으로 표시됩니다.

창이 130칸보다 좁으면 SYSTEM 칸이 접힙니다. 보호 정지와 링크 끊김은 그때도 상태줄에 나옵니다.

SYSTEM​

] 로 이 칸을 숨기거나 보입니다. 좁은 창에서는 접힌 채로 시작하니 ] 로 펼치세요.

행표시뜻
EtherCATeth0 / 빨간 ✖ eth0버스 인터페이스 이름. 빨간 ✖ 는 연결이 끊겼다는 뜻입니다
Slaves● ● ● ● ● ● ● 7/7고른 로봇의 마스터에 붙은 EtherCAT 장치마다 점 하나. 서보 드라이브 외 장치도 포함합니다. 초록 = 정상(OP), 주황 = 초기화 중, 빨강 = 링크 끊김·오류. 숫자는 정상/전체
WKC7/7 초록 / 빨강EtherCAT 워킹 카운터(현재/기대 값). 장치 수와 같지 않을 수 있습니다. 빨강이면 이번 주기에 일부 장치의 응답이 빠졌습니다
ModeTRAJ 초록 · FREE 주황 · BRAKE 회색 · STOP 주황 · ERR 빨강고른 로봇의 모드: 궤적 추종 · Freedrive · 브레이크 · 정지 중 · 오류
SafetyNORMAL 초록 / P-STOP 빨강보호 정지 여부. 빨강이면 정지와 복구를 보세요
CPU · Memory42% · 5.1 / 16 GB (32%)기기 부하. 3초마다 갱신
Domain42 / 빨간 0 · shared이번 plem 실행에 적용된 ROS 도메인. 빨강은 도메인을 정하지 않아 기본값 0으로 동작 중이라는 뜻입니다. 설정에서 바꾼 값은 plem 을 다시 실행해야 여기 반영됩니다
ControllerADRC · PID · Plugin <파일>고른 로봇의 토크 컨트롤러
Workspaceunset · ~/ws ✓ · ~/ws !build · ~/ws !missing등록한 사용자 워크스페이스와 빌드 여부
WEB · <기기 주소>Pendant :8080/web · Lab :8080/lab기동 중에 다른 컴퓨터의 브라우저로 열 웹 화면. Start session 화면에서 끈 도구는 나오지 않습니다

로봇 목록​

로봇마다 두 줄입니다. 첫 줄은 굵은 이름, 그 아래 줄은 ● <모드> <모델> 입니다. 모델은 프로필의 로봇 모델 값입니다.

  • ● 초록은 ROS 2 연결됨, ○ 회색은 아직 연결 전입니다.
  • 보호 정지 중에는 모드 자리에 빨간 P-STOP 이 나옵니다. 복구용 Freedrive 상태에서는 FREE P-STOP 으로 나옵니다. 브레이크가 열려 있고 손으로 팔을 움직일 수 있다는 뜻입니다.
  • 여러 대를 띄웠으면 ← 로 목록에, → 로 로그에 포커스를 옮깁니다. 목록에서 고른 로봇이 관절 이동과 로그의 대상입니다.
  • [ 는 왼쪽 열 전체를 숨기거나 다시 보입니다.

브레이크와 Freedrive​

r 은 브레이크를 풀어 궤적 추종(TRAJ)으로 넘기고, 그 밖의 모드에서는 브레이크를 겁니다. f 는 브레이크와 Freedrive(FREE) 사이를 오갑니다. Freedrive 상태에서는 손으로 팔을 움직일 수 있습니다. 키 줄의 라벨은 그 키가 다음에 할 일을 적습니다(release brake, end freedrive 등).

주의
움직이는 중에 누른 r

움직이는 중에 r 을 누르면 브레이크 전환을 요청하며, 급정지할 수 있습니다. 로봇 행과 SYSTEM 칸의 Mode 값이 BRAKE(상태줄은 Brakes on)로 바뀐 것을 보기 전까지는 멈춘 것으로 여기지 마세요.

f 는 브레이크 상태에서만 Freedrive 모드로 들어갑니다.

  • 궤적 추종 중에 누르면 먼저 브레이크만 걸고 Braking first. Press f again after BRAKED to enter FreeDrive. 가 뜹니다. 브레이크가 걸린 뒤 한 번 더 누르세요.
  • 기동 전이면 Press s to launch first 가 뜹니다.
  • 연결 중이면 ROS2 connecting — try again in a moment 가 뜹니다.

전환이 받아들여진 뒤에도 하드웨어 상태를 다시 확인합니다. 로그에 아래 줄이 뜨면 정지와 복구를 따르세요.

  • 보호 정지 중: mode change acknowledged but PROTECTIVE_STOP is active — motion will be blocked by hardware.
  • 관절이 설계 범위 밖: … joints beyond URDF design range … Press [R] to attempt FreeDrive recovery.
움직이기 전에

r 로 브레이크를 풀면 로봇이 명령을 받습니다. 작업 반경에 사람과 물건이 없는지 확인하고, 비상 정지 버튼에 손이 닿는 곳에서 조작하세요. 화면의 어떤 키도 물리 비상 정지를 대신하지 않습니다.

관절 이동​

왼쪽 아래 JOINT MOVE 칸에서 관절 목표를 직접 입력하거나 저장 자세로 이동합니다. Motion planning 체크를 켜고 기동했을 때만 쓸 수 있고, 로봇이 궤적 추종(TRAJ) 모드여야 움직입니다.

위에 ROBOTS 칸(ballet_1, 그 아래 줄 ● TRAJ indy7_v3), 아래에 관절 이동 칸. current·target 두 열에 J0–J5 관절의 현재 각도와 빈 목표 입력란, 아래에 POSES add delete 줄과 zero pos·packaging pos·jog left pos·jog right pos 네 자세, 오른쪽 아래 Reset·Move 버튼.

저장 자세는 ~/.plem/settings.yaml 의 poses 목록입니다. 처음 실행할 때 기본 자세 넷이 그 파일에 기록됩니다. 그 뒤로는 파일 내용을 그대로 쓰므로, 여기서 추가·삭제하거나 파일을 직접 고쳐도 됩니다. 전부 지우면 빈 목록으로 남고 기본 자세는 되살아나지 않습니다.

직접 입력​

  1. target 칸에 목표 각도를 도 단위로 입력하세요. 비워 둔 관절은 지금 위치를 유지합니다.
  2. Move 버튼을 누르거나 입력란에서 Enter 를 치세요. Reset 버튼은 입력을 지웁니다.
  3. 결과가 Reset·Move 버튼 바로 위 줄에 나옵니다. 성공하면 입력이 지워지고, 실패하면 남습니다.
Move 성공은 도착이 아니라 수락입니다

성공은 플래너가 명령을 받아들였다는 뜻입니다.

  • 실행 진행·완료는 이 칸에 나오지 않고 취소 기능도 없습니다. current 열이 목표에 이르러 멈추는 것을 보고 판단하세요.
  • 명령이 수락된 뒤에는 다른 조작이 막히지 않습니다. 멈춘 것을 확인하기 전에는 Teaching Pendant 실행·Jog·캘리브레이션처럼 로봇을 움직이는 다른 동작을 시작하지 마세요.

숫자가 아니면 칸이 빨간 글자로 바뀌고 아래 줄에 not a number 가 나옵니다. 관절 한계 밖이면 허용 범위가 나옵니다. 이동은 한 번에 목표까지 가므로 각도 차이가 크면 동작도 큽니다. 반경을 먼저 비우세요.

입력란 안에서 누르는 키

목표 입력란은 숫자와 부호, 소수점만 받습니다. 커서가 입력란에 있어도 그 밖의 키는 화면 키로 동작합니다. r 은 브레이크, s 는 정지, q 는 종료, a·d 는 자세 추가·삭제입니다.

저장 자세​

조작동작
목록에서 ↑ ↓그 자세의 값을 목표 칸에 미리 채웁니다. 직접 입력한 값이 있으면 덮지 않고 edits kept — enter loads '…' 로 알립니다
목록에서 Enter 또는 클릭목표 칸을 그 자세로 채웁니다. 직접 입력한 값이 있을 때만 덮어쓸지 묻습니다. 이동은 Move 버튼을 눌러야 시작됩니다
a목표 칸의 값을 새 자세로 저장합니다. 모든 관절이 채워져 있어야 합니다
d하이라이트한 자세를 확인을 거쳐 삭제합니다

기본 자세 넷은 관절 이름이 joint0–joint5 인 6축 로봇용입니다. 지원 모델은 전부 여기에 해당하고, 화면에는 J0–J5 로 나옵니다.

자세J0J1J2J3J4J5
zero pos000000
packaging pos001580−1580
jog left pos−20−40−110−20400
jog right pos204011020−400

칸을 쓸 수 없을 때는 이유가 나오고 Reset·Move 버튼은 감춰집니다.

  • Available once the robot is running.
  • waiting for ROS2 connection
  • MoveIt disabled for this launch
  • waiting for joints / URDF
  • URDF arm chain unresolved — Joint Move disabled (see log)

로그​

가운데 LOG 칸에는 두 종류가 섞여 흐릅니다.

  • 기동한 스택의 출력: 항상 보입니다.
  • 로봇 이벤트(연결·모드·안전·한계): 목록에서 고른 로봇 것만 보입니다.

화면에는 최근 1000줄만 남고, 기록은 ~/.plem/log/ 아래 파일로도 남습니다. 위치는 문제 해결 › 지원을 요청할 때에 있습니다.

접두뜻
[RT]실시간 제어 루프 이벤트(PROTECTIVE_STOP · BRAKE_ENGAGE · PROTECTIVE_FLOOR_VIOLATION 등). 뒤에 심각도 severity= INFO · WARN · ERROR · CRITICAL 가 붙습니다. 5초 안에 반복된 같은 이벤트는 접히고, 접힌 횟수가 (xN more in 5s) 로 뒤따릅니다
[SAFETY]안전 상태 변화. 예: [SAFETY] NORMAL → PROTECTIVE_STOP
[LIMIT]관절이 설계 범위를 벗어나거나 되돌아옴
[RECOVER]R 복구의 진행
[CRASH]스택 프로세스가 예기치 않게 끝남
[ERROR]스택 관리 오류. 기동 전 검사 실패(예: EtherCAT 슬레이브 미검출), 프로세스 시작 실패, 비정상 종료 등
[measured]기동 때 그 로봇에 적용된 기구학: geometry: measured record applied (measured <날짜>) 또는 geometry: model nominal (<모델>). rejected: 면 실측값 검증에 실패해 기동이 멈춘 것입니다(정지와 복구)
  • 마우스로 드래그하면 선택한 줄을 지금 보고 있는 화면의 클립보드로 보냅니다(로그 복사).
  • 위로 스크롤한 동안에는 새 줄이 와도 따라 내려가지 않습니다. Enter 를 누르면 최신 줄로 돌아갑니다.
  • l 은 로그 상세 정도를 info → debug → warn → err 순으로 바꿉니다. 저장되며 다음 기동부터 적용됩니다.

로그 복사​

SSH 접속이라면 선택한 줄을 노트북 터미널로 보냅니다(OSC 52). 받는지는 터미널에 따라 다릅니다.

터미널받는지
Windows Terminal · VS Code · WezTerm · kitty받습니다
iTerm2클립보드 접근을 허용해야 받습니다
GNOME Terminal받지 않습니다. ssh -X 로 접속하세요
tmux 3.3 이상(기기·노트북 어느 쪽이든)그 tmux 설정 파일 ~/.tmux.conf 에 set -g set-clipboard on 이 있어야 받습니다

복사가 끝나면 어떻게 보냈는지 알려 줍니다. 클립보드 프로그램(xclip 등)이 받았으면 Copied to clipboard, 터미널로 보내기만 했으면 Sent to the terminal clipboard (needs a terminal with OSC 52) 입니다.

그리퍼·F/T 칩​

그리퍼를 설정한 로봇이면 로그 위에 GRIP <모델> 칩이 나옵니다. F/T 센서를 설정한 로봇이면 그 아래 줄에 F/T <모델> 칩이 따로 나옵니다. 그리퍼 칩은 상태 뒤에 위치(pos=…mm)와 힘(eff=…)을 붙입니다.

칩표시뜻
GRIP○ idle대기 중(잡은 물체 없음)
GRIP● grip물체를 잡고 있음
GRIP⋯ busy동작 중
GRIP✗ ERROR그리퍼 오류
GRIP· waiting for /gripper_status아직 상태를 받지 못함
GRIP✗ not answering그리퍼가 응답하지 않음. 케이블과 툴 전원을 확인하세요. 그리퍼가 다시 응답하면 칩도 저절로 돌아옵니다
F/T● ok |F|=… |T|=… load=…%정상. 힘·토크 크기와 정격 대비 부하
F/T노랑 ▲ <문장> · 빨강 ✗ <문장>경고 · 오류. 센서가 보낸 상태 문장을 그대로 보여 줍니다
F/T· no signal아직 신호가 없음

F/T 값 읽는 법은 F/T 센서에 있습니다.

그리퍼와 F/T 센서를 설정한 로봇의 Robot Control 화면. 로그 위에 GRIP rg6 ✗ not answering 칩과, 그 아래 F/T aft200_d80 ● ok |F|=4.8N |T|=0.13Nm load=12% 칩이 있다.

RViz · PlotJuggler​

v 로 MoveIt RViz 창을 띄우거나 닫습니다. Motion planning 체크를 켜고 기동했을 때만 쓸 수 있습니다. p 로는 PlotJuggler 창을 띄우거나 닫으며, 이 키는 키 줄에 나오지 않습니다. 기기에 모니터가 없으면 창이 뜨지 않습니다. 스택을 정지하면 둘 다 함께 닫힙니다.

키 전체​

키 줄에는 지금 상황에 맞는 키만 나옵니다. 창이 좁으면 뒤쪽 키부터 빠지지만, 빠진 키도 그대로 동작합니다. 한글 입력 상태에서도 같은 자리의 자음·모음으로 동작합니다. 대소문자를 가립니다. r 은 브레이크, R(Shift+r)은 복구입니다.

키한글동작키 줄
sㄴ스택 기동 · 정지항상 (start / stop)
rㄱ브레이크 해제(궤적 추종) · 브레이크기동 후
fㄹ브레이크 ↔ Freedrive기동 후
Rㄲ복구복구가 필요할 때만 (빨강)
a · dㅁ · ㅇ자세 추가 · 삭제JOINT MOVE 칸 안
[ · ]같은 키왼쪽 열 · SYSTEM 보이기·숨기기항상
lㅣ로그 상세 정도기동 후
vㅍRVizMotion planning 켠 기동
pㅔPlotJuggler나오지 않음
← · →—로봇 목록 · 로그로 포커스나오지 않음
,—설정기동 전
qㅂ종료. 두 번 누르면 강제 종료(종료)항상