Microduck Robot●microduck-robot.com
Outils

Outil pour servos de bus

Créer, vérifier et comprendre les paquets Feetech.

Configurer la commande

254 diffuse à tous les servos. Les commandes de diffusion ordinaires ne répondent pas ; la lecture synchronisée fait exception.
Saisissez 0–359,9° pour un tour. Pour une cible négative ou multitour, modifiez la valeur du registre.

Paquet

Format et somme valides

Réponses du protocole uniquement. Aucun matériel réel connecté.

Code Python / Arduino

            
Bus virtuel et réponses
    Une réponse inattendue ?

    Construire des transactions Feetech

    Découvrez requêtes et réponses dans le générateur et le bus virtuel avant une liaison série réelle. Aucun servo physique n'est connecté par cette page.

    Modèles du bus virtuel

    • Feetech STS3215
    • Feetech STS3250
    • Feetech HD1910M

    Version des règles: 2026-11-12.2

    Choisir modèle et direction

    Sélectionnez modèle, instruction, ID et registre. Les valeurs suivent largeur et représentation signée du registre. Instruction et erreur de statut occupent le même emplacement ; choisissez la direction pour décoder les octets hexadécimaux.

    Suivre une transaction

    1. Créez la requête et examinez en-tête, ID, longueur, paramètres et somme de contrôle.
    2. Testez le bus virtuel ou collez la requête et les réponses correspondantes dans le journal de paires.
    3. Vérifiez somme, IDs de réponse, longueur et statut avant d'interpréter les valeurs.

    Code et journaux locaux

    Copiez les octets ou exemples Python/Arduino. Exportez et importez les journaux JSON/CSV. Tension, température et position codeur sont converties selon le registre ; les autres valeurs restent brutes.

    Interpréter la simulation

    Une confirmation virtuelle ne prouve ni réponse ni écriture acceptée par un vrai servo. Vérifiez séparément alimentation, câblage TTL semi-duplex, débit et documentation du modèle. Le navigateur n'exécute pas les commandes matérielles et ne téléverse pas les journaux.

    Cas complets de requêtes et réponses

    Examinez des requêtes fixes au format du SDK et des réponses explicitement virtuelles. Téléchargez le journal JSON ou CSV pris en charge pour les vérifier à nouveau. Ce ne sont pas des captures matérielles ; rien n’est transmis.

    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.

    Décoder les valeurs dans le bon contexte READ

    Que signifient 00 08, 4A et 1F dans ces réponses ?

    Versions de référence: Microduck bus rules 2026-11-12.2 · Feetech SDK 64922cda46e56b21b8c1d9e830d936a1941645ae · Register-table baseline LeRobot 0.6.1, as recorded by src/servo-tool/data.json

    Paramètres et étapes

    Les réponses virtuelles du STS3215 ID 1 correspondent aux lectures des registres 56, 62 et 63. Données : 00 08, 4A et 1F ; temps du journal : 0, 10 et 20 ms.

    1. Associer chaque réponse à sa requête, son ID, sa longueur et sa somme de contrôle.
    2. Lire la position en little-endian : 00 08 vaut 2048 ; calculer 2048 / 4096 × 360.
    3. Appliquer les unités des registres : 74 / 10 V et 31 °C.

    Résultat de référence

    Aucun conflit connu

    Le rapport hors ligne ne détecte pas de conflit connu et affiche 180°, 7.4 V et 31 °C pour ces données virtuelles.

    Voir les paramètres et le JSON de référence
    {
      "inputs": {
        "records": [
          {
            "request": "FF FF 01 04 02 38 02 BE",
            "responses": [
              "FF FF 01 04 00 00 08 F2"
            ],
            "timeMs": 0,
            "origin": "virtual",
            "model": "sts3215"
          },
          {
            "request": "FF FF 01 04 02 3E 01 B9",
            "responses": [
              "FF FF 01 03 00 4A B1"
            ],
            "timeMs": 10,
            "origin": "virtual",
            "model": "sts3215"
          },
          {
            "request": "FF FF 01 04 02 3F 01 B8",
            "responses": [
              "FF FF 01 03 00 1F DC"
            ],
            "timeMs": 20,
            "origin": "virtual",
            "model": "sts3215"
          }
        ]
      },
      "status": "no_known_conflict",
      "findings": [],
      "outputs": {
        "pairs": [
          {
            "index": 0,
            "timeMs": 0,
            "model": "sts3215",
            "id": 1,
            "error": 0,
            "request": "FF FF 01 04 02 38 02 BE",
            "response": "FF FF 01 04 00 00 08 F2",
            "address": 56,
            "values": [
              {
                "address": 56,
                "name": "Present_Position",
                "raw": 2048,
                "value": 180,
                "unit": "°"
              }
            ]
          },
          {
            "index": 1,
            "timeMs": 10,
            "model": "sts3215",
            "id": 1,
            "error": 0,
            "request": "FF FF 01 04 02 3E 01 B9",
            "response": "FF FF 01 03 00 4A B1",
            "address": 62,
            "values": [
              {
                "address": 62,
                "name": "Present_Voltage",
                "raw": 74,
                "value": 7.4,
                "unit": "V"
              }
            ]
          },
          {
            "index": 2,
            "timeMs": 20,
            "model": "sts3215",
            "id": 1,
            "error": 0,
            "request": "FF FF 01 04 02 3F 01 B8",
            "response": "FF FF 01 03 00 1F DC",
            "address": 63,
            "values": [
              {
                "address": 63,
                "name": "Present_Temperature",
                "raw": 31,
                "value": 31,
                "unit": "°C"
              }
            ]
          }
        ],
        "pairing": "declared-request-response",
        "units": "Only voltage, temperature and encoder-position conversions are established here; other registers remain raw."
      }
    }
    

    Ce que cet exemple ne démontre pas

    • 180° est une conversion d’angle du codeur, pas un angle articulaire SO-101 étalonné ni une pose réelle vérifiée.
    • Ce cas STS3215 ne prouve ni les autres modèles/firmwares, ni le PING diffusé, ni des unités pour les registres laissés bruts.

    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.

    Refuser une réponse à la somme de contrôle incorrecte

    Des données plausibles peuvent-elles tout de même être refusées ?

    Versions de référence: Microduck bus rules 2026-11-12.2 · Feetech SDK 64922cda46e56b21b8c1d9e830d936a1941645ae · Register-table baseline LeRobot 0.6.1, as recorded by src/servo-tool/data.json

    Paramètres et étapes

    La réponse virtuelle de position finit par F3 au lieu de la référence F2, tout en gardant les données 00 08.

    1. Distinguer le sens requête du sens réponse.
    2. Valider la réponse entière avant de convertir les données.
    3. Recontrôler avec la réponse valide de référence, rédigée séparément.

    Résultat de référence

    Configuration non utilisable

    Le rapport est bloqué : la réponse est invalide et aucune réponse valide ne reste pour l’ID 1. Aucune position n’est produite.

    Voir les paramètres et le JSON de référence
    {
      "inputs": {
        "records": [
          {
            "request": "FF FF 01 04 02 38 02 BE",
            "responses": [
              "FF FF 01 04 00 00 08 F3"
            ],
            "timeMs": 0,
            "origin": "virtual",
            "model": "sts3215"
          }
        ]
      },
      "status": "blocked",
      "findings": [
        {
          "code": "bad_reply",
          "severity": "blocked",
          "fieldPath": "records",
          "messageKey": "rxBad",
          "details": {
            "index": 1
          },
          "sourceRef": null
        },
        {
          "code": "missing_reply",
          "severity": "needs_review",
          "fieldPath": "records",
          "messageKey": "missingReply",
          "details": {
            "index": 1
          },
          "sourceRef": null
        }
      ],
      "outputs": {
        "pairs": [],
        "pairing": "declared-request-response",
        "units": "Only voltage, temperature and encoder-position conversions are established here; other registers remain raw."
      }
    }
    

    Modifier puis vérifier à nouveau

    La référence virtuelle connue finit par F2 et donne 180°. Cela démontre le décodage, pas une réparation du câble ou du servomoteur.

    Aucun conflit connu

    Voir le JSON de référence après modification
    {
      "inputs": {
        "records": [
          {
            "request": "FF FF 01 04 02 38 02 BE",
            "responses": [
              "FF FF 01 04 00 00 08 F2"
            ],
            "timeMs": 0,
            "origin": "virtual",
            "model": "sts3215"
          }
        ]
      },
      "status": "no_known_conflict",
      "findings": [],
      "outputs": {
        "pairs": [
          {
            "index": 0,
            "timeMs": 0,
            "model": "sts3215",
            "id": 1,
            "error": 0,
            "request": "FF FF 01 04 02 38 02 BE",
            "response": "FF FF 01 04 00 00 08 F2",
            "address": 56,
            "values": [
              {
                "address": 56,
                "name": "Present_Position",
                "raw": 2048,
                "value": 180,
                "unit": "°"
              }
            ]
          }
        ],
        "pairing": "declared-request-response",
        "units": "Only voltage, temperature and encoder-position conversions are established here; other registers remain raw."
      }
    }
    

    Ce que cet exemple ne démontre pas

    • Sur un bus réel, refaire une capture et examiner l’intégrité ; recalculer seulement le checksum ne rend pas des octets inconnus fiables.
    • Le journal reste un fichier importable valide même si son paquet est invalide.

    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.

    Une erreur d’état bloque la conversion physique

    Une somme de contrôle valide suffit-elle malgré une erreur d’état ?

    Versions de référence: Microduck bus rules 2026-11-12.2 · Feetech SDK 64922cda46e56b21b8c1d9e830d936a1941645ae · Register-table baseline LeRobot 0.6.1, as recorded by src/servo-tool/data.json

    Paramètres et étapes

    Une réponse virtuelle du registre 63 contient l’erreur 0x04 et les données 1F avec une somme de contrôle valide.

    1. Valider la trame puis lire l’octet d’erreur.
    2. Garder l’erreur visible ; ne pas accepter 1F comme température.
    3. Comparer avec une autre réponse de référence d’état 0.

    Résultat de référence

    Vérification nécessaire

    Le rapport demande une vérification et ne convertit aucune température tant que l’erreur vaut 0x04.

    Voir les paramètres et le JSON de référence
    {
      "inputs": {
        "records": [
          {
            "request": "FF FF 01 04 02 3F 01 B8",
            "responses": [
              "FF FF 01 03 04 1F D8"
            ],
            "timeMs": 0,
            "origin": "virtual",
            "model": "sts3215"
          }
        ]
      },
      "status": "needs_review",
      "findings": [
        {
          "code": "servo_status",
          "severity": "needs_review",
          "fieldPath": "records",
          "messageKey": "servoError",
          "details": {
            "id": 1,
            "code": "0x4"
          },
          "sourceRef": null
        }
      ],
      "outputs": {
        "pairs": [
          {
            "index": 0,
            "timeMs": 0,
            "model": "sts3215",
            "id": 1,
            "error": 4,
            "request": "FF FF 01 04 02 3F 01 B8",
            "response": "FF FF 01 03 04 1F D8",
            "address": 63,
            "values": []
          }
        ],
        "pairing": "declared-request-response",
        "units": "Only voltage, temperature and encoder-position conversions are established here; other registers remain raw."
      }
    }
    

    Modifier puis vérifier à nouveau

    Le paquet synthétique d’état 0 donne 31 °C sans conflit de paquet connu. Seuls les octets de référence changent ; aucun moteur n’a été réinitialisé ou testé.

    Aucun conflit connu

    Voir le JSON de référence après modification
    {
      "inputs": {
        "records": [
          {
            "request": "FF FF 01 04 02 3F 01 B8",
            "responses": [
              "FF FF 01 03 00 1F DC"
            ],
            "timeMs": 0,
            "origin": "virtual",
            "model": "sts3215"
          }
        ]
      },
      "status": "no_known_conflict",
      "findings": [],
      "outputs": {
        "pairs": [
          {
            "index": 0,
            "timeMs": 0,
            "model": "sts3215",
            "id": 1,
            "error": 0,
            "request": "FF FF 01 04 02 3F 01 B8",
            "response": "FF FF 01 03 00 1F DC",
            "address": 63,
            "values": [
              {
                "address": 63,
                "name": "Present_Temperature",
                "raw": 31,
                "value": 31,
                "unit": "°C"
              }
            ]
          }
        ],
        "pairing": "declared-request-response",
        "units": "Only voltage, temperature and encoder-position conversions are established here; other registers remain raw."
      }
    }
    

    Ce que cet exemple ne démontre pas

    • 0x04 est le drapeau de surchauffe de ce profil STS ; le paquet virtuel ne prouve aucune surchauffe réelle.
    • Une référence d’état 0 ne démontre ni rétablissement physique ni comportement de diffusion propre à chaque modèle.

    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.

    Contact