# PX4 자율 비행 프로그램 안내서 (master)

배포 (opens new window) 토론 (opens new window) 슬랙 (opens new window)

PX4는 전문적인 자율비행 프로그램 입니다. 세계적인 수준의 개발자들이 산업계와 학계에서 참여하여 개발하였으며, 여러 나라에서 활동중인 단체의 지원을 받을 수 있습니다. 레이싱 드론, 운송용 드론, 자동차와 선박 등 다양한 운송체에 적용할 수 있습니다.

TIP

이 안내서는 PX4를 이용한 기체 조립, 설정 및 비행 방법 등을 설명합니다. 기여를 하시려면, 개발편을 참고하여 주십시오.

# 시작하기

시작편을 먼저 읽으실 것을 추천합니다. 비행 스택(비행 모드 및 안전 기능)과 지원 하드웨어(비행 제어장치, 기체, 기체 프레임, 텔레메트리 시스템, 원격 조종 제어 시스템)와 더불어 PX4의 전반적인 내용을 알려드립니다.

이 안내서를 보실 때 도움이 되는 팁들은 다음과 같습니다.

가지고 있는 드론을 날리고 싶을 경우

PX4를 지원하는 기체가 준비되어 있는 경우:

  • 기본 설정편에서는 펌웨어를 최신 버전으로 업데이트하고, 기본 센서(나침반, 자이로/IMU, 대기 속도 등)를 캘리브레이션하고 원격 제어 및 안전 기능을 설정하는 방법에 대해 설명합니다.
  • 비행편은 안전하게 비행할 수 있는 방법과 장소, 그리고 시동 방법 및 비행 관련 문제 해결 방법 등에 대하여 설명합니다. 또한 비행 모드에 대한 자세한 정보를 제공합니다.

처음부터 PX4로 무인 항공기를 만드는 경우

TIP

"지원" 기체의 목록은 기체 프레임 정의서에 기술되어 있습니다. 이 목록의 기체들은 QGroundControl에서 시험을 마쳤으며 각 기체에 적합하게 튜닝되어 있습니다.

처음부터 기체를 제작하려면

  • 기체 선택하기 - 기체 제작에서는 지원 기체 목록이 있으며, 기체 조립법을 자세하게 설명합니다.
  • 비행 컨트롤러 선택 - 시작하기 > 비행 컨트롤러자동 항법 장치 하드웨어를 살펴보십시오.
  • 조립은 중요한 주변 장치를 자동 항법 장치에 연결하는 방법을 설명합니다.
  • 기초 설정은 펌웨어 업데이트 방법과 기체에 적합한 펌웨어 설정법을 설명합니다. 주요 센서(나침반, 자이로/IMU, 항속센서 등)를 보정법과 원격 조종법 및 안전 기능 설정 방법을 설명합니다.

기체를 날릴 준비가 되었다면 비행편으로 넘어가십시오.

페이로드 또는 카메라를 추가하는 경우

페이로드 섹션에서는 카메라를 추가하는 방법 또는 패키지를 제공 할 수 있도록 PX4를 설정하는 방법을 설명합니다.

  • 페이로드에서는 페이로드를 통합하는 방법을 설명합니다.

기체를 변경하는 경우

비행 컨트롤러 및 기본 센서 수정은 위 항목에서 다룹니다. 새로운 센서를 추가하거나 중요한 비행 설정을 변경하는 경우

  • 주변 장치에서는 외부 센서 사용에 대한 추가 정보를 제공합니다.
  • 기본 설정에서는 주요 센서를 보정법을 설명합니다.
  • 고급 설정에서는 기체의 재설정 및 튜닝 방법을 설명합니다.

새 하드웨어에서 PX4를 실행하고 플랫폼을 확장하는 경우

  • 개발에서는 신규 기체 사용 방법, 비행 알고리즘 수정, 신규 모드 추가, 신규 하드웨어 통합 및 비행 컨트롤러 외부에서 PX4와 통신하는 방법을 설명합니다.

# 도움 받기

지원 페이지는 코어 개발 팀과 더 넓은 커뮤니티로부터 도움을 받는법에 대해 설명합니다.

다음과 같은 내용을 다루고 있습니다.

# 버그 및 문제점 보고

PX4 사용에 문제를 겪었다면, 먼저 지원 포럼에 내용을 올려주십시오.

개발팀의 지침에 따라, Github (opens new window)에 코드 이슈를 제기할 수 있습니다. 가능한 경우 문제 양식(Issue template)에 비행 기록과 기타 정보를 제공해 주십시오.

# 기여

코드와 문서에 기여하는 방법은 기여편을 참고하십시오.

# 번역

이 안내서에는 다양한 번역본이 있습니다. (우측 상단의) 언어 메뉴에서 원하시는 번역본을 선택할 수 있습니다:

언어 선택

# 라이센스

PX4 코드는 BSD 3-clause 라이센스 (opens new window)에 따라 자유롭게 사용하고 수정할 수 있습니다. 이 문서는 CC BY 4.0 (opens new window) 라이센스를 준수합니다. 자세한 정보는 라이센스를 참고하십시오.

# 주요 행사 및 일정

드론 코드 달력에서는 플랫폼 개발자와 사용자를 위한 중요한 일정이 표시되어 있습니다. 사용자의 시간대와 맞는 달력을 보려면 아래 링크를 선택하십시오. 사용자의 달력에 추가할 수도 있습니다.

TIP

달력의 기본 시간대는 유럽중앙시간대(CET)입니다. :::

# 아이콘

이 라이브러리에서 사용하는 다음 아이콘은 별도의 라이센스를 적용합니다 (아래 그림 참조).

www.flaticon.com (opens new window) 사이트의 Smashicons가 만든 placeholder 아이콘은 크리에이티브 커먼즈 저작자 표시 3.0 라이센스를 따릅니다.

www.flaticon.com (opens new window) 사이트의 Freepik이 만든 camera-automatic-mode 아이콘은 크리에이티브 커먼즈 저작자 표시 3.0 라이센스를 따릅니다.

# 운영 방법

PX4는 Dronecode 프로젝트 (opens new window) 주관으로 운영되고 관리합니다.

Dronecode 로고 리눅스 재단 로고