构建并检查 Feetech 总线事务
先用封包生成器与虚拟总线了解请求和回包,再处理真实串口连接。本页面没有连接实机舵机。
虚拟总线中的型号
- Feetech STS3215
- Feetech STS3250
- Feetech HD1910M
选择型号与封包方向
选择舵机型号、指令、目标 ID 和寄存器。数值按寄存器长度及有符号表示法编码。命令指令与状态错误位处于相同字节位置,因此解析粘贴的十六进制字节时须选对方向。
跟踪一次事务
- 生成请求并检查帧头、ID、长度、参数与校验和。
- 发送到虚拟总线,或把请求及对应回包粘贴到成对记录区。
- 先检查校验和、回包 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。
- 将回包与请求配对,检查ID、字节数和校验和。
- 按小端读取位置:00 08为2048,再计算2048 / 4096 × 360。
- 依寄存器单位转换为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或仅保留原始值寄存器的单位转换。
参考案例制作日期:
规格资料来源
下列链接保留技术资料的原文标题。请结合案例假设,核对资料版本及核对日期。
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · 核对日期
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · 核对日期
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · 核对日期
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · 核对日期
拒绝校验和错误的回包
数据看起来合理也会被拒绝吗?
适用版本: 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。
- 区分请求与回包方向。
- 转换数据前先验证整帧回包。
- 换用另行编写的有效参考回包,再次检查。
参考检查结果
此配置不可使用
报告被阻挡:回包无效,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."
}
}
本案例尚不能证明的事项
- 真实通信应重新采集并排查完整性问题,不能只重算校验和就认可未知数据。
- 日志文件格式可导入,不代表其中的封包有效。
参考案例制作日期:
规格资料来源
下列链接保留技术资料的原文标题。请结合案例假设,核对资料版本及核对日期。
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · 核对日期
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · 核对日期
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · 核对日期
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · 核对日期
状态错误时不输出物理单位值
校验和正确就能忽略状态错误吗?
适用版本: 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,校验和有效。
- 验证帧后读取状态错误字节。
- 保留错误,不把1F当作有效温度。
- 与另一个状态为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参考不证明实物恢复,也不解决不同型号的广播行为。
参考案例制作日期:
规格资料来源
下列链接保留技术资料的原文标题。请结合案例假设,核对资料版本及核对日期。
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · 核对日期
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · 核对日期
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · 核对日期
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · 核对日期