문제 해결
증상에서 시작하세요.
| 증상 | 먼저 볼 것 |
|---|---|
| Robot Control Setup 에 로봇 목록이 비어 있다 | 납품 시 설정된 프로필이 보이지 않는 상태 — 지원팀 문의. 화면 설명은 기동 구성 |
s 를 눌렀는데 스택이 안 뜬다 | 로봇 스택 기동 §안 뜰 때 |
| 로봇이 멈춰서 안 움직인다 | 아래 §로봇이 멈췄다 |
웹 화면(:8080)이 안 열린다 | 아래 §웹 화면이 안 열린다 |
| 카메라 영상이 없다 | 아래 §ZED X Mini 카메라가 잡히지 않는다 |
| 업데이트한 뒤 동작이 달라졌다 | 변경 이력 확인 — 되돌리기는 없습니다 (업데이트) |
로봇이 멈췄다
TUI 앞이시라면 이 순서입니다.
f로 FreeDrive 로 바꾸고, 손으로 안전한 자세로 빼내세요.R로 복구를 보내세요.- 안전 상태가 정상으로 돌아왔는지 화면에서 확인하세요. 원인이 남아 있으면 다음 제어 주기에 다시 걸립니다.
Teaching Pendant 를 보고 계시다면 화면의 복구 배너가 같은 경로입니다. 배너는 상태가 정상이 된 것만으로는 사라지지 않고, 복구를 눌러 확인하셔야 사라집니다.
원인 식별과 ROS 2 클라이언트용 계약은 정지·안전에 있습니다.
웹 화면이 안 열린다
순서대로 확인하세요.
- 스택이 떠 있는지 — Robot Control 에서
s로 기동한 상태여야 합니다. 웹 화면은 스택과 함께 뜹니다. - 구성 요소를 켠 채 기동했는지 — Robot Control Setup 의 Teaching Pendant · Plem Lab (기본값은 둘 다 켜짐). 끈 채로 기동하셨으면 스택을 내리고 켠 뒤 다시 기동하세요.
- 주소가 맞는지 — Robot Control 에서
i를 누르면 이 기기의 주소가 나옵니다. 끝 슬래시까지 포함해야 합니다 —/web/,/lab/.
셋 다 맞는데 안 열리면 웹 브릿지만 빠진 경우입니다. 기동 로그에 브릿지 관련 경고가 있으면 나머지 스택이 정상이어도 웹 화면만 안 뜹니다. 스택을 내리고 다시 기동하세요.
ZED X Mini 카메라가 잡히지 않는다
이 카메라는 GMSL2 로 연결되며, 기기의 카메라 데몬 상태가 어긋나면 영상이 나오지 않습니다. 로봇 스택을 띄울 때 자동으로 점검과 복구가 돌지만, 수동으로도 확인하실 수 있습니다. 다른 카메라를 쓰신다면 로봇 스택 기동의 실패 신호 표를 보세요.
/usr/share/plem/plem-camera-recover.sh --check # 판정만 (아무것도 바꾸지 않습니다)
sudo /usr/share/plem/plem-camera-recover.sh # 필요하면 복구까지
제조사 도구의 "정상" 표시를 근거로 삼지 마세요
카메라 제조사 진단 도구가 장치를 정상으로 보고해도 이 상태를 놓칠 수 있습니다. 판정은 위 스크립트로 하세요.
원격 지원을 받고 싶다
기기에서 다음을 실행하시면 지원 엔지니어가 접속할 수 있는 임시 통로가 열립니다. 명령을 끝내시면(Ctrl+C) 통로도 함께 닫힙니다.
plem remote
지원을 요청할 때
문의는 william@wimcorp.co.kr 로 보내 주세요.
증상이 발생한 시점의 로그를 함께 보내시면 진단이 빠릅니다.
| 로그 | 위치 |
|---|---|
| TUI · 로봇 스택 · 서버 | ~/.plem/log/plem_tui.log |
여기에 plem version 결과와 어떤 조작에서 문제가 났는지를 덧붙여 주세요.