建立並檢查 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 · 核對日期