본문으로 건너뛰기

명령줄

TUI 화면을 열지 않고 터미널에서 쓰는 plem 명령입니다. 명령 목록은 명령어에 있고, 이 페이지는 각 명령의 동작을 설명합니다.

plem 은 plem-cli 패키지가 설치하는 명령입니다. plem <명령> 을 실행하면 이 기기에 설치된 plem-<명령> 실행 파일에 인자를 그대로 넘깁니다. 그래서 쓸 수 있는 명령은 설치된 패키지에 따라 다릅니다. 예를 들어 드라이브 패키지(plem-drive)만 설치한 기기에는 plem drive 만 있습니다.

  • plem --help 는 이 기기에 설치된 명령 목록을, plem <명령> --help 는 그 명령의 자세한 도움말을 보여 줍니다.
  • 인자 없이 plem 만 실행하면, TUI 패키지가 설치된 기기에서는 TUI 화면을 띄우고 없으면 명령 목록을 보여 줍니다.
  • 설치되지 않은 명령을 부르면 plem <명령>: not installed on this device (no plem-<명령>) 한 줄을 출력하고 종료 코드 127로 끝납니다.

plem code 는 로봇 스택 기동·정지, 이동, 그리퍼, 저장 자세를 대화로 다룹니다. 물리 동작과 저장 자세·프로필 변경은 실행 전에 확인을 받습니다.

Teaching Pendant 화면에서 Job 하나가 실행 중이거나 일시정지돼 있으면, plem code 는 팔 이동·그리퍼 명령을 거부하고 어느 Job 때문인지 알려 줍니다. 펜던트에서 ⏹로 그 Job 실행을 끝낸 뒤 다시 시키세요. 이 확인은 명령을 보내기 직전 한 번뿐입니다. 그 뒤 펜던트에서 새로 시작한 Job 실행과 겹치는 것은 막지 못합니다.

plem 을 실행할 때 뜨는 질문​

업데이트 안내​

새 버전이 있으면 TUI 화면이 뜨기 전에 안내가 먼저 나옵니다. 안내 문구는 영어로 나옵니다.

PLEM 0.10.0 → 0.10.1 available (patch)
Update now? [Y/n] (the robot starts if there is no answer in 20 s)
  • Enter 나 y 는 업데이트를 시작하고, n 은 건너뜁니다.
  • 20초 동안 아무것도 누르지 않거나 Ctrl+C 를 누르면 질문을 건너뛰고 TUI 화면으로 넘어갑니다. 무인 재시작에서 업데이트 질문이 기동을 막지 않게 하려는 동작입니다.
  • 질문은 터미널에서 직접 실행했을 때만 나오고, 새 버전 확인에 실패하면 그냥 넘어갑니다.

자세한 절차는 업데이트에 있습니다.

워크스페이스 채택​

빌드된 사용자 워크스페이스 안에서 plem 을 실행하면 Use this directory as the active workspace? [y/N] 라고 묻습니다. 기본은 아니오입니다. 채택한 워크스페이스는 로봇 기동 전체에 오버레이로 적용되고, 커스텀 토크 컨트롤러를 찾을 때도 쓰입니다(커스텀 토크 컨트롤러). 그 용도가 아니면 아니오로 두세요.

plem kill​

TUI 프로세스가 비정상 종료돼 스택 프로세스만 남았을 때 씁니다. 모든 프로세스에 한꺼번에 종료 신호를 보내고, 3초 뒤 남은 것을 강제로 끝냅니다.

다음은 대상에서 빠집니다. 각자 띄운 터미널에서 멈추세요.

  • plem drive run 으로 띄운 드라이브 버스: Ctrl-C 로 세웁니다.
  • ros2 bag record 녹화
  • 셸에서 직접 띄운 ROS launch(MoveIt 데모 등): 같은 터미널에서 띄웠어도 건드리지 않습니다. 다만 파일 이름이 PLEM 것과 같은 launch(robot.launch.py 등), bash -c 로 감싸 띄운 launch, PLEM 스택과 한 명령(파이프라인·스크립트)으로 함께 띄운 것은 정리됩니다.
plem kill --dry # 무엇을 끝낼지 목록만 봅니다
plem kill # 정리합니다
plem kill --force # 기다리지 않고 즉시 강제 종료합니다 (--dry 와 함께 주면 --force 가 이깁니다)
살아 있는 스택에는 쓰지 마세요

plem kill 은 브레이크를 먼저 걸지 않고 카메라 종료도 기다리지 않습니다. TUI 화면이 떠 있으면 s 로 정지하고 q 로 종료하세요(정지와 복구). 그 밖의 주의사항은 로봇 스택 기동에 있습니다.

plem remote​

지원팀이 요청했을 때 실행하세요. 원격 지원 터널이 열리고 터미널을 차지합니다. Ctrl+C 로 끊습니다.

plem workspace​

등록한 워크스페이스를 보여 줍니다. 워크스페이스는 로봇 기동 전체에 적용되는 오버레이이고, 주 용도는 커스텀 토크 컨트롤러입니다.

plem workspace clear 는 등록만 해제합니다. 로봇 프로필에서 고른 Plugin 컨트롤러는 그대로 남습니다. 내장 컨트롤러로 돌아가려면 프로필의 토크 컨트롤러도 되돌리세요.

plem profile​

로봇 프로필의 그리퍼와 F/T 센서를 터미널에서 확인하고 바꿉니다. TUI 화면의 로봇 편집과 펜던트 로봇 설정에서도 같은 항목을 고를 수 있습니다.

하위 명령하는 일
plem profile grippers이 기기에서 쓸 수 있는(드라이버가 설치된) 그리퍼 모델 목록
plem profile set-gripper <로봇> <모델>그 로봇의 그리퍼를 바꿉니다. none 이면 해제
plem profile ft-sensors이 기기에서 쓸 수 있는(설명 패키지가 설치된) F/T 센서 모델 목록
plem profile set-ft-sensor <로봇> <모델>그 로봇의 F/T 센서를 바꿉니다. none 이면 해제

두 set- 명령에 공통입니다.

  • 저장한 값은 다음 기동부터 적용됩니다.
  • --dry-run 을 붙이면 바뀌는 내용만 보여 주고 저장하지 않습니다.
  • 다른 곳(설정 화면·펜던트)이 같은 로봇을 저장하는 중이면 잠시 후 다시 시도하라고 알립니다.

로봇마다 고를 수 있는 모델은 지원 하드웨어에 있습니다. 로봇이 지원하지 않는 F/T 센서는 cannot be set on this robot 으로 거부합니다. 카메라 캘리브레이션이 있는 로봇에서 둘 중 하나를 바꾸면 경고 한 줄(The tool stack changed (…), Hand-eye 캘리브레이션 참조)을 남기고 저장은 그대로 합니다. plem code 에 그리퍼 변경을 시키면 이 명령으로 처리하고 확인을 받습니다. F/T 센서는 plem code 로 바꿀 수 없습니다.

plem uninstall​

PLEM 제거 명령입니다. 먼저 sudo 암호를 묻고, 지울 범위를 보여 준 뒤, 확인을 받고 진행합니다. 패키지만 새로 받으려는 것이면 제거하지 말고 plem update 를 쓰세요.

plem uninstall --keep-license # 라이선스·기기 키를 남기고 제거합니다
plem uninstall --help # 전체 옵션
다시 설치할 계획이면

기본은 라이선스와 plem code 기기 키까지 지웁니다. 하지만 기기 등록은 PLEM 서버에 그대로 남습니다. 그래서 같은 기기를 다시 등록하면 어떤 토큰으로도 거부됩니다. 기기 키는 PLEM 서버도 다시 알려 주지 않으므로, 남긴 파일이 유일한 사본입니다.

제거한 뒤 다시 설치할 계획이면 이렇게 하세요.

  • 부득이 제거할 때는 --keep-license 를 붙여 라이선스와 기기 키 파일을 남기세요. 다시 설치하기 전에 지원팀에 문의하세요.
  • 이미 기본값으로 지웠다면 담당자에게 기존 기기 등록 삭제를 요청하세요. 그 등록에 쓴 토큰도 함께 폐기됩니다. 그 뒤 새로 받은 토큰으로 설치하세요.

함께 지울 것 고르기​

기본으로 남기는 공유 구성 요소와 사용자 데이터는 옵션을 붙여야 지웁니다. 여러 옵션을 함께 줄 수 있습니다.

옵션하는 일
--keep-license라이선스·등록 정보·plem code 기기 키(/etc/plem/{license.key,depot.json,code/plem-code-key.json})를 남깁니다
--remove-user-data로봇 프로필·로그 등 사용자 데이터(~/.plem)와 로컬 전체화면 브라우저 프로필(~/.config/plem-pendant/, ~/.config/plem-lab/)도 지웁니다. 기본은 남깁니다
--remove-ros2-sourceROS 2 apt 저장소 등록도 지웁니다. 기본은 남깁니다(다른 ROS 작업과 공유)
--remove-pip-depsPLEM 설치가 시스템 pip 으로 깐 파이썬 패키지도 지웁니다. 기본은 남깁니다. 같은 패키지를 쓰는 다른 프로그램(cuMotion 포함)도 함께 깨집니다
--remove-pendant-browser전체화면 펜던트용으로 깐 Firefox 브라우저와 그 apt 등록도 지웁니다. 기본은 남깁니다
--remove-cumotion충돌 회피 구성 요소(cuMotion·nvblox)와 그 apt 채널도 지웁니다. torch 등 pip 스택과 다른 Isaac ROS 패키지는 남습니다
--keep-virtual-displayPLEM 쪽에서 설정한 가상 디스플레이 구성을 남깁니다. 기본은 원래대로 되돌립니다
--all위 --remove-* 를 모두 켜고 플러그인 빌드 도구(colcon 등)까지 지웁니다. --keep-license 등과 함께 주면 그 항목은 남깁니다
--non-interactive확인을 묻지 않고 바로 실행합니다

plem init​

커스텀 토크 컨트롤러 스캐폴드를 만듭니다. 전체 흐름은 커스텀 토크 컨트롤러에 있습니다.