ROS 터미널과 연결
www_posim_ros 패키지는 실행 중인 WWW-POSIM 작업공간과 내 컴퓨터의 ROS 환경을 연결합니다. 커넥터가 인증된 센서 데이터를 받아 로컬 ROS 도메인에 표준 ROS 2 메시지로 발행합니다. ROS 도구를 사용하는 동안 커넥터를 실행해 두세요.
Gazebo 센서→ HTTPS / WebSocket →www_posim_ros
커넥터→ 로컬 ROS 2 →ros2 topic · RViz
내 Python 프로그램
설치형 앱의 ROS 터미널
월드를 시작한 뒤 설치형 앱에서 ROS 터미널 열기를 누르세요. 작업 폴더가 열리고 앱의 ROS 환경이 준비됩니다. 기본 작업 폴더는 Documents/WWW-POSIM입니다. 앱에서 연 여러 터미널은 하나의 로컬 커넥터를 함께 사용합니다.
Windows에서 시작에 실패하면 앱이 연 터미널에 오류 메시지가 남습니다. 내용을 확인한 뒤 Enter를 눌러 닫으세요. 실시간 데이터 대기 시간이 초과됐다면 브라우저에서 월드를 시작하고 ROS 터미널을 다시 여세요.
macOS 터미널에는 WWW-POSIM 제목, 준비 상태와 연결 대기 시간이 표시됩니다. ROS connected와 ROS·Python·커넥터 버전이 나타나면 명령을 입력하세요. 색상이 적용된 WWW-POSIM 프롬프트로 준비된 환경을 확인할 수 있습니다.
VS Code에서 열기를 누르면 같은 폴더에서 ROS 환경이 준비된 터미널과 ros_vehicle_command.py 예제가 열립니다. 제어 프로그램 실행은 설치형 작업공간에서 제어를 참고하세요. RViz 열기는 설치된 뷰어를 실행합니다.
Autopilot 모드에서는 ROS 도구로 센서 데이터를 조회할 수 있습니다. ros_vehicle_command.py는 ROS 2 직접 제어 모드가 필요합니다. 모드를 바꾸려면 차량의 시동을 해제하고, 작업 공간 설정에서 준비된 지형을 다시 선택한 뒤 ROS 2 직접 제어로 월드를 시작하세요. 다시 시작하면 시뮬레이션이 초기화됩니다. 저장한 차량의 제어 모드는 해당 버전에 고정됩니다. 기본 차량을 선택하거나 저장한 차량을 복사해 편집하세요.
설치형 앱의 ROS 2 직접 제어 패널에서도 ROS 터미널 열기와 VS Code에서 열기를 사용할 수 있습니다. 두 버튼은 앱에서 선택한 작업 폴더를 사용합니다. 웹사이트를 사용하거나 로컬 실행 기능에 연결할 수 없으면 ROS 터미널·VS Code 사용 안내를 선택하세요. 문서는 별도 창에서 열립니다.
내 ROS 환경을 웹 작업공간에 연결하기
웹사이트에서 내 월드를 시작하세요. ROS 설치 안내에 따라 ROS 2 Lyrical과 표준 메시지 패키지를 준비하세요. Ubuntu 또는 WSL 터미널에서 ROS 환경을 불러오고 커넥터를 설치합니다.
source /opt/ros/lyrical/setup.bash
sudo apt install ros-lyrical-rmw-cyclonedds-cpp
python3 -m venv --system-site-packages .venv-ros
source .venv-ros/bin/activate
python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl
export RMW_IMPLEMENTATION=rmw_cyclonedds_cpp
export ROS_DOMAIN_ID=76
export ROS_AUTOMATIC_DISCOVERY_RANGE=LOCALHOST
www-posim-connect --server https://www-posim.vercel.app/api --email YOU@example.com
안내가 나오면 계정 비밀번호를 입력하고 이 터미널을 열어 두세요. 두 번째 터미널에서도 같은 ROS 환경과 가상환경을 불러오고, 위의 환경변수 세 개를 똑같이 설정하세요. Python 가상환경만으로는 ROS나 rclpy가 설치되지 않습니다.
Mac 앱에 포함된 ROS 환경을 쓰려면 ROS 환경을 불러오는 명령 대신 다음 명령을 사용하세요.
eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"
내 ROS 환경을 설치형 작업공간에 연결하기
설치형 앱에서 월드를 시작하세요. 준비된 ROS 환경에서 웹사이트 연결 명령 대신 다음 명령을 실행합니다.
www-posim-connect --local --server http://127.0.0.1:3300/api
앱의 실행 중인 세션으로 연결하므로 웹사이트 계정 정보를 다시 입력하지 않습니다. ROS 도메인 하나에는 커넥터 하나만 실행하세요. 같은 도메인에서 앱이 관리하는 커넥터를 중복 실행하지 마세요. 별도의 WSL 배포판에서 Windows 앱의 루프백 주소에 접근할 수 없다면 앱의 ROS 터미널 열기를 사용하세요.
토픽과 실시간 데이터 확인하기
연결 준비가 끝나면 준비된 터미널에서 다음 명령을 실행하세요.
ros2 topic list
ros2 topic echo /model/wamv/odometry
메시지가 계속 들어오고 타임스탬프가 바뀌는지 확인하세요. Ctrl+C로 출력을 멈춥니다. BlueROV2를 사용한다면 목록에서 해당 기체의 odometry 토픽을 찾아 입력하세요. 목록에 토픽 이름이 나타나는 것만으로 실시간 수신이 확인되는 것은 아닙니다.
데이터가 없다면 월드가 실행 중인지, 두 터미널의 ROS 환경과 도메인이 같은지 확인하세요. 이어서 ROS 문제 해결, 웹 작업공간에서 제어, 설치형 작업공간에서 제어를 읽어 보세요.