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参考不证明实物恢复,也不解决不同型号的广播行为。

    参考案例制作日期:

    规格资料来源

    下列链接保留技术资料的原文标题。请结合案例假设,核对资料版本及核对日期。

    联系我们