Python으로 ArduPilot 제어
개인 Autopilot 작업공간의 WAM-V 또는 BlueROV2 한 대를 Python으로 제어합니다. ArduPilot은 선택한 모드와 구동기 믹싱을 담당하고, 콜백은 수동 입력을 제공합니다. 다중차량 월드가 없어도 사용할 수 있습니다.
실행 환경 준비
WWW-POSIM 0.6.16 이상과 SDK 0.4.3을 사용합니다. 개인 월드를 Autopilot 모드로 시작하고 항법·시동 전 준비가 완료될 때까지 기다리세요. 임무와 수동 제어를 끝내고 QGC 연결을 해제합니다. 설치형 앱과 작업공간을 열어 두세요. ROS 터미널과 연결에서 준비한 Python 터미널을 열고 해당 환경에 SDK를 설치합니다:
python -m pip install --upgrade https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl
WAM-V에 짧은 입력 보내기
차량 주변 수역이 비어 있는지 확인하세요. 다음 코드를 ardupilot_manual.py로 저장하고 같은 터미널에서 python ardupilot_manual.py로 실행합니다. MANUAL 모드로 전환하고 시동한 뒤 2초간 작은 전진 입력을 보내며, 정리 단계에서 시동 해제를 요청합니다:
from www_posim_ros import ArduPilotSession
with ArduPilotSession.local(control=True) as sim:
sim.set_mode("MANUAL")
try:
sim.arm(True)
sim.control_manual(
lambda elapsed: {"x": 0.2, "r": 0.0},
duration=2.0,
gain=0.25,
)
finally:
sim.arm(False)
입력과 제어권
콜백은 실행 후 경과한 실제 시간을 초 단위로 받고 딕셔너리를 반환합니다. x, y, z, r 축은 −1~1 범위이며 생략한 축은 0입니다. WAM-V는 x, r, BlueROV2는 네 축을 사용합니다. 이는 정규화된 입력이며 m/s나 N 단위가 아닙니다. 실행 시간은 0초 초과, 최대 30초입니다. gain은 0.1~0.35이며 처음에는 0.25를 사용하세요.
헬퍼는 중립 입력으로 제어권을 얻고 최대 10 Hz로 갱신합니다. 완료·중단·콜백 오류 시 중립 입력을 보내고 제어권을 반환합니다. 유효한 갱신이 0.6초 동안 없으면 차량 watchdog이 수동 입력을 멈춥니다. sim.stop()과 세션 종료는 입력을 해제하지만 시동 해제나 모드 변경은 하지 않습니다. 예제는 시동 해제를 별도로 요청합니다. 중립 입력도 관성이나 파도의 힘을 없애지는 않습니다.
모드·시동 요청은 비행제어기의 확인을 기다립니다. WAM-V는 MANUAL·HOLD·STEERING, BlueROV2는 MANUAL·STABILIZE·ALT_HOLD를 지원합니다. 다른 수동 제어기·임무·QGC가 있으면 요청이 거절될 수 있습니다. 월드가 바뀌거나 제어권이 만료되면 자동으로 다시 확보하지 않고 종료합니다. 정리 요청이 거절되면 작업공간에서 현재 제어 주체와 차량 상태를 확인한 뒤 다시 시도하세요.
웹 작업공간과 ROS 텔레메트리
본인 웹 작업공간에 연결하려면 with 문을 아래와 같이 바꾸세요. 계정 비밀번호는 터미널 프롬프트에서 입력하고 소스 코드에 넣지 마세요:
with ArduPilotSession.remote(email="YOU@example.com", control=True) as sim:
두 연결 방식 모두 sim.topics와 sim.latest(topic)으로 최신 ROS 메시지 딕셔너리를 읽습니다. 텔레메트리를 읽는 것만으로 ROS 명령 권한이 생기지는 않습니다. 설치형 작업공간에서 제어는 ROS 2 모드에서 사용하고, 이 챕터의 요청은 ArduPilot을 거칩니다. QGC로 제어 전에는 Python 제어기를 종료하세요.