Microduck Robot●microduck-robot.com
Outils

Vérification du montage et de la calibration

Vérifiez localement la configuration et les fichiers ; la calibration physique reste non vérifiée.

Chargement de l’outil…

Préparer montage et fichiers de calibration

Vérifiez les données déclarées et le bon format avant les commandes matérielles. Calibration moteur et calibration IMU n'ont pas le même rôle.

Configurations prises en charge

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

Version des règles: 2026-11-12.2

Rassembler les bons paramètres

Pour SO-101, identifiez leader/follower, bus, port, IDs et rapports de réduction. Confirmez use_degrees : le JSON de calibration ne précise pas ce mode. UNO Q utilise IMU-v2 et une déclaration séparée de 15 servos réels ; la simulation comporte 14 articulations.

Contrôler le montage

  1. Choisissez robot et bus. Vérifiez la correspondance articulation–ID ; un ID peut être réutilisé sur un autre bus.
  2. Sélectionnez localement le JSON moteur ou IMU et corrigez format, articulations manquantes et unités non confirmées.
  3. Lisez les éléments manquants et instructions de version fixe avant l'export.

Rapports et commandes

Téléchargez projet, rapport et sauvegarde de la configuration déclarée. Les commandes disponibles utilisent la version officielle figée et l'échappement POSIX ou PowerShell. Vérifiez-les puis exécutez-les séparément.

Aucune validation physique

La page ne scanne pas les IDs et n'écrit pas de calibration. Un fichier valide ne prouve ni zéro physique, ni sens, ni limites. Les données IMU UNO Q ne sauvegardent pas quinze calibrations de servos. Les fichiers restent dans le navigateur.

Exemples de montage et de calibration

Ces cas vérifient une configuration déclarée et la structure des fichiers. Tous les fichiers de calibration fournis sont synthétiques et ne doivent pas être utilisés sur un vrai robot.

Les contrôles locaux ne vérifient ni le matériel réel ni sa sécurité. Ces exemples synthétiques sont indépendants des paramètres saisis plus haut. Importez un exemple pour vérifier à nouveau ses données : un verdict enregistré n’est pas repris sans contrôle.

Les mêmes ID sur deux bus séparés

Le bras maître et le bras suiveur peuvent-ils utiliser chacun les ID 1–6 ?

Versions de référence: Microduck rules 2026-11-12.2 · LeRobot 0.7.0

Paramètres et étapes

LeRobot 0.7.0 ; bus leader/follower distincts sur /dev/ttyACM0 et /dev/ttyACM1 ; ID 1–6 chacun ; useDegrees=true ; deux JSON de calibration synthétiques.

  1. Choisissez les deux profils SO-101 avec des noms de bus et ports distincts. Gardez le rapport de réduction propre à chaque profil.
  2. Chargez les fichiers synthétiques et confirmez explicitement le mode en degrés prévu ; le JSON moteur ne le contient pas.
  3. Vérifiez les deux bus, les unités degrés/plage et le résultat local avant de télécharger le projet.

Résultat de référence

Aucun conflit connu

Aucun conflit connu : les ID peuvent se répéter sur des bus séparés. commandsReady vaut true pour cet exemple déclaré.

Voir les paramètres et le JSON de référence
{
  "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"
    ]
  }
}

Ce que cet exemple ne démontre pas

  • Les offsets et plages sont inventés pour tester le format. Ce ne sont pas des sauvegardes réelles ; ne les utilisez jamais sur du matériel.
  • Les ports sont des exemples et les unités se déclarent séparément. Le zéro, le sens et les limites physiques restent à calibrer officiellement.

Référence préparée le:

Sources des spécifications

Les liens ci-dessous conservent les titres d’origine des sources techniques. Lisez leur version et leur date de vérification avec les hypothèses de l’exemple.

  • lerobot-calibration410c095eacc0011d998a73383eb94abed2715af0 · vérifié le
  • lerobot-so101410c095eacc0011d998a73383eb94abed2715af0 · vérifié le
  • lerobot-units410c095eacc0011d998a73383eb94abed2715af0 · vérifié le
  • lerobot-leader410c095eacc0011d998a73383eb94abed2715af0 · vérifié le

