RBQ Python SDK — 빠른 시작

3단계로 Python SDK 예제를 돌려봅니다.

1. 클론 및 설치

git clone https://github.com/RainbowRobotics/RBQ.git
cd RBQ

# Python SDK 설치
cd rbq_sdk/python
pip install -e .
cd ../..

2. 시뮬레이터 실행 (하드웨어 사용 시 생략)

시뮬레이터는 도커 안에서 실행됩니다. 도커 외에는 설치할 것이 없고, 도커가 없으면 스크립트가 설치를 제안합니다. 처음 실행할 때 이미지를 만드느라 몇 분 걸립니다. MuJoCo를 참조하세요.

bash scripts/sim.bash --no-gui

같은 PC 에서 RBQ 앱을 켭니다. 데스크탑 앱이 이 시뮬레이터를 스스로 찾아 붙습니다 — 컨트롤 → 자동 기동 → STAND 순서로 누릅니다. 제어 홈 참고.

3. 예제 실행

cd rbq_sdk/python/example/sport

# 터미널 CLI
python3 rbq_sport_client.py

# 조이스틱 제어
python3 rbq_sport_client_joy.py

두 예제 모두 기본적으로 루프백 인터페이스(lo)를 사용합니다. 시뮬레이터와 로봇 내부 스택이 쓰는 인터페이스와 같으므로, 스택 전체가 이 PC에서 도는 동안에는 인자를 줄 필요가 없습니다.

실제 로봇에 연결할 때는 로봇에 닿는 인터페이스를 첫 인자로 넘기세요:

python3 rbq_sport_client.py eth0

인터페이스 이름은 ip link로 확인하세요.

예제 목록

예제	설명
Sport Client →	터미널 CLI — 명령 테스트
Sport Client (Joy) →	게임패드 — 전체 버튼 매핑