Feetech 버스 트랜잭션 검사
패킷 생성기와 가상 버스로 요청과 응답을 익힌 뒤 실제 직렬 연결을 다루세요. 페이지는 실물 서보에 연결하지 않습니다.
가상 버스 지원 모델
- Feetech STS3215
- Feetech STS3250
- Feetech HD1910M
모델과 패킷 방향 선택
모델, 명령, 대상 ID와 레지스터를 선택합니다. 값은 레지스터 크기와 부호 표현을 따릅니다. 명령 코드와 상태 오류는 같은 바이트 위치에 있으므로 16진수 데이터를 해석할 때 방향을 지정하세요.
트랜잭션 확인 순서
- 요청을 생성하고 헤더, 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 관절 각도나 확인된 실물 자세가 아닙니다.
- 다른 모델·펌웨어, 브로드캐스트 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
입력 조건과 확인 순서
가상 위치 응답의 끝이 알려진 참조 체크섬 F2 대신 F3입니다. 데이터는 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 · 확인일