Microduck Robot●microduck-robot.com
도구

조립 및 보정 사전 검사

설정과 파일을 로컬에서 검사하며 실제 하드웨어 보정은 검증하지 않습니다.

도구 불러오는 중…

조립 및 보정 파일 준비

하드웨어 명령 실행 전에 선언한 로봇 구성과 해당 파일 형식을 확인합니다. 모터 보정과 IMU 보정은 서로 다른 작업입니다.

지원 로봇 구성

  • SO-101 leader · LeRobot 0.7.0
  • SO-101 follower · LeRobot 0.7.0
  • Microduck UNO Q / V1.1

규칙 버전: 2026-11-12.2

필요한 입력 준비

SO-101에서는 leader/follower, 버스, 포트, ID와 감속비를 확인합니다. 보정 JSON은 단위 모드를 포함하지 않으므로 use_degrees를 직접 확인해야 합니다. UNO Q는 IMU-v2 파일과 실물 서보 ID 15개를 별도로 다루며 시뮬레이션은 14관절입니다.

조립 확인 순서

  1. 로봇과 버스를 선택하고 관절과 ID 대응을 확인합니다. 서로 다른 버스는 같은 ID를 쓸 수 있습니다.
  2. 해당 모터 또는 IMU JSON을 기기에서 선택하고 형식, 누락 관절, 미확인 단위를 수정합니다.
  3. 백업이나 명령을 내보내기 전에 누락 항목과 고정 버전 지침을 읽습니다.

보고서와 명령

프로젝트, 검사 보고서와 선언 구성 백업을 받습니다. 지원 명령은 고정된 공식 버전과 POSIX 또는 PowerShell 인용 형식을 사용합니다. 내용을 검토한 후 별도로 실행하세요.

실물 검증을 의미하지 않습니다

페이지는 ID를 스캔하거나 보정을 쓰지 않습니다. 올바른 파일 형식만으로 실제 영점, 방향과 한계를 확인할 수 없습니다. UNO Q의 IMU 파일은 서보 15개의 보정 백업이 아닙니다. 파일은 브라우저에서 처리하며 업로드하지 않습니다.

조립·보정 검사 따라 해보기

선언한 구성과 파일 형식을 확인하는 예제입니다. 제공하는 보정 파일은 모두 합성 데이터이므로 실제 로봇에 사용하지 마세요.

로컬 검사는 실제 하드웨어나 안전성을 검증하지 않습니다. 이 합성 예제는 위 양식에 입력한 설정과 별개인 참고 자료입니다. 예제를 가져오면 입력값을 다시 검사하며 저장된 판정을 그대로 신뢰하지 않습니다.

서로 다른 버스에서 같은 ID 사용

리더와 팔로워가 각각 ID 1–6을 사용해도 되나요?

기준 버전: Microduck rules 2026-11-12.2 · LeRobot 0.7.0

입력 조건과 확인 순서

LeRobot 0.7.0, leader/follower는 /dev/ttyACM0와 /dev/ttyACM1의 별도 버스, 각각 ID 1–6, useDegrees=true. 보정 JSON 2개는 합성 데이터입니다.

  1. SO-101 프로필 2개를 선택하고 버스 이름과 포트를 구분합니다. 각 프로필의 감속비는 유지합니다.
  2. 합성 파일을 불러오고 사용할 도 단위 모드를 따로 확인합니다. 모터 보정 JSON에는 단위 모드가 없습니다.
  3. 두 버스, 도/범위 단위와 오프라인 결과를 확인한 뒤 참조 프로젝트를 저장합니다.

예제의 기준 검사 결과

알려진 구성 충돌 없음

알려진 구성 충돌은 없습니다. 버스가 다르면 같은 ID를 쓸 수 있으며 이 선언 예제의 commandsReady는 true입니다.