Un ID répété sur le même bus

Que se passe-t-il si shoulder_pan et shoulder_lift portent tous deux l’ID 1 ?

Versions de référence: Microduck rules 2026-11-12.2 · LeRobot 0.7.0

Paramètres et étapes

SO-101 follower ; un bus, LeRobot 0.7.0, degrés confirmés et fichier synthétique. shoulder_lift est volontairement déclaré avec l’ID 1.

  1. Partez du profil follower et de son fichier synthétique.
  2. Attribuez l’ID 1 à shoulder_lift et examinez duplicate_motor_id et motor_mapping.
  3. Rétablissez l’ID 2 de shoulder_lift sans modifier le fichier, puis comparez les rapports.

Résultat de référence

Configuration non utilisable

La déclaration initiale est bloquée et commandsReady vaut false.

Voir les paramètres et le JSON de référence
{
  "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"
    ]
  }
}

Modifier puis vérifier à nouveau

L’ID 2 supprime les deux conflits déclarés ; la référence corrigée ne présente aucun conflit connu.

Aucun conflit connu

Voir le JSON de référence après modification
{
  "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"
    ]
  }
}

Ce que cet exemple ne démontre pas

  • Le fichier de calibration est synthétique. N’utilisez pas ses offsets ou plages sur du matériel.
  • Modifier la déclaration ne scanne ni ne change l’ID d’un servo et ne valide pas une calibration réelle.

Référence préparée le:

Sources des spécifications

Les liens ci-dessous conservent les titres d’origine des sources techniques. Lisez leur version et leur date de vérification avec les hypothèses de l’exemple.

  • lerobot-so101410c095eacc0011d998a73383eb94abed2715af0 · vérifié le
  • lerobot-calibration410c095eacc0011d998a73383eb94abed2715af0 · vérifié le
  • lerobot-units410c095eacc0011d998a73383eb94abed2715af0 · vérifié le

Un fichier IMU ne sauvegarde pas les moteurs

Pourquoi une structure IMU-v2 valide demande-t-elle encore une vérification ?

Versions de référence: Microduck rules 2026-11-12.2 · Microduck runtime 4ce3315c86190a632f4d75a2464a4ed31c9af69a · IMU offset format 2

Paramètres et étapes

Microduck UNO Q / V1.1 ; 15 ID déclarés ; IMU-v2 synthétique avec frame qmi-policy-body-offset-v2, vecteurs nuls et sans provenance de mesure.

  1. Conservez les 15 ID physiques, dont celui de la bouche, 34. Le modèle simulé possède 14 articulations.
  2. Dans synthetic-imu-v2.json, distinguez les champs IMU version, frame, acc_offset_ms2 et gyro_zero_dps.
  3. Lisez imu_provenance et gardez la vérification ouverte ; n’inventez pas des mesures pour obtenir un résultat favorable.

Résultat de référence

Vérification nécessaire

Les champs requis ont une structure valide, mais leur provenance manque. Le statut reste needs_review et imuPhysicalPoseVerified vaut false.

Voir les paramètres et le JSON de référence
{
  "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"
    ]
  }
}

Ce que cet exemple ne démontre pas

  • IMU-v2 ne contient pas les calibrations des 15 moteurs et ne constitue pas leur sauvegarde.
  • Les vecteurs à zéro sont synthétiques. Ni mesure immobile et verticale, ni pose réelle, ni correspondance physique entre 15 servos et 14 articulations simulées n’a été vérifiée.

Référence préparée le:

Sources des spécifications

Les liens ci-dessous conservent les titres d’origine des sources techniques. Lisez leur version et leur date de vérification avec les hypothèses de l’exemple.

  • duck-config4ce3315c86190a632f4d75a2464a4ed31c9af69a · vérifié le
  • duck-imu4ce3315c86190a632f4d75a2464a4ed31c9af69a · vérifié le
  • duck-midpoint4ce3315c86190a632f4d75a2464a4ed31c9af69a · vérifié le
Contact