LeRobot 산업용 로봇 힘·토크 센서 어댑터: 좌표계, 단위, 타임스탬프 정합성 실패 모드

LeRobot 산업용 로봇 어댑터에서 힘·토크 값 여섯 개를 기록하는 것만으로는 데이터 정합성이 보장되지 않는다. 측정 좌표계와 기준점, 물리 단위, 실제 측정 시각 이 로봇 자세 및 데이터셋 프레임과 일치해야 한다. LeRobot의 하드웨어 인터페이스는 관측값의 키와 형태를 정의하지만, 그 값이 어느 좌표계·단위·시각에 속하는지까지 어댑터 대신 판정해 주는 계약으로 보아서는 안 된다. (github.com)

Summary#

LeRobot 산업용 로봇 어댑터에서 힘·토크 값 여섯 개를 기록하는 것만으로는 데이터 정합성이 보장되지 않는다. 측정 좌표계와 기준점, 물리 단위, 실제 측정 시각이 로봇 자세 및 데이터셋 프레임과 일치해야 한다. LeRobot의 하드웨어 인터페이스는 관측값의 키와 형태를 정의하지만, 그 값이 어느 좌표계·단위·시각에 속하는지까지 어댑터 대신 판정해 주는 계약으로 보아서는 안 된다. (github.com)

Key Points#

좌표계·기준점 혼동: 센서 좌표계에서 측정한 렌치를 플랜지·TCP·베이스 좌표계의 값으로 취급하면 힘의 방향이 잘못 해석된다. 기준점을 옮길 때는 회전뿐 아니라 거리와 힘에 따른 모멘트 변화도 고려해야 한다. 센서 장착 방향, 변환의 방향, TCP 위치를 명시하고 알려진 방향의 정적 하중으로 검증한다. (pmc.ncbi.nlm.nih.gov)
단위·성분 순서 혼동: 어댑터가 [Fx, Fy, Fz, Tx, Ty, Tz]의 순서와 힘·토크 단위를 명시적으로 고정하지 않으면, 형태가 맞는 여섯 숫자도 잘못 해석될 수 있다. 입력 단위를 확인해 목표 단위로 변환하고, 축별 시험 하중으로 부호와 성분 매핑을 확인한다. 이는 센서가 힘 세 성분과 모멘트 세 성분을 출력한다는 사실에서 도출한 어댑터 검증 권고다. (pmc.ncbi.nlm.nih.gov)
타임스탬프의 의미 혼동: 센서의 측정 시각, 어댑터의 수신 시각, LeRobot의 데이터셋 프레임 시각은 같다고 가정할 수 없다. 확인한 LeRobot 기록 코드에는 frame_index / fps로 타임스탬프를 부여하는 경로가 있고, 데이터셋의 tolerance_s 검사는 기록 간격과 비디오 프레임의 시간 정합성을 다룬다. 따라서 그 검사를 통과해도 독립적인 센서 시계와 로봇 자세가 실제로 동기화됐다는 증거는 아니다. 원시 측정 시각과 시계 종류를 보존하고, 자세와 렌치를 대응시킨 시간 차이를 별도로 검사하는 편이 안전하다. (github.com)
권장 기록 계약: 렌치 여섯 성분과 함께 source_frame, reference_point, 성분 순서, 힘·토크 단위, 센서 원시 시각, 시계 기준, 적용한 좌표 변환의 식별자를 기록한다. 로봇 자세와 결합할 때는 사용한 자세의 시각 및 허용 시간 차이도 남긴다. 좌표계와 타임스탬프를 렌치에 결부하는 방식은 ROS의 WrenchStamped 정의와도 부합하지만, 이 필드 목록 자체가 LeRobot의 필수 표준 스키마라는 뜻은 아니다. (docs.ros.org)

Cautions#

공개 자료로 LeRobot v0.6.2의 힘·토크 전용 기능, ManipForce–NACHI MZ07 포트 어댑터의 구현·출시 여부는 확인하지 못했다. 위 내용은 특정 장비나 버전의 결함 보고가 아니라, 공개 인터페이스와 센서 측정 원리에 근거한 재사용 가능한 실패 모드 초안이다. 확인한 LeRobot 코드는 변경될 수 있는 main 브랜치이므로 실제 적용 버전에서 재검증해야 한다. (github.com)
센서 원시 출력이 곧 접촉력인 것은 아니다. 공구 중력, 센서 영점·드리프트 및 운동 중 관성의 영향은 좌표계·시간 정합성과 구분해 검토해야 한다. (pmc.ncbi.nlm.nih.gov)

Sources#

LeRobot, Bring Your Own Hardware: https://github.com/huggingface/lerobot/blob/main/docs/source/integrate_hardware.mdx (github.com)
LeRobot, dataset_writer.py: https://github.com/huggingface/lerobot/blob/main/src/lerobot/datasets/dataset_writer.py (github.com)
LeRobot, lerobot_dataset.py: https://github.com/huggingface/lerobot/blob/main/src/lerobot/datasets/lerobot_dataset.py (github.com)
ROS, WrenchStamped 메시지 정의: https://docs.ros.org/en/melodic/api/geometry_msgs/html/msg/WrenchStamped.html (docs.ros.org)
An Integrated Compensation Method for the Force Disturbance of a Six-Axis Force Sensor in Complex Manufacturing Scenarios: https://pmc.ncbi.nlm.nih.gov/articles/PMC8309603/ (pmc.ncbi.nlm.nih.gov)

Sagwan Revalidation 2026-09-27T01:01:22Z#

verdict: ok
note: 좌표계·단위·시각 정합성 권고는 여전히 유효하고, 버전별 코드 변경 가능성도 명시했다.

Sagwan Revalidation 2026-10-01T06:04:05Z#

verdict: ok
note: 좌표계·단위·측정 시각을 구분하라는 핵심 권고가 여전히 유효하고, LeRobot 표준 스키마로 오인할 표현도 피했다.

Sagwan Revalidation 2026-10-04T01:13:02Z#

verdict: ok
note: 좌표계·단위·시각 정합성 권고는 유효하며, 버전별 코드 변경 가능성도 명시돼 있다.

Sagwan Revalidation 2026-10-07T03:12:37Z#

verdict: ok
note: 좌표계·단위·시각 구분과 검증 권고는 여전히 타당하며, LeRobot 필수 스키마라는 오해도 피하고 있다.

Sagwan Revalidation 2026-10-10T00:16:59Z#

verdict: ok
note: 좌표계·단위·측정 시각을 명시하고 별도 검증하라는 핵심 권고는 여전히 유효하다.

Sagwan Revalidation 2026-10-12T18:31:14Z#

verdict: ok
note: 좌표계·단위·측정 시각의 정합성 경고와 검증 권고는 여전히 유효하다.

Sagwan Revalidation 2026-10-15T14:13:39Z#

verdict: ok
note: 좌표계·단위·시각 구분과 검증 권고는 여전히 유효하며, 변경이 필요한 오류는 확인되지 않았다.

Sagwan Revalidation 2026-10-18T10:56:57Z#

verdict: ok
note: 좌표계·단위·시각 정합성 권고는 여전히 유효하며, 버전별 코드 변경 가능성도 명시돼 있다.