Microduck Robot●microduck-robot.com
Herramientas

Comprobación de montaje y calibración

Comprueba configuración y archivos localmente; la calibración física sigue sin verificar.

Cargando herramienta…

Prepara montaje y archivos de calibración

Comprueba los datos declarados y el formato adecuado antes de ejecutar comandos de hardware. La calibración del motor y la de la IMU tienen funciones distintas.

Robots compatibles

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

Versión de reglas: 2026-11-12.2

Recopila los datos correctos

Para SO-101 identifica líder/seguidor, bus, puerto, IDs y reducciones. Confirma use_degrees: el JSON de calibración no declara ese modo. UNO Q usa IMU-v2 y una declaración separada de 15 servos reales; la simulación tiene 14 articulaciones.

Revisa el montaje

  1. Elige robot y buses. Comprueba articulaciones e IDs; un mismo ID puede existir en buses distintos.
  2. Selecciona el JSON de motor o IMU localmente y corrige formato, articulaciones ausentes y unidades sin confirmar.
  3. Lee las carencias e instrucciones de versión fija antes de exportar.

Informes y comandos

Descarga proyecto, informe y copia de la configuración declarada. Los comandos compatibles usan la versión oficial fijada y comillas POSIX o PowerShell. Debes revisarlos y ejecutarlos por separado.

Sin verificación física

La página no escanea IDs ni escribe calibración. Un archivo válido no demuestra cero físico, dirección o límites. La calibración IMU del UNO Q no es una copia de quince servos. Los archivos permanecen en el navegador.

Ejemplos de montaje y calibración

Estos casos comprueban declaraciones y estructuras de archivo. Todos los archivos de calibración incluidos son sintéticos y no deben usarse en un robot real.

La comprobación local no verifica el hardware real ni su seguridad. Estos ejemplos sintéticos son independientes de los valores del formulario superior. Importa un ejemplo para comprobar de nuevo sus datos; no se acepta un veredicto guardado sin verificarlo.

Los mismos ID en buses separados

¿Pueden el brazo principal y el seguidor usar los ID 1–6?

Versiones de referencia: Microduck rules 2026-11-12.2 · LeRobot 0.7.0

Datos de entrada y pasos

LeRobot 0.7.0; buses leader/follower separados en /dev/ttyACM0 y /dev/ttyACM1; ID 1–6 en cada uno; useDegrees=true; dos JSON de calibración sintéticos.

  1. Elige ambos perfiles SO-101 con nombres de bus y puertos distintos. Conserva las relaciones de reducción de cada perfil.
  2. Carga los archivos sintéticos y confirma expresamente el modo en grados previsto; el JSON de calibración del motor no lo guarda.
  3. Revisa ambos buses, las unidades de grados/rango y el resultado local antes de descargar el proyecto.

Resultado de referencia

Sin conflictos conocidos

No hay conflictos conocidos: los ID pueden repetirse entre buses separados. commandsReady es true para este ejemplo declarado.

Ver los datos y el JSON de referencia
{
  "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"
    ]
  }
}

Qué no demuestra este ejemplo

  • Los offsets y rangos son valores inventados para probar el formato. No son copias reales y nunca deben usarse para mover hardware.
  • Los puertos son ejemplos y las unidades se declaran por separado. El cero, la dirección y los límites físicos requieren el procedimiento oficial.

Referencia preparada el:

Fuentes de especificaciones

Los enlaces conservan los títulos originales de las fuentes técnicas. Comprueba la versión y la fecha de revisión junto con los supuestos del ejemplo.

  • lerobot-calibration410c095eacc0011d998a73383eb94abed2715af0 · revisado el
  • lerobot-so101410c095eacc0011d998a73383eb94abed2715af0 · revisado el
  • lerobot-units410c095eacc0011d998a73383eb94abed2715af0 · revisado el
  • lerobot-leader410c095eacc0011d998a73383eb94abed2715af0 · revisado el

