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
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
- Créez la requête et examinez en-tête, ID, longueur, paramètres et somme de contrôle.
- Testez le bus virtuel ou collez la requête et les réponses correspondantes dans le journal de paires.
- 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.
- Associer chaque réponse à sa requête, son ID, sa longueur et sa somme de contrôle.
- Lire la position en little-endian : 00 08 vaut 2048 ; calculer 2048 / 4096 × 360.
- 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.
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · vérifié le
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · vérifié le
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · vérifié le
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · vérifié le
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.
- Distinguer le sens requête du sens réponse.
- Valider la réponse entière avant de convertir les données.
- 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.
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · vérifié le
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · vérifié le
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · vérifié le
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · vérifié le
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.
- Valider la trame puis lire l’octet d’erreur.
- Garder l’erreur visible ; ne pas accepter 1F comme température.
- 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.
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · vérifié le
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · vérifié le
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · vérifié le
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · vérifié le