Microduck Robot●microduck-robot.com
ツール

バスサーボツール

Feetech のパケットを生成・確認・解析します。

コマンド設定

254 は全サーボへのブロードキャストです。通常のブロードキャストに応答はありませんが、同期読み取りは例外です。
1 回転内の角度は 0~359.9° で入力してください。負値や複数回転の目標はレジスタ値を直接変更してください。

パケット

形式とチェックサムは正常

プロトコルの応答のみを再現します。実機には接続しません。

Python / Arduino コード

            
仮想バスと応答
    予期しない応答を受信しましたか?

    Feetechバスの通信を確認する

    パケット生成と仮想バスで要求・応答を理解してから、実際のシリアル接続を扱います。このページは実機サーボに接続しません。

    仮想バスの対象モデル

    • Feetech STS3215
    • Feetech STS3250
    • Feetech HD1910M

    ルール版: 2026-11-12.2

    モデルとパケット方向を選ぶ

    モデル、命令、ID、レジスターを指定します。値はレジスター幅と符号表現に従います。命令と状態エラーは同じバイト位置なので、16進データを解析するときは方向を指定してください。

    通信を追う手順

    1. 要求を作り、ヘッダー、ID、長さ、パラメーター、チェックサムを確認します。
    2. 仮想バスへ送るか、要求と対応する応答をペア記録欄に貼り付けます。
    3. チェックサム、応答ID、データ長、サーボ状態を確認してから値を解釈します。

    コードとローカル記録

    バイト列やPython/Arduinoの例をコピーできます。要求と応答をJSON/CSVで入出力できます。電圧・温度・エンコーダー位置はレジスターの文脈で単位変換し、他の値は生のままです。

    仮想応答の意味

    仮想確認は実機の応答や書き込み成功を証明しません。電源、半二重TTL配線、ボーレート、モデル資料を別途確認してください。ブラウザーは機器向けコマンドを実行せず、通信記録もアップロードしません。

    要求と応答を最後まで確認する事例

    SDK形式に沿う固定要求と、明示的に仮想の応答を調べます。対応するバスログJSONまたはCSVをダウンロードして再確認できます。実機の通信記録ではなく、送信も行いません。

    ローカル確認は実機の動作や安全性を保証しません。 ここに示す合成ケースは、上のフォームに入力した値とは別の参考データです。ケースをインポートすると入力から再チェックされ、保存済みの判定はそのまま採用されません。

    READ要求の文脈で値を換算する

    応答の00 08、4A、1Fは何を意味しますか?

    対象バージョン: 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

    入力条件と手順

    仮想STS3215のID 1から、レジスター56、62、63へのREADに対応する応答を用意します。データは00 08、4A、1F、ログ時刻は0、10、20 msです。

    1. 応答を要求と対応付け、ID、バイト数、チェックサムを確認します。
    2. 位置をリトルエンディアンで読みます。00 08は2048なので、2048 / 4096 × 360を計算します。
    3. レジスターの単位を使い、74 / 10 Vと31 °Cに換算します。

    参考ケースの確認結果

    既知の構成矛盾なし

    オフライン報告では既知の矛盾がなく、仮想データとして180°、7.4 V、31 °Cを表示します。

    入力と参考結果のJSONを見る
    {
      "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."
      }
    }
    

    このケースでは確認できないこと

    • 180°はエンコーダー角度の換算であり、校正済みSO-101関節角度や実機姿勢ではありません。
    • 他の型番・ファームウェア、ブロードキャストPING、未換算レジスターの物理単位を保証する例ではありません。

    参考データの作成日:

    仕様の出典

    以下のリンクには技術資料の原題を記載しています。ケースの前提条件とあわせて、対象バージョンと確認日を確認してください。

    チェックサムが違う応答を拒否する

    データが妥当そうでも拒否されますか?

    対象バージョン: 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

    入力条件と手順

    仮想位置応答の末尾を、既知の参照値F2ではなくF3にしています。データ自体は00 08のままです。

    1. 要求と応答の方向を区別します。
    2. データを換算する前に応答全体を検証します。
    3. 別に作成した正しい参照応答に置き換えて再確認します。

    参考ケースの確認結果

    この構成は使用できません

    無効な応答として報告が阻止され、ID 1の有効な応答がないと判定されます。位置値は生成しません。

    入力と参考結果のJSONを見る
    {
      "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."
      }
    }
    

    設定を変えて再確認

    既知の仮想参照はF2で終わり、180°になります。解析の実演であり、配線修理やサーボ復旧ではありません。

    既知の構成矛盾なし

    変更後の参考JSONを見る
    {
      "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."
      }
    }
    

    このケースでは確認できないこと

    • 実際の通信では新しく受信して原因を調べます。未知のデータのチェックサムだけ直して信用してはいけません。
    • ログファイルの形式が有効でも、中のパケットは無効なままです。

    参考データの作成日:

    仕様の出典

    以下のリンクには技術資料の原題を記載しています。ケースの前提条件とあわせて、対象バージョンと確認日を確認してください。

    状態エラーがあると物理単位へ換算しない

    チェックサムが正しければ、状態エラーも無視できますか?

    対象バージョン: 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

    入力条件と手順

    レジスター63の仮想応答はエラーバイト0x04、データ1Fで、チェックサムは正しい状態です。

    1. フレームを検証してからエラーバイトを読みます。
    2. エラーを残し、1Fを有効な温度として扱いません。
    3. 状態0の別の参照応答と比較します。

    参考ケースの確認結果

    確認が必要

    エラーバイト0x04では要確認となり、温度への換算値は出しません。

    入力と参考結果のJSONを見る
    {
      "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."
      }
    }
    

    設定を変えて再確認

    合成した状態0のパケットでは31 °Cとなり、既知のパケット矛盾がありません。参照バイトだけを変更し、モーターはリセットも試験もしていません。

    既知の構成矛盾なし

    変更後の参考JSONを見る
    {
      "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."
      }
    }
    

    このケースでは確認できないこと

    • 0x04はこのSTSプロファイルの過熱フラグですが、仮想パケットは実機の過熱を示す証拠ではありません。
    • 状態0の参照は、実機の復旧や型番別ブロードキャスト動作を証明しません。

    参考データの作成日:

    仕様の出典

    以下のリンクには技術資料の原題を記載しています。ケースの前提条件とあわせて、対象バージョンと確認日を確認してください。

    お問い合わせ