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 需要主臂/從臂、匯流排、連接埠、伺服馬達 ID 與減速比資訊。請自行確認 use_degrees;校正 JSON 不包含該單位模式。UNO Q 使用 IMU-v2 檔案,並單獨聲明 15 個實機伺服馬達 ID;模擬模型只有 14 個關節。

分三步核對配置

  1. 選擇機器人並新增各條匯流排,核對關節與 ID 對照;不同匯流排允許相同 ID。
  2. 在本機選擇對應的馬達或 IMU JSON,修正格式、缺失關節與未確認的單位。
  3. 閱讀缺項報告與固定版本說明,再匯出備份或命令文字。

報告、備份與命令

可下載專案、檢查報告與聲明配置備份。支援的命令採用固定官方版本,並按 POSIX 或 PowerShell 正確引用參數;請先審閱,再在外部自行執行。

聲明不等於真機驗證

頁面不會掃描 ID,也不會寫入校正。檔案結構有效不能證明實機零位、方向或限位正確。UNO Q 的 IMU 校正不是十五伺服馬達校正備份。檔案僅在瀏覽器內檢查,不上傳。

裝機與校正完整案例

這些案例檢查宣告設定與檔案結構。附帶的校正檔案都是合成資料,不能用於真實機器人。

離線配置檢查不代表真實硬體或安全性已驗證。 這些合成案例與上方表單輸入的配置相互獨立。匯入案例後會重新檢查輸入,不直接採用已儲存的結論。

不同匯流排可以使用相同 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。

  1. 選擇兩種 SO-101 設定,分別指定匯流排名稱與序列埠路徑,保留各自減速比。
  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;單條匯流排、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

輸入條件與操作步驟

機器鴨 UNO Q / V1.1;宣告 15 個伺服馬達 ID;合成 IMU-v2 的 frame 為 qmi-policy-body-offset-v2,向量全為零,沒有量測來源。

  1. 保留嘴部 ID 34 在內的 15 個實機 ID;模擬模型有 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 · 核對日期
聯絡我們