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 · 核对日期
联系我们