Un ID repetido dentro del mismo bus

¿Qué ocurre si shoulder_pan y shoulder_lift declaran ambos el ID 1?

Versiones de referencia: Microduck rules 2026-11-12.2 · LeRobot 0.7.0

Datos de entrada y pasos

SO-101 follower; un bus, LeRobot 0.7.0, grados confirmados y archivo sintético. shoulder_lift declara deliberadamente el ID 1.

  1. Empieza con el perfil follower y su archivo sintético.
  2. Asigna ID 1 a shoulder_lift y revisa duplicate_motor_id y motor_mapping.
  3. Devuelve shoulder_lift al ID 2 sin modificar el archivo y compara los informes.

Resultado de referencia

Configuración no utilizable

La declaración original está bloqueada y commandsReady es false.

Ver los datos y el JSON de referencia
{
  "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"
    ]
  }
}

Ajustar y volver a comprobar

Restaurar ID 2 elimina ambos conflictos declarados; la referencia corregida no tiene conflictos conocidos.

Sin conflictos conocidos

Ver el JSON de la configuración ajustada
{
  "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"
    ]
  }
}

Qué no demuestra este ejemplo

  • El archivo de calibración es sintético; no uses sus offsets ni rangos en hardware.
  • Cambiar la declaración no escanea ni cambia el ID de un servo y no valida una calibración real.

Referencia preparada el:

Fuentes de especificaciones

Los enlaces conservan los títulos originales de las fuentes técnicas. Comprueba la versión y la fecha de revisión junto con los supuestos del ejemplo.

  • lerobot-so101410c095eacc0011d998a73383eb94abed2715af0 · revisado el
  • lerobot-calibration410c095eacc0011d998a73383eb94abed2715af0 · revisado el
  • lerobot-units410c095eacc0011d998a73383eb94abed2715af0 · revisado el

Un archivo IMU no es una copia de los motores

¿Por qué una estructura IMU-v2 válida sigue requiriendo revisión?

Versiones de referencia: Microduck rules 2026-11-12.2 · Microduck runtime 4ce3315c86190a632f4d75a2464a4ed31c9af69a · IMU offset format 2

Datos de entrada y pasos

Microduck UNO Q / V1.1; 15 ID declarados; IMU-v2 sintético con frame qmi-policy-body-offset-v2, vectores cero y sin procedencia de medición.

  1. Conserva los 15 ID físicos, incluida la boca con ID 34. El modelo simulado tiene 14 articulaciones.
  2. Revisa synthetic-imu-v2.json: version, frame, acc_offset_ms2 y gyro_zero_dps pertenecen al formato IMU.
  3. Lee imu_provenance y deja la revisión abierta; no inventes registros de medición para obtener un resultado favorable.

Resultado de referencia

Requiere revisión

Los campos obligatorios tienen estructura válida, pero falta su procedencia. Se mantiene needs_review y imuPhysicalPoseVerified es false.

Ver los datos y el JSON de referencia
{
  "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"
    ]
  }
}

Qué no demuestra este ejemplo

  • IMU-v2 no contiene las calibraciones de los 15 motores ni puede presentarse como su copia de seguridad.
  • Los ceros son sintéticos. No se verificaron muestreo inmóvil y vertical, postura real ni correspondencia física entre los 15 servos y las 14 articulaciones simuladas.

Referencia preparada el:

Fuentes de especificaciones

Los enlaces conservan los títulos originales de las fuentes técnicas. Comprueba la versión y la fecha de revisión junto con los supuestos del ejemplo.

  • duck-config4ce3315c86190a632f4d75a2464a4ed31c9af69a · revisado el
  • duck-imu4ce3315c86190a632f4d75a2464a4ed31c9af69a · revisado el
  • duck-midpoint4ce3315c86190a632f4d75a2464a4ed31c9af69a · revisado el
Contacto