Tạo và kiểm tra giao dịch Feetech
Tìm hiểu yêu cầu và hồi đáp bằng bộ tạo gói và bus ảo trước khi nối cổng thật. Trang không kết nối servo vật lý.
Mẫu servo trong bus ảo
- Feetech STS3215
- Feetech STS3250
- Feetech HD1910M
Chọn mẫu và chiều gói
Chọn mẫu servo, lệnh, ID và thanh ghi. Giá trị theo độ rộng và biểu diễn có dấu của thanh ghi. Lệnh và lỗi trạng thái ở cùng vị trí byte, nên phải chọn đúng chiều khi giải mã dữ liệu thập lục phân.
Theo dõi một giao dịch
- Tạo yêu cầu và kiểm tra đầu gói, ID, độ dài, tham số và checksum.
- Gửi yêu cầu vào bus ảo hoặc dán yêu cầu và các phản hồi tương ứng vào nhật ký yêu cầu–phản hồi.
- Kiểm tra checksum, ID trả lời, độ dài và trạng thái trước khi diễn giải giá trị.
Mã và ghi chép cục bộ
Sao chép byte hoặc ví dụ Python/Arduino. Xuất và nhập bản ghi JSON/CSV. Điện áp, nhiệt độ và vị trí encoder đổi đơn vị theo thanh ghi; các giá trị khác giữ dạng thô.
Hiểu kết quả mô phỏng
Xác nhận ảo không chứng minh servo thật đã trả lời hoặc nhận lệnh ghi. Kiểm tra riêng nguồn, dây TTL bán song công, baud và tài liệu mẫu. Trình duyệt không thực thi lệnh phần cứng hay tải bản ghi lên.
Ví dụ đầy đủ về yêu cầu và phản hồi
Kiểm tra các yêu cầu cố định theo định dạng SDK và phản hồi được ghi rõ là ảo. Tải nhật ký JSON hoặc CSV được hỗ trợ để kiểm tra lại. Đây không phải bản ghi phần cứng và không có dữ liệu nào được gửi.
Kiểm tra cục bộ không xác minh phần cứng thực hay độ an toàn. Các ví dụ tổng hợp này tách biệt với thông số bạn nhập ở trên. Khi nhập một ví dụ, công cụ sẽ kiểm tra lại đầu vào thay vì tin vào kết luận đã lưu.
Đổi đơn vị trong đúng ngữ cảnh READ
00 08, 4A và 1F trong các phản hồi có nghĩa gì?
Phiên bản áp dụng: 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
Dữ liệu đầu vào và các bước
Phản hồi ảo từ STS3215 ID 1 đi với yêu cầu đọc thanh ghi 56, 62 và 63. Dữ liệu là 00 08, 4A, 1F; thời gian nhật ký là 0, 10, 20 ms.
- Ghép phản hồi với yêu cầu rồi kiểm tra ID, số byte và checksum.
- Đọc vị trí little-endian: 00 08 là 2048; tính 2048 / 4096 × 360.
- Áp dụng đơn vị thanh ghi: 74 / 10 V và 31 °C.
Kết quả kiểm tra tham chiếu
Chưa thấy xung đột cấu hình
Báo cáo ngoại tuyến không có xung đột đã biết và hiển thị 180°, 7.4 V, 31 °C cho dữ liệu ảo.
Xem đầu vào và JSON tham chiếu
{
"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."
}
}
Những điều ví dụ này chưa xác minh
- 180° là góc encoder được quy đổi, không phải góc khớp SO-101 đã hiệu chuẩn hay tư thế thực đã kiểm chứng.
- Ví dụ STS3215 này không xác nhận mẫu/firmware khác, PING quảng bá hay đơn vị của thanh ghi chỉ để dạng thô.
Ngày tạo bản tham chiếu:
Nguồn thông số
Các liên kết dưới đây giữ tên gốc của tài liệu kỹ thuật. Hãy đọc phiên bản và ngày đối chiếu cùng với các giả định của ví dụ.
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · ngày đối chiếu
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · ngày đối chiếu
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · ngày đối chiếu
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · ngày đối chiếu
Từ chối phản hồi có checksum sai
Dữ liệu trông hợp lý vẫn có thể bị từ chối không?
Phiên bản áp dụng: 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
Dữ liệu đầu vào và các bước
Phản hồi vị trí ảo kết thúc bằng F3 thay cho checksum tham chiếu F2 đã biết, dù dữ liệu vẫn là 00 08.
- Phân biệt chiều yêu cầu và chiều phản hồi.
- Kiểm tra toàn bộ phản hồi trước khi đổi đơn vị.
- Thay bằng phản hồi tham chiếu hợp lệ được soạn riêng rồi kiểm tra lại.
Kết quả kiểm tra tham chiếu
Không thể dùng cấu hình
Báo cáo bị chặn: phản hồi không hợp lệ và không còn phản hồi hợp lệ cho ID 1. Không tạo giá trị vị trí.
Xem đầu vào và JSON tham chiếu
{
"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."
}
}
Điều chỉnh rồi kiểm tra lại
Tham chiếu ảo đã biết kết thúc bằng F2 và cho 180°. Đây là minh họa phân tích, không phải sửa dây hay phục hồi servo.
Chưa thấy xung đột cấu hình
Xem JSON tham chiếu sau điều chỉnh
{
"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."
}
}
Những điều ví dụ này chưa xác minh
- Với đường truyền thực, hãy thu phản hồi mới và tìm lỗi toàn vẹn; tính lại riêng checksum không làm byte chưa biết trở nên đáng tin.
- Tệp nhật ký có định dạng nhập hợp lệ không có nghĩa gói tin bên trong hợp lệ.
Ngày tạo bản tham chiếu:
Nguồn thông số
Các liên kết dưới đây giữ tên gốc của tài liệu kỹ thuật. Hãy đọc phiên bản và ngày đối chiếu cùng với các giả định của ví dụ.
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · ngày đối chiếu
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · ngày đối chiếu
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · ngày đối chiếu
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · ngày đối chiếu
Lỗi trạng thái ngăn hiển thị đơn vị vật lý
Checksum hợp lệ có đủ khi phản hồi báo lỗi trạng thái không?
Phiên bản áp dụng: 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
Dữ liệu đầu vào và các bước
Phản hồi ảo của thanh ghi 63 có byte lỗi 0x04 và dữ liệu 1F với checksum hợp lệ.
- Kiểm tra khung rồi đọc byte lỗi.
- Giữ lỗi hiển thị; không nhận 1F là nhiệt độ hợp lệ.
- So sánh với một phản hồi tham chiếu riêng có trạng thái 0.
Kết quả kiểm tra tham chiếu
Cần kiểm tra thêm
Báo cáo cần xem xét và không quy đổi nhiệt độ khi byte lỗi là 0x04.
Xem đầu vào và JSON tham chiếu
{
"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."
}
}
Điều chỉnh rồi kiểm tra lại
Gói tin tổng hợp trạng thái 0 cho 31 °C và không có xung đột gói tin đã biết. Chỉ byte tham chiếu đổi; không đặt lại hay thử động cơ.
Chưa thấy xung đột cấu hình
Xem JSON tham chiếu sau điều chỉnh
{
"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."
}
}
Những điều ví dụ này chưa xác minh
- 0x04 là cờ quá nhiệt trong hồ sơ STS này; gói tin ảo không chứng minh servo thực bị quá nhiệt.
- Tham chiếu trạng thái 0 không chứng minh đã phục hồi thực tế hay giải quyết hành vi quảng bá riêng từng mẫu.
Ngày tạo bản tham chiếu:
Nguồn thông số
Các liên kết dưới đây giữ tên gốc của tài liệu kỹ thuật. Hãy đọc phiên bản và ngày đối chiếu cùng với các giả định của ví dụ.
- Feetech SDK packet construction64922cda46e56b21b8c1d9e830d936a1941645ae · ngày đối chiếu
- Feetech STS register addresses64922cda46e56b21b8c1d9e830d936a1941645ae · ngày đối chiếu
- Waveshare ST3215 READ-position exampleOfficial example, unversioned page; ST3215 only · ngày đối chiếu
- Waveshare ST memory-table unitsOfficial ST-family table, unversioned; match actual model/firmware · ngày đối chiếu