입력과 기준 결과 JSON 보기
{
  "inputs": {
    "profileId": "so101-leader-v0.7.0",
    "buses": [
      {
        "busId": "leader",
        "profileId": "so101-leader-v0.7.0",
        "port": "/dev/ttyACM0",
        "robotId": "example_leader",
        "version": "0.7.0",
        "useDegrees": true,
        "unitsConfirmed": true,
        "motors": [
          {
            "joint": "shoulder_pan",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 191
          },
          {
            "joint": "shoulder_lift",
            "id": 2,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "elbow_flex",
            "id": 3,
            "model": "sts3215",
            "gearRatio": 191
          },
          {
            "joint": "wrist_flex",
            "id": 4,
            "model": "sts3215",
            "gearRatio": 147
          },
          {
            "joint": "wrist_roll",
            "id": 5,
            "model": "sts3215",
            "gearRatio": 147
          },
          {
            "joint": "gripper",
            "id": 6,
            "model": "sts3215",
            "gearRatio": 147
          }
        ],
        "calibration": {
          "shoulder_pan": {
            "id": 1,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "shoulder_lift": {
            "id": 2,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "elbow_flex": {
            "id": 3,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_flex": {
            "id": 4,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_roll": {
            "id": 5,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "gripper": {
            "id": 6,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          }
        }
      },
      {
        "busId": "follower",
        "profileId": "so101-follower-v0.7.0",
        "port": "/dev/ttyACM1",
        "robotId": "example_follower",
        "version": "0.7.0",
        "useDegrees": true,
        "unitsConfirmed": true,
        "motors": [
          {
            "joint": "shoulder_pan",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "shoulder_lift",
            "id": 2,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "elbow_flex",
            "id": 3,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_flex",
            "id": 4,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_roll",
            "id": 5,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "gripper",
            "id": 6,
            "model": "sts3215",
            "gearRatio": 345
          }
        ],
        "calibration": {
          "shoulder_pan": {
            "id": 1,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "shoulder_lift": {
            "id": 2,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "elbow_flex": {
            "id": 3,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_flex": {
            "id": 4,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_roll": {
            "id": 5,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "gripper": {
            "id": 6,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          }
        }
      }
    ],
    "imuCalibration": null
  },
  "status": "no_known_conflict",
  "findings": [],
  "outputs": {
    "buses": [
      {
        "busId": "leader",
        "profileId": "so101-leader-v0.7.0",
        "role": "leader",
        "family": "so101",
        "version": "0.7.0",
        "port": "/dev/ttyACM0",
        "robotId": "example_leader",
        "declaredMotors": [
          {
            "joint": "shoulder_pan",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 191
          },
          {
            "joint": "shoulder_lift",
            "id": 2,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "elbow_flex",
            "id": 3,
            "model": "sts3215",
            "gearRatio": 191
          },
          {
            "joint": "wrist_flex",
            "id": 4,
            "model": "sts3215",
            "gearRatio": 147
          },
          {
            "joint": "wrist_roll",
            "id": 5,
            "model": "sts3215",
            "gearRatio": 147
          },
          {
            "joint": "gripper",
            "id": 6,
            "model": "sts3215",
            "gearRatio": 147
          }
        ],
        "jointUnits": {
          "shoulder_pan": "degrees",
          "shoulder_lift": "degrees",
          "elbow_flex": "degrees",
          "wrist_flex": "degrees",
          "wrist_roll": "degrees",
          "gripper": "range_0_100"
        },
        "calibrationStatus": "configuration-checked",
        "calibration": {
          "shoulder_pan": {
            "id": 1,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "shoulder_lift": {
            "id": 2,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "elbow_flex": {
            "id": 3,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_flex": {
            "id": 4,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_roll": {
            "id": 5,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "gripper": {
            "id": 6,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          }
        }
      },
      {
        "busId": "follower",
        "profileId": "so101-follower-v0.7.0",
        "role": "follower",
        "family": "so101",
        "version": "0.7.0",
        "port": "/dev/ttyACM1",
        "robotId": "example_follower",
        "declaredMotors": [
          {
            "joint": "shoulder_pan",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "shoulder_lift",
            "id": 2,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "elbow_flex",
            "id": 3,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_flex",
            "id": 4,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_roll",
            "id": 5,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "gripper",
            "id": 6,
            "model": "sts3215",
            "gearRatio": 345
          }
        ],
        "jointUnits": {
          "shoulder_pan": "degrees",
          "shoulder_lift": "degrees",
          "elbow_flex": "degrees",
          "wrist_flex": "degrees",
          "wrist_roll": "degrees",
          "gripper": "range_0_100"
        },
        "calibrationStatus": "configuration-checked",
        "calibration": {
          "shoulder_pan": {
            "id": 1,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "shoulder_lift": {
            "id": 2,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "elbow_flex": {
            "id": 3,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_flex": {
            "id": 4,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_roll": {
            "id": 5,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "gripper": {
            "id": 6,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          }
        }
      }
    ],
    "commandsReady": true,
    "imuStatus": "not-applicable",
    "imuPhysicalPoseVerified": false,
    "physicalChecks": [
      "physical_zero",
      "physical_direction",
      "physical_travel",
      "physical_firmware"
    ],
    "manualChecklist": [
      "manual_single_motor",
      "manual_physical_calibration"
    ]
  }
}

이 예제로 확인할 수 없는 사항

  • 오프셋과 범위는 형식 검사용으로 만든 값입니다. 실제 백업이 아니며 하드웨어 구동에 절대 사용하면 안 됩니다.
  • 포트는 예시이며 단위 모드는 별도 선언입니다. 실제 영점·방향·한계는 공식 절차로 보정해야 합니다.

기준 자료 작성일:

사양 출처

아래 링크에는 기술 자료의 원래 제목을 표시합니다. 예제의 전제 조건과 함께 버전 및 확인일을 확인하세요.

  • lerobot-calibration410c095eacc0011d998a73383eb94abed2715af0 · 확인일
  • lerobot-so101410c095eacc0011d998a73383eb94abed2715af0 · 확인일
  • lerobot-units410c095eacc0011d998a73383eb94abed2715af0 · 확인일
  • lerobot-leader410c095eacc0011d998a73383eb94abed2715af0 · 확인일

한 버스 안에서 중복된 ID

shoulder_pan과 shoulder_lift가 모두 ID 1이면 어떻게 되나요?

기준 버전: Microduck rules 2026-11-12.2 · LeRobot 0.7.0

입력 조건과 확인 순서

SO-101 follower, 버스 1개, LeRobot 0.7.0, 도 단위 확인 및 합성 보정 파일. shoulder_lift를 의도적으로 ID 1로 선언합니다.

  1. follower 프로필과 해당 합성 파일에서 시작합니다.
  2. shoulder_lift를 ID 1로 바꾸고 duplicate_motor_id와 motor_mapping을 확인합니다.
  3. 보정 파일은 유지한 채 shoulder_lift를 ID 2로 되돌려 보고서를 비교합니다.

예제의 기준 검사 결과

사용할 수 없는 구성

처음 선언은 차단되며 commandsReady는 false입니다.

입력과 기준 결과 JSON 보기
{
  "inputs": {
    "profileId": "so101-follower-v0.7.0",
    "buses": [
      {
        "busId": "follower",
        "profileId": "so101-follower-v0.7.0",
        "port": "/dev/ttyACM0",
        "robotId": "example_follower",
        "version": "0.7.0",
        "useDegrees": true,
        "unitsConfirmed": true,
        "motors": [
          {
            "joint": "shoulder_pan",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "shoulder_lift",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "elbow_flex",
            "id": 3,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_flex",
            "id": 4,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_roll",
            "id": 5,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "gripper",
            "id": 6,
            "model": "sts3215",
            "gearRatio": 345
          }
        ],
        "calibration": {
          "shoulder_pan": {
            "id": 1,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "shoulder_lift": {
            "id": 2,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "elbow_flex": {
            "id": 3,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_flex": {
            "id": 4,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_roll": {
            "id": 5,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "gripper": {
            "id": 6,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          }
        }
      }
    ],
    "imuCalibration": null
  },
  "status": "blocked",
  "findings": [
    {
      "code": "duplicate_motor_id",
      "severity": "blocked",
      "fieldPath": "buses.0.motors.1.id",
      "messageKey": "duplicate_motor_id",
      "details": {
        "id": 1,
        "bus": "follower"
      },
      "sourceRef": "lerobot-calibration"
    },
    {
      "code": "motor_mapping",
      "severity": "blocked",
      "fieldPath": "buses.0.motors.1.id",
      "messageKey": "motor_mapping",
      "details": {
        "joint": "shoulder_lift",
        "id": 2
      },
      "sourceRef": "lerobot-calibration"
    }
  ],
  "outputs": {
    "buses": [
      {
        "busId": "follower",
        "profileId": "so101-follower-v0.7.0",
        "role": "follower",
        "family": "so101",
        "version": "0.7.0",
        "port": "/dev/ttyACM0",
        "robotId": "example_follower",
        "declaredMotors": [
          {
            "joint": "shoulder_pan",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "shoulder_lift",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "elbow_flex",
            "id": 3,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_flex",
            "id": 4,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_roll",
            "id": 5,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "gripper",
            "id": 6,
            "model": "sts3215",
            "gearRatio": 345
          }
        ],
        "jointUnits": {
          "shoulder_pan": "degrees",
          "shoulder_lift": "degrees",
          "elbow_flex": "degrees",
          "wrist_flex": "degrees",
          "wrist_roll": "degrees",
          "gripper": "range_0_100"
        },
        "calibrationStatus": "configuration-checked",
        "calibration": {
          "shoulder_pan": {
            "id": 1,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "shoulder_lift": {
            "id": 2,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "elbow_flex": {
            "id": 3,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_flex": {
            "id": 4,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_roll": {
            "id": 5,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "gripper": {
            "id": 6,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          }
        }
      }
    ],
    "commandsReady": false,
    "imuStatus": "not-applicable",
    "imuPhysicalPoseVerified": false,
    "physicalChecks": [
      "physical_zero",
      "physical_direction",
      "physical_travel",
      "physical_firmware"
    ],
    "manualChecklist": [
      "manual_single_motor",
      "manual_physical_calibration"
    ]
  }
}

설정을 바꾸고 다시 확인

ID 2로 되돌리면 두 선언 충돌이 사라지고 수정 예제에 알려진 구성 충돌이 없습니다.

알려진 구성 충돌 없음

변경한 기준 JSON 보기
{
  "inputs": {
    "profileId": "so101-follower-v0.7.0",
    "buses": [
      {
        "busId": "follower",
        "profileId": "so101-follower-v0.7.0",
        "port": "/dev/ttyACM0",
        "robotId": "example_follower",
        "version": "0.7.0",
        "useDegrees": true,
        "unitsConfirmed": true,
        "motors": [
          {
            "joint": "shoulder_pan",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "shoulder_lift",
            "id": 2,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "elbow_flex",
            "id": 3,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_flex",
            "id": 4,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_roll",
            "id": 5,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "gripper",
            "id": 6,
            "model": "sts3215",
            "gearRatio": 345
          }
        ],
        "calibration": {
          "shoulder_pan": {
            "id": 1,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "shoulder_lift": {
            "id": 2,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "elbow_flex": {
            "id": 3,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_flex": {
            "id": 4,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_roll": {
            "id": 5,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "gripper": {
            "id": 6,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          }
        }
      }
    ],
    "imuCalibration": null
  },
  "status": "no_known_conflict",
  "findings": [],
  "outputs": {
    "buses": [
      {
        "busId": "follower",
        "profileId": "so101-follower-v0.7.0",
        "role": "follower",
        "family": "so101",
        "version": "0.7.0",
        "port": "/dev/ttyACM0",
        "robotId": "example_follower",
        "declaredMotors": [
          {
            "joint": "shoulder_pan",
            "id": 1,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "shoulder_lift",
            "id": 2,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "elbow_flex",
            "id": 3,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_flex",
            "id": 4,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "wrist_roll",
            "id": 5,
            "model": "sts3215",
            "gearRatio": 345
          },
          {
            "joint": "gripper",
            "id": 6,
            "model": "sts3215",
            "gearRatio": 345
          }
        ],
        "jointUnits": {
          "shoulder_pan": "degrees",
          "shoulder_lift": "degrees",
          "elbow_flex": "degrees",
          "wrist_flex": "degrees",
          "wrist_roll": "degrees",
          "gripper": "range_0_100"
        },
        "calibrationStatus": "configuration-checked",
        "calibration": {
          "shoulder_pan": {
            "id": 1,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "shoulder_lift": {
            "id": 2,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "elbow_flex": {
            "id": 3,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_flex": {
            "id": 4,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "wrist_roll": {
            "id": 5,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          },
          "gripper": {
            "id": 6,
            "drive_mode": 0,
            "homing_offset": 0,
            "range_min": 0,
            "range_max": 4095
          }
        }
      }
    ],
    "commandsReady": true,
    "imuStatus": "not-applicable",
    "imuPhysicalPoseVerified": false,
    "physicalChecks": [
      "physical_zero",
      "physical_direction",
      "physical_travel",
      "physical_firmware"
    ],
    "manualChecklist": [
      "manual_single_motor",
      "manual_physical_calibration"
    ]
  }
}

이 예제로 확인할 수 없는 사항

  • 보정 파일은 합성 데이터입니다. 오프셋이나 범위를 실제 하드웨어에 사용하지 마세요.
  • 선언을 바꿔도 실제 서보 ID를 검색하거나 변경하지 않으며 실제 보정을 검증하지도 않습니다.

기준 자료 작성일:

사양 출처

아래 링크에는 기술 자료의 원래 제목을 표시합니다. 예제의 전제 조건과 함께 버전 및 확인일을 확인하세요.

  • lerobot-so101410c095eacc0011d998a73383eb94abed2715af0 · 확인일
  • lerobot-calibration410c095eacc0011d998a73383eb94abed2715af0 · 확인일
  • lerobot-units410c095eacc0011d998a73383eb94abed2715af0 · 확인일

IMU 파일과 모터 보정 백업의 차이

IMU-v2 형식이 유효해도 왜 검토가 남나요?

기준 버전: Microduck rules 2026-11-12.2 · Microduck runtime 4ce3315c86190a632f4d75a2464a4ed31c9af69a · IMU offset format 2

입력 조건과 확인 순서

Microduck UNO Q / V1.1, 서보 ID 15개 선언. frame은 qmi-policy-body-offset-v2이며 영벡터와 측정 이력이 없는 합성 IMU-v2입니다.

  1. 입 ID 34를 포함한 실제 ID 15개를 유지합니다. 시뮬레이션 모델은 관절 14개입니다.
  2. synthetic-imu-v2.json의 version, frame, acc_offset_ms2, gyro_zero_dps가 IMU 항목인지 확인합니다.
  3. imu_provenance를 읽고 needs_review를 유지합니다. 통과시키려고 측정 기록을 만들어 넣지 마세요.

예제의 기준 검사 결과

확인 필요

필수 필드 구조는 유효하지만 측정 출처가 없습니다. needs_review가 유지되고 imuPhysicalPoseVerified는 false입니다.

입력과 기준 결과 JSON 보기
{
  "inputs": {
    "profileId": "microduck-unoq-v1.1",
    "buses": [
      {
        "busId": "microduck-main",
        "profileId": "microduck-unoq-v1.1",
        "port": "",
        "robotId": "microduck",
        "version": "4ce3315c86190a632f4d75a2464a4ed31c9af69a",
        "useDegrees": null,
        "unitsConfirmed": false,
        "motors": [
          {
            "joint": "left_hip_yaw",
            "id": 10,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "left_hip_roll",
            "id": 11,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "left_hip_pitch",
            "id": 12,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "left_knee",
            "id": 13,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "left_ankle",
            "id": 14,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_hip_yaw",
            "id": 20,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_hip_roll",
            "id": 21,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_hip_pitch",
            "id": 22,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_knee",
            "id": 23,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_ankle",
            "id": 24,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "neck_pitch",
            "id": 30,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "head_pitch",
            "id": 31,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "head_yaw",
            "id": 32,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "head_roll",
            "id": 33,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "mouth",
            "id": 34,
            "model": "hd1910m",
            "gearRatio": null
          }
        ],
        "calibration": null
      }
    ],
    "imuCalibration": {
      "version": 2,
      "frame": "qmi-policy-body-offset-v2",
      "acc_offset_ms2": [
        0,
        0,
        0
      ],
      "gyro_zero_dps": [
        0,
        0,
        0
      ]
    }
  },
  "status": "needs_review",
  "findings": [
    {
      "code": "imu_provenance",
      "severity": "needs_review",
      "fieldPath": "imuCalibration",
      "messageKey": "imu_provenance",
      "details": {},
      "sourceRef": "duck-imu"
    }
  ],
  "outputs": {
    "buses": [
      {
        "busId": "microduck-main",
        "profileId": "microduck-unoq-v1.1",
        "role": "robot",
        "family": "microduck",
        "version": "4ce3315c86190a632f4d75a2464a4ed31c9af69a",
        "port": "",
        "robotId": "microduck",
        "declaredMotors": [
          {
            "joint": "left_hip_yaw",
            "id": 10,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "left_hip_roll",
            "id": 11,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "left_hip_pitch",
            "id": 12,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "left_knee",
            "id": 13,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "left_ankle",
            "id": 14,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_hip_yaw",
            "id": 20,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_hip_roll",
            "id": 21,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_hip_pitch",
            "id": 22,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_knee",
            "id": 23,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "right_ankle",
            "id": 24,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "neck_pitch",
            "id": 30,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "head_pitch",
            "id": 31,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "head_yaw",
            "id": 32,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "head_roll",
            "id": 33,
            "model": "hd1910m",
            "gearRatio": null
          },
          {
            "joint": "mouth",
            "id": 34,
            "model": "hd1910m",
            "gearRatio": null
          }
        ],
        "jointUnits": {
          "left_hip_yaw": "encoder_steps",
          "left_hip_roll": "encoder_steps",
          "left_hip_pitch": "encoder_steps",
          "left_knee": "encoder_steps",
          "left_ankle": "encoder_steps",
          "right_hip_yaw": "encoder_steps",
          "right_hip_roll": "encoder_steps",
          "right_hip_pitch": "encoder_steps",
          "right_knee": "encoder_steps",
          "right_ankle": "encoder_steps",
          "neck_pitch": "encoder_steps",
          "head_pitch": "encoder_steps",
          "head_yaw": "encoder_steps",
          "head_roll": "encoder_steps",
          "mouth": "encoder_steps"
        },
        "calibrationStatus": "not-applicable",
        "calibration": null
      }
    ],
    "commandsReady": false,
    "imuStatus": "configuration-checked",
    "imuPhysicalPoseVerified": false,
    "physicalChecks": [
      "physical_zero",
      "physical_direction",
      "physical_travel",
      "physical_firmware",
      "imu_standing",
      "servo_midpoint"
    ],
    "manualChecklist": [
      "manual_declared_ids",
      "manual_midpoint",
      "manual_imu_standing",
      "manual_power"
    ]
  }
}

이 예제로 확인할 수 없는 사항

  • IMU-v2에는 모터 15개의 보정이 없으며 그 백업으로 볼 수 없습니다.
  • 영벡터는 합성 값입니다. 정지·직립 상태의 측정, 실제 자세 또는 서보 15개와 모의 관절 14개의 물리적 대응을 검증하지 않았습니다.

기준 자료 작성일:

사양 출처

아래 링크에는 기술 자료의 원래 제목을 표시합니다. 예제의 전제 조건과 함께 버전 및 확인일을 확인하세요.

  • duck-config4ce3315c86190a632f4d75a2464a4ed31c9af69a · 확인일
  • duck-imu4ce3315c86190a632f4d75a2464a4ed31c9af69a · 확인일
  • duck-midpoint4ce3315c86190a632f4d75a2464a4ed31c9af69a · 확인일
문의하기