변경 이력
v0.11.1
최신개선·변경1
- 설치·업데이트: 원격 지원(
plem remote)은 Depot 이 WebSocket(wss) 접속점을 알려 주면 그 경로로 붙어, Depot 망이 예비 경로로 넘어가도 끊기지 않습니다. 접속점을 알려 주지 않으면 종전과 같습니다.
수정1
- 펜던트: 0.11.0 설치 기기에서 시뮬레이션 실행이 시작되지 않던 문제(서버 내부 오류)를 고쳤습니다.
v0.11.0
변경 289건 보기
호환성 주의44
- 펜던트: 반복 밖에서 반복 안 노드로 바로 이은 선이 있거나, 병렬의 두 레인이 실행 중 같은 그리퍼를 쓰는 프로그램은 이제 ▶ 실행이 거부됩니다(서버도 같은 검사). 문제 목록에 뜬 노드를 반복 입구로 다시 잇거나 그리퍼 노드를 한 레인으로 모으세요.
- 서버 API:
PUT /api/workflows/{id}는 편집의 바탕 판expected(새 문서 0)가 필수라, 없이 저장하는 스크립트·에이전트는 400 입니다. GET 이 주는version을expected로 보냅니다. 다른 기기 저장으로 기대 판이 어긋나면 409 와 서버 판이 옵니다. 업그레이드 때 열려 있던 펜던트 탭은 새로고침하세요. - 서버 API:
/plem의reset_error응답이 문장(text) 대신set_mode와 같은success·message를 줍니다. 컨트롤러가 리셋을 거절하면success: false와 그 이유가 옵니다. 응답을 읽는 클라이언트는text대신success·message를 읽도록 바꿉니다. - 서버 API:
/health는robotId를 주지 않습니다(셀 로봇은session_meta의robots)./api/system/restart와/api/gripper/initialize는robot_id쿼리가 필수이고, 다시 시작은 셀 로봇 중 하나라도 모션 중이면 거부합니다. - 서버 API: 작업(Job)은 작업 문서의 대상 로봇(
metadata.robot_id)에서만 돌고 같은 셀에서만 이어 실행합니다. 대상이 없던 작업은 업데이트 때 셀 첫 로봇 대상이 됩니다. 대상이 셀 밖 로봇이라 거부되면 그 로봇이 든 셀을 기동하거나 셀에 그 로봇을 추가합니다. - 서버 API: 셀 물체(
/api/cell-objects)가 셀의 모든 로봇 장면에 들어가고, 받침대는robot_id로 로봇마다 하나 둡니다. 기존 받침대는 업데이트 때 셀 첫 로봇 것이 되며, 셀에 없는 로봇의 받침대는 장면에서 빠집니다. 겹침 거부에는robot이 붙습니다. - 서버 API: 모든 HTTP·
/plem오류가{"error": {"code", "message", "params"}}한 형태로 오고 코드는 거부 사유마다 다릅니다.node_error, Waypoint 저장·이름 변경·삭제 거부,measure_tool_load실패도 같습니다. 이름 변경 결과 필드:old_name. 스크립트는error.code로 분기합니다. - 서버 API:
/plem의session_meta가 로봇 하나 대신 실행 중인 셀과 셀 로봇 목록(robots)을 줍니다. 로봇 범위 액션(set_mode·move_to_joints· 캘리브레이션 등)과/api/calibration/camera/*는robot_id가 필수이고,robot_state는 로봇마다robotId를 붙여 옵니다. - 캘리브레이션: 핸드아이 캘리브레이션 기록은 측정한 로봇의 것이라 그 로봇에만 쓸 수 있고, 셀이 바뀌어도 같은 로봇이면 그대로 씁니다. 업데이트 뒤 첫 기동이 옛 기록에 로봇을 채우고(그 시리얼이나 그 기록을 쓰는 로봇이 하나뿐일 때), 로봇을 알 수 없는 기록은 쓸 수 없으니 다시 캘리브레이션합니다.
- 로봇: Waypoint 가 교시한 로봇을 기억해, 다른 로봇이 교시한 Waypoint 를 쓰는 작업은 배포·시작·재개 때 거부합니다. 옛 Waypoint 는 업데이트 때 마지막으로 기동한 첫 로봇의 것이 됩니다.
PLEM_DATA_DIR·PLEM_DEVICE_ID로 자료 폴더를 바꿨던 기기는 비워 두니, 그 위치로 이동해 대상 로봇에서 덮어 저장(다시 교시)하세요. - 로봇: 보호 바닥(
workspace_min_z)이 툴 끝·팔꿈치 두 점 대신 로봇과 툴 충돌 모양의 가장 낮은 점을 감시합니다. 값이 있으면 켜지고 0·음수도 높이입니다.workspace_elbow_link는 거부되니 지웁니다. 바닥 아래에서 멈추면 Freedrive 로 올린 뒤 리셋합니다. - ROS 2:
RtEvent0x47 은 보호 바닥 위반입니다(joint_id= 바닥 세그먼트 번호,value= 검출한 주기의 최저 꼭짓점 높이에서 여유를 뺀 값, m). 0x48 은 더는 오지 않습니다. 어느 링크인지는 드라이버 로그에 이름으로 남습니다. - 개발자 SDK:
EtherCATBus::get_status()·ControlStatus는motion_possible()로, SDO 목록 두 형은SlaveSdos로 합쳐졌고has_injected_config()·ControllerConfig::watchdog·describe_*·set_brake_engage_sequence()는 없어졌습니다. - 개발자 SDK: 툴 링크 계약(채널 4개와
ToolTxCommand·ToolRxResponse·ToolAutoQuery)이<plem/driver_interface/tool_link.hpp>(plem::robot)로,SerialToolBridge는plem_gripper_nodes로 옮겨졌고SharedMemoryRegistry는 없어졌습니다. - 개발자 SDK:
plem_ipc는 이제 plem-drive 가 아니라 plem-core 에 실립니다(드라이브만 설치한 환경에는 없습니다). - 서보 드라이브:
with Bus(...)블록을 정상으로 끝내도 축을 멈추고 브레이크를 겁니다(종전에는 예외로 끝날 때만). 블록 뒤에도 축을 풀어 둔 채 두려면with대신Bus(...)를 만들고close()로 끝냅니다. - 서보 드라이브: 드라이브 모델 파일의 이름이 바뀌었습니다 —
control_word→controlword,mode_display→mode_display_timing,serial→serial_number,pdo_mapping: standard→generated,sync_mode: sm→drive_default. 옛 이름은 거부되고, 고쳐도 승인은 유지됩니다. - ROS 2: 드라이브 메시지 이름이 바뀌었습니다 —
RtRawBatch의actual_position·command_torque·statusword등,RtEvent의RAMP_STOP_TIMEOUT등,DriveStatus.brake_operation_pending.RtEvent.extra는 없어졌습니다. 구독 코드를 고치고, 이전 버전에서 녹화한 bag 은 그 버전에서 분석합니다. - ROS 2: 드라이브 패키지가
plem_drive·plem_drive_msgs·plem_rt_msgs셋이 됐습니다(plem_drive_nodes는 합침).RtEvent·RtRawBatch·SetControlCommand는plem_rt_msgs에서 가져옵니다. 플러그인은plem_drive/DriveSystemInterface, C++ 헤더는<plem/drive/…>입니다. - ROS 2: 드라이브 버스의 제어 서비스가
/<bus>/plem_drive/control_command로 옮겼습니다(종전/<bus>/plem/control_command). 로봇의/<robot_id>/plem/control_command는 그대로입니다. - 서보 드라이브:
plem drive check가 사람이 읽는 요약(버스·축·승인 상태·경고·다음 할 일)을 출력합니다. JSON(plem-drive-check/1)을 읽는 스크립트는plem drive check --json <파일>로 바꿉니다. 종료 코드는 그대로입니다. - 개발자 SDK: Python
plem.drive의Bus.status.statusword(종전status_word)와 C++ 이름이 바뀌었습니다 —JointTarget·JointActual,plem/fieldbus/cia402_types.hpp,ramp_stop(),Approval,ModeDisplayTiming. 전체 대응표는 공개 저장소의 마이그레이션 문서에 있습니다. - 개발자 SDK: C++ 버스
initialize()(ICiA402Bus·EtherCATBus), IO 장치의register_PDOs()·configure_after_domain(), 설치 헤더의validate_*함수가plem::core::Result<void>를 돌려줍니다. 버스·장치를 직접 구현했다면 재정의를 바꾸고, 성공은is_ok(), 이유는message()로 읽습니다. - 개발자 SDK: IO 장치의 브레이크 상태 훅
DeviceBase::set_brakes_released()가 없어졌습니다. 재정의했다면 그 함수를 지웁니다. 브레이크 상태가 필요하면 컨트롤러의brake_engaged()를 읽습니다. - 개발자 SDK: 모니터링의
is_initialized()(전역 함수와MonitoringContext)가 없어졌습니다. 초기화 여부는 큐 크기가 0 이 아닌 스트림의queue<T>()가 null 이 아닌지로 봅니다. - 개발자 SDK:
plem::core::Result를 버리면 컴파일러가 경고합니다. 오류 결과의value()는std::logic_error를 던지고(종전에는 기본값을 읽었습니다), 빈 메시지의error()는 실패 그대로 "(no reason given)" 을 담습니다. - 개발자 SDK: C++ 이름이 바뀌었습니다 —
SharedJointData(종전SharedRobotData, 헤더shared_joint_data.hpp),Logger::instance()(종전EcatLogger::Instance()), 툴 채널 이름plem::core::kTool*(종전plem::ipc::paths). 로봇 스택 전용 타입은 공개 코어에서 빠졌습니다. - 개발자 SDK: 공유 메모리
connect()가 이미 연결된 채널과 음수 재시도 간격을 이유와 함께 거부합니다(종전에는 OWNER 재연결이 세그먼트를 0 으로 다시 만들었고, 음수 간격은 기다리지 않고 재시도했습니다). 음수 재시도 횟수도 이유를 말합니다.shared_memory.hpp는<fcntl.h>·<sys/mman.h>·<unistd.h>를 더는 포함하지 않습니다. - 개발자 SDK: PLEM 패키지 헤더가 패키지마다
include/<패키지>/에 설치됩니다(ROS 2 권장 방식).#include줄과 CMake 타깃 연결은 그대로이고,-I/opt/plem/include를 직접 쓰던 빌드는-I/opt/plem/include/<패키지>로 바꿉니다. - 개발자 SDK:
plem_fieldbus를 소스에서 빌드하려면 IgH EtherCAT 마스터가 있어야 합니다. 시리얼 전용 빌드(-DPLEM_ENABLE_ETHERCAT=OFF)와PLEM_HAS_ETHERCAT정의가 없어졌고,plem_drive/specs/drive_model_spec.hpp는models/로 옮겼습니다. - 개발자 SDK: 벤치 적재는
load_drive_model_file(path, ApprovalRecord::IGNORE)로 씁니다(종전bool인자). 더 이상 보내지 않는RtEvent상수REFERENCE_CHAIN_STATS·BRAKE_RELEASE_HANDSHAKE_FAILED·BRAKE_ENGAGE_HANDSHAKE_FAILED와pointer_free_field.hpp는 없어졌습니다. - 개발자 SDK:
EtherCATController::start()가 버스 주기(set_cycle_time_ns, 미설정 1 ms)와 루프 주기(cycle_time_us)가 다르면 거부합니다.enter_quiesce_mode()는close_brake_release_admission()으로 씁니다. 지운 API 목록은 마이그레이션 문서에 있습니다. - 개발자 SDK: 공유 메모리
connect()에 모드 기본값이 없습니다. 세그먼트를 만드는 한 프로세스는ConnectMode::OWNER, 나머지는CLIENT로 적습니다(인자 없는connect()는 소유자의 세그먼트를 지웠습니다). - 개발자 SDK:
MonitoringContext::initialize()·plem::core::monitoring::initialize()가plem::core::Result<void>를 돌려줍니다(다른 설정으로 다시 부르면 실패와 그 이유).PLEM_EMIT은 값이 없는 식이라 결과가 필요하면emit()을 씁니다. - 개발자 SDK: 헤더 위치가 바뀌었습니다 —
<plem/core/monitoring.hpp>(plem::core::monitoring, 종전<plem/monitoring.hpp>),SeqlockData·seqlock::는plem::core::threading(threading/seqlock.hpp),rt_memory.hpp는threading/. 대응표는 마이그레이션 문서에 있습니다. - 개발자 SDK:
plem/core/monitoring/queues.hpp는monitoring/rt_queue.hpp로 이름이 바뀌었고, 내부 보호 정지 판정(internal_pstop_decision.hpp)은types/control_mode_flags.hpp로 합쳐졌으며MotionLimit::dump()는 없어졌습니다.PeriodicTimerRT를 쓰는 코드는 다시 빌드합니다. - 개발자 SDK: 늘 0 이던
RtSample::controlword, 모니터링Config의cycle_period_us·monitor_stats_decimation,MonitoringContext(MetricQueues&)·detail::g_metric_queues가 없어졌고,RtEventEmitter는 공개 헤더에서 빠졌습니다. - 개발자 SDK:
TriState::TRUE·FALSE가YES·NO로 바뀌었습니다(glib 매크로와 충돌).plem_fieldbus시험 키트는plem::fieldbus::test한 네임스페이스로 모였고,MockBus와 시험 전용 생성자DeviceServo(const ServoInfo&)·DeviceBase()는 없어졌습니다. - 개발자 SDK:
EtherCATController가 NaN·역순 한계, 0 이하 속도·토크 한계, 음수·비유한 정지 감속을 거부하고, 한계를 선언한 csp·csv 축에 정지 감속(>0)이 없으면start()를 거부합니다.ServoInfo는 0 이 빠진 토크 범위를,SerialToolBridge::start()는 0 이하poll_period를 거부하며,EtherCATBus는 복사·이동할 수 없습니다. - 개발자 SDK: 공유 메모리 OWNER 는 지우지 못한 같은 이름의 세그먼트(다른 사용자 것)가 있으면 그것을 함께 쓰지 않고 연결에 실패합니다. 쓰지 않던
DeviceServo::position_actual_value_word()·WatchdogResult::should_protective_stop은 없어졌습니다. - 개발자 SDK:
EtherCATController가 한계 미선언 csp·csv 축의start()(먼저set_drive_limits()·set_drive_stop()을 부릅니다), 무한 속도 한계, 분할 규칙 밖set_brake_setup()마스크를 거부하며 성공한EtherCATBus::initialize()의 재호출을 거부하고,ServoInfo::slave_position은 65535 까지입니다. - 개발자 SDK: IO 장치의
DeviceBase::read()·write()가noexcept라 재정의에도 적습니다.build_pdo_mappings()는plem::core::Result를 돌려주고, 열거자(RampStop*·Approval·ApprovalRecord·Partition)는IDLE처럼 대문자이며,RtQueue는 용량 0 과 2^24 초과를 거부합니다. - ROS 2:
teleop_controller가 별칭 없이joint_target_stream_controller(타입plem_controllers/JointTargetStreamController)로 바뀌고~/target의 점(위치·속도·stamp)을 따릅니다. 끊기면 마지막 목표에 서고 빈 메시지면 재활성화까지 멈추며 상태는~/controller_state(100 Hz)로 냅니다. 설정 섹션·타입·토픽을 바꿉니다. - 로봇: 로봇 설치 위치가 로봇 프로필이 아니라 셀(
~/.plem/cell-state/default/)에 저장되고, 기동하는 로봇은 그 셀에 있어야 합니다. 업데이트 뒤 첫 기동이 마지막으로 기동한 로봇들과 프로필의 설치 위치를 셀로 옮기고 프로필에서 지웁니다. 그 뒤 구 버전으로 되돌리면 설치 위치가 원점이 됩니다.
보안4
- 서버 API: 셀 IO 의 Modbus TCP 에는 인증이 없어, PLC 가 plem 에 접속하는 연결의 포트에 닿는 누구나 입력 신호를 쓸 수 있습니다. 받을 주소를 셀 전용 네트워크 인터페이스로 좁히고 그 네트워크에는 셀 장비만 두세요.
- plem code: plem code 가 띄우는 로봇 스택·rosbridge·설정 조회 프로세스가 더 이상 기기 키를 환경 변수로 물려받지 않습니다.
- 설치·업데이트: 설치·기기 등록,
plem update의 버전 보고, 원격 지원, 텔레메트리 업로드,plem code키 갱신은 Depot 주소가 https 가 아니면 Depot 토큰(사용자·기기 토큰)을 보내지 않습니다(로컬 개발용http://127.0.0.1만 예외). 버전 보고는 건너뛰고, 텔레메트리는 기록을 보관한 채 업로드를 미루며, 나머지는 이유를 알리며 멈춥니다. - 설치·업데이트: cuMotion 설치는 PyTorch wheel 의 SHA-256 을 확인해, 내려받은 파일이 다르면 설치하지 않습니다.
새 기능41
- 서보 드라이브: 셋업 마법사가 하드웨어, 소프트웨어 버전, 기기 상태, EtherCAT 세션 통계를 WIM 에 보낼지 한 번 묻습니다. 예를 고르지 않으면 보내지 않으며
sudo plem-fleet off로 언제든 끕니다. 보내는 항목과 보관 기간은 공개 저장소의docs/telemetry.md에 있습니다. - 펜던트: 화면을 영어와 한국어로 씁니다. 왼쪽 레일의 언어 버튼이 새로고침 없이 바꾸고, 고른 언어는 그 태블릿에 남습니다. 처음 접속하면 브라우저 언어를 따르고, 둘 다 아니면 영어입니다. 서버의 거부 사유, 캘리브레이션 진행·실패 안내와 기록을 쓸 수 없는 이유, 직교 목표에 닿지 않는 이유, 정지·영점·입력 오류 알림, 노드 목록의 이름·설명도 고른 언어로 보이며, 서버·로봇이 붙인 상세 문장은 그대로입니다.
- 서버 API: 배포 거부(
WORKFLOW_VALIDATION_FAILED)와 시작·재개 거부(JOB_REVALIDATION_FAILED)가 문제마다 검사 코드와 파라미터를params.issues에 싣습니다. 셀 IO 사유로 거부된 신호 대기·신호 쓰기 노드는 사유마다 검사 코드(io_wait_*·io_write_*)가 다릅니다. 클라이언트는 이 코드로 거부 사유를 자기 언어로 보일 수 있습니다. - 펜던트: 프로그램 캔버스 오른쪽 위 「문제 N개」가 실행 전에 고칠 노드를 모아 보입니다. 행을 누르면 그 노드의 값 창이 열려 문제 칸으로 가고, ▶ 가 거부되면 목록이 저절로 열려 서버가 거부한 이유를 노드별로 붙입니다.
- 펜던트: 프로그램 캔버스 위 명령 띠에 되돌리기·다시 하기, 선택 수, 반복으로 묶기, 복제, ⋯, 삭제가 늘 있고 좁으면 ⋯ 로 접힙니다. 노드·선은 확인 없이 지워지고 「되돌리기」 한 번에 돌아옵니다(6초 뒤 머리글로 접혀 다음 편집까지). 목록 ⋯ 에 「복제」가 생겼습니다.
- 펜던트: 프로그램 이름 옆에 저장 상태(저장됨·저장 대기·저장 중·저장 안 됨)가 늘 보이고, 끊겼던 연결이 돌아오면 사람 없이 다시 저장합니다. 다른 기기가 먼저 저장했으면 덮지 않고 다시 불러오기·내 것으로 덮기·사본 저장 중에서 고르게 합니다.
- 펜던트: Jog 툴 탭에 [버튼 | 3D 핸들] 을 둡니다. TCP 의 큐브를 끌면 자유 이동, 툴 축 화살표를 끌면 그 축으로만 이동, 링을 돌리면 회전하며 로봇이 따르고 거리·각도가 보입니다. 놓으면 로봇이 그곳(TCP 에서 최대 0.25 m·0.6 rad)까지 가서 멈추고, 다가가지 못하면 1 초 뒤 멈춥니다. 끝나면 큐브는 TCP 로 돌아갑니다. Shift 면 1/10 로 움직입니다. 핸들은 로봇과 같이 확대되고 멀면 큐브만 보입니다.
- 펜던트: 셀 3D 가 셀의 모든 로봇을 이름표와 함께 그리고, 상단 스위처나 3D 에서 로봇을 눌러 포커스를 바꿉니다. 포커스 로봇은 윤곽선으로 보이고 Jog·목표 이동·Payload·캘리브레이션은 그 로봇에 합니다(누르는 동안·측정 중엔 못 바꿈). 다른 로봇의 보호 정지·고장은 이름 붙은 알림으로 남고, 평면 모드로 배치를 보며 어느 로봇이든 설치·받침대를 고칩니다. 다른 로봇이 Job 을 도는 동안에도 포커스 로봇은 조작합니다.
- 펜던트: 셀에 로봇이 둘 이상이면 프로그램 이름 옆에서 그 프로그램을 돌릴 대상 로봇을 고르고, Job 화면에도 그 로봇이 보입니다. 그리퍼 노드의 범위, 실패한 이동에 넣는 경유점과 경유점·시뮬레이션·충돌 고스트는 포커스 로봇이 아니라 그 로봇의 것입니다.
- ROS 2: Jog 노드가
/<robot_id>/jog/pose_target_cmd(geometry_msgs/PoseStamped)로 TCP 의 절대 목표 자세를 받습니다. 시뮬레이터처럼 로봇과 같은 좌표의 입력에 쓰고, 입력 장치가 움직인 만큼 옮기는 입력은jog/pose_cmd로 보냅니다. 두 토픽 모두frame_id를 TF 로 풉니다. - ROS 2: 새 서비스
/<robot_id>/plem/request_lane(plem_msgs/srv/RequestLane)이 TRAJECTORY 안에서 jog 레인과 궤적 레인을 바꿉니다. 지금 레인을 멈추고 팔이 정지한 것을 확인한 뒤 전환합니다. jog 레인이 켜져 있을 때의set_mode도 거부하지 않고 같은 순서로 넘겨받습니다. - TUI: Start session 맨 위에서 셀(작업장)을 고르면 그 셀의 로봇이 모두 기동되고, PREFLIGHT 에 셀 이름이 보입니다. 셀 만들기·이름 바꾸기·지우기와 셀에 로봇 넣기·빼기, 로봇 위치·보호 바닥 편집도 이 화면에서 합니다. 셀 밖 로봇은 ROBOTS 아래에 보이며
enter로 넣습니다. 로봇을 하나씩 골라 띄우던space선택은 없어졌고, 한 대만 띄우려면 그 로봇만 든 셀을 만드세요. - 그리퍼: DH-Robotics AG-95 를 지원합니다(Neuromeka 로봇 플랜지 RS-485). 로봇 편집에서 고르고 그리퍼 설정에 장치 ID(Modbus 주소 1–247)를 넣은 뒤 스택을 다시 시작하면 적용되고, 3D·MoveIt 계획 충돌 검사·충돌 회피(cuMotion)·Payload에 반영됩니다. ZED X Mini 와 함께 달면 충돌 회피는 아직 쓸 수 없습니다. 새 deb 는
plem-gripper-dh입니다. - 그리퍼: 로봇 편집이 그리퍼의 통신 경로를 보여 주고 「모양·무게만 사용(통신 끄기)」을 고를 수 있습니다. 저장한 그리퍼가 실행 중인 것과 다르면 「다시 시작 대기」가 보입니다. Neuromeka 가 아닌 로봇에서 플랜지 RS-485 통신을 켜면 저장과 기동이 이유와 함께 거부되고, 통신을 끄면 저장됩니다. AG-95 의 상태 조회 주기(기본 1000 ms)는 고급 설정에서 바꿉니다.
- 그리퍼: 그리퍼 노드에 세 번째 결과 「물체 놓침」이 생겼습니다. 노드 실행 중 그리퍼가 놓침을 알리면 그 갈래로 가고, 잇지 않았으면 경로가 거기서 끝납니다(예전 프로그램도 같음). 다른 때 놓치면 Job 은 계속되고 상단 배너가 노드와 잡은 지 몇 초인지 알립니다.
- 펜던트: 셀 IO 장치 신호에 「그리퍼 놓침」(
device.<로봇 id>.gripper.dropped)이 생겼습니다. 놓침을 알리는 그리퍼에서만 켜지고 다음 그리퍼 명령에 꺼지므로, 멈춰야 하는 공정은 조건 노드로 이 신호를 보세요. - 그리퍼: 초기화가 필요한 그리퍼(AG-95)는 그리퍼 상태 카드의 [초기화] 버튼과 확인 창으로 초기화합니다. 드라이버를 다시 켜도 손가락은 움직이지 않습니다. Job 이 실행·일시정지 중이면 막히고, 초기화 중 Job 시작·재개는 「그리퍼 초기화 중입니다」로 바로 거부됩니다. 10초 안에 끝나지 않으면 이유가 보입니다(
POST /api/gripper/initialize). - 펜던트: 로봇 › 설정에 그리퍼 상태 카드가 생겼습니다. 이동 중·목표 도착(빈손)·물체 잡음·물체 놓침과 현재 폭을 「42.5 mm / 95 mm」처럼 최대 폭과 함께 보여 주고, 그리퍼가 응답하지 않으면 마지막 폭 대신 「연결 끊김」을 보여 줍니다. 로봇 편집의 그리퍼 목록도 모델 id 대신 제품명(OnRobot RG6)으로 보입니다.
- ROS 2:
plem_msgs/GripperStatus에needs_initialization(초기화 전이라 위치 명령을 무시)과object_dropped(잡았던 물체를 놓침, 다음 그리퍼 명령에 해제)가 생겼습니다. RG6 는 둘 다 늘 false 입니다. 이 메시지를 쓰는 노드는 다시 빌드하세요. - 펜던트: 셀 탭 [셀 IO] 에서 Modbus TCP 연결(plem 이 PLC 에 접속 · PLC 가 plem 에 접속)과 신호를 만들면 재기동 없이 적용되고, 연결 상태와 신호 현재값이 실시간으로 보입니다. 로봇마다 그리퍼 파지 · 연결 · 폭도 읽기 전용 장치 신호(
device.<로봇 id>.gripper.*, 사용자 신호는device.로 시작 불가)로 보입니다. 같은 설정은/api/cell-io로도 다룹니다. - 펜던트: 「신호 대기」 노드가 입력 · 장치 신호의 조건을 최대 대기 초까지 기다려 충족 · 시간 초과로 갈라지고, 「신호 쓰기」 노드가 출력 신호에 값을 씁니다. 시간 초과 갈래를 잇지 않았거나 쓰기가 실패하면 이유와 함께 오류로 끝나고, 시뮬레이션은 기다리지도 쓰지도 않습니다.
- 펜던트: 셀 IO 신호 표에서 출력 신호를 직접 켜고 끄거나 값을 씁니다(강제 출력). 확인을 거치고, 실행 중이거나 일시정지된 Job 이 있으면 막히며, 쓰기와 거부는 모두 감사 기록(
~/.plem/audit/cell-io.jsonl)에 남습니다. Job 을 정지 · 종료해도 plem 이 쓴 출력값은 그대로 남습니다. - 펜던트: 하단 바 ▶ 옆 시뮬레이션이 로봇과 그리퍼를 움직이지 않고 Job 화면에 계획 성공 · 실패와 탄 가지를 보이고, 계획된 경로를 3D 고스트로 재생합니다. 첫 이동은 지금 자세에서 계획하고, 거절된 이동 뒤에도 계속해 실패한 이동 수를 하단 바에 보이며, 계획기가 무응답이면 오류로 끝납니다. 그리퍼는 목표 폭 도달, 조건은 지금 변수값, while · 무한 반복은 1회로 보고 대기는 건너뜁니다. 성공이 실행 성공을 보장하지 않습니다.
- 서보 드라이브:
plem drive check가 축의limits.position이zero_offset_count·flip으로 드라이브의 32비트 위치가 나타낼 수 있는 범위를 넘으면 그 범위와 함께 경고합니다. 예제의vendor_id(0x00c0ffee)가 남은 파일에는 경고하고, 승인 전이면 다음 할 일로plem drive run대신 예제 값을 바꾸라고 안내합니다. - 서보 드라이브: 승인된 파일로
plem drive run을 하면 기동 전에 버스의 드라이브를 승인 기록과 대조합니다. 같은 모델의 다른 개체로 바뀌었으면 터미널에서 벤치를 제안하고, 통과하면 승인을 바꿔 기동합니다. 다른 모델·빠진 드라이브·순서가 바뀐 배선은 거부합니다.--unapproved는 승인된 파일도 기록 없이 벤치 모드로 돌리고, 시작 줄에 bench mode 로 적습니다. - 서보 드라이브: 드라이브 모델 파일이 오류 코드(0x603F)를 PDO 로 매핑했으면, 알람으로 멈춘 축의
plem drive run --monitor상태에 그 코드가 나오고(axis0 fault (statusword 0x0238, error 0xff50)),Bus.reset()은 알람을 지우기 전에 축과 코드를 경고로 남깁니다. 버스 정지 때 남는 통신 알람(A6B 는 0xFF50)과 실제 드라이브 알람을 구별할 수 있습니다. - 설치·업데이트: 설치하거나 업데이트하면 시스템 로그를 디스크에 보관하도록 설정합니다. 기기가 멈추거나 재부팅된 뒤에도 이전 부팅의 로그(
journalctl -b -1)를 볼 수 있습니다. 로그는 루트 파일 시스템의 2 %(최대 2 GiB)까지 씁니다. 커널 패닉이 나면 멈춰 있지 않고 10초 뒤 스스로 재부팅합니다. - 펜던트: 셀 물체(평면·박스·구·원기둥·원뿔·메시)를 수치·3D 놓기·로봇 점 찍기·MoveIt
.scene(가져오기·내보내기)로 다루고 3D 핸들로 옮기고 돌리고 크기를 바꾸며 복제·되돌리기·삭제합니다. 끌면 20 mm 안의 바닥·옆 물체 면에 붙고 물체끼리 겹치면 빨갛게 보이며, 스냅은 10 mm·15° 단위입니다. 메시(STL·OBJ·GLB·DAE, 64 MB·삼각형 100만 개까지)는 조금 큰 충돌 모양으로 검사합니다. - 펜던트: 셀 물체 「여러 개 고르기」로 물체를 여럿 골라 X·Y·Z 축에서 최소 면·가운데·최대 면을 처음 고른 물체에 맞추거나, 3개 이상을 양 끝은 두고 같은 간격으로 놓습니다. 한 번에 저장되어 되돌리기 한 번에 돌아가고, 하나라도 로봇과 겹치면 전부 놓지 않습니다.
- 펜던트: 충돌 검사로 고른 셀 물체는 다시 시작하지 않아도 반영되어, 계획은 부딪히는 경로를 거부하고 Jog 는 물체에 다가가면 멈춥니다. 로봇의 지금 자세와 겹치는 곳에는 놓이지 않습니다(빨갛게 보이고 닿은 링크를 알림). 계획기가 꺼져 있을 때 저장한 물체는 검사 없이 저장되고 화면이 알립니다. 바닥은 꺼진 채 시작하니 설치 높이를 보고 켭니다.
- 라이선스: plem-server 에
/usr/share/doc/plem-server/BUNDLED-NATIVE-NOTICES가 생겼습니다. 메시용 coacd 에 든 제3자 네이티브 코드의 고지입니다. coacd 는 CoACD(MIT)를 수정해 빌드한 휠로 싣습니다 — Sobol 생성기를 자체 구현으로 바꿨습니다. - 펜던트: 셀 3D 뷰에 위·앞·옆에서 보기와 전체 맞춤 버튼이 생겼고, Job 실행 중에는 지금 노드 이름이 3D 위에 보입니다. 프로그램 탭만 볼 때는 오른쪽 아래 로봇 미리보기를 누르면 셀로 갑니다. 로봇 자세·F/T 값이 거의 그대로이고 카메라를 움직이지 않으면 3D 화면을 다시 그리지 않으며, 가려진 3D 화면과 미리보기는 그리지 않습니다.
- 펜던트: 이동이 경로 충돌로 계획에 실패하면 「경로가 ‘공급 상자’에 부딪힘, 42% 지점, 손목(링크 5)」처럼 부딪힌 물체(자기 충돌이면 링크)와 지점을 알리고, 그 노드에 [3D 에서 보기](물체·접촉점·그 순간 자세)와 [경유점 추가](그 자세의 경유점 이동을 앞에 넣고 목표 도구로 엶)가 붙습니다. 시뮬레이션에서 실패한 이동도 같습니다. 충돌이 아닌 실패는 종전 문장 그대로입니다.
- 펜던트: 관절 목표와 셀의 Waypoint 를 3D 에 반투명 목표 고스트로 미리 봅니다. 셀 Waypoint 섹션에서 점을 고르면 그 자세가 보이고 Jog 「목표」가 그 점(이름이 보임)이 되어, Jog 의 「누르는 동안 이동」으로 보냅니다. 관절값을 고치면 목표는 그 값이, 선택을 풀면 지금 자세가 됩니다. 이 이동의 속도는 서버 기본값 대신 Jog 속도를 따릅니다. 3D 왼쪽 위 칩이 무엇의 고스트인지와 이동 중인지를 알립니다.
- 펜던트: 셀 「로봇 설치」에서 베이스의 X·Y·높이·방향과 보호 바닥 높이를 고치면 3D 고스트로 미리 보이고, 셀에 저장되어 다음 기동부터 적용됩니다(기울기는 아직 없음). 보호 바닥은 충돌 모양의 최저점이 그 아래로 가면 멈추니 여유를 두고, 설치 높이보다 높으면 거부됩니다. 받침대(박스·메시)는 베이스 밑에 붙어 설치를 따르고 핸들로 끌고 돌립니다.
- 펜던트: 「다시 시작해야 적용」 안내 옆의 「로봇 스택 다시 시작」이
plem화면에서 S 키를 두 번 누른 것처럼 세션의 모든 로봇을 브레이크를 건 뒤 정지했다가 다시 띄웁니다. Job·Jog·캘리브레이션 구동 중이면 거절하고(Freedrive 는 못 막고 정지는 먼저 브레이크),plem화면 없이 띄운 스택에서는 꺼집니다. - 펜던트: Jog 의 「관절 목표」 탭이 「목표」가 되고 직교(TCP) 목표가 생겼습니다. 3D 핸들(이동·회전 중 하나, 이동 화살표는 툴 축)을 끌거나 X·Y·Z·Rx·Ry·Rz 를 적으면 서버가 푼 관절 자세가 고스트로 따라오고, 도달 가능·도달 불가·특이점 근처·이동 중을 색·아이콘·글자로 보입니다. 도달 불가면 이유가 보이고 이동이 잠깁니다.
- 서버 API:
GET /api/jobs·GET /api/jobs/{id}가started_at(마지막 실행 시작, epoch ms, 미실행null)을 다시 싣습니다. 시작과 보호 정지·재시작 뒤 체크포인트에서 이어하기가 갱신하고, 일시정지 뒤 재개는 바꾸지 않습니다. - 서버 API:
solve_tcp_target액션이 TCP 자세의 관절 해와 상태(도달 가능 · 도달 불가와 이유 · 특이점 근처 휴리스틱)를 돌려줍니다. 로봇은 움직이지 않습니다. - Lab: Run & capture 가 저장되면 Simulation 탭에 「Run saved」 알림이 뜹니다. 같은 자극의 이전 런이 있으면 「Compare with previous」로 두 런을 바로 비교하고, 없으면 「Open in Runs」로 새 런을 엽니다.
- 설치·업데이트: RT 설정 마법사(
setup/rt/setup.sh)에 메뉴 5 가 생겼습니다. 커널에 꺼져 있는 USB-CAN(gs_usb 호환)·USB-시리얼(CH340/CH341, PL2303) 어댑터 드라이버를 실행 중인 커널(RT·일반)과 같은 판의 원본 소스로 기기에서 빌드해, 어댑터의 USB ID 로 자동 로드되도록 설치합니다. 메뉴 2 가 드라이버가 있는지 확인합니다.
개선·변경89
- 펜던트: 펜던트와 서버가 지어 주는 이름은 화면 언어와 상관없이 영어입니다. 새 노드("Start"·"Move Gripper"), 사본("<이름> copy"), 경유점 이동("<노드> via"), 새 셀의 바닥("Floor"), 셀 IO 의 그리퍼 장치 신호("arm1 gripper holding"), AG-95 설정 칸("Device ID")이 그렇습니다. 이미 있는 이름은 바뀌지 않습니다.
- 펜던트: 선 잇기는 끌기·두 번 누르기·선 끝 옮기기가 같은 규칙을 씁니다. 카드 몸통에 놓아도 이어지고, 못 잇는 곳 위에서는 이유가 손가락 위에 뜨며, 빈 슬롯의 선을 빈 곳에 놓으면 추가 창이 열립니다. 대상 바꾸기·선 출발 옮기기는 되돌리기 한 번에 돌아가고, 노드를 반복·병렬에 넣고 뺄 때 끊길 선이 미리 보입니다. 반복 안 노드를 반복 머리에 이어 끝내던 것은 바닥 「반복 나가기」 칸으로만 합니다.
- 펜던트: 노드를 한 번 누르면 값 창이 열리고, 칸이 기본 · 고급(접힘) · 값 연결(접힘)로 놓입니다. 숫자 칸은 −/+ 나 Enter · 다른 곳 누르기로 확정되고, 확정할 수 없는 입력만 같은 노드를 다시 열 때 남아 있습니다. 잘못된 값은 칸 아래 한 줄로, 넘치는 칸 설명은 「더 보기」로 보이며 모든 스킬 노드가 같은 틀을 씁니다.
- 펜던트: 그리퍼 노드의 결과 이름이 「잡힘 · 위치 도달 · 놓침」으로 짧아지고, 「수동 트리거」 노드는 노드 패널과 새 노드에서 「시작」이라 불립니다. 저장된 연결과 실행은 그대로입니다.
- 펜던트: 「프로그램」 화면 배치를 바꿉니다. 왼쪽 막대는 목록·노드·구조·변수·로봇·캘리브 한 단계이고 누르면 패널이 캔버스 위에 뜹니다. 분할 경계는 선 자체를 끌고, 노드 상세는 셀 칸을 줄이며 캔버스 오른쪽에 열립니다. 확인창이 떠도 「정지」는 눌립니다.
- 펜던트: 캔버스 카드를 새 틀로 그립니다. 노드 종류 아이콘 타일(분류색)과 아이콘 붙은 핵심 값 칩(두 개까지)이 보이고, 실행 중·완료·오류 같은 상태는 테두리와 배지로 함께 보입니다. 연결이 끊긴 작업 화면의 카드는 회색으로 흐려지고, 조건 노드의 출구와 비교는 「예 · 아니오」로 보입니다. 카드가 커져 이전 버전에서 촘촘히 놓은 노드가 겹쳐 보이면 끌어서 옮기세요.
- 펜던트: 프로그램 캔버스의 반복 상자를 새로 그립니다. 머리 왼쪽의 − 3번 + 와 유형(횟수·계속·조건)을 바로 고치고, 바닥의 「↻ 반복 처음으로」「⇥ 반복 나가기」 칸에 선을 잇습니다. 반복 조건 고르기는 변수만 보이고 목록 밖 식은 고치지 않고 그대로 둡니다.
- 펜던트: 캔버스 선이 둥근 직각으로 그려지고, 선을 누르면 위에 뜬 🗑 로 지웁니다(되돌리기 가능). 반복 횟수·조건식·레인 이름·case 이름 칸은 Enter 나 칸을 떠날 때 한 번에 저장되어 되돌리기 한 번에 돌아옵니다. 캔버스 편집은 배율 1 이상에서만 됩니다.
- 펜던트: 노드 추가가 맨 위 검색이 있는 팝업 하나로 모였고 넣을 수 없는 항목은 빠집니다. 빈 출구 + 로 넣은 노드는 출구 높이에 놓여 값 창이 열리고, 선의 + 는 그 선 사이에 끼웁니다. 노드 패널은 누르면 잇지 않고 화면 가운데에 놓으며 반복·조건·병렬은 「로직」에 있습니다. 팝업은 목록이 다 보이는 자리에 열리고, 왼쪽 아래 보기 단추 한 줄(− 배율 + 맞춤 정리)의 「정리」가 노드를 왼→오로 줄 세웁니다.
- 펜던트: 실행 중인 Job 화면이 실행 중인 노드를 따라갑니다. 노드가 바뀔 때만 한 번 옮기고 반복·병렬 틀은 따라가지 않으며, 화면 고정 핀은 없어졌습니다. 캔버스 위 Job 띠가 결과·멈춘 자리·걸린 시간을 한 줄로 보이고, 누르면 그 노드나 오류 목록으로 갑니다.
- 펜던트: 반복 머리에 진행(「2/5 ●●○○○」·「2번째」)이 보이고 새 회차에는 안쪽 노드 표시가 대기로 돌아갑니다. Job 띠의 편집은 Job 에서 누른 노드를 원본에서 고른 채 엽니다. 화면에서 「배포」라는 말이 없어져 단추는 「실행」·「실행 정지」, 상태는 「실행 전」입니다.
- 펜던트: 보호 정지 복구 대기의 하단 바에서, 재개 기준 자세와의 차이 옆 ⓘ 가 화면 폭과 상관없이 늘 보입니다. 잘린 문장과 이동 결과를 ⓘ 를 눌러 펼쳐 봅니다. 펜던트는 가로 화면 전용(최소 폭 1024)입니다.
- 펜던트: Jog 패널의 「수동 조작」과 「세션 해제」가 한 버튼으로 합쳐졌습니다. 켜져 있으면 「수동 조작 끄기」이고, 해제가 확인되지 않았을 때 누르면 해제를 다시 시도합니다. Jog 패널의 로봇 이름은 없어졌고 헤더의 로봇 선택이 대상 로봇을 보입니다.
- 센서: ZED 카메라 설치(
zed-setup)가 ZED SDK 5.5, ZED ROS 2 노드 v5.5.0, GMSL2 드라이버 1.4.4 를 씁니다. 카메라 IMU 토픽 지연이 크게 줄었습니다. 이미 설치된 드라이버는 커널 종류(일반/RT)가 맞으면 다시 실행해도 그대로 두며, 새 버전은 「재설치」(--force-reinstall)로 받습니다. wrapper 빌드 위치로 PLEM 워크스페이스를 지정하면 설치 전에 멈춥니다. - 로봇: Jog 가 벤더와 관계없이 모든 로봇(Huayan Elfin 포함)에서 새 Jog 엔진으로 돌아갑니다. MoveIt 없이 띄워도 Jog 할 수 있지만 그때는 셀 물체를 피하지 않습니다. 회전 Jog 는 TCP 를 중심으로 돌고, 툴 축 Jog 는 그 축을 따라 곧게 갑니다.
- 로봇: 그리퍼 상태 보고가 없는 구성(예: Elfin + RG6)에서 Jog 를 쓰려면 로봇 프로필에
gripper_state_source: full_range를 적습니다. 없으면 Jog 만 꺼지고 로봇은 정상으로 뜹니다. - 로봇: Jog 가 셀의 보호 바닥 앞에서도 다른 물체처럼 늦춥니다.
- 펜던트: Jog 버튼이나 3D 핸들을 놓아도 수동 조작은 이어져 다시 누르면 곧바로 움직입니다. Jog 상태 줄 한 곳이 멈추거나 늦춘 이유(충돌 근접·특이점·관절 한계·정지 사유)와 다음 할 일을 보이고, 이상 정지 뒤 첫 누름(핸들은 잡기)은 「다시 시작하는 중」 뒤에 움직입니다. 서보 초기화 버튼은 없어졌습니다.
- ROS 2:
joint_target_stream_controller가 모든 내장 로봇 모델에 비활성으로 뜹니다. 실측값이 없으면joint_limits.yaml의max_acceleration(저크 = 가속 ÷ 0.05 s)을 쓰고 한 번 경고하며, 값이 없거나 잘못되면 기동을 거부합니다.controller_config_file에는 이 절(경계값 포함)이 있어야 합니다. - 펜던트: 정지 버튼이 셀의 모든 로봇을 멈춥니다. 한 로봇이 응답하지 않아도 다른 로봇은 바로 멈추고, 브레이크를 확인하지 못한 로봇이 있으면 로봇별로 알립니다.
- 설치·업데이트: 프로그램·작업·Waypoint·변수가 셀에 속합니다. 업데이트 뒤 첫 기동 때
~/.plem/<첫 로봇>/의 자료를~/.plem/cell-state/default/로 옮깁니다.PLEM_DEVICE_ID는 자료 위치를 더는 바꾸지 않습니다. - 그리퍼: 프로그램의 그리퍼 노드가 「그리퍼 제어」 하나로 합쳐졌습니다. 예전 OnRobot RG6 그리퍼 노드로 만든 프로그램은 열거나 실행할 때 폭·힘·결과 연결을 그대로 둔 채 그리퍼 제어 노드로 바뀌고, 다음 저장 때 새 형식으로 저장됩니다.
- 펜던트: 그리퍼 노드의 폭·힘 슬라이더 범위가 장착된 그리퍼 사양을 따르고(RG6 160 mm·25–120 N), 힘은 실제로 잡는 힘으로 보입니다(0 은 최대 힘). 폭·힘이 범위를 넘거나 로봇에 그리퍼가 없으면 노드 이름과 함께 배포를 거부합니다. 시뮬레이션은 그리퍼가 없어도 됩니다.
- 펜던트: 「누르는 동안 이동」에서 버튼을 놓으면 급정지하지 않고 진행 방향을 따라 부드럽게 감속해 멈춥니다. 멈출 때까지 버튼은 「정지 중」으로 잠깁니다. 부드럽게 멈출 수 없으면 종전처럼 즉시 멈추고, 소프트 정지 상태를 확인할 수 없으면 브레이크를 겁니다.
- 펜던트: Waypoint 는 셀의 Waypoint 섹션 한 곳에서 저장·이름 변경·현재 위치로 갱신·삭제·검색합니다. 사이드바의 Waypoint 목록은 없어졌고, 행의 「이 위치로 이동」은 점을 고른 뒤 Jog 의 「누르는 동안 이동」으로 대신합니다. Waypoint JSON 내보내기는 없앴습니다. 사이드바 로봇 › 설정은 탭 줄과 「로봇 (n)」 머리 없이 바로 보입니다.
- 펜던트: 「현재 위치 저장」 이 이름을 묻지 않고 P1, P2 … 처럼 짧은 이름으로 바로 저장하고, 그 행을 이름 고치기로 엽니다(Enter 로 새 이름, Esc 로 그대로). 하단 바 「위치 저장」 의 자동 이름도 wp_날짜_시각 대신 P 번호입니다. 이미 있는 이름은 바뀌지 않습니다.
- 펜던트: 「누르는 동안 이동」의 결과가 「도달」·「취소됨 — 서버 문장」·「이동하지 않음 — 이유」·「실패 — 이유」로 보입니다. 떼었는데도 도착했으면 「도달 — 서버 문장」입니다. 다른 동작이 로봇을 쥐고 있으면 「다른 동작이 로봇을 쓰는 중」과 그 보유자를, 손을 뗀 뒤 감속하는 동안 로봇이 BRAKED 가 되면 「정지됨」을 보입니다.
- 펜던트: 작업의 「설계」·「실행」이 「프로그램」 한 목록이 됐습니다. 실행 중인 Job 은 맨 위, 끝난 Job 은 그 프로그램 아래(최근 3건, 화살표로 접기), 원본 없는 Job 은 맨 아래에 있고 프로그램은 최근 실행 순입니다(옛 Job 을 다시 실행해도 그 프로그램이 위로 올라옵니다). Job 목록의 날짜 묶음과 프로그램 필터(「배포 Job N개 보기」)는 없어졌습니다.
- 펜던트: 실행 중이 아닌 Job 화면에서 그 Job 의 내용을 시뮬레이션하고(끝난 시뮬레이션은 「다시 시뮬레이션」), 캔버스 위 띠의 연필로 원본 프로그램을 엽니다. ▶ 를 눌러도 왼쪽 패널이 열리거나 실행 목록으로 바뀌지 않습니다.
- 펜던트: Job 화면 띠가 자물쇠와 「읽기 전용」으로, 화면 고정·따라가기가 핀 아이콘으로 바뀌었습니다. 실행 목록 머리는 「실행 중 n」, 원본을 지운 Job 은 「원본 없음」으로 표시하고, 완료 배지의 슬롯 이름과 패널의 부연 문구는 없앴습니다. 버튼이 잠긴 이유는 하단 바에 글자로 보입니다.
- 펜던트: Jog 목표가 고정하기 전까지 로봇의 지금 자세(직교는 지금 TCP)를 따라가고, 「현재 자세 읽기」 버튼은 없어졌습니다. 값을 바꾸거나 Waypoint 를 고르면 고정되고, 「지금 자세로」를 누르거나 이동이 도달·실패로 끝나면 다시 따라가고, 손을 떼는 등 취소로 끝나면 목표가 남아 다시 누르면 그 목표로 이어 갑니다.
- 펜던트: 관절 목표의 입력 범위가 로봇 모델(URDF)의 관절 한계를 따릅니다(종전 모든 관절 −180°~180°). 한계 밖 값은 범위를 적어 거부합니다.
- 펜던트: 상단의 [프로그램 | 셀] 탭으로 프로그램 편집과 3D 화면을 오가고, 분할 버튼으로 둘을 나란히 봅니다. 분할 경계를 끝까지 밀면 그 칸이 접히고, 두 번 누르면 반반이 됩니다. 마지막 화면은 펜던트를 다시 열어도 그대로이며, 헤더의 3D 뷰 펼치기 버튼은 없어졌습니다. 셀 탭에서는 왼쪽 패널이 잠시 접혀 3D 가 넓어지고, 프로그램으로 돌아오면 다시 열립니다(셀에서 직접 열면 그대로 둡니다).
- 로봇: EtherCAT 장치가 필요한 PDO 항목을 매핑하지 않아 로봇이 시작되지 않으면, 로그가 어느 장치의 어떤 항목이 없는지와 장치 펌웨어 버전을 확인하는 명령을 알려 줍니다. 종전에는 원인 후보만 나열했습니다.
- 로봇: indy7_v3 실측 기구학의 링크 변위 허용 한도를 12 mm 에서 13 mm 로 넓혔습니다. 그에 맞춰 경로 계획의 링크 충돌 여유도 링크마다 1 mm 커집니다.
- 로봇: Indy7 툴 플랜지 LED 가 로봇 상태를 색으로 보여 줍니다 — 대기(브레이크 체결) 흰색, 궤적 실행 초록, 핸드 가이딩 파랑, 보호 정지 빨강. 종전에는 브레이크를 풀면 꺼지고 체결하면 빨간색으로 깜박였습니다. PLEM 이 돌지 않거나 통신이 끊기면 보드 기본값인 어두운 빨간색 깜박임입니다.
- 서보 드라이브:
plem drive run의 호스트 경고(RT 커널 아님·격리 CPU 없음·nvpps TSC 잠금)가 고치는 방법(PLEM 공개 저장소의 설정 위저드setup/rt/setup.sh메뉴 1,sudo plem-nvpps-tsc-unlock)을 함께 알립니다. - 서보 드라이브: 드라이브 벤치·
plem drive run·RT 설정 위저드의 안내 문구를 다듬었습니다. 벤치가 중단되면 통과 조건을expected:로 표시하고, 위저드는 화면과 같은 「menu N」으로 단계를 가리키며, RT 권한·EtherCAT 활성화 실패 메시지가 고치는 방법을 함께 알립니다. - 서보 드라이브: 드라이브 모델 파일의
mode_display_timing을 빼면pre_enable로 읽습니다. 기존 파일의 승인은 그대로입니다. 활성화한 뒤에야 모드를 표시하는 드라이브는 해제가 거부되고, 그 메시지가 해당 축에post_enable을 쓰라고 알려 줍니다. - Lab:
rt_raw신호 이름표가 바뀐 필드 이름(actual_position·command_torque등)을 따릅니다. 저장한 대시보드·런·내보내기는 그대로 열립니다. - 서보 드라이브: 벤치가 CiA 402 상태를 전체 이름(
SWITCH_ON_DISABLED·READY_TO_SWITCH_ON·OPERATION_ENABLED등)으로 적습니다. - 서보 드라이브: 벤치의 승인 단계가 거부할 때 문구가
drive_model_tool approve:로 시작합니다(종전plem-drive approve:는 없는 명령이었습니다). - 서보 드라이브:
plem drive run --plot은 실행하는 버스의 축으로 PlotJuggler 레이아웃을 만듭니다(축마다 위치, 모든 축의 속도·토크, 루프 타이밍, 버스 상태). 두 축 거울 짝의 sync 탭은a6b_pair예제의plotjuggler.xml에 있어 PlotJuggler 에서 불러옵니다. - 서보 드라이브: 안내·오류 문구가 명령을
plem drive run·plem drive check로 적습니다.plem명령 없이 쓰는 이름은plem-drive <verb>입니다. - 서보 드라이브:
PLEM_LOG_LEVEL에 모르는 값(예:verbose)이 있으면 말없이 info 로 두지 않고 허용 이름과 함께 알립니다.plem drive run은 기동 전에 알리고 그 값을 무시합니다. - TUI: settings.yaml 의
log_level이 설정 화면에서 고를 수 있는 네 값(err·warn·info·debug)이 아니면 TUI 로그에 한 번 남기고 info 로 둡니다. 종전에는 그 밖의 값이 화면과 ROS 로그 레벨에서 서로 다르게 읽혔습니다. - 개발자 SDK: PLEM 로그는 출력 대기열이 가득 차면 기다리지 않고 가장 오래된 미출력 줄을 버리며, 종료할 때 버린 줄 수를 표준 오류에 남깁니다. PLEM 라이브러리를 올린 프로세스의 다른 spdlog 로거와 설정은 건드리지 않습니다.
- TUI: 로봇 제어 화면을 세 칸(로봇·관절 이동 | 로그 | SYSTEM)으로 바꿨습니다. 맨 아래 상태줄이 실행 중(선택한 로봇의 모드를 글로)·보호 정지·EtherCAT 끊김과 정지 진행 단계를 알리고,
[·]는 왼쪽 열·SYSTEM 칸을 보이거나 숨깁니다. 웹 화면 주소는 SYSTEM 의 WEB 에 있고, 관절은 J0·J1…, 이동 버튼은 Move 입니다. - TUI: 시작 화면(Start session)을 세 칸(로봇 | 세션 구성 | Preflight)으로 바꿨습니다. 구성 요소 이름은 Motion planning·Camera·Collision avoidance 이고, 지난번에 시작한 로봇을 미리 골라 둡니다(지워졌으면 첫 로봇). Camera quality 프리셋은 Balanced 처럼 읽기 쉬운 이름으로, 설명은
Sees up to 3 m · 5 cm detail한 줄로 보입니다. - TUI: Tab 으로 옮긴 포커스가 모든 화면에서 cyan 바탕으로 또렷이 보이고, 체크 상자는 정사각형으로 그립니다.
- TUI: 설정 화면(
,)을 세 칸(SETTINGS | 로봇 목록 | 구성)으로 바꿨습니다.e편집·n새 로봇은 오른쪽 칸의 폼으로 열리고(ctrl+s저장·esc취소), 저장 전에는 상태줄에● Unsaved changes가 뜹니다. 폼 항목 이름은 Model·Controller·F/T sensor 입니다. 100칸보다 좁으면 SETTINGS 칸이 접히고g로 Robots 와 General 을 오갑니다. - TUI: 카메라 시리얼은 로봇 폼의 CAMERA › Serial 에 넣고, 로봇 상세에도 Serial 로 보입니다.
- TUI: 색을 새 팔레트(짙은 남회색 배경, 성공 초록·경고 노랑·오류 빨강)와 cyan 강조색 하나로 바꿨습니다(안전·모드 색의 뜻은 그대로). 키는 라벨 속 글자에 색으로 표시합니다(
release brake·end freedrive·stop, 복구는 빨간Recover). - TUI: 로봇을 켤 때 이 TUI 가 이전에 띄웠다가 남긴 프로세스만 정리합니다. 다른 곳에서 띄운 프로세스는 — ROS 노드든 포트·EtherCAT 버스를 쥔 것이든 — 강제 종료하지 않고 이름과 PID 를 보여 주며 plem kill 을 안내합니다.
- TUI: 실행 화면 로그에는 launch 의 경고·오류와 고장 줄(traceback·
Failed to reserve master)만 보입니다. INFO 줄은 TUI 로그 파일에만 남고, 기동할 때 그 파일 경로를 한 줄로 알려 줍니다. 시끄러운 launch 가 화면 입력을 붙들던 지연도 줄었습니다. - TUI: 실행 중에 프로세스가 죽으면 그 프로세스가 마지막에 찍은 레벨 없는 줄(최대 5줄)을 사망 줄 앞에 함께 보여 원인 문장이 남습니다.
- TUI: 같은 경고가 30초 안에 반복되면 한 번만 보이고, 30초가 지나면 그 줄을 「(xN more in 30s)」와 함께 다시 보여 그사이 반복 횟수를 알립니다(반복이 멎어도 개수가 나옵니다). 로봇의 RT 이벤트(
[RT]) 반복도 5초 창으로 같은 방식으로 셉니다. - TUI: 로그의 경고는 주황, 오류는 빨강으로 보이고, 프로세스 사망·traceback·
Failed to reserve master줄은 ✖ 를 붙인 굵은 빨강이라 일상적인 오류 줄 사이에서도 눈에 띕니다. - TUI: RViz·PlotJuggler 출력도 같은 기준으로 걸러 경고·오류와 비정상 종료 줄만 보입니다. RViz 안의 프로세스가 죽으면 마지막 레벨 없는 줄을 사망 줄 앞에 함께 보이고, PlotJuggler 의 레벨 없는 출력은 경고 바로 뒤에 이어진 줄이 아니면 TUI 로그 파일에만 남습니다.
- TUI:
plem실행 때의 업데이트 안내·워크스페이스 질문,plem workspace·plem init·plem kill의 안내와 오류,plem init이 만드는 README 가 영어로 나옵니다. - 문서: F/T 센서 안내를 단계별 절차로 다시 쓰고, 펜던트의 F/T 칩·상세 카드·영점·Payload 측정 화면을 함께 실었습니다.
- 문서: ROS 2 통합·정지·안전·서보 드라이브 문서를 절차와 표로 정리하고, 브레이크 직접 해제 조건, 모델별 궤적 도달 허용치, 드라이브 준비 절차, 패키지를 받을 수 있는 기기(토큰으로 등록한 Jetson)를 현재 동작대로 고쳤습니다. 메뉴 이름은 「서보 드라이브 연결하기」·「서보 드라이브 실기 검증」입니다.
- 문서: Teaching Pendant 안내에서 Job 정지가 감속 없이 멈추고 브레이크는 걸지 않는다는 점을 바로잡고, 실행·로봇 움직이기·프로그램·캘리브레이션 쪽을 단계별 절차와 표로 다시 썼습니다. 위치 저장, Waypoint 이름 변경과 사용 중 삭제, 반복·병렬 상자, 로봇 편집 화면을 새로 실었습니다.
- 문서: 라이선스 잠금 페이지 이름을 지금 화면(PLEM is locked)에 맞추고, 라이선스 파일·기기 키를 잃었을 때의 복구,
plem uninstall옵션, 인식 프로파일 미리보기, 플러그인.so경로 고르기를 실었습니다. 문제 해결·TUI·Lab 안내는 단계별 절차와 표로 정리했습니다. - 문서: 공개 문서 사이트를 영어로 쓰고 한국어판을
/ko/에 둡니다. 위쪽 언어 메뉴로 바꿉니다. Teaching Pendant 스크린샷은 그 페이지 언어의 화면이고, 에이전트용 색인(llms.txt)은 영어입니다. - 라이선스: 드라이브 계층
plem-drive(6패키지와 그 설치 파일)와plem명령의plem-cli가 Apache License 2.0 으로 바뀝니다./usr/share/doc/<패키지>/에 계약 전문 대신 Apache-2.0 요약과NOTICE가 실립니다. 다른 PLEM 패키지는 그대로입니다. - 라이선스: 라이선스 계약이 판 1.2 로 바뀌어, 회사가 오픈소스 라이선스로 제공한다고 표시한 공개 구성요소에는 계약 대신 그 라이선스가 적용됩니다(제1조 제10호·제8조의2).
- Lab: 런 자동 이름이 같은 컨트롤러의 직전 런 대비 바뀐 게인을
kp[0] 200→400꼴로 보여 줍니다(최대 2개, 나머지는 +N). 직전 런이 없거나 바뀐 게인이 없으면 게인을 생략합니다. 이미 저장된 런 이름은 바뀌지 않습니다. - Lab: 화면의 게인 이름을
kp[0]한 형식으로 맞췄습니다(튜닝 패널·수렴 리포트·Runs 게인 표·게인 스윕). 이름에 마우스를 올리면 ROS 파라미터 이름(kp.j0)이 보이고, 내보내기 파일(CSV·JSON)은 계속 ROS 파라미터 이름을 씁니다. - Lab: 숫자 표시를 한 규칙으로 맞췄습니다. 측정값은 유효숫자 3자리, 게인·속도 상한은 6자리, 시각·재생 위치·궤적 길이·관절각은 소수 둘째 자리입니다.
- Lab: 튜닝 패널의 Apply 버튼은 보낼 값이 있을 때만 채워지고, 튜닝이 잠기면 입력칸과 함께 흐려집니다.
- Lab: Experiment 의 Shape 목록에서 Ramp 를 뺐습니다. Ramp 는 Rise 를 이동 시간으로, Hold 를 0 으로 둔 Step 과 같은 자극입니다. 이전에 저장한 Ramp 런은 그 Step 으로 표시되고 같은 Step 런과 같은 자극으로 비교됩니다.
- Lab: 임계 밴드 폼의 Immediate 체크박스를 없앴습니다. Dwell 을 0 으로 두면 조건에 맞는 첫 표본 하나로 판정합니다. 저장된 밴드와 템플릿은 그대로 동작합니다.
- Lab: 화면 스타일을 다듬었습니다. 강조색이 회사 브랜드 블루로 바뀌고, 그래프 선 색은 다크·라이트 테마마다 서로 잘 구별되는 색으로 나뉩니다. 섹션 제목과 탭은 대문자 대신 문장형으로, 고정폭 글꼴은 수치·신호 이름에만 씁니다. 녹화 중 표시와 수렴 밴드는 더 이상 경고색(빨강)으로 그리지 않습니다 — 녹화 중 표시는 빨간 점만, 밴드는 위반 감시 밴드만 빨강입니다.
- Lab: Runs 의 Inspect·Compare 화면을 덜어냈습니다. 게인 표는 런 사이에 다른 게인만 보이고(바뀐 칸 강조, 「Show all gains」로 전체), 자극 불일치는 배지 하나로 알립니다. 「Remove start offset」 체크박스는 「Zero start」 토글이 됐습니다.
- Lab: Runs 지표 표는 step 이면 Rise·Overshoot·Settle·Steady state·Chatter, sine 이면 Amp·Phase·RMS, 그 밖은 Mean·RMS 를 먼저 보이고 나머지는 「More」 뒤에 둡니다. 값은 유효숫자 3자리(소수점 아래 최대 6자리), 방향이 정해진 지표의 Δ 는
(-40%)꼴입니다. - Lab: Runs 의 결과 줄과 Gain sweep 은 첫 번째로 그린 신호를 따릅니다. Gain sweep 은 게인 하나만 다른 런을 3개 이상(튜닝이 잠긴 런 제외) 고를 때만 나옵니다.
- Lab: Simulation 탭의 「Send to robot」 버튼이 Run & capture 아래의 작은 「Move without recording」 버튼으로 바뀌었습니다. 기록 없이 이동만 하는 동작은 같습니다.
- Lab: 글자 크기를 데이터 12px·화면 요소 13px·제목 15px 세 단계로 맞췄습니다(10·11px 제거). 그래프 축과 밴드 라벨도 12px 입니다. 버튼·탭은 키보드로 이동할 때만 강조색 실선 포커스 윤곽선이 보입니다.
- 설치·업데이트: RT 설정 마법사가 Wi-Fi 국가 코드를 시간대로 짐작해 바꾸지 않습니다(설정된 값은 그대로). 내용이 있는 실행 로그는 종료 뒤에도 남고 경로가 보이며, DTB 를 고치기 전 이전 파일을
/boot/dtb/.plem-bak-<이름>에 남깁니다. - 설치·업데이트: RT 설정 마법사의 EtherCAT 마스터 설치(메뉴 3)가
/dev/EtherCAT*를 모든 사용자가 아닌realtime그룹만 열 수 있게(0660) 설정합니다. 그 전에 그룹을 만들고 실행한 사용자를 넣으며, 새로 들어갔다면 다시 로그인해야 합니다. 메뉴 2 가 장치 권한과 가입을 확인합니다. - 설치·업데이트: RT 설정 마법사(
setup/rt/setup.sh)의 판정 문구가 측정한 것만 말합니다(격리 시험 통과의 "fully isolated", 부하 시험 중 EtherCAT 상태 변화의 원인 단정을 뺐습니다). - 서보 드라이브: 벤치의 기동 실패 원인 목록과
plem drive run의 미승인 안내 문장을 다듬었습니다(동작은 그대로). - 서보 드라이브: EtherCAT·드라이브 계층의 오류·경고 문구 일부(CiA 402 전이 표 검사, stored_sdo 불일치 안내, 모델 파일 크기 초과, 정지 뒤 브레이크 미확인, 메이저 페이지 폴트 보고)를 짧고 정확하게 고쳤습니다. 문구를 그대로 찾는 스크립트는 새 문구에 맞춥니다.
- 서보 드라이브:
move_to(profile=)의 사용자 프로파일은 이제 점마다 축별 위치와 속도를 담고 시간이 늘어나야 하며, NaN 이 있으면 보내기 전에 거부됩니다. 위치만 담은 궤적은 더 이상 받지 않습니다. - 서보 드라이브:
cst축이 섞인 버스는 벤치의stop-decel을 하지 않습니다(NA). 그 버스의 정지는 램프가 아니라 즉시 disable 이라 램프 감속으로 승인하지 않습니다. 이 항목을 담은 이전 승인은 그대로 유효합니다. - 설치·업데이트: RT 설정 마법사 메뉴 4(jitter 측정)는 격리 CPU 에서 제어 루프 같은 사용자 RT 스레드가 돌고 있으면 측정을 거부합니다. 우선순위 99 의 측정이 그 루프를 밀어내고 루프를 재게 되기 때문입니다. 앱을 띄우기 전에 실행하세요.
- plem code: 로봇 스택 기동 승인 창에 기본값과 다르게 지정한 옵션(MoveIt·카메라 스택과 인식 프로필·충돌 회피·펜던트·Lab)이 값과 함께 표시됩니다. 기본 구성이면 지금처럼 로봇과 master 만 보입니다.
- 캘리브레이션: 캘리브레이션 뒤 관절 제안 보정값(Δq)을 계산하는 분석이 더 빨리 끝납니다. 계산 내용은 같아, 내부 시간 제한 안에 끝나는 분석의 결과는 종전과 같습니다.
수정103
- 펜던트: Job 을 정지해 중단된 노드에 운영자가 정지했다고 표시됩니다. 전에는 보호 정지나 일반 노드 실패로 표시됐습니다.
- 서버 API: 임시 Job(시뮬레이션 등)의
GET /api/jobs/{id}가 항상completed로 답하던 문제를 고쳤습니다. 이제 실행이 끝난 상태(success·failure·stopped·error·waiting_for_operator)를 돌려주고, 시작 전에는saved, 서버 재시작으로 실행을 잃었으면error를 돌려줍니다. - 설치·업데이트: RT 설정 마법사의 EtherCAT 설치(메뉴 3)가 C 컴파일러(
cc)나make가 실제로 없으면 빌드 전에 멈추고 복구 명령을 알려 줍니다. 전에는 패키지가 설치된 것으로만 보고 넘어가 빌드 단계에서 원인이 드러나지 않는 오류로 실패했습니다. - 펜던트: 짧은 Job 이 끝난 직후 하단 바의 실행 상태가 「완료」에서 「실행 중」으로 되돌아가고 재실행 대신 일시정지·정지 버튼이 보이던 문제를 고쳤습니다. 다른 기기가 같은 Job 을 다시 시작하면 그대로 「실행 중」으로 바뀝니다.
- 설치·업데이트: 원격 지원(
plem remote)을 여러 기기에서 동시에 열 수 있습니다. 종전에는 한 기기가 원격 지원 중이면 다른 기기의 연결이 거부됐습니다. 원격 지원을 열 기기만 업데이트하면 됩니다. - 펜던트: 다른 로봇에 포커스가 있어도 작업(Job) 화면의 실행·재실행·시뮬레이션·이어서 실행은 작업 내용을 받은 뒤부터 그 작업 로봇의 보호 정지(작업이 보고한 것 포함)로 잠기고, 이어서 실행의 시작 위치도 그 로봇의 자세로 판정됩니다. 작업 내용을 받기 전이나 받지 못했으면 포커스 로봇 기준입니다. 작업이 보고한 보호 정지는 로봇 전환기와 3D 이름표에도 보입니다.
- 펜던트: 모드 전환이나 오류 리셋이 거절되면 고정 문구 「서버 미연결」 대신 거절 이유 전체를 알림으로 보입니다. 서버에 닿지 못한 오류 리셋도 알림으로 보이고, 모드 전환이 거절되면 수동 조작(Jog)을 시작하지 않습니다.
- 로봇: b0 튜닝이 끝난 뒤 정지 명령이 오기 전까지 대상 관절 토크가 0 Nm 이 돼 브레이크가 풀린 자세에서 처질 수 있던 문제를 고쳤습니다. 이제 튜닝이 끝나면 그 관절이 바로 평소 제어로 돌아가 자세를 지지합니다.
- 개발자 SDK: 토크 제어 플러그인 파라미터에 NaN·무한대, 선언한 범위 밖 값, 파라미터 타입(float·정수)이 담을 수 없는 값을 보내면 적용하지 않고 거절로 답합니다. 종전에는 그런 값이 그대로 적용돼 모든 관절이 0 Nm 이 되고 보호 정지로 떨어질 수 있었습니다. 범위를 NaN·무한대나 min > max 로 선언한 플러그인은 로드하지 않습니다.
- TUI:
plem kill이 셸에서 직접 띄운 ROS launch(MoveIt 데모 등)를 끝내지 않습니다. 같은 터미널의 다른 작업도 그대로 둡니다. 다만 파일 이름이robot.launch.py처럼 PLEM 것과 같은 launch,bash -c로 감싸 띄운 launch, PLEM 스택과 한 명령으로 함께 띄운 것은 정리합니다. - 펜던트: 「현재 위치 저장」이
@로 시작하는 Waypoint 이름을 거절합니다(그 이름의 노드가@를 뗀 다른 Waypoint 로 움직이던 문제 수정). 이미 그렇게 저장된 Waypoint 는 업데이트 때@를 뗀 이름으로 바뀌고 그 Waypoint 를 쓰던 노드는 새 이름을 따라갑니다. 그 이름이 이미 있어_2등이 붙은 경우, 그것을 쓰던 노드는 실행 때 거절되니 Waypoint 를 다시 고릅니다. - 센서:
zed-setup이 JetPack 7(Ubuntu 24.04·Jazzy) 기기에서도 ROS 의존성 단계를 설치하고, 일반 커널과 PREEMPT_RT 커널 모두에서 기기에 맞는 GMSL2 드라이버 파일을 찾습니다(JetPack 7.2 일반 커널에서 드라이버를 찾지 못해 멈추던 문제 수정). - 로봇: 멈춰 있다가 시작하는 직교·관절 Jog 가 0.1 초에 걸쳐 속도를 올립니다. 시작 직후 TCP 속도가 상한을 넘던 정도가 줄었고, 주로 높은 Jog 속도에서 줄었습니다. 낮은 속도에서는 여전히 상한을 다소 넘을 수 있습니다.
- 로봇: 툴 회전 Jog 처럼 한 관절만 움직이는 Jog 에서 멈춰 있어야 할 손목 관절이 주기적으로 약 1 mrad 씩 튀어 생기던 손목 떨림을 없앴습니다.
- 펜던트: Jog 노드가 뜨지 못한 로봇에서 수동 조작을 누르면 「조그 노드가 실행 중이 아닙니다」가 바로 보입니다. 상태 줄의 「수동 조작 꺼짐」은 초록 표시 대신 중립 표시입니다.
- 펜던트: 셀의 둘째 로봇도 자기 그리퍼·F/T 가 보여, 그 로봇 대상 그리퍼 노드 배포와 그리퍼 초기화가 「그리퍼 없음」으로 거부되지 않습니다.
- 로봇: Jog 직후의 자율 캘리브레이션·
plem code이동·Plem Lab 궤적이 꺼진 궤적 컨트롤러로 가지 않습니다. 레인을 바꾸는 동안 목표 이동 버튼을 놓으면 움직이지 않습니다. - 펜던트: Jog 버튼을 누른 채 다른 창으로 가거나 화면이 가려지면 그 Jog 가 멈춥니다(전에는 그 사이 손을 떼도 놓은 것이 전달되지 않아 계속 움직일 수 있었습니다). Jog 알림은 화면 언어로 시작하고 서버가 준 이유를 그 뒤에 그대로 붙입니다.
- 그리퍼: 그리퍼 드라이버가 처음 응답하기 전에는 3D 화면과 MoveIt 계획에서 손가락이 닫힌 것이 아니라 완전히 열린 것으로 보입니다(실제 폭은 아직 모름, 충돌 검사는 가장 큰 모양으로 합니다).
- 펜던트: 페이지를 새로 열거나 다시 연결해도 이미 확인했거나 끝난 보호 정지가 다시 뜨지 않습니다. 확인하지 않은 보호 정지는 포커스를 다른 로봇으로 바꿨다 돌아와도 ↻ 로 복구할 때까지 남고, 늦게 온 복구 응답이 다른 로봇이나 그 뒤의 새 보호 정지를 지우지 않습니다.
- 그리퍼: RG6 를 최대 폭(160 mm)으로 여는 명령이 시간 초과로 실패하지 않고 155 mm 에서 멈춰 성공으로 끝납니다. 그리퍼 노드의 힘 0 N 은 최대 힘(120 N)으로, 25 N 미만은 25 N 으로 잡습니다.
- 로봇: JetPack 6 의 cuMotion 계획에서 시작 자세가 주변 물체와 부딪혀 한 번 거부된 뒤, 팔이 자기 자신과 부딪히는 시작 자세를 거르지 못하고 엉뚱한 실패 사유로 계획이 실패하던 문제를 고쳤습니다. 이제 그 경우에도 시작 자세 충돌로 바로 알려 줍니다.
- Lab: 접속 직후 로봇 모델(관절 한계) 조회가 실패해도 2초부터 두 배씩 늘어나는 간격(최대 1분)으로 다시 조회해, 성공하면 Generate 가 풀립니다. 컨트롤러를 바꾸면(ADRC↔PID 등) 새 컨트롤러에 없는 신호의 멈춘 그래프가 더는 남지 않습니다.
- Lab: 연결 화면에
/indy7·indy-7처럼 쓸 수 없는 로봇 네임스페이스를 넣으면 이유와 함께 바로 거부합니다(종전에는 「Waiting for manifest…」에서 멈췄습니다). 거부된 이름은 최근 목록에 남지 않습니다. - plem code: 여러 터미널에서 plem code 를 써도 각자 자기 로봇 연결 프로세스를 쓰므로, 한쪽을 닫아도 다른 쪽 연결이 끊기지 않습니다. 연결 프로세스는 plem code 가 강제 종료돼도 함께 정리됩니다. 이전 버전이 남긴 연결 프로세스는 그 세션이 끝나도 남으면 재부팅이나
plem kill로 정리됩니다. - plem code: 로봇 이동·그리퍼 동작 중에 plem code 를 종료하면 그 동작을 취소하고 로봇에 브레이크(BRAKED)를 한 번 요청한 뒤 끝납니다. 브레이크를 확인하지 못하면 화면이 원래 터미널로 돌아온 뒤 물리 비상 정지를 확인하라는 안내를 출력합니다.
- Lab: 사인 런의 Phase @freq 를 같은 관절의 명령 목표값 대비 위상차로 계산합니다. 명령을 그대로 따라간 런은 진폭·주기와 상관없이 0° 근처로 나옵니다(종전에는 15°~72° 어긋났습니다). 목표값 신호를 녹화하지 않았으면 위상이 비고 진폭만 보입니다. 게인 스윕 위상 축도 같습니다.
- plem code: 그 로봇의 펜던트 Job 이 실행 중이거나 일시정지 중이면 AI 의 Freedrive(손 안내) 모드 전환을 이동·그리퍼처럼 거부하고, 펜던트에서 ⏹ 로 종료하라고 안내합니다. 브레이크 체결과 P-STOP 해제는 Job 중에도 그대로 되고, P-STOP 중에는 손으로 안전한 자세로 옮길 수 있게 Freedrive 전환도 막지 않습니다. 다른 로봇의 Job 은 막지 않습니다.
- Lab: rosbridge 연결이 잠깐 끊겨도 콘솔이 연결 화면으로 돌아가지 않습니다. 작성 중인 실험·적용 전 게인·진행 중 이동의 Abort 가 그대로 남고, 끊긴 동안에는 Disconnected 표시와 함께 모드 변경·게인 적용·새 이동이 막힙니다. 연결 화면은 Disconnect 를 누를 때만 나옵니다.
- plem code: 이동·그리퍼 실행을 예산이 거의 끝날 무렵 취소하면 정지가 확인되지 않은 것으로 판정해 브레이크를 추가로 걸고 잘못 보고하던 문제를 고쳤습니다. 이제 취소 결과를 기다려 실제 종단 상태를 보고합니다.
- 설치·업데이트: RT 설정 마법사 메뉴 3 이 링크가 올라오기 전에 「no slaves connected」를 내던 것을 고쳐, 최대 10초 기다린 뒤 슬레이브를 셉니다. 메뉴 1 요약은 다시 실행해 바꾼 것이 없는 단계를 done 대신 skipped 로 적습니다.
- 그리퍼: 시리얼 그리퍼 브리지가 이전 사용자가 켜 둔 흐름 제어를 끄므로, 장치가 응답하지 않을 때 종료가 멈추지 않습니다. 폴링 주기를 1초 이상으로 두어도 CPU 를 다 쓰지 않습니다.
- 서보 드라이브: 드라이브가 둘 이상인 버스에서
pdo_mapping: generated가 다음 드라이브의 축까지 첫 드라이브의 매핑에 넣어 파일이 거부되거나 잘못된 매핑이 되던 문제를 고쳤습니다. 이제 드라이브마다 자기 축만 매핑합니다. - 서보 드라이브:
with Bus(...)안에서move_to중 Ctrl-C 로 빠져나오면 축은 멈춰도 궤적 이동 요청이 취소되지 않고 남던 문제를 고쳤습니다. 블록을 나가며 하는 정지가 그 이동도 취소합니다. - 설치·업데이트: realtime 그룹 사용자의 로그인 세션이 가장 낮은 우선순위(nice 19)로 돌던 문제를 고쳤습니다. 이미 설치된 기기는 RT 설정 마법사 메뉴 1 재실행, plem-drive 업그레이드, 또는 prod 에서
plem-deploy dev로 전환할 때 고쳐지며, 이미 열린 세션은 다시 로그인해야 적용됩니다. - 설치·업데이트: RT 설정 마법사가 설치된 버전과 다른 버전 고정, 도중에 멈춘 부하 생성기, 실패한 설정 파일 쓰기, 꺼진 jetson-clocks 서비스를 통과로 보고하지 않습니다. 메뉴 1 을 다시 실행하면 고정과 서비스를 바로잡습니다.
- 서보 드라이브:
plem drive run이every slave in OP를 찍은 직후Bus.release()를 부르면 궤적 컨트롤러가 아직 기동 전이라 해제가 실패하던 문제를 고쳤습니다. 해제는 컨트롤러가 켜질 때까지Bus의 timeout(기본 10초) 안에서 기다리고, 벤치도 이 실패로 승인 없이 끝나지 않습니다. - 설치·업데이트: RT 설정 마법사(
setup/rt/setup.sh)에서 단계가 실패하면 그 자리에서 Enter 를 기다리지 않고 단계 요약표(중단했으면 그 이유)를 보여 준 뒤 한 번만 기다립니다. 종전에는 중요한 단계가 실패하면 요약표가 메뉴로 돌아가며 지워졌습니다. - 센서: F/T 센서가 정격 초과로 표시돼도 로봇이 정지해 있으면 영점을 잡을 수 있습니다. 영점이 틀리게 저장되면 툴에 아무것도 닿지 않아도 정격 초과가 될 수 있어 영점을 다시 잡을 수 없던 문제를 고쳤습니다.
- 서보 드라이브: 로봇과 드라이브 버스의
SERVO_FAULT_RESET_RESULT가 결과와 상관없이 ERROR 로 찍히던 것이 바뀌었습니다. 복구(R·reset_error·Bus.reset()) 때 고장 상태가 아니어서 버려진 축과, 복구·자동 초기화에서 초기화가 쓰인 경우는 INFO 입니다. statusword 를 해석하지 못해 버린 요청은 그대로 ERROR 입니다. - 서보 드라이브: 기동 중 SDO 읽기(stored_sdo 비교, 승인 기록의 하드웨어·소프트웨어 버전, 첫 활성화 전 위치)와 벤치의 SDO 읽기가 입출력 오류(-EIO)로 중단 코드 없이 실패하면 0.1·0.3·0.5초 뒤 세 번까지 다시 읽습니다. 그래도 버전을 못 읽으면 재벤치 대신 잠시 뒤 다시 기동하라고 안내합니다.
- 서보 드라이브:
plem drive run이 기동마다 작업 폴더(plem-drive-run-*)를 새로 남기지 않고, 본인 전용$XDG_RUNTIME_DIR가 있으면 버스마다 그 아래 한 폴더를 다시 씁니다. - TUI: SSH 로 접속해 로그를 드래그하면 노트북 터미널로 복사를 보냅니다(OSC 52 를 받는 터미널, tmux 3.3 이상은
set-clipboard on필요). 종전에는 기기 화면 클립보드에 넣고Copied라고 알렸습니다. - 서보 드라이브: 하드웨어 파라미터
master_index(plem drive run --master N이 정하는 값)가 숫자만 받습니다.1x는 1 로,-1은 아주 큰 번호로 읽던 대신 기동할 때 이유와 함께 거부합니다. - 그리퍼: 로봇 드라이버보다 먼저 뜬 RG6 그리퍼 드라이버가 툴 채널을 찾지 못하면 바로 종료하던 것을, 채널이 생길 때까지 최대 30초 기다리도록 고쳤습니다.
- 서보 드라이브: 드라이브 모델 파일 오류가 파일의 키와 경로(
slaves[0].axes[1]등)로 나옵니다.plem drive run인자 오류는 사용법 한 줄만 보입니다. - 서보 드라이브:
plem.drive의release()가 거부를 버스 상태(브레이크 물림, 진행 중인 브레이크 동작 없음)로 판정합니다. 이전 요청의 거부를 이번 거부로 오인하지 않고, 이유가 실리지 않은 거부도 시간 초과를 기다리지 않습니다(앞선 브레이크 동작이 도는 중이면 기다립니다). - 개발자 SDK:
apply_rt_thread_config가 [0, CPU_SETSIZE) 밖의 CPU 를 받으면 나머지 CPU 에 고정하지 않고EINVAL로 거부하며 스레드의 CPU 마스크를 그대로 둡니다. - 개발자 SDK:
DriveHost::write가 앞선 시각과 0 이하 시각(CLOCK_MONOTONIC 으로 50 ms 넘게 앞선 값)을 거부하고, csp·csv 축의 CiA 402 표에 Quick stop 행(전이 11)이 없으면EtherCATController가 시작을 거부합니다. 내보낸 CMake 타깃이 C++20 을 요구합니다. - 설치·업데이트: CPU 를 둘 이상 격리하도록 부팅 설정을 고친 기기에서 RT 설정 마법사의 메뉴 2 가 잘못 경고하며 메뉴 1 재실행(격리를 한 CPU 로 되돌림)을 권하던 문제를 고쳤습니다.
- 서보 드라이브: 벤치의 정지 판정이 정지 때 브레이크가 체결됐다는 드라이버의 확인 줄을 요구합니다. 그 줄이 없으면 브레이크 상태를 알 수 없으므로 통과가 아니라 실패로 판정합니다.
- 서보 드라이브: 드라이브가 음수 모드(제조사 고유 모드, 예: -1)를 보고하면
MODES_OF_OPERATION_MISMATCH값과 거부 문구에 255 대신 -1 로 나옵니다. - 서보 드라이브: 버스 초기화가 거부되면
plem drive와 드라이브 노드가 숫자 코드(예: -9) 대신 실패한 단계와 그 원인을 알립니다. - 캘리브레이션: 로봇 스택을 정지할 때 캘리브레이션 서버가 더는
process has died … exit code 1로 기록되지 않습니다 — 정상 정지인데 거의 매번 오류로 남았습니다. - 캘리브레이션: 관절 제안 보정값(Δq) 분석이 시간 제한에 걸려 재현성 확인을 끝내지 못하면, 보정값을 제안하지 않고 재현성 미확인으로 거부합니다. 종전에는 확인하지 않은 보정값이 재현 신뢰도가 높은 것처럼 제안될 수 있었습니다.
- TUI: 시작 화면(Start session)에서
Esc가 더는 plem 을 끝내지 않습니다 — 설정에서 빠져나오다 한 번 더 누르면 바로 꺼졌습니다. 끝내기는q입니다. - TUI: Settings 로봇 상세의 Calibration 이 연결한 기록(
이름 · RMS · 날짜)을 보이고, 기록이 손상됐거나 다른 카메라 모델의 것이면 기동이 어떻게 되는지 경고 색으로 알립니다. 로봇 폼의 Calibration 칸은 카메라를 골랐을 때만 보입니다. - TUI: 로봇을 정지하면 LOG 칸에
Stopped 1 robot이 남습니다(기동 줄은Launched 1 robot). - TUI: 확인·자세 이름·첫 로봇 대화상자가 떠 있는 동안 키 줄이 그 대화상자의 키를 보입니다. 첫 로봇 대화상자도
ctrl+s로 저장합니다. - TUI: Session 화면 Joint Move 의 각도 칸은 숫자 글자만 받습니다. 입력 중에도
s(정지) 등 다른 글자 키는 바로 단축키로 동작하고, 칸에 입력되지 않습니다. 첫Tab이 J0 칸으로 바로 갑니다. - TUI: Settings 의 로봇 편집·추가 폼이 개발 워크스페이스에서 열리는 데 2초 가까이 걸리던 문제를 고쳤습니다.
- TUI: Session 화면의 SYSTEM 칸이 로봇을 시작하기 전에도 EtherCAT·CPU·메모리를 보이고, 정지하면 Mode·Safety 와 그리퍼·F/T 칩이 마지막 값을 남기지 않고 비워집니다.
- TUI: 터미널 폭을 줄인 뒤 Session 화면의 LOG 칸에서
←가 로봇 목록으로 돌아가지 않고 로그를 옆으로 넘기던 문제를 고쳤습니다. - TUI: 로봇 기하 측정값 줄(
[measured] …— 적용·거부·위반)이 경고·안내(NOTICE) 줄 뒤에 나오면 LOG 칸에 두 번 보이던 문제를 고쳤습니다. - TUI: 확인 창(자세 삭제·덮어쓰기, 로봇 삭제)의
y/n이 한글 자판(ㅛ/ㅜ)에서도 답합니다. - TUI: 명령 팔레트(
ctrl+p)에서 Theme 를 고르면 TUI 가 종료되던 문제를 고쳤습니다(Theme 항목을 뺐습니다).ctrl+q와 팔레트의 Quit 은q처럼 정지 단계를 상태줄에 보이며 끝납니다. - ROS 2: 로봇·드라이브의
rt_events토픽에서event_sequence가 모든 이벤트에 발생 순서대로 매겨집니다(버스마다 0부터). 지금까지 보호 정지·브레이크·리밋 정지 등 대부분의 이벤트가 0 으로 나갔습니다. - 센서: 로봇 기동이 만든 복구 잠금 파일 때문에
sudo plem-camera-recover.sh --force가 「열 수 없어 복구를 진행하지 않습니다」로 멈추던 문제를 고쳤습니다. - 센서: 카메라에 외부 보정(extrinsic)이 없어 카메라 드라이버만 뜰 때, 카메라 자체 TF 트리가 로봇 TF 와 떨어진 채 발행돼 MoveIt 이 프레임마다 「Unable to transform object from frame」 경고를 내던 것을 고쳤습니다. ZED·RealSense 모두 이제 그 TF 를 내지 않습니다.
- ROS 2: 로봇 어댑터의 모드·브레이크·B0 튜닝 액션 서버 세 노드가 같은 이름(
/<로봇>/plem)을 쓰던 것을 고쳤습니다. 이제plem_set_mode·plem_set_joint_brake·plem_tune_b0로 따로 보이고, 액션 경로(/<로봇>/plem/set_mode등)는 그대로입니다. - Lab: 실기 런의 Runs 화면이 추종 오차 채널을 만들지 못하고(내장 컨트롤러의
measured_신호 이름) 신호를 내부 키로 보이던 것을 고쳤습니다. 이제 자극이 움직인 관절의 추종 오차로 열리고, 신호는 신호 트리와 같은 이름으로 보입니다. - Lab: 거의 평평한 신호의 그래프 축(라이브 플롯·Runs)이 같은 값(
-0.00000000)을 눈금마다 반복하던 것을 고쳤습니다. - Lab: 사이드바 기본 폭을 넓혀 튜닝 패널의 게인 값 끝자리가 잘리지 않습니다.
- Lab: 모드 변경(SetMode) 응답이 5초 안에 오지 않으면 내부 전송 문구 대신, 모드가 아직 바뀔 수 있으니 Mode 표시를 보고 다시 시도하라고 알립니다. Simulation 3D 화면이 로봇 손목·툴을 자르던 것과, 일시정지 표시가 두 줄로 접혀 툴바를 밀던 것도 고쳤습니다.
- 서보 드라이브: 스트림 컨트롤러만 끄면(
ros2 control switch_controllers) 속도·토크 축이 마지막 명령으로 계속 돌던 것을 고쳤습니다. 이제 명령이 남지 않아 50 ms 명령 감시가 버스 전체(모든 축)를 보호 정지합니다. 다시 움직이려면 스트림 컨트롤러를 다시 켜고 스트림을 흘린 뒤reset()하고release()합니다. 정지가 걸리는 것은 풀린(release 된) 버스나 토크 축이 있는 버스입니다. - TUI: R(Recover)은 지금 걸린 P-STOP, 범위를 벗어난 관절, 아직 남아 있을 수 있는 서보 드라이브 고장에만 표시됩니다. 지난 이벤트만으로는 표시되지 않습니다. 한계를 벗어난 관절을 복구할 때는 브레이크를 먼저 건 뒤 FreeDrive 로 들어가고, 드라이브 고장은 브레이크를 건 채 리셋합니다.
- TUI: P-STOP 중 복구용 FreeDrive 로 팔을 손으로 옮길 때 로봇 목록이 BRAKE 대신 FREE P-STOP 으로 브레이크가 풀린 상태를 보여 주고, f 또는 r 로 브레이크를 걸 수 있습니다. 이때 브레이크를 걸면 안전 자세 확인으로 P-STOP 도 해제되며, 원인이 남아 있으면 다시 걸립니다.
- TUI: 터미널이나 SSH 가 끊기면 로봇 스택을 정리한 뒤 TUI 도 함께 끝납니다. 같은 화면에서 정지 후 다시 시작해도 모드 표시와 P-STOP 알림이 이어지고, r 키 이름이 지금 할 일(
release brake·brake)을 보여 줍니다. 마스터보다 많은 로봇으로 시작하면 꺼지지 않고 이유를 알리며, 삭제 확인창의 경고가 잘리지 않습니다. - Lab: 사이드바 Tuning·Experiment 탭이나 메인 탭을 오가도 실험 초안과 생성된 궤적이 남고, 진행 중인 이동의 Abort 도 그대로 보입니다. Run & capture 는 모드 전환을 기다리는 동안에도 Abort 할 수 있습니다. 이동 중에는 다른 이동이 시작되지 않습니다.
- Lab: 게인 적용이 거부되거나 실패하면 입력값이 남아 바로 다시 적용할 수 있고, 값이 클램프되면 컨트롤러가 실제로 쓰는 값을 보여 줍니다. 녹화·수렴 리포트에는 컨트롤러가 적용을 확인했거나 다시 읽어 준 게인을 기록하고, 둘 다 확인하지 못하면 마지막으로 확인된 값을 남깁니다.
- Lab: 수렴 리포트를 Escape·배경 클릭·✕ 로 닫아도 밴드가 지워지지 않습니다. 밴드 제거는 「Remove band」로 합니다(위반 리포트와 같은 동작).
- Lab: 긴 시간 창의 라이브 그래프에서 내려가는 신호가 톱니처럼 들쭉날쭉 그려지던 것을 고쳤습니다(일시정지하면 매끄럽던 경우).
- Lab: 그래프 축 눈금 라벨이 간격대로 정확히 찍힙니다. 0.25 간격이 「0.3 0.5 0.8」, 2.5 간격이 「68 70 73」 처럼 반올림되던 것을 바로잡았습니다.
- Lab: 녹화가 300,000 표본 상한에 닿아도 Capturing 으로만 보이던 것을 고쳤습니다. 이제 「Capture full」로 바뀌고, 이동은 그대로 계속되며, 저장된 런에는 끝이 잘렸다는 표시가 남습니다.
- Lab: Abort 는 모드 표시가 늦게 갱신돼도 BRAKED 요청을 보내고, TRAJECTORY 전환을 기다리던 중이면 전환이 끝난 뒤 한 번 더 보냅니다. Protective Stop 이거나 모드를 모르면 보내지 않습니다. 이동이 끝난 직후의 Abort 는 「Aborted after the move completed」로 표시합니다.
- Lab: 실행 중 연결을 끊고 다시 붙으면 이전 실행이 새 세션의 녹화를 끝내거나 모드 전환 뒤 로봇을 움직이던 것을 고쳤습니다. 저장 중 같은 로봇에 다시 붙으면 저장된 런이 Runs 목록에 바로 나타납니다.
- Lab: 다시 연결하면 새 로봇이 보고하기 전까지 이전 로봇의 컨트롤러·모드·자세를 쓰지 않고, 이전 연결에서 늦게 온 게인 적용 응답이 새 연결 값을 덮지 않습니다. 다른 로봇에 연결하면 Runs 의 이전 비교 화면을 닫습니다. 연결이 잠깐 끊긴 사이 접속 화면에서 로봇 이름을 바꿔도, 다시 붙은 로봇의 이름으로 런을 저장합니다.
- Lab: 녹화 중 컨트롤러의 신호 구성이 바뀌면 신호 개수가 같아도 녹화를 멈추고 이유를 보여 줍니다(신호 이름이 뒤바뀐 채 저장되지 않습니다).
- Lab: 컨트롤러가 게인 변경을 거부하면, 이미 같은 값을 쓰고 있었더라도 「verified」 대신 실패로 표시합니다.
- 로봇: 로봇을 켤 때 실행 화면에 찍히던 MoveIt octomap 경고·오류와 RViz 의 「Found remap rule」 경고가 사라지고, 감속 한계 경고(「Failed loading deceleration limits」)도 줄었습니다.
- plem code: AI 가 로봇 스택 기동을 동시에 두 번 요청해도 스택은 하나만 뜨고 나머지는 이미 실행 중이라며 거부합니다.
- 서보 드라이브:
plem drive check가 csp 축의 속도 한계가 한 주기의 위치 카운트 반올림 여유 안이면(플래너가 쓸 속도가 없음) 파일을 거부합니다. 종전에는 통과시키고velocity_cap_rad_s를 0 이하로 적었습니다. - 서보 드라이브: Python
move_to가 버스가 1초 넘게 상태를 보내지 않으면 궤적을 보내기 전에 거부합니다(종전에는 보낸 뒤 실패해 이동이 남을 수 있었습니다). ros2_control hardware 가 없는 로봇 설명으로Bus()를 만들면 이유가 있는DriveError이고,with블록이 예외로 끝날 때 실패한 정지는 경고 로그로 남습니다. - 설치·업데이트: RT 설정 마법사 메뉴 3 재설치가 EtherCAT 마스터를 쥔 앱(
plem drive run등)이 있으면 옛 모듈 위에 설치하고 verified 로 보고하던 것을 고쳐, 그 앱을 멈추라고 알리며 중단합니다. 메뉴 1 단계 6 은isolcpus=만 있는 부팅 항목에irqaffinity=를 넣습니다(종전에는 매번 실패). - 문서: 공개 저장소 문서에서
operation_enabled의 조건(선언한 모드까지),move_to의 가속 검사 범위(점과 점 사이 평균), 메뉴 3 재설치 절차를 코드대로 고쳤습니다. - 서버 API: 시작이 거절된 일회성 배포(보호 정지 중 시작 등)가 다음 배포를 409 로 막던 것을 고쳤습니다. 거절된 배포는 그대로 다시 시작할 수 있고, 5분 넘게 시작하지 않은 배포는 다음 배포 때 정리됩니다.
- 펜던트: 응답을 받지 못한 Job 배포, 프로그램·Job 삭제, Job 이름표 변경, 변수 값·정의 변경과 삭제를 자동으로 다시 보내지 않습니다. 네트워크가 흔들려도 Job 이 두 번 만들어지거나 변수 값이 이전 값으로 되돌아가지 않고, 실패로 알려 운영자가 다시 할지 정합니다. 프로그램 저장은 아직 다시 보냅니다.
- 설치·업데이트: 제거(uninstall)가 설치 뒤 바뀐 부팅 설정(
/boot/extlinux/extlinux.conf)을 설치 때 백업으로 덮어 RT 커널·CPU 격리 설정을 되돌리던 문제를 고쳤습니다. 바뀌었으면 현재 설정을 두고 백업 경로를 알립니다. - 펜던트: 지운 셀 물체가 3D 화면에서 바로 사라집니다. 전에는 마지막 물체가 카메라를 움직일 때까지 그려져 있었습니다.
- 펜던트: 프로그램 편집에서 거부된 동작(정리·반복으로 묶기 등)이 더는 「실행할 수 없습니다」와 문제 개수로 표시되지 않습니다. 사유는 문제 목록에 닫을 수 있는 경고로 남습니다.
- 펜던트: 대상 로봇이 BRAKED 상태이면 이동 노드가 있는 프로그램의 ▶ 실행을 잠그고 그 이유를 보여 줍니다. 이동 노드가 없는 프로그램과 시뮬레이션은 그대로 실행합니다.
- 펜던트: 반복으로 묶기가 더는 옆 노드를 덮지 않습니다. 뒤에 있는 노드는 비켜 나고, 방해되지 않는 노드는 그대로이며, 되돌리기 한 번에 모두 돌아옵니다. 카드 높이에 맞춰 상자도 커져 바닥 칸을 가리지 않습니다.
- 설치·업데이트: 패키지 목록이 오래됐거나 비어 있는 기기에서 첫 설치가 apt 오류로 바로 멈추던 문제를 고쳤습니다. 이제 필요한 도구를 설치하기 전에 목록을 갱신하고, 갱신이 실패하면 확인할 내용을 안내합니다.
제거8
- 문서: 운영자 매뉴얼과 통합 가이드 PDF 를 더 이상 만들지 않습니다. PLEM 문서는 공개 문서 사이트(https://www.wimcorp.co.kr/plem) 하나로 제공합니다.
- 펜던트: 하단 로봇 제어 바의 모드 버튼 왼쪽에 있던 「로봇 모드」 글자를 없앴습니다. 버튼과 동작은 그대로입니다.
- 펜던트: 상단 로고 옆의 사이드바 접기 버튼을 없앴습니다. 왼쪽 막대에서 지금 묶음(강조된 아이콘)을 다시 누르면 패널이 접히고 펴지며,
Ctrl+B도 그대로입니다. - 펜던트: Jog 패널의 「관절」 탭(관절 Jog)을 없앴습니다. 관절은 「목표」 탭의 관절(처음 열리는 방식)에서 각도를 정하고 누르는 동안 이동하며, 화면의 「IK 해 없음」 안내도 그쪽을 가리킵니다. 특이점 정지 중에는 서보 초기화, 또는 조작 종료 뒤 목표 › 관절로 빠져나옵니다. 로봇 쪽 관절 Jog 경로도 함께 없앴습니다.
- TUI: Settings 로봇 폼의 카메라 Overrides 와 그 Edit… 화면을 뺐습니다. 그 화면의 깊이·프레임 속도 값은 로봇 스택이 쓰지 않았습니다 — 깊이·속도는 Start session 의 Camera quality(와
~/.plem/perception_overrides.yaml)가 정합니다. 저장돼 있던 값은 그대로 둡니다. - TUI: 로봇 제어 화면의 plem_server WebSocket 주소(
ws://<기기>:8080/plem) 표시와 설정 화면의 개발용 plem-server hot reload 스위치를 뺐습니다(settings.yaml의plem_server_dev_mode는 그대로 동작합니다). - ROS 2: MoveIt Servo 를 없앴습니다. Neuromeka
move_group.launch.py의enable_servo·jog_natural_rotation_lever인자와servo_node·jog_gateway노드가 더는 없으며, Jog 는 로봇마다 뜨는 Jog 엔진 노드(/<robot_id>/jog/*)로 합니다. 설치에ros-<distro>-moveit-servo가 필요 없습니다. - ROS 2: 문서화된 적 없고 제품 기능에서도 쓰지 않던 Pilz 시퀀스 액션
/<로봇>/sequence_move_group과 서비스/<로봇>/plan_sequence_path를 더 이상 띄우지 않습니다.
v0.10.1
변경 15건 보기
호환성 주의1
- 개발자 SDK:
plem init이--example을 받지 않고 늘 골격 패키지를 만듭니다. 중력·코리올리(ManipulatorDynamics)·Payload(ToolLoad) 헬퍼가 들어 있고 PID 예제는 없어졌습니다(헬퍼를 쓰는 PD 예시는CONTROLLER_PLUGIN_GUIDE.md, 게인 튜닝 안 됨).--example을 넘기는 스크립트는 그 인자를 지우세요.
새 기능4
- 펜던트: 하단 로봇 제어 바의 「정지」 왼쪽 「위치 저장」을 한 번 누르면 대화상자 없이 지금 자세가 Waypoint 로 저장됩니다. 이름은 날짜·시각으로 자동으로 붙고(예: wp_20261007_093015) 알림과 Waypoint 목록에 바로 나타납니다.
- 펜던트: 로봇 › Waypoint 목록의 ⋯ 메뉴에서 Waypoint 이름을 바꿀 수 있습니다. 그 Waypoint 를 쓰는 프로그램과 배포된 Job 은 그대로 실행되고 보이는 이름도 함께 바뀝니다. 프로그램이나 Job 이 쓰는 Waypoint 는 지워지지 않고, 어디서 쓰는지 그 행 아래에 알려 줍니다.
- 서보 드라이브: 모델 파일을 써 주는 에이전트 스킬
add-drive가 함께 설치됩니다 — plem code 는 설치만으로 바로 쓰고, Claude Code 는 스킬 폴더에 링크 한 줄로 씁니다. 드라이브를 읽기 전용으로 읽고 매뉴얼·ESI 를 찾아 값마다 출처를 달고, 한계 같은 결정은 사용자에게 묻고, 근거 없는 값은 비워 두어plem drive check가 거부하게 합니다. 벤치는 사용자가 돌립니다. - 서보 드라이브: 모델 파일을 짧게 쓸 수 있습니다. 같은 드라이브 여러 대는
ring_position: [0, 1]로 한 항목에 적고 축 이름·flip·zero_offset_count만 드라이브마다 적습니다. 위치·속도unit과 매핑에 0x603F 가 있을 때의error_code_pdo는 빼도 되고,pdo_mapping: standard는 PLEM 이 쓰는 CiA 402 객체로 매핑을 만들어 씁니다.
개선·변경5
- 펜던트: 되돌리기 한 번이 조작 한 번(값 확정·끌기·명령)을 되돌립니다. 우클릭·키·띠가 같은 대상(선택 안 노드 = 선택 전체)과 결과를 내고, 새 반복은 3번, Ctrl+V 는 보이는 캔버스 가운데에 놓습니다. 선택 모드의 터치 끌기는 사각형만 그리고 끝나면 해제됩니다.
- plem code: 로봇 기동이 plem TUI 로봇 설정에서 마지막으로 고른 셀(없으면
default)로 기동합니다. 셀 밖 로봇이라 거부되면 TUI 에서 그 셀을 고르거나 셀에 로봇을 추가합니다. - 펜던트: 벤더가 섞인 셀에서 둘째 벤더 로봇도 Jog 를 쓸 수 있고, 마지막 펜던트가 떠날 때 그 로봇의 Jog 세션도 해제됩니다.
- 서버 API: 이동 노드가 Waypoint 를 이름과 고유 id(
waypoint_id)로 가리킵니다. 이름만 있는 워크플로우도 동작하며 저장·배포 때 id 가 채워집니다. 이 로봇에 없는 Waypoint 를 가리키는 노드는 실행 전에 배포·Job 시작·재개 때 거부됩니다(배포된 Job 도).waypoint_rename·waypoint_usage가 생겼고waypoint_delete는 쓰이는 Waypoint 를 거부합니다. - 펜던트: 새 프로그램 이름 입력칸이 장갑으로 누르기 쉬운 크기로 커졌습니다. 열린 프로그램을 저장하지 못해 만들지 못하면 입력한 이름을 그대로 두고 그 이유를 보여 주며, Esc 로 입력을 닫을 수 있습니다.
수정5
- 펜던트: 오른쪽 패널이 좁을 때(세로 태블릿, 또는 패널을 최소 폭으로 줄였을 때) Jog 패널의 「관절 목표」 탭이 패널 끝에서 잘리고 「세션 해제」·속도 버튼이 어긋나 보이던 것을 고쳤습니다. 좁으면 버튼이 전체 폭 줄로 정돈되어 쌓입니다.
- 펜던트: 프로그램을 열어 둔 상태에서 새 프로그램을 만들면 열려 있던 프로그램이 서버에서 빈 새 프로그램으로 덮어써지던 문제를 수정했습니다. 새 프로그램은 자기 이름으로 따로 저장됩니다.
- 설치·업데이트: 개발용 설정을 거치지 않고 설치한 기기에서
plem을 켜면 로봇 스택과 서버가 「error creating node」로 바로 멈추던 문제를 고쳤습니다(JP7 에서 확인, JP6 도 같은 조건이면 발생). 이제 설치·업데이트가 ROS 2 통신에 필요한 커널 수신 버퍼 설정을 함께 깔고 바로 적용합니다. - plem code: 로봇 스택 기동·모션 준비·Freedrive·오류 해제를 승인한 뒤 실제로 실행되기 전에 취소하면 실행하지 않습니다(이전에는 취소해도 스택이 뜨거나 브레이크가 풀릴 수 있었습니다). 이동·그리퍼도 보내기 전에 취소하면 AI 에게 실행된 것으로 잘못 알리지 않습니다.
- plem code: 끝난 로봇 스택의 가동 시간이 종료 뒤에도 계속 늘어나 보이던 것을 고쳤습니다.
v0.10.0
변경 171건 보기
호환성 주의21
- TUI:
plem env명령을 없앴습니다. 새 터미널은 열릴 때 로봇과 같은 ROS 2 환경으로 자동 설정됩니다. 설정을 바꿨다면 plem 을 다시 시작한 뒤 새 터미널을 여세요. - ROS 2: 셸에서
export한ROS_DOMAIN_ID·CYCLONEDDS_URI·RMW_IMPLEMENTATION은 로봇 기동에 반영되지 않습니다.~/.bashrc등의 그 줄은 지우고(남기면 그 셸의ros2만 로봇을 못 봅니다) 도메인은 TUI 설정(,)에서 바꾸세요. 업데이트한 뒤에는 새 터미널에서ros2 daemon stop을 한 번 실행하세요. - ROS 2:
PLEM_CYCLONEDDS_SYSTEM_DEFAULT=off는 더 이상 읽지 않습니다. 원격 PC 접속을 열어 둔 기기는/usr/share/plem/cyclonedds-localhost.xml을/etc/plem/cyclonedds.xml로 복사해 네트워크 인터페이스 줄만 바꾸세요(PLEM Docs 「ROS 2 통합」). 옮기지 않으면 기기 안에서만 통신합니다. - ROS 2:
RtRawBatch(/rt_raw)·RtEvent(/rt_events)·SetControlCommand(<로봇>/plem/control_command)의 패키지가plem_msgs에서plem_drive_msgs로 바뀝니다. 토픽·서비스 경로와 필드 이름은 그대로이니, 직접 구독·호출하는 코드는 import 와 타입 이름만 바꾸세요. - ROS 2:
/rt_raw메시지에applied_command·axis_count·dc_sync_monitor_ns가 더해져, 이전 버전에서 녹화한/rt_raw·/rt_eventsbag 은 이 버전에서 풀리지 않습니다. 그 bag 은 녹화한 버전에서 분석하고, 직접 구독하는 도구는 관절 값을 주기마다axis_count개씩 읽으세요. - ROS 2: 이동 계획 액션(
plem/plan_trajectory)의 목표에서workspace필드가 빠지고, 실패 사유workspace_invalid·workspace_violation_*도 더 이상 나오지 않습니다. 이 액션을 직접 부르는 스크립트는workspace를 채우지 않도록 고치세요. - ROS 2:
ros2 launch로 직접 기동할 때profile_dir를 생략하면~/.plem(또는$PLEM_HOME)을 쓰고, 그 아래 프로필이 없는 로봇이나 로봇 수보다 짧은masters는 장비 없는 기본 프로필·추정 버스로 뜨는 대신 기동 전에 멈춥니다. 로봇마다 TUI 에서 프로필을 만들고 마스터를 적으세요. - 로봇: 모션 계획 진단 로그를 켜는 환경변수
IKFAST_AUDIT_LOG가PLEM_MOTION_AUDIT_LOG로 바뀝니다. 셸 프로필 등에 적어 둔 값은 새 이름으로 옮기세요. - 펜던트: 관절·직선 이동 노드의 목표는 Waypoint 이름으로만 지정합니다. 각도를 직접 넣은 옛 노드는 배포가 거부되고, 그 노드가 실행 경로에 있는 배포된 Job 은 새 시작·체크포인트 복구가 거부됩니다(일시정지 중인 Job 의 재개는 됩니다). 노드 상세에서 이름을 적고 「Waypoint 로 저장」을 누른 뒤 다시 배포하세요(로봇은 움직이지 않습니다).
- 펜던트: 그리퍼 노드는 「물체 잡고 멈춤」과 「지정 위치 도달」 중 하나만 결과로 냅니다. 물체를 잡으면 「지정 위치 도달」 쪽은 실행되지 않으니, 집은 뒤 이어갈 단계는 「물체 잡고 멈춤」에 연결하세요.
- 펜던트: 반복 상자의 「반복 중단」 출구가 「반복 끝난 뒤」로 합쳐집니다. 옛 파일은 열 때 옮겨지지만 두 출구를 다 쓰던 경우 「반복 중단」 쪽 연결이 끊기니 열어서 확인하세요. 식에서
outputs.<반복 ID>.exit를 참조하면 실행 경로에 있는 한 배포가 거부되고 고칠 곳을 알려 줍니다. - 펜던트: 변수가 로봇별 변수 목록에 저장되고 값은 실행이 끝나도 유지됩니다.
persistent: false는 없어졌으니 시작 때 초기값이 필요하면 첫머리에 변수 설정 노드를 두세요. 옛 선언은 저장할 때 목록에 자동 등록되고 같은 이름이 다른 타입으로 있으면 저장이 거부되며, 병렬 갈래는 변수를 공유합니다(마지막에 쓴 값이 남음). - 서버 API: 변수를 다루는
GET/PUT/PATCH/DELETE /api/variables가 추가되고, 저장·배포되는 워크플로 문서에서variables블록이 빠집니다(참조만 남음). 실행 중에는 값·타입 변경과 삭제가 거부됩니다(409). - 서버 API: AI 워크플로 작성용 WebSocket 메시지(
workflow_agent_*)·/api/agent-sessions·/api/stt/token·/api/setup/settings, 도달 범위 조회(/api/robots/{robot_id}/reach_envelope)와 환경변수PLEM_URDF_XACRO_PATH가 제거됩니다. 이를 쓰던 외부 클라이언트는 고쳐야 합니다. - 서버 API:
GET /api/calibration/extrinsics·GET /api/calibration/robots가 없어지니 로봇 단위GET …/robots/{robot}로 옮기세요(해제용DELETE …/extrinsic-ref추가). 로봇 단위 조회와PUT·DELETE …/extrinsic-ref는 이 서버가 구동하는 로봇만 다루고 다른 로봇은 403 이니plem화면의 로봇 설정에서 바꾸세요. - 서버 API: WebSocket
capture_seed는 첫 시드만 찍고secondView.token을 돌려주니,generate_plan전에 새capture_second_seed {token}을 불러 두 번째 시드를 찍으세요(로봇이 조금 움직였다 돌아옵니다).save_camera_extrinsic의mount는 선택이 되고(비우면 오늘 날짜)missing_mount는 없어집니다. - 서버 API: WebSocket 액션
move_to_waypoint·gripper_command·waypoint_save·waypoint_get·get_state와ping을 없앴습니다. 대신move_to_joints(waypoint_name)·waypoint_save_joints·waypoint_list·robot_state브로드캐스트·ROS 그리퍼 액션을 씁니다. - 설치·업데이트: 업데이트한 뒤 첫 기동 때 저장돼 있던 AI 워크플로 세션 기록을 지웁니다. 보존하려면 업데이트 전에
~/.plem/<기기 ID>/plem.db(PLEM_DATA_DIR을 바꿨다면 그 아래)를 백업하세요. - 라이선스: 기기 토큰은 라이선스 만료일을 따릅니다. 만료되면
plem update가 거부되고plem code도 다음 키 갱신부터 거부되며(원격 지원은 열립니다), 담당자가 연장하면 다시 쓸 수 있습니다. 기기를 다시 설치하거나 교체할 때는 새 토큰을 쓰세요 — 담당자가 기기를 삭제하면 그 토큰도 폐기됩니다. - 개발자 SDK: 커스텀 토크 컨트롤러에서
calculate_torque()override 가 없어졌습니다. 이미 빌드한 플러그인은 그대로 동작하지만, 다시 빌드하려면 본문을compute()로 옮기고measured.position(j)같은 접근자를 쓰세요(PLEM Docs 「커스텀 토크 컨트롤러」). - 로봇: 직접 작성한 URDF 의
gripper_payload_*·camera_payload_*파라미터는 더 이상 받지 않고 로봇이 기동하지 않습니다. 장착물 전체를tool_payload_mass·tool_payload_com_x·tool_payload_com_y·tool_payload_com_z하나로 합쳐 적으세요. plem 이 만드는 로봇 설명은 자동으로 바뀝니다.
보안1
- 서버 API: QA 전용
/api/debug/*경로(작업 감사 로그 조회·P-STOP 시험)가 기본으로 꺼집니다. 이전에는 같은 네트워크의 누구나 인증 없이 감사 로그를 읽을 수 있었습니다. 시험용으로만PLEM_DEBUG_ROUTES=1로 켭니다.
새 기능43
- 센서: 펜던트 F/T 카드의 「무게 측정」이 툴(그리퍼·카메라 등) 질량과 무게중심을 재서 복사해 줍니다.
plem init으로 만든 토크 플러그인의tool_load.hpp에 붙여 넣으면 자세가 바뀌어도 Payload 를 뺀 힘·토크를 씁니다. 선택 기능이며 지금은 Indy7 만 지원합니다. - ROS 2:
plem_drive_msgs/RtEvent가 이벤트 종류·심각도·LIMIT_STOP사유 번호를 상수로 싣습니다(RtEvent.LIMIT_STOP·RtEvent.SEVERITY_ERROR등)./rt_events를 직접 구독하는 코드는 숫자 대신 이 이름으로 비교하세요. 메시지 형식은 그대로입니다. - 로봇: 기체별 실측 기구학이 등록된 로봇은 기동할 때 검증을 거쳐 그 실측값으로 동작합니다. 기동 로그에 적용 여부가 한 줄 남고, 검증에 실패하면 잘못된 기하로 움직이지 않도록 기동을 멈춥니다.
- 로봇: 등록된 기기는 로봇 스택을 띄울 때 로봇 프로필·설정 사본, 운전·안전 모드, 제어기 종류·튜닝 값, 제어 이벤트, 진단 통계, 관절 데이터(브레이크 정지 중 제외, 10 ms 구간 요약으로 초당 약 100회)와 운영 로그·작업 감사 기록 등을 WIM 으로 보내는 수집 에이전트가 함께 뜹니다. 항목·목적·보존 기간은 라이선스 계약 별표 제6호(판 1.1)에, 끄는 방법은 PLEM Docs 「라이선스」에 있습니다.
- 서보 드라이브: 로봇팔 없이 CiA 402 서보 드라이브 버스 하나를 돌릴 수 있습니다. 축마다 토크(
cst)·위치(csp)·속도(csv) 모드를 고르며, 드라이브는 YAML 파일로 정의합니다(예제example_drive.yaml의 값은 지어낸 값입니다). 도구는plem-drive check·plem-drive run(또는plem drive …)으로 씁니다(PLEM Docs 「내 서보 드라이브 붙이기」). - 서보 드라이브: 엔코더는 절대형이어야 합니다 — PLEM 은 원점 복귀가 없어 증분 엔코더에서는 영점과 위치 한계가 맞지 않습니다.
- 서보 드라이브:
plem-drive run은 버스를 ros2_control 로 띄워 위치 축은 FollowJointTrajectory(MoveIt 포함), 속도·토크 축은 스트림 토픽으로 움직입니다. - 서보 드라이브: Python
plem.drive의bus.move_to({...})(위치 축, 사다리꼴·SCurve·자작Profile)와bus.stream({...})(속도·토크 축)이 명령을 파일 한계로 검사합니다.bus.reset()은 fault·보호 정지를 풀고 남은 원인을 오류로 알리며,bus.status·bus.velocities로 상태를 봅니다. - 서보 드라이브: 모델 파일에 버스 이름
bus.name이 필수가 되고, 버스는/<bus.name>에서 뜨며 Python 은Bus("<bus.name>")로 붙습니다(--ns는 없어짐). 이름은 승인에 들어가지 않고, 같은 이름의 버스가 떠 있으면plem-drive run이 거부합니다.with Bus(...)가 예외로 끝나면 축을 세웁니다. - 서보 드라이브: 한 기기에서 버스 둘을 돌릴 때는
plem-drive run --rt-cpu N으로 두 RT 루프를 서로 다른 CPU 에 둡니다. - 서보 드라이브: 모션은 승인된 파일로만 열립니다.
plem-drive check가 버스가 거부할 파일을 드라이브 없이 JSON(plem-drive-check/1)으로 알리고, 승인 전 파일은plem-drive run이 터미널에서 드라이브 앞 벤치(모드·극성·토크·브레이크 등)를 제안해 통과하면 파일의approval블록에 승인을 적습니다. 파일·드라이브·펌웨어를 바꾸면 다시 벤치합니다. - 서보 드라이브: 기동 때 링 위치의
vendor_id·product_code와 매핑을 스캔하는 드라이브의 매핑·리비전이 파일·승인 때와 다르면 양쪽 값을 보여 주며 활성화 전에 멈춥니다. 벤치 시작 전 남아 있던 드라이브 fault 는 경고 뒤 한 번 리셋하고, 그래도 남으면 멈추니 드라이브 알람을 해제하고 다시 실행하세요. - 서보 드라이브: 위치·속도 명령이 한계를 넘거나 명령 발행이 50 ms 넘게 끊기면 값을 자르지 않고 바로 보호 정지한 뒤 브레이크를 물립니다. 이때는 PLEM 이 감속하지 않으니 드라이브의 정지 감속(0x6084·0x6085 등)을
startup_sdo로 설정하세요. 토크 한계limits.torque_nm은 토크(cst) 축에만 적습니다(위치·속도 축은 드라이브의 0x6072). - 서보 드라이브:
protective_stop과plem-drive run의 Ctrl-C 는 위치·속도 축을 축마다 적는limits.acceleration_rad_s2(필수)로 감속해 세운 뒤 브레이크를 걸고, 제때 서지 않으면 드라이브 Quick Stop(0x6085·0x605A)으로 넘깁니다. 토크 축이 있는 버스는 바로 끕니다. 체결을 확인하지 못하면 축별 statusword 와 함께 오류 로그를 남깁니다. - 서보 드라이브: 토크 축이 없는 버스는 브레이크를 풀면 그 순간 위치를 지키고(속도 축은 0) 첫 명령부터 따르며, 토크 축이 있으면 풀기 전에 토크 명령을 보내고 있어야 합니다.
release_brake·protective_stop은requested로 답하니status의operation_enabled·brake_engaged로 확인하고, 거부 원인은rt_events에서 보세요. - 서보 드라이브: 끝 멈춤이 없는 축(
limits.position: null)을 위치(csp) 축으로도 쓸 수 있고 32비트 카운트 끝을 넘어도 끊기지 않습니다. 재시작하면 드라이브 값부터 세고, 한 방향 2⁴⁸ 카운트를 넘으면 멈추며, 32비트 범위 밖에서 끝나면 종료 때 경고합니다. 드라이브의 소프트웨어 위치 한계는 끄고, 그 밖의 드라이브 쪽 설정은 PLEM Docs 「드라이브 모델 파일」을 따르세요. - 서보 드라이브: 모델 파일에 토크 단위
rated_per_mille, SYNC0 주기를 0x1C32:02 에 쓰는dc.write_cycle_time(드라이브가 rw 로 적을 때만),dc.sync0_shift_ns, 기동 때 드라이브 저장값을 대조해 경고만 하는stored_sdo를 적을 수 있습니다. DC 기준 클록은 링에서 가장 앞 드라이브입니다(PLEM Docs 「드라이브 모델 파일」). - 서보 드라이브:
plem-drive run은 기본으로 시작 요약과 경고·오류만 보여 주고 전체 로그는--verbose로 봅니다.--monitor는 버스 상태를 1초에 한 행씩 표로,--plot은 PlotJuggler 로 제어 주기마다의 기록을 보여 줍니다(PlotJuggler 는 ROS apt 저장소에 닿으면 함께 설치됩니다). - 서보 드라이브: Panasonic MINAS A6B 두 축 예제 폴더
a6b_pair(DC 운전, 21:1 감속기 출력축 기준)에 맞물린 두 축을 거울처럼 움직이는demo.py와 동기 그래프 레이아웃이 함께 설치됩니다. 정지 감속(모터 기준 3200 rad/s²)은 무부하 벤치 값이니 설비에 맞게 정하고, 첫 운전은 부하를 떼고 시작하세요. - 센서: Neuromeka Indy7 v3 에 Aidin AFT200-D80 F/T 센서를 로봇 프로필에서 지정하면 힘·토크가
/<로봇 이름>/ft_sensor/wrench(측정 원점<로봇 이름>_ft_sensor_frame기준)로 나오고, 펜던트 3D 화면과 TUI 에 값과 상태가 보이며 펜던트나ft_sensor/zero서비스로 영점을 잡습니다. 프로그램에서는 아직 쓸 수 없습니다(PLEM Docs 「F/T 센서」). - 센서: F/T 센서가 펜던트 3D 화면에 커넥터까지 실제 모양으로 그려지고 경로 계획도 커넥터까지 피합니다. 값이 갱신되지 않으면(케이블 빠짐 등) 센서 상태에 알리고 값을 내보내지 않으며, 다시 바뀌면 저절로 풀립니다. 프로그램은 상태 토픽의
state값으로 이유를 구분합니다. 중력 보상은 하지 않습니다. - 센서: 현장에 맞춘 인식 설정(충돌 격자·nvblox 지도 범위·복셀 크기 등)을
~/.plem/perception_overrides.yaml에 적으면 PLEM 파일을 고치지 않고 덮어씁니다. 잘못된 키나 값은 기동을 거부하며, TUI 인식 프로파일 미리보기에서 적용될 값을 확인할 수 있습니다(파일이 깨졌거나 읽을 수 없으면 미리보기가 거부 사유를 보여 줍니다). - 캘리브레이션: 카메라 캘리브레이션이 있는 로봇에서 그리퍼나 F/T 센서를 바꿔 저장하면, 캘리브레이션을 이전 구성으로 측정했으니 다시 하라는 경고가 한 번 나옵니다(펜던트·TUI 로봇 설정·
plem profile·plem code). 저장과 기동은 막지 않습니다. - 펜던트: Jog 에 관절 목표 탭이 생겼습니다. 관절 각도 여섯 개를 적고 「누르는 동안 이동」을 누르고 있으면 그 자세로 이동하고, 떼거나 창이 포커스를 잃거나 연결이 끊기면 그 이동을 취소합니다(즉시 정지는 비상 정지).
- 펜던트: 작업 › 변수 탭에서 변수를 등록·편집·삭제하고 실행 중 값을 봅니다. 등록되지 않은 변수를 쓰는 노드는 검증에서 막히고, 이미 있는 이름의 추가와 저장된 프로그램이 쓰는 변수의 삭제는 거부됩니다(쓰는 곳을 알려 줌). 실행 중에는 삭제가 잠기고 타입을 바꾸면 저장 전에 알립니다.
- 펜던트: 하단 바의 ⏸ ⏹ ▶ 를 눌렀는데 서버 확인이 오지 않으면 「확정 안 됨」으로 바뀌고 다시 보내기 버튼이 생깁니다. 정지·일시정지가 확정되지 않으면 비상 정지를 안내하며, 명령을 저절로 다시 보내지는 않습니다.
- 펜던트: 실행 상태 연결이 끊기면 캔버스와 하단 바가 회색으로 바뀌고 끊긴 시각이 표시되어, 로봇의 지금 상태가 아님을 알 수 있습니다. 3D 뷰도 로봇 연결이 끊기면 마지막 자세를 회색으로 남깁니다.
- 펜던트: 배포된 Job 을 보는 중 「화면 고정」으로 노드 상태 표시를 멈춰 둘 수 있고, 「따라가기」로 실시간으로 돌아옵니다.
- 펜던트: 사이드바에 구조 탭이 생겨 열린 프로그램·Job 을 시작 노드부터 순서대로 볼 수 있습니다. 줄을 누르면 캔버스에서 그 노드로 이동하고, 실행 중에는 현재 노드를 따라갑니다.
- 펜던트: 선택한 노드는
Enter로 상세 창을 열고(배포된 Job 의 노드는 두 번 눌러 저장된 값을 읽기 전용으로 봅니다), 연결선은 선택해Delete로 지웁니다. 캔버스 빈 곳을 두 번 눌러 확대하는 동작은 없어졌습니다. - 펜던트: 하단 바에서 보낸 일시정지·재개·정지도 누가 왜 보냈는지 감사 기록에 남습니다.
- 펜던트: 한글과 영문을 한 서체(Wanted Sans)로 내장해, 기기와 관계없이 오프라인에서도 같은 글꼴로 보입니다.
- Lab: F/T 센서가 있는 로봇에 연결하면 신호 트리에
ft_sensor가 나타나 힘·토크를 그래프로 보고 CSV·JSON 으로 내보낼 수 있습니다(Runs 녹화에는 담기지 않습니다). - TUI:
plem profile set-gripper·set-ft-sensor <로봇> <모델|none>으로 명령줄에서 로봇 프로필의 그리퍼·F/T 센서를 바꿉니다(다음 기동부터 적용). 모델 이름의 앞뒤 공백은 무시하고none은 대소문자와 관계없이 해제입니다. - 서버 API:
/plem액션에move_to_joints(관절 각도 또는waypoint_name,request_id필수,cancel_action으로 취소)와waypoint_save_joints(관절 각도를 Waypoint 로 등록)가 추가됩니다. - 서버 API:
GET /api/calibration/robots/{robot}/pending-result가 측정했지만 적용하지 않은 결과(측정 시각·잔차·통과 여부)를 돌려줍니다. 이 서버가 구동하는 로봇만 다루고 다른 로봇은 403 입니다. - 서버 API:
GET /api/jobs/{id}/resume-preview가 추가되고,resume과 체크포인트를 이어받는start는 로봇이 기준 자세를 벗어나 있으면 거부합니다(422). 허용치는PLEM_RESUME_ALIGN_TOLERANCE_DEG로 정합니다. - plem code: AI 코딩 에이전트
plem code가 베타로 기본 설치에 포함됩니다. 기기 등록 때 받은 기기 키(/etc/plem/code/plem-code-key.json)로 동작하는데plem그룹이 이 키를 바꿀 수 있으니 필요한 계정만 그룹에 넣으세요. 로봇 이동·그리퍼는 운영자 확인을 받고 실행 중인 Job 이 있으면 거부합니다. 화면은 영어입니다. - 라이선스: 담당자가 라이선스를 연장하면 기기에서
sudo plem-register --refresh로 새 라이선스를 받고, 로봇 스택을 다시 시작하면 적용됩니다(PLEM Docs 「업데이트」). - 개발자 SDK: 커스텀 토크 컨트롤러가
measured.wrench()로 F/T 센서의 힘·토크를 제어 주기마다 읽을 수 있습니다. 값은 중력 보상 없는 센서 좌표 값이며,wrench_state()·wrench_zero_seq()로 값이 없는 이유와 영점이 바뀐 때를 알 수 있습니다. 기존 플러그인은 다시 빌드하지 않아도 동작합니다(PLEM Docs 「커스텀 토크 컨트롤러」). - 설치·업데이트:
plem uninstall --remove-cumotion(--all에 포함)으로 설치 때 깐 충돌 회피 구성 요소(cuMotion·nvblox)의 패키지와 저장소 등록도 제거할 수 있습니다. 다른 Isaac ROS 패키지와 torch 등 pip 패키지는 남습니다. - 펜던트: 하단 로봇 제어 바 오른쪽 끝에 「정지」(■) 버튼이 생겼습니다. 다른 조작이 잠겨 있어도 로봇 팔과 그리퍼 동작의 취소를 요청하고 BRAKED 모드 버튼처럼 진행 중인 전환을 기다리지 않고 곧바로 브레이크를 겁니다. 멈춘 그리퍼는 부품을 약하게 잡은 채이거나 놓을 수 있습니다. 비상 정지가 아니니 위험할 때는 물리 비상 정지를 누르세요.
- 설치·업데이트:
plem명령을 새plem-cli패키지가 설치합니다.plem <명령>은 이 기기에 설치된plem-<명령>을 실행하고plem --help는 설치된 명령을 보여 주므로, 쓸 수 있는 명령은 설치한 패키지에 따라 다릅니다(드라이브만 설치한 기기는plem drive). 기존plem <명령>은 그대로 동작합니다.
개선·변경56
- 서보 드라이브: 드라이브 도구의 사용법·안내 문장이
plem drive …로 바뀝니다.plem-drive …로 직접 불러도 그대로 동작합니다. - 서버 API: 기동 로그·TUI 로그와 서버의 오류·응답 문장(펜던트 알림·검증 패널·AI 채팅에 실리는 것 포함)을 영어로 통일했습니다(예:
rejected:). 이 문구로 로그를 걸러 보던 스크립트는 새 문구로 바꾸세요. 펜던트 자체 화면 문구는 그대로입니다. - 펜던트: 하단 바의 로봇 모드 전환이 글자 없이 아이콘만 보입니다 — 자물쇠 BRAKED, 곡선 TRAJ(실행 ▶ 와 헷갈리던 재생 아이콘을 바꿈), 손 FREE. 이름은 툴팁으로 보입니다.
- 로봇: 브레이크 해제나 TRAJ→FREEDRIVE 감속 같은 다른 모드 전환이 진행 중이어도 BRAKED 요청은 거부되지 않고 그 전환을 끊어 바로 걸립니다.
- 로봇: EtherCAT 슬레이브가 OP 가 아닌 축은 브레이크 해제가 거부되고
rt_events에SLAVE_NOT_OPERATIONAL이 남습니다(서보 드라이브 버스도 같습니다). 기동 직후 OP 에 닿기 전이면 잠시 뒤 다시 보내고, 계속되면sudo dmesg | grep -i ethercat에서 원인을 찾으세요. - 로봇: 기동할 때 드라이브의 통신 매핑을 검증해, 필요한 항목이 빠졌거나 어긋나면 로봇을 움직이기 전에 원인을 알리고 기동을 멈춥니다.
- 로봇: 오류 초기화 요청을 보낼 때마다 새 신호를 내, 고장이 이어지는 동안 반복한 요청도 매번 전달됩니다. 오류 표시가 사라졌는데 로봇이 멈춰 있으면 BRAKED 로 돌아온 것을 확인한 뒤 목표 모드를 다시 고르세요.
- 로봇: Neuromeka 로봇은 고장 난 축에 초기화 명령을 자동으로 보내지 않으니(브레이크 체결 마지막 단계 포함), 원인을 해결한 뒤 초기화를 요청하세요. Huayan Elfin 은 고장이 이어지는 드라이브의 자동 초기화 요청을 약 200 ms 마다, 한 번의 고장에 최대 25회 보냅니다(1 kHz 제어에서는 전과 같습니다).
- 로봇: Neuromeka Indy7 v3 의 충돌 모델 여유를 12 mm 로 넓혀, 좁은 공간의 경로 계획이 조금 보수적으로 동작할 수 있습니다.
- 로봇: JP6(Humble) 기기의 모션 계획 IK 솔버가 IKFast 에서 pick_ik 로 바뀌어 실측 기구학을 적용한 로봇도 정확히 풉니다(JP7 은 전처럼 TRAC-IK). Neuromeka IKFast 자산과 로봇 카탈로그의
motion_solver키가 없어지니, 직접 고친robot_models.yaml에 그 줄이 있으면 지워도 됩니다. - ROS 2: 새로 연 터미널의
ros2가 로봇 스택과 같은 CycloneDDS 로 고정되어(필요한 패키지는 함께 설치)ros2 topic list같은 명령이 바로 로봇을 봅니다. - ROS 2:
plem/control_command에protective_stop과 브레이크 해제(release_brake·free_drive)를 한 요청에 보내면 정지만 실행하고 실패로 응답합니다. 전에는 해제가 정지를 덮을 수 있었으니, 해제는 정지 뒤 별도 요청으로 보내세요. - 캘리브레이션: 「레코드」·「로봇」 화면이 연결된 로봇의 「현재 값」 카드로 합쳐지고 「새 캘리브레이션」은 「새 측정」이 됩니다. 카드는 실행 중/재시작 필요·다음 기동 실패 경고·재측정 권장을 보여 주고 값 사용·해제·가져오기·이름 변경·내보내기·폐기를 하며, 기준 미달이거나 판정이 없는 값은 「실기 확인」 전에 잠깁니다.
- 캘리브레이션: 저장 버튼이 바뀔 값(이전 → 새)을 보여 주는 「적용(재시작 후)」이 됩니다. 적용하지 않은 결과는 기기에 남아 스택을 다시 시작한 뒤에도 「현재 값」 카드에서 적용할 수 있습니다. 기록 이름 입력은 없어지고 라벨은 선택이며, 비우면 카메라 모델과 날짜로 이름이 붙습니다(예: zedxm-2026-10-01-v1). 기록의 측정 시각은 계산을 마친 시각입니다.
- 캘리브레이션: 화면 용어가 「Hand-eye 캘리브레이션」·「통과」/「기준 미달」·「실기 확인」으로 정리되고, 오류 메시지가 무엇을 확인할지 알려 줍니다(오류 코드는 그대로). 측정 중 안내와 측정 엔진·서버 메시지는 영어로 나오고, 로봇 스택 재시작 안내는 plem 화면의 S 키 절차입니다.
- 캘리브레이션: 새 측정은 카메라 화면을 가운데 크게 보여 주고, 자율 구동 중에는 Jog·모드 전환 등 다른 조작을 잠급니다(E-Stop 제외). 종료를 확인하지 못하면 원인 후보와 조치를 보여 주고 E-Stop 을 확인하기 전까지 새 구동을 막습니다. 측정 중이거나 저장하지 않은 결과가 있을 때 페이지를 떠나면 브라우저가 묻습니다.
- 캘리브레이션: 측정이 실패하면 원인에 맞춰 「같은 계획으로 다시 구동」·「조준부터 다시」·「보드 사양부터 다시」 중 한 곳에서 이어 합니다. 보드 사양 입력은 현재 값의 보드로 미리 채워지고, 저장한 뒤에도 결과를 복사할 수 있습니다.
- 캘리브레이션: 자율 측정의 시드는 보드를 한 번 조준하고 이동을 승인하면 로봇이 두 번째 시드를 찍고 돌아옵니다. 두 번째 자세를 찾지 못하면 물러날 거리를 안내하고, 돌아온 자세가 처음과 5 mm·5° 넘게 다르면 다시 조준하게 합니다. 캡처 방식 기본값은 자율 구동이며, 시드 캡처·이동·계획 생성은 취소할 수 있습니다(새로고침도 취소).
- 캘리브레이션: 실측 기구학을 쓰는 로봇에서도 정밀 마스터링과 도달성 계획을 쓸 수 있습니다. 세션 뒤 기하가 바뀌면 승인이 거부되니 세션을 다시 하고, 실측으로 바꾼 로봇의 기존 자동 캡처 계획은 다시 만드세요.
- 펜던트: 화면 아래 로봇 제어 바에 로봇 모드(BRAKED·TRAJ·FREE)와 ▶ ⏸ ⏹, 진행 상태, 오류가 한 줄로 모이고 상태는 한글(정지됨·실패·오류)로 보입니다. 상단에는 로봇·서버·실행 채널·서버 요청의 연결 상태가 남습니다. ⏸ 는 현재 노드가 끝난 뒤 멈추며, 기다리는 동안 그렇게 표시합니다.
- 펜던트: 보호 정지 복구 뒤 뜨던 「어떻게 재개할까요?」 창이 없어지고 하단 바의 ▶ 이어서 실행·⏹ Job 정지가 맡습니다. 이어서 실행 전에 로봇이 재개 기준 자세와의 차이를 하단 바(좁은 화면에서는 ⓘ 를 눌러)에, 기준 자세를 3D 뷰에 반투명으로 보여 주고, 「시작 위치로 이동」을 누르고 있으면 그 자세로 갑니다. 허용치(기본 5°) 밖이면 재개가 거부됩니다.
- 펜던트: 아직 보호 정지 중이면 ▶ 이어서 실행이 잠기고 이유가 보입니다. 자세를 기록하지 않은 옛 체크포인트는 기준 자세가 없어 이어서 실행이 거부되니 ⏹ Job 정지 뒤 처음부터 실행하세요.
- 펜던트: 서버가 종료되거나 멈춘 뒤 다시 켜지면, 실행 중이던 Job 은 체크포인트가 있을 때 「복구 대기」로 표시되어 이어서 실행하거나 정지할 수 있습니다. 일시정지·복구 대기 Job 은 새로고침하거나 다른 기기에서도 이어서 실행하거나 정지할 수 있습니다.
- 펜던트: 왼쪽 사이드바가 아이콘 막대(작업·로봇·캘리브레이션)와 패널로 나뉘고 좁은 화면에서는 패널이 캔버스 위에 떠서 열립니다. 오른쪽 아래 탭 4개는 없어지고 Jog 는 3D 뷰 아래에 붙으며, 오른쪽 3D 열은 접을 수 있습니다(실행하면 펼쳐집니다). 노드 추가는 작업 › 노드 탭으로 모이고 상단 「+」는 없어집니다.
- 펜던트: 화면 테두리가 어두운 배경 하나로 통일되고 가운데 작업 화면이 밝아지며, 캔버스 도구 버튼과 노드 상세의 섹션 링크가 장갑 낀 손으로 누르기 쉽게 커집니다. 목록의 행 동작(이름 변경·삭제 등)은 행 오른쪽 「⋯」 메뉴로 들어가고 삭제는 한 번 더 확인합니다.
- 펜던트: 서버가 로봇 이름을 알려 주기 전에도 화면이 먼저 뜨고, 로봇을 움직이는 조작만 「로봇 연결 확인 중」으로 잠깁니다. 연결에 계속 실패하면 상단 배너에 재시도 버튼이 뜹니다.
- 펜던트: 수동 조작 중 로봇 모드가 바뀌거나 3D 뷰를 접거나 연결이 끊기면 조작이 자동으로 멈추고 그 이유가 Jog 패널에 남습니다. 펜던트를 모두 닫으면 서버가 조작 세션 해제를 시도합니다.
- 펜던트: Jog 의 서보 표시가 「서보 정상」이 되고 직교 ± 버튼에 3D 뷰와 같은 축 색(X 빨강·Y 초록·Z 파랑)이 들어갑니다. Waypoint 목록의 「이 위치로 이동」은 누르고 있는 동안만 이동하고 떼면 취소하며, 이름이 정확히 같은 Waypoint 만 움직입니다.
- 펜던트: 이동 노드 상세의 「현재 위치로 갱신」이 확인 창을 거치며, 그 이름을 쓰는 모든 노드에 적용된다고 먼저 알립니다.
- 펜던트: 실행 목록은 끝난 Job 을 최근 20건씩 보여 주고 「더 보기」로 펼치며, 다른 클라이언트가 저장 없이 돌리는 실행은 맨 위에 「서버 실행」으로 표시됩니다. 배포 직후와 실행 시작 때 캔버스가 그 Job 을 보여 주고, 상단 바는 열린 문서의 이름과 상태만 표시합니다.
- 펜던트: 로봇 편집의 그리퍼·F/T 센서 선택에서 이 기기에 설치되지 않은 모델이 「(없음)」 대신 「<모델> (미설치)」로 보입니다.
- 펜던트: 병렬 노드가 레인(모션·보조)으로 바뀝니다. 로봇을 움직이는 노드는 모션 레인에서만 실행되고 레인 안 노드는 같은 레인끼리만 연결됩니다. 옛 파일은 열 때 변환되며, 갈래가 노드를 공유하던 파일은 고쳐야 합니다.
- 펜던트: 반복 상자에 유형(항상·횟수·조건)이 생기고 머리글에 실행 중 회차가 보입니다. 「반복 끝내기」·「다음 회차로」 인렛으로 중단과 다음 회차(남은 본문 건너뜀)를 잇고, 이전 저장본은 횟수가 있으면 「횟수」, 없으면 「항상」으로 읽힙니다. 최대 실행 단계(
max_steps)는 반복·병렬 안에도 적용됩니다. - 펜던트: switch 가 비교 대상 하나와 case 행, 「그 외」 출구로 바뀌고 옛 switch 는 열 때 바뀝니다. 대상 타입과 맞지 않던 출구(예:
2.50)는 미설정 case 로 남으니 지우거나 값을 고치세요. 조건 노드 상세는 저장된 식을 맨 위에 보여 주고, 비교는==·>처럼 식과 같은 기호로 고릅니다. - 펜던트: 노드의 출구가 슬롯 행이 되어 빈 슬롯을 누르면 노드 팔레트가 열리고 캔버스의 노드를 누르면 바로 연결됩니다. 노드 위의 「+」는 없어졌고, 반복을 끝내는 연결은 상자 머리글을 눌러 만듭니다.
- 펜던트: 연결하지 않은 출구에서 흐름이 끝나면 정상 완료로 기록되고 하단 바의 완료 표시에 그 출구가 보입니다. 한 노드에서 여러 출구가 참이면 저장된 출구 순서에서 앞선 것(빈 슬롯 포함)을 고르고, 실행 중 캔버스는 실제로 지나간 연결선과 나간 출구만 색으로 표시합니다.
- 펜던트: 노드 카드와 노드 목록은 스킬 코드(
motion.move_linear등) 대신 종류별 색 아이콘을 보입니다(코드는 노드 상세 창). 반복·조건 상자에는 긴 식 대신 「항상」·「5회」·「조건」 같은 요약이 보이고 전문은 상세 창에서 봅니다. 상세 창 검증의 오류·경고는 한국어로 보입니다. - 펜던트: 반복·병렬 상자에 실선 테두리와 안쪽 여백이 생깁니다(옛 파일은 열 때 상자가 한 번 넓어질 수 있고 노드 위치는 그대로). 팔레트로 만든 노드는 겹치지 않는 자리에 놓이고 반복 상자는 필요한 만큼 늘어나며, 자리가 없으면 노드를 만들지 않고 이유를 보여 줍니다.
- 펜던트: 반복 상자에서 노드를 빼거나 넣으면 경계를 넘는 연결이 끊기고 끊긴 수를 알려 줍니다. 상자를 지우면 안의 노드는 바깥으로 나오고 상자 안에 상자를 새로 만들 수는 없습니다. 상자를 복사하면 안의 노드와 연결·조건식 참조가 함께 복사됩니다(시작 노드 제외).
- 펜던트: 노드 ID 의
-는 조건식에서 쓸 수 있도록 열거나 배포할 때_로 바뀌고 연결·참조도 함께 갱신됩니다. 반복 안에서 시작 슬롯과 이어지지 않은 노드는 「도달 불가」로 표시되고 실행되지 않습니다. - 펜던트: 배율은 25–150% 이고 80% 미만에서는 개요로 보이며, 노드를 누르면 그 노드 중심으로 확대됩니다. 프로그램을 열면 시작 노드 주변을 보여 주고 전체 보기는 ⤢ 버튼입니다.
- 펜던트: 보호 정지는 화면 위 띠 대신 하단 바의 로봇 모드 옆 P-STOP 표시와 ↻ 복구 버튼으로 알립니다. 그동안 TRAJ·▶·Jog·Waypoint 이동·캘리브레이션 구동은 잠기고, BRAKED·FREE·⏸·⏹ Job 정지와 오른쪽 끝 「정지」는 남습니다(로봇이 보호 정지를 보고하는 동안은 BRAKED 도 잠김). 복구 대기의 「시작 위치로 이동」은 하단 바 ▶ ⏹ 옆으로 옮겼습니다.
- TUI: TUI 와 로봇 스택(launch·노드·서버) 로그가
~/.plem/log에 모입니다. TUI 는 켤 때마다plem_tui_<시각>.log를, 로봇 스택은 기동할 때마다<시각>/폴더를 새로 만들고 각각 최근 20개만 남깁니다(이전 위치의 로그는 지우지 않습니다). RViz 같은 보조 도구와 손으로 띄운ros2 launch는 전처럼~/.ros/log에 남습니다. - TUI: 설정 화면과 상태줄의 도메인 표시는 기동 때 적용된 값이고, 바꾸면 plem 을 다시 시작할 때까지 「restart plem to apply」가 붙습니다.
~/.plem/settings.yaml의ros_domain_id가 1–101 정수가 아니면 도메인 0 으로 뜨는 대신 파일 경로와 허용 범위를 보여 주며 시작을 거부하니 그 줄을 고치거나 지우세요. - TUI: Joint Move 기본 자세(zero·packaging·jog left/right)가 첫 실행 때
~/.plem/settings.yaml의poses에 기록되고, 그 뒤로는 이 파일이 기준입니다. 지운 자세는 되살아나지 않으며 파일을 직접 고쳐도 됩니다. - 설치·업데이트: 드라이브 기능이 새 패키지
plem-drive로 나뉩니다.plem update가 함께 설치하므로 조치할 것은 없습니다. - 설치·업데이트:
plem uninstall --keep-license는 라이선스와 함께 plem code 기기 키도 보존합니다. 제거해도 기기 등록은 남아 다시 설치하려면 기존 등록 처리가 필요하니, 패키지만 갱신할 때는plem update를 쓰세요(자세한 절차는 PLEM Docs 「명령줄」의plem uninstall). - 라이선스: 라이선스가 없거나 만료됐거나 확인할 수 없으면 펜던트·Lab 대신 원인과 조치를 담은 안내 페이지가 뜨고 서버 기능이 막힙니다. 조치한 뒤 로봇 스택을 다시 시작하세요(PLEM Docs 「문제 해결」).
- 라이선스:
plem-register·plem remote·plem update·plem code의 토큰·등록 오류 안내가 원인별로 바뀝니다. 토큰 거부는 토큰 폐기와 라이선스 만료를 각각의 조치와 함께 알리고, 라이선스 파일만 잃었으면 재등록이 아니라 담당자에게 재발급(만료됐으면 Renew)을 요청하라고 안내합니다. - 라이선스: 라이선스 계약이 판 1.1 로 바뀌어 수집 항목(기기 등록 정보·버전·plem code 대화·도구 입출력·서버 접속 기록·원격지원 세션 기록·로봇 운영 기록(제6호))과 목적·보존 기간을 별표에 적습니다. plem code 대화는 모델 재학습에 쓰지 않고 보존 기간 뒤 지우니 자격증명·개인정보는 붙여넣지 마십시오. 전문은 기기의
/usr/share/doc/plem-core/에 있습니다. - 라이선스: 라이선스 계약(판 1.1) 제8조 제3항에 단서를 더해 LGPL 등 제3자 라이선스가 요구하는 범위에서 PLEM 의 수정과 그 디버깅을 위한 리버스 엔지니어링을 허용하고, WIM 이 설치해 인도한 기기의 GPL 등 구성 요소 소스코드를 요청하면 인도일부터 3년 이상 제공하며 의존 패키지 라이선스 고지 위치(
THIRD-PARTY-NOTICES, 제4항)를 적었습니다(PLEM Docs 「라이선스」). - 문서: 공개 문서 사이트의 변경 이력이 버전별 타임라인과 목차로 바뀌고 이전 버전은 접혀 보입니다. 개요에는 호환성 주의 요약과 상황별 진입점이 생기고, 채널을 바꿔도 같은 페이지에 머물며 모바일에서 표와 제목이 읽기 쉬워집니다.
- 설치·업데이트:
plem update가 시작할 때 최신 업데이트 절차를 받아 진행하므로, 여러 버전을 건너뛰어도 그 사이 추가된 단계를 모두 거칩니다. 업데이트로 더 이상 쓰이지 않게 된 패키지는 이름과 정리 명령을 알려 드립니다(자동으로 지우지 않습니다). - 설치·업데이트: 이미 설치·등록된 기기에서 설치 명령을 다시 실행하면 아무것도 바꾸지 않고
plem update를 안내합니다. 다른 기기에서 옮겨 온 디스크처럼 남아 있는 라이선스가 이 기기 것이 아니면 설치 단계에서 멈춥니다(전에는 설치가 끝난 뒤 실행 화면이 기기 불일치로 잠겼습니다). Jetson 이 아닌 호스트는 시작 전에 거부하고, 시스템 기본 로캘을 더 이상 바꾸지 않으며, 완료 화면에 재로그인 등 남은 할 일을 보여 줍니다. - 캘리브레이션: 자율 측정의 「중단」(이제 아이콘 버튼)이 이동 중에도 로봇을 그 자리에 멈추고 측정을 끝냅니다. 브레이크는 걸지 않습니다.
- 서버 API: WebSocket
execute_stop이 같은 연결의 다른 액션이 실행 중이어도 바로 처리되고, 모든 클라이언트의 궤적·그리퍼·캘리브레이션 goal 과 실행 중인 Job 의 취소를 요청한 뒤BRAKED를 확인될 때까지 요청하고, 실패하면 오류로 답합니다.
수정35
- Lab: 관절 브레이크가 아직 풀리거나 잠기는 중이면 컨트롤러 튜닝 적용을 막고 그 이유를 알려 줍니다. 브레이크 동작이 끝난 뒤 다시 적용하면 됩니다.
- 캘리브레이션: 측정 중 검출 품질이 캡처 직후 0% 로 떨어지지 않습니다. 이동·카운트다운·카메라 끊김처럼 새 관측이 없는 동안에는 마지막 값을 흐리게 「마지막 값」으로 보여 주고, 보드 인식 표시는 새 관측이 있을 때만 켜집니다.
- 로봇: Elfin 의 전원을 켠 뒤 처음 기동하면 서보를 켜기 전 관절 각도가 실제 자세와 다르게(15°·20° 등) 보이고, 첫 브레이크 해제에서 J2 고장으로 보호 정지가 걸리던 문제를 고쳤습니다. 이제 처음부터 실제 자세가 보이고 첫 해제도 정상으로 진행됩니다.
- 로봇: 로봇 스택을 정지할 때마다 이동 계획 노드(
move_group)가 비정상 종료(exit code -11) 오류를 남기던 문제를 고쳤습니다. - 로봇: 같은 순간에 난
/rt_events이벤트가 사라지거나 섞일 수 있던 문제를 고쳤습니다. - 로봇: 한 번 비활성화한 로봇 하드웨어를 같은 스택에서 다시 활성화하는 요청은 거부합니다. 전에는 성공한 것처럼 보였지만 이후 비활성화가 제어를 멈추지 못했습니다. 다시 쓰려면 로봇 스택을 재시작하세요.
- 로봇: 브레이크 해제 뒤 이동 명령 없이 멈춰 있을 때 위치가 조금씩 밀리던 문제를 고쳤습니다.
- 로봇: 트래커 조종에서 시작 위치가 맞지 않아 거부된 동작을 놓을 때 팔이 거부된 목표로 끌려가던 문제를 고쳤습니다(JP7 만 해당).
- 로봇: 오래된 형식의 프로필에서 그리퍼를 해제해도 다음 기동에 예전 그리퍼가 다시 올라오던 문제를 고쳤습니다.
- 그리퍼: 케이블이 빠지거나 툴 전원이 꺼진 그리퍼가 마지막 상태를 정상인 것처럼 계속 보이던 문제를 고쳤습니다. 이제
gripper_status의connected가 false 가 되고 TUI 에 not answering 이 뜨며, 다시 연결하면 몇 초 안에 저절로 돌아옵니다. - 그리퍼: 그리퍼 명령이 드물게 빠지거나 직전 명령과 섞일 수 있던 문제를 고쳤습니다. 동작을 취소하면 정지 명령은 다음 상태 확인 때(최대 약 0.1초) 나갑니다. 업데이트한 뒤에는 로봇 스택을 완전히 내렸다가 다시 기동하세요.
- 그리퍼: 드라이버가 첫 상태를 받기 전에는 상태를 내지 않고 그 사이의 명령은 실패로 끝납니다. 상태가 보이면 다시 보내세요. Danhae 는 첫 열기·닫기 전까지 폭이 0.0 으로 보이고 첫 닫기가 이미 닫힌 것으로 판정될 수 있습니다.
- 센서: 카메라 데몬을 다시 시작하거나 부팅 뒤 카메라를 연결했을 때 「모션 센서를 찾을 수 없음」으로 열리지 않던 문제를 고쳤습니다(케이블 불량처럼 보이던 증상).
- 캘리브레이션: 자동 캘리브레이션의 이동 계획이 로봇 설정의 그리퍼·카메라로 충돌을 검사합니다. 전에는 설정과 관계없이 RG6 그리퍼와 ZED X Mini 를 단 것으로 계산했습니다.
- 캘리브레이션: 캘리브레이션 전에 쓰는 카메라 기본 위치가 F/T 센서와 그리퍼 회전을 따라갑니다(전에는 카메라를 센서 높이 약 52 mm 만큼 낮게 계산했습니다). 측정 때와 카메라 모델이나 툴 회전이 다른 캘리브레이션 값은 기동을 막지 않고 경고한 뒤 이 기본 위치를 쓰며, 다시 측정할 때까지 인식 기능은 꺼집니다. 전에는 카메라를 바꾸면 기동이 실패했습니다.
- 캘리브레이션: 「실기 확인」에서 보드를 클릭하면 이동 계획이 관절 해를 찾지 못해 거부되던 문제를 고쳤습니다. 이제 툴의 현재 자세에서 이어 가며 관절 해를 찾아 클릭 지점 위 2 cm 까지 관절 이동으로 가고, 이어지는 카운트다운 동안 「취소」로 멈출 수 있습니다.
- 펜던트: 정지·일시정지·재개·재실행·삭제 요청이 겹칠 때 Job 이 엉뚱한 상태로 남거나 재개 정보를 잃던 문제를 고쳤습니다. 실행 직후 누른 정지도 첫 동작 전에 적용되고, ▶ 실행은 편집 내용의 저장이 끝난 뒤 시작하며 저장에 실패하면 사유를 보여 줍니다. 저장 중에 다시 편집하고 창을 닫아도 최신 내용을 저장합니다.
- 펜던트: 일시정지·재개 뒤에도 보호 정지를 계속 감지하고, 노드 사이에서 보호 정지된 뒤 이어서 실행하면 다음 노드부터 재개합니다(반복·하위 프로그램 안에서는 그 노드를 처음부터).
- 펜던트: 배포 탭의 ▶ 가 보호 정지·복구 대기 Job 에 재개 대신 새 시작을 보내던 문제와, 다른 Job 을 보는 중 시작한 새 Job 이 취소되던 문제를 고쳤습니다. 재개는 Job 을 연 뒤 하단 바의 ▶ 이어서 실행으로 합니다.
- 펜던트: 서버 재시작·네트워크 끊김 뒤 실행 상태 연결이 다시 붙지 않거나 끝난 Job 이 「실행 중」으로 남던 문제, 끝난 Job 을 열면 「연결」이 「연결 이상」으로 남던 문제, 설계 탭에서 프로그램을 열어도 Job 화면에 머물던 문제를 고쳤습니다.
- 펜던트: 배포한 Job 의 노드 오류가 오류 목록에 뜨지 않고 이전 실행의 오류가 남던 문제를 고쳤습니다. Job 이 끝나는 순간 연 화면에도 종료 결과가 표시되고, 정지 버튼 설명은 정지하면 재개 지점을 버린다고 안내합니다.
- 펜던트: 되돌리기(Ctrl+Z)·다시 실행한 내용이 저장되지 않아 취소한 편집이 실행되던 문제를 고쳤습니다(여러 노드를 한 번에 지운 것도 한 번에 되돌립니다). 두 손가락으로 확대·축소할 때 노드가 선택되던 문제도 고쳤습니다.
- 펜던트: 편집기와 서버의 조건식 판정이 달라 서버가 받는 식을 편집기가 오류로 보이던 문제를 고쳤습니다. 한글 출력 이름과 특수 공백을 양쪽이 받고, 숫자는 일반 숫자(0–9)만 받습니다.
- 펜던트: 오류 목록의 「노드로 이동」이 반복 상자 안 노드를 잘못 찾아가던 문제와 캔버스의 화면 낭독 안내가 영어로 나오던 문제를 고쳤습니다.
- TUI: 설정 화면에서 로봇을 저장할 때 그리퍼 해제가 일부만 반영되거나 연결 방식이 EtherCAT 도구 채널로 잘못 적히던 문제를 고쳤습니다. 연결 방식을 알 수 없으면 저장을 거절하거나 비워 두어 그리퍼 드라이버를 띄우지 않습니다.
- TUI: 설정 화면에서 로봇을 저장할 때 그 사이 펜던트가 바꾼 항목을 되돌리지 않습니다. 같은 항목을 양쪽이 바꿨으면 저장을 거절하고 다시 열어 저장하라고 안내합니다.
- TUI: 그리퍼·카메라 목록이 비었을 때 상관없는
plem init을 권하던 안내를 고쳐, PLEM 환경과 로봇 패키지 설치를 확인하라고 안내합니다. - TUI: 설정 화면에서 로봇 행의 Del 이 확인 없이 바로 로봇 프로필을 지우던 문제를 고쳤습니다. 이제 되돌릴 수 없다고 묻고
y를 눌러야 지웁니다. - TUI: 보호 정지 중
R의 안내가 관절·작업영역 한계 정지에서는 풀리지 않는 순서를 알려 주던 문제를 고쳤습니다. 한계 정지는f로 Freedrive에 들어가 팔을 범위 안으로 옮긴 뒤R, 안전 상태가NORMAL·모드가FREE일 때f로 브레이크를 거는 순서로 안내합니다. - 설치·업데이트: 충돌 회피 구성요소를 설치한 기기에서 카메라를 켜도 영상이 나오지 않던 문제를 고쳤습니다(launch 로그의
libgxf_serialization.so: cannot open shared object file). 업데이트하면 자동으로 적용되며, apt 로 직접 업그레이드했다면sudo /usr/share/plem/setup-cumotion.sh를 한 번 실행하세요. - 설치·업데이트: JetPack 7 기기의 온보딩이 쓰지 않는 가상 디스플레이 구성을 더 이상 하지 않습니다. 이미 온보딩된 기기의 구성은 남으며,
plem uninstall때 원래대로 되돌립니다(재부팅 후 적용). - 라이선스: 라이선스 파일을 손으로 복구하는 안내가 권한까지 맞추는 명령(
sudo install -m 0644 …)을 제시하고,/etc/plem/depot.json의token·depot_url이 문자열이 아니면 토큰 거부가 아니라 설정 오류로 알립니다. 보드나 네트워크 모듈을 교체하면 새 기기로 등록되니, 교체 뒤에도 「이미 등록됨」이 나오면 검출된 serial·MAC 을 확인하세요. - 로봇: 툴 질량이 음수이거나 10 kg 을 넘으면 Payload 없이 기동하던 문제를 고쳐, 어느 값이 틀렸는지 알리고 기동을 멈춥니다.
- 로봇: Elfin 에 카메라를 설정하면 로봇 모델과 중력 보상에서 빠지던 문제를 고쳤습니다. ZED 카메라는 이 로봇에서 캘리브레이션한 뒤 장착됩니다.
- 로봇: 그리퍼에 브래킷으로 붙는 카메라의 무게중심이 그리퍼 회전과 F/T 센서 높이를 따라가, 그 구성에서 중력 보상이 정확해집니다.
제거15
- 서버 API: Job 의
/restart와/ws/jobs/{id}명령 수신이 없어졌습니다. 실행 제어는 REST 의 start·pause·resume·stop 을 쓰고, 처음부터 실행하려면 stop 뒤 start 를 부르세요. Job 상세의started_at·completed_at도 빠집니다. - 서버 API: 펜던트의 3D 환경 맵 표면·「3D 확인」 탭이 없어지면서 쓰는 곳이 사라진
collision_avoidance·nvblox_enabled·perception_mode가/plem접속 직후 오는session_meta에서 빠집니다. 이 값을 읽던 클라이언트는 그 처리를 지우세요. - 서버 API: 스킬 목록을 디스크에서 다시 읽던
POST /api/catalog/reload가 없어졌습니다. 스킬 목록은 서버가 시작할 때 읽으니, 이 경로를 부르던 스크립트는 그 호출을 지우세요. - 서버 API: 서버가 UDP 9999 포트에서 응답하던 기기 탐색(
PLEM_DISCOVER)과 이를 설정하던 환경변수PLEM_UDP_HOST·PLEM_UDP_PORT·PLEM_DEVICE_MODEL이 없어졌습니다. 펜던트는 이 기능을 쓰지 않아 영향이 없습니다. - 개발자 SDK: PLEM 코어 C++ 헤더에서 쓰이지 않던 IPC 채널·레거시 통신 모드와 모음 헤더
plem/ipc.hpp·plem/fieldbus.hpp·plem/control.hpp가 없어졌습니다. 소스로 빌드한다면 필요한 개별 헤더를 직접 include 하세요. - 펜던트: 「즉석 실행」 버튼과 프로그램 모드 선택(Design·Snapshot·Live,
Ctrl+1~Ctrl+3)이 없어지고 ▶ 하나가 검증·배포·시작을 한 번에 합니다. 캔버스는 프로그램이나 배포된 Job 하나를 보여 주며, 실행·보호 정지·복구 대기 중에는 프로그램으로 돌아갈 수 없습니다. 처음부터 다시 하려면 ⏹ 뒤 ▶ 를 누르세요. - 펜던트: 프로그램의 작업 영역 상자(워크스페이스)와 그 검사가 제거됩니다. 남는 안전장치는 운영자 입회·속도 제한·관절 한계·자기충돌 검사·비상 정지이며, 저장돼 있던 상자 값은 읽을 때 자동으로 버려집니다.
- 펜던트: AI 프로그램 작성 기능(라이브러리의 AI 탭, 음성 입력)과 펜던트·TUI 설정의 OpenAI API Key 항목이 제거됩니다.
~/.plem/settings.yaml에 남은openai_api_key는 지워도 됩니다. - 펜던트: 실행 기능이 없던 카메라·비전·IO 노드가 제거됩니다. 이 노드가 실행 흐름에 연결된 프로그램은 배포가 거부되니 편집기에서 지우세요.
- 펜던트: 프로그램을 고친 뒤 뜨던 「재배포 필요」 표시와 직선 이동 노드에서 동작하지 않던 「PoseRef 연결」 선택지가 없어졌습니다.
- 펜던트: 3D 뷰의 환경 맵 표면과 인식 상태 배지, 캘리브레이션 확인 창의 「3D 확인」 탭이 없어집니다. 카드 버튼은 「실기 확인」이 되고 잔차·현재 값 상태는 실기 확인 화면에 보이며, 카메라만 켜져 있으면 충돌 회피(cuMotion)·환경 맵(nvblox)을 끈 구성에서도 실기 확인을 쓸 수 있습니다.
- 펜던트: 하위 프로그램(
custom.*노드) 실행 기능이 없어졌습니다. 펜던트에서 만들 수 없던 노드라 일반 프로그램는 영향이 없고, 가져온 파일의 이 노드가 실행 흐름에 연결돼 있으면 이전처럼 스킬 목록에 없는 스킬로 배포가 거부되니 편집기에서 지우세요. - TUI:
plem ros2 <인자>가 없어졌습니다. 새 터미널에서ros2를 바로 쓰세요. - TUI: 위쪽 상태 줄의 NITROS 칸이 없어지고, EtherCAT 칸은 연결이 끊겼을 때만 빨간
✖를 붙입니다. - ROS 2: nvblox 환경 메시를 보내던
/<로봇 이름>/perception/environment_scene토픽과plem_msgs/EnvironmentScene메시지, 이를 싣던plem-perception-scene패키지가 없어집니다.plem update가 그 패키지를 저절로 지우며, 장애물 회피(nvblox)는 그대로입니다.
v0.9.0
변경 24건 보기
호환성 주의7
- 로봇: 관절 브레이크 조작이 전 벤더에서 전원과 함께 움직입니다 — 해제는 관절에 전원을 넣어 자세를 잡은 채 풀고(이동(TRAJECTORY)·Freedrive 모드에서만 받아들입니다), 체결은 전원을 내려 잠급니다.
- 로봇: 전원을 끈 채 브레이크만 풀어 팔을 손으로 밀던 조작이 없어집니다 — 충돌 뒤 재배치는 화면의 복구 조작으로 오류를 초기화한 다음 Freedrive에서 중력보상을 받으며 손으로 옮기고, 보호 정지가 살아 있으면 원인(비상 정지 버튼, 팔이 밀고 있는 외력)을 먼저 없애 안전 상태가 NORMAL 로 돌아온 뒤 Freedrive로 들어갑니다.
- 로봇: Indy7 계열·Elfin10-L 은 기기 시리얼 없이 기동하면 즉시 오류로 멈춥니다 — 관절 보정값의 유일한 원천이 기기별 프로필(
~/.plem/profiles/<시리얼>.json)이라 이전처럼 시리얼 없이 보정값 0 으로 조용히 기동해 자세가 어긋나는 일을 막는 것으로, plem TUI 로 기동하면 로봇 프로필에 등록된 시리얼이 자동으로 전달됩니다. - 로봇: Elfin 로봇의 모션 계획이 Pilz(PTP·LIN·CIRC) 전용으로 바뀝니다 — 계획기를
ompl로 지정해 둔 RViz·MoveIt 구성은 Pilz 로 바꿔야 하고, Elfin 에는 장애물 회피 계획이 제공되지 않습니다. - 로봇: 장애물 회피가 필요한 계획 요청은 충돌 회피(cuMotion)가 켜져 있지 않으면 다른 계획기로 대체되지 않고 거부됩니다 — 회피 계획은 cuMotion 을 켠 Humble 트레인의 Neuromeka 로봇에서만 실행되고 그 밖에서는 기본(결정론적) 계획으로 바꿔 보내야 하며, 계획기를 직접 지정하던
planner_hint도 더는 계획기를 바꾸지 못하고 다르면 거부되니 이 값은 비우고 회피 필요 여부로 요청하십시오. - 그리퍼: 그리퍼 하드웨어 플러그인 이름이
neuromeka_robot_driver/GripperHardwareInterface에서plem_robot_nodes/GripperHardwareInterface로 바뀝니다 — 옛 이름을 손으로 적어 둔 URDF 는 기동에 실패하므로 새 이름으로 고쳐야 합니다(제공된 그리퍼 xacro 를 그대로 쓰는 구성은 조치가 필요 없습니다). - 튜닝: b0 자동 튜닝이 위치영역 하나로 통일되면서 같은 이름의 튜닝 액션이 다른 계약을 갖습니다 —
TuneB0Position(tune_b0_position)을 쓰던 호출자는TuneB0(tune_b0)로, 튜닝 도구는online-position대신online서브커맨드로 바꾸고adapt_sign은 ±1 을 반드시 명시해야 합니다(속도영역 튜너는 은퇴).
새 기능1
- 문서: 공개 문서 사이트에 plem TUI · Teaching Pendant · Plem Lab 사용 가이드가 화면별 페이지로 들어갑니다 — 기동 구성·제어·정지와 복구·조작·튜닝·실행 절차를 실제 화면 캡처와 함께 단계별로 설명합니다.
개선·변경6
- 문서: 카메라(ZED X Mini)와 충돌 회피(cuMotion)가 ROS 2 Humble 트레인에서만 제공되는 점을 하드웨어·기동 안내에 명시합니다.
- 로봇: 서버가 로봇의 기준 프레임과 벤더 도구(마스터링·도달성 검사)를 설치된 로봇 카탈로그에서 해석합니다 — Neuromeka 고정값을 없애 다른 벤더 로봇(Huayan Elfin)에서도 장면·캘리브레이션 흐름이 올바른 프레임으로 동작합니다.
- 안전: 로봇 모션 잠금(캘리브레이션·TUI·서버 사이의 동시 조작 방지)을 한 구현으로 통일합니다 — 구성 요소마다 따로 두던 사본이 서로 다른 잠금 파일을 잡아 배타가 조용히 풀릴 수 있던 경로를 없앴습니다.
- 문서: AI 코딩 에이전트용 문서(
depot.wimcorp.dev/docs/<버전>/llms.txt)가 공개 문서 사이트와 코드에서 컴파일한 위키(전수 인덱스 + 자기완결 페이지)로 바뀝니다 — 구 developer manual 챕터 재발행을 중단합니다. 이 문서는 플러그인 없이 어떤 코딩 에이전트에서도 같은 URL 로 씁니다(Claude Code 용plem-docs플러그인은 은퇴). - 로봇: plem TUI 에서 Huayan Elfin 로봇을 골라 그대로 기동할 수 있습니다 — 로봇 종류가 지정되지 않으면 엉뚱한 로봇으로 기동하지 않고 즉시 오류로 알리며, 관절 목록도 벤더와 무관하게 올바로 읽습니다.
- Jog: Teaching Pendant 에서 Jog 속도를 1 % 단위로 지정합니다 — 슬라이더가 1 % 격자로 움직이고 ±1 % 버튼과 퍼센트 표시가 함께 붙습니다.
수정8
- 문서: 릴리스마다 공개 문서 사이트가 Humble·Jazzy 두 트레인 모두 같은 버전으로 갱신됩니다 — 이전에는 Jazzy 문서가 0.6.5 에 머물러 있었습니다.
- 로봇: JP7 기기에서 관절 이동 명령이 모두 "IK solver" 오류로 거부되던 문제를 고쳤습니다 — Jazzy 트레인의 로봇 패키지가 IK 솔버 플러그인(TRAC-IK)을 함께 설치합니다.
- Teaching Pendant: JP7 기기에서 3D 패널을 연 뒤 rosapi 노드가 종료돼 3D 로봇 모델·Plem Lab 로봇 검색이 되지 않던 문제를 고쳤습니다 — 설치·업데이트 시 rosapi 의 알려진 결함을 자동 보정하고, rosapi 가 apt 로 갱신돼도 다시 적용됩니다.
- Teaching Pendant · Plem Lab: 로봇 모델을 읽을 때 존재하지 않는 노드까지 조회해 로그에
Service /robot_state_publisher/get_parameters is not available가 남던 동작을 없앴습니다. - 로봇: 설정 화면에서 Elfin 로봇에 '플래닝 미지원' 표시가 잘못 붙던 것을 없앴습니다 — 이 로봇은 실제로 모션 계획이 됩니다.
- 로봇: Elfin10-L 에서 브레이크를 푸는 중 드라이브가 고장으로 떨어져 관절이 잠긴 채 보호 정지로 무너지던 문제를 고쳤습니다 — 이전 운전에서 남은 고장도 전원 재투입 없이 초기화됩니다.
- 로봇: Elfin10-L 의 링크 질량·무게중심·관성과 토크 환산 값을 벤더 자료를 근거로 정정하고 제어 튜닝 기본값을 다시 잡았습니다 — 중력보상이 과하게 걸려 Freedrive에서 팔이 밀리던 현상과 화면 토크 표시의 오차가 개선되며, 일부 관절 모듈과 Freedrive 밀림은 실기 확인이 남아 있습니다.
- 문서: 문서 사이트 주소로 들어가면 배포판 선택 화면 대신 문서 첫 화면으로 바로 연결됩니다 — 배포판(Humble/Jazzy) 전환은 상단 토글에서 합니다.
제거2
- 문서: plem-tui 패키지가 개발자 매뉴얼 PDF(
/opt/plem/share/doc/plem-developer-manual.pdf)를 더 이상 동봉하지 않습니다 — 개발자 문서는 공개 문서 사이트(https://www.wimcorp.co.kr/plem/)가 정본이며, PDF 는 릴리스 산출물로만 제공됩니다. - 로봇: 드라이버에 등록되지 않은 로봇 모델 12종(icon·indyrp2·nuri·opti·indy12 계열)을 선택 목록에서 제거합니다 — 목록에는 드라이버 레지스트리에 등록된 모델(Indy7 계열, Elfin10-L)만 남으며, 이전에는 제거된 항목을 고르면 'Unknown robot model' 로 실패했습니다.
v0.8.0
변경 6건 보기
새 기능2
- 그리퍼: JP7(Ubuntu 24.04) 기기에서도 Danhae 그리퍼 패키지가 함께 설치됩니다.
- 튜닝: 위치영역 b0 온라인 튜닝 도구가 추가됩니다 (전문가용).
개선·변경2
- 패키징: 모든 릴리스 패키지를 격리된 컨테이너에서 빌드하고, 설치 검증을 통과한 산출물만 발행합니다.
- Jog: Jog 명령의 적용이 불확실하게 끝난 경우 화면이 이를 구분해 표시합니다.
수정2
- Jog: JP7 기기에서 Jog 실패 후 복구가 이어지지 않던 문제를 고쳤습니다.
- 로봇: JP7 기기에서 Freedrive 명령이 올바로 전달되지 않던 문제를 고쳤습니다.
v0.7.1
이 버전에는 사용자에게 보이는 변경이 없습니다.
v0.7.0
변경 15건 보기
새 기능1
- 설치: 파이썬 구성 요소가 필요한 라이브러리를 패키지에 담아 배포합니다 — 설치·업데이트 중 인터넷이 끊겨도 완료됩니다.
개선·변경6
- 설치: 통신 설정·실시간 권한·환경 변수·카메라 권한을 패키지가 직접 관리합니다. 설치하면 항상 갖춰지고, 제거하면 함께 정리됩니다.
- 업데이트: 설치 대상 목록을 대표 패키지 하나가 관리해
plem update가 구성 요소를 빠뜨리지 않습니다. - 원격 지원: 원격 지원 도구가 라이선스 도구와 함께 항상 설치됩니다.
- 온보딩: 설치·업데이트·제거가 서로 겹쳐 실행되지 않도록 잠금을 공유합니다.
- 패키징: 패키지 버전 표기에 배포판 이름이 붙습니다 (예:
0.7.0-1jammy). - 문서: 공개 문서 사이트를 개편했습니다 — 브랜드 테마, 화면 스크린샷, 변경 이력 페이지.
수정7
- 온보딩: 설치 중 네트워크가 끊겨도 스크립트가 중간까지만 실행되지 않습니다.
- 설치: ROS 2 저장소 키를 내려받을 때 검증하고 원자적으로 배치합니다.
- 제거:
--keep-license가 라이선스를 실제로 보존합니다. - 제거: ROS 2 저장소 원복이 다른 패키지가 쓰는 키 참조를 보존합니다.
- 업데이트: 시스템 언어 설정과 무관하게 버전이 올바로 표시됩니다.
- 라이선스 발급: 토큰 앞뒤 공백 때문에 인증이 실패하던 문제를 고쳤습니다.
- 라이선스 발급: 빈 토큰을 넘기면 즉시 오류로 알립니다.
제거1
- 업데이트:
plem update --rollback을 은퇴했습니다 — 실행하면 안내와 함께 중단되며, 복구는 재설치로 합니다.