QGroundControl(QGC) 개발자 가이드

- for masOS (9/9)

Part 9. Maintenance & Advanced Topics (유지보수 및 고급 주제)

이 파트에서는 macOS 환경에서 QGroundControl(QGC)의 유지보수 및 고급 기능 활용법을 설명합니다. 로그 관리, RTK, 멀티드론, Companion Computer 연동 외에도 브랜칭 전략과 CI/CD 자동화를 반영했습니다.

---

1) 로그 관리 및 분석

기본 저장 경로: ~/Library/Application Support/QGroundControl/Logs

로그 형식: .tlog, .ulg, .BIN

분석 도구: QGC Analyze View, PX4 Flight Review, MAVExplorer

macOS는 Python + Brew 환경에서 로그 분석 스크립트 실행이 용이합니다

2) RTK 및 고정밀 GPS 설정

Image source: QGroundControl Documentation (CC BY 4.0, https://creativecommons.org/licenses/by/4.0/)

NTRIP 클라이언트를 통한 네트워크 RTK 지원

USB RTK 장치는 `/dev/tty.usbserial*`로 인식

macOS 보안 권한에서 장치 접근 허용 필요

3) 영상 스트리밍 (RTSP/UDP)

Image source: QGroundControl Documentation (CC BY 4.0, https://creativecommons.org/licenses/by/4.0/)

GStreamer 설치 후 영상 스트리밍 가능:
```bash
brew install gstreamer
```

Retina Display 환경에서 GPU 가속 지원

4) Companion Computer 연동

Jetson, Raspberry Pi와 연동해 AI 기능 수행

MAVLink Router를 통해 QGC와 TCP/UDP 연결

macOS Wi-Fi/Ethernet 네트워크로 원격 Companion 제어

5) 멀티드론 운영

MultiVehicleManager로 Vehicle 객체 관리

SITL 다중 인스턴스로 테스트 가능

각 드론은 별도 Vehicle로 인식되어 Fly View 전환 가능

6) 릴리스 및 브랜칭 전략

Stable Release, Daily Build, Out-Of-Band Release 전략 지원

GitHub Actions/Jenkins로 dmg 자동 빌드

notarization 및 코드 서명 필요

7) 유지보수 전략 (CI/CD)

Unit Test + SITL 테스트 자동화

로그 자동 백업 Automator 스크립트

MAVLink 버전 관리 및 GPU 드라이버 업데이트

macOS CI/CD에서 notarization 필수

8) macOS 환경 특화 팁

Retina Display에서 UI 최적화

앱 실행 차단 시 보안 및 개인정보 보호에서 허용 필요

dmg 배포 시 Apple Developer ID 코드 서명 필요