Claude에서 열기ChatGPT에서 열기
https://rainbowrobotics.github.io/RBQ/nightly/llms-full.txt 는 Rainbow Robotics RBQ 4족 로봇 매뉴얼 전문입니다. 읽고 이 문서를 근거로 한국어로 답변해 주세요.
AI 답변은 부정확할 수 있습니다. 안전·정비 항목은 매뉴얼 원문을 확인하세요.
한국어
https://rainbowrobotics.github.io/RBQ/nightly/llms-full.txt 는 Rainbow Robotics RBQ 4족 로봇 매뉴얼 전문입니다. 읽고 이 문서를 근거로 한국어로 답변해 주세요.
AI 답변은 부정확할 수 있습니다. 안전·정비 항목은 매뉴얼 원문을 확인하세요.
한국어
소스: rbq_sdk/python/example/sport/rbq_sport_client.py
C++의 rbq_sport_client를 Python으로 포팅한 버전입니다.
SportClient 명령을 하나씩 로봇에 전송하는 터미널 기반 대화형 애플리케이션으로, 입력한 줄마다 요청을 하나씩 보냅니다.
단일 메인 루프:
stdin에서 한 줄 입력 받기 (list, 명령 이름, 또는 명령 ID).TestOption 업데이트.SportClient 메서드를 한 번 호출하고 다음 줄을 기다림.rbq_sdk_py 설치 완료 — Python SDK 개요 참조.rbq_sdk/python/example/sport/에서:
python3 rbq_sport_client.py [networkInterface]
# 시뮬레이터 / 로봇 내부 스택 — 인터페이스 기본값은 lo
python3 rbq_sport_client.py
# 실제 로봇 — 로봇에 닿는 인터페이스를 넘깁니다
python3 rbq_sport_client.py eth0프롬프트에서 list를 입력하면 전체 명령 목록이 출력됩니다.
| ID | 이름 | 호출되는 SportClient 메서드 |
|---|---|---|
| 0 | damp | Damp() |
| 1 | balance_stand | BalanceStand() |
| 2 | stop_move | StopMove() |
| 3 | stand_down | StandDown() |
| 4 | recovery_stand | RecoveryStand() |
| 5 | move | Move(0.0, 0.0, 0.5) — 제자리 회전 |
| 6 | switch_gait | SwitchGait(0) — 걷기 보행(49)으로 전환 |
| 7 | speed_level | SpeedLevel(1) — 빠르게: move 속도 × 1.5 |
| 8 | get_state | GetState() — 로봇 상태 출력 |
| 9 | body_height | BodyHeight(-0.1) — 몸 10 cm 낮추기 |
| 10 | stand_up | StandUp() |
| 11 | enter_leftside_gait | LeftSideGait(1) |
| 12 | exit_leftside_gait | LeftSideGait(0) — 걷기 보행(49)으로 복귀 |
| 13 | enter_handstand | HandStand(1) — RL_FRONT_WALK(31) 정책으로 전환 |
| 14 | exit_handstand | HandStand(0) — 걷기 보행(49)으로 복귀 |
| 15 | pose | BodyPosition(0.0, 0.0, -0.1, 0.2) — 몸 10 cm 낮추고 0.2 rad 돌리기 |
| 16 | euler | Euler(0.2, 0.3, 0.3) — 몸 기울이기(roll·pitch·yaw, 라디안) |
WARNING
ID 11–14 는 넓은 곳에서 시험하세요 — C++ 예제 소스가 이 명령들에 "Caution: test in open area" 를 달아 두었습니다.
move를 뺀 모든 명령은 로봇의 응답을 기다렸다가 그 코드를 출력합니다.move는 기다리지 않고0을 출력합니다.
move·body_height·pose·euler는 제어 모드가 HighLevel 일 때만 먹습니다. 예제는 시작할 때rt/rbq/cmd/switch_control_mode에true를 발행해 켭니다(ROS/rbq/cmd/switch_control_mode). 게임패드 스틱을 움직이면 다시 꺼집니다. 꺼져 있으면 로봇이0대신3205(거부)로 답합니다.Move()는 그 답을 기다리지 않고0을 돌려주며, 로봇의 답은LastMoveCode()로 봅니다(가장 최근Move()에 대한 답).move는 걷기 보행도 켜져 있어야 하므로move전에switch_gait(6)를 먼저 실행하세요.
switch_gait는 걷기 보행49로 바꿉니다.SwitchGait(1)(달리기)도 같은 보행입니다 —49는 1.3 m/s 를 넘으면 빠른 정책으로 알아서 바뀝니다.SwitchGait(2)(오르기)는 비전 걷기48로 바꾸는데, 지형을 로봇의 비전으로 봅니다. 비전이 꺼져 있으면 지형 정보 없이 그대로 걷고 경고도 없습니다. 옆걸음·물구나무를 끝내면49로 돌아갑니다.
Euler(roll, pitch, yaw)는 라디안입니다.BodyHeight(h)와BodyPosition(x, y, z, yaw)의z는 기본 높이에서의 차이(m),yaw는 라디안입니다. 서 있을 때(보행1)는 roll ±25°, pitch ±20°, yaw ±25°, 높이 −0.15~+0.05 m 를 따릅니다. 걸을 때(48·49)는 pitch(±25°)와 높이(−0.25~+0.1 m)만 따릅니다. 범위를 넘는 값은 잘립니다. 자세는move·stop_move를 해도 유지되고,stand_up·stand_down·balance_stand·recovery_stand·damp를 하면 수평으로 돌아갑니다. 앱·비상정지 같은 다른 경로로 로봇이 앉거나 넘어지거나 멈추면 SDK 가 자세를 버리고 다음move·stop_move에서 몸을 수평으로 돌립니다 — 그 전에 HighLevel 모드로 다시 세우면 마지막 자세로 설 수 있습니다. 로봇은 몸을 앞뒤·좌우로 옮기지 못하므로BodyPosition은x·y가0이 아니면3204(파라미터 오류)를 돌려줍니다.
SpeedLevel(-1)은 느리게,0은 보통(기본값),1은 빠르게입니다 — 로봇이move속도에 0.5·1·1.5 를 곱합니다. 보행마다 정해진 최대 속도는 그대로 적용됩니다. 로봇 소프트웨어를 다시 켜면0으로 돌아갑니다.
get_state는 로봇의 응답을 한 줄에 키 하나씩 출력합니다:
| 키 | 값 |
|---|---|
fsm_id | 현재 보행 ID(Gait State ID) |
fsm_name | 현재 보행 이름 |
speed_level | -1, 0, 1 |
control_mode | 1 HighLevel, 0 조이스틱 |
is_standing | 1 또는 0 |
is_fall | 1 또는 0 |
$ python3 rbq_sport_client.py eth0
Input "list " to list all test option ...
balance_stand
Test: balance_stand, test_id: 1
Request successed: balance_stand, code: 0
move
Test: move, test_id: 5
Request successed: move, code: 0SetTimeout(25.0): Python SportClient는 25초 타임아웃을 명시적으로 설정합니다 — GetState 같은 RPC 스타일 호출에 필요합니다.input()이 Enter 를 누를 때까지 블로킹되므로, 입력한 줄마다 요청을 하나씩 보냅니다 — 명령을 반복해서 보내지 않습니다.get_state: 로봇 응답의 키를 전부 출력합니다.| 항목 | C++ | Python |
|---|---|---|
| 타임아웃 | 기본값 | SetTimeout(25.0) 명시 |
ConvertToInt 실패 시 | -1 반환 | None 반환 (ID 0과의 오매칭 없음) |
| 터미널 입력 | std::getline 블로킹 | input() 블로킹 |
| 에러 메시지 | 카운트 출력 | 카운트 출력 |