Microduck Robot●microduck-robot.com
工具

匯流排伺服馬達工具

產生、檢查並理解 Feetech 匯流排封包。

設定指令

254 向所有伺服馬達廣播。一般廣播指令不回覆;同步讀取是例外。
單圈角度請輸入 0–359.9°。帶負號或多圈目標請直接修改暫存器數值。

封包

格式與校驗和有效

僅模擬協定回應,不連接真實硬體。

Python / Arduino 程式碼

            
虛擬匯流排與回覆封包
    收到異常回覆封包?

    建立並檢查 Feetech 匯流排事務

    先用封包產生器與虛擬匯流排了解請求與回覆封包,再處理真實序列埠連線。本頁面沒有連接實機伺服馬達。

    虛擬匯流排中的型號

    • Feetech STS3215
    • Feetech STS3250
    • Feetech HD1910M

    規則版本: 2026-11-12.2

    選擇型號與封包方向

    選擇伺服馬達型號、指令、目標 ID 與暫存器。數值按暫存器長度與有符號表示法編碼。命令指令與狀態錯誤位處於相同位元組位置,因此解析貼上的十六進位資料時須選對方向。

    追蹤一次事務

    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的讀取請求;資料為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關節角度或已驗證的實際姿態。
    • 此STS3215範例不證明其他型號/韌體、廣播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

    輸入條件與操作步驟

    虛擬位置回包末尾是F3,而非已知參考校驗和F2;資料仍是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參考不證明實物恢復,也不解決不同型號的廣播行為。

    參考案例製作日期:

    規格資料來源

    下列連結保留技術資料的原文標題。請搭配案例假設,核對資料版本與核對日期。

    聯絡我們