MAVSDK

Beschreibung

MAVSDK ist eine Reihe von Bibliotheken, die eine High-Level-API für MAVLink bereitstellen. Ziel ist es:

• Einfach zu verwenden mit einer einfachen API, die sowohl synchrone (blockierende) API-Aufrufe als auch asynchrone API-Aufrufe mithilfe von Rückrufen unterstützt.
• Schnell und leicht.
• Plattformübergreifend (Linux, macOS, Windows, iOS, Android).
• Erweiterbar (mit dem MavlinkPassthrough-Plugin).
• Vollständig kompatibel mit dem MAVLink-Standard/-Definitionen.

Um mehrere Programmiersprachen zu unterstützen, implementiert MAVSDK einen gRPC-Server in C++, der es Clients in verschiedenen Programmiersprachen ermöglicht, eine Verbindung herzustellen. Die API wird durch die Proto-IDL (Protodateien) definiert. Diese Architektur ermöglicht die Implementierung der Clients in idiomatischen Mustern, also unter Verwendung der von Endbenutzern erwarteten Tools und Syntax. Beispielsweise kann die Python-Bibliothek mit pip von PyPi aus installiert werden.

Der MAVSDK C++-Teil besteht aus:

• Die Kernbibliothek, die die grundlegende MAVLink-Kommunikation implementiert.
• Die Plugin-Bibliotheken, die die für eine Funktion spezifische MAVLink-Kommunikation implementieren.
• Der mavsdk_server implementiert den gRPC-Server für die Sprachclients.

Repos

• MAVSDK – dieses Repo, das den Quellcode für den C++-Kern enthält.
• MAVSDK-Proto – Gemeinsame Schnittstellendefinitionen für die API, die als Protodateien angegeben werden, die von gRPC zwischen Sprachclients und mavsdk_server verwendet werden.
• MAVSDK-Python – MAVSDK-Client für Python (erstmals veröffentlicht auf Pypi 2019).
• MAVSDK-Swift – MAVSDK-Client für Swift (in der Produktion verwendet, erstmals 2018 veröffentlicht).
• MAVSDK-Java – MAVSDK-Client für Java (erstmals 2019 auf MavenCentral veröffentlicht).
• MAVSDK-JavaScript – MAVSDK-Client in JavaScript (Proof of Concept, 2019).
• MAVSDK-Rust – MAVSDK-Client für Rust (Proof of Concept, 2019).
• MAVSDK-CSharp – MAVSDK-Client für CSharp (Proof of Concept, 2019).
• Dokumente – MAVSDK-Dokumentenquelle.

Dokumente

Anweisungen zur Verwendung der C++-Bibliothek finden Sie in den MAVSDK-Dokumenten (Links zu anderen Programmiersprachen finden Sie in der Seitenleiste der Dokumentation).

Quicklinks:

• Erste Schritte
• C++-API-Übersicht
• API-Referenz
• Installieren der Bibliothek
• Aufbau der Bibliothek
• Beispiele
• FAQ

Lizenz

Dieses Projekt ist unter der zulässigen BSD-3-Klausel lizenziert, siehe LICENSE.md.

Wartung

Dieses Projekt wird von Freiwilligen betreut:

• Julian Oes (Sponsoring, Beratung).
• Jonas Vautherin

Die Wartung wird von keinem Unternehmen gesponsert, das Hosting der Dokumente und des Forums wird jedoch von der Dronecode Foundation bereitgestellt.

Support und Probleme

Wenn Sie nur eine Frage haben, sollten Sie diese im Forum stellen.

Wenn Sie auf ein Problem gestoßen sind, einen Fehler entdeckt haben oder eine Funktion anfordern möchten, erstellen Sie ein Problem. Wenn es für Sie wichtig oder dringend ist, sollten Sie darüber nachdenken, einen der Betreuer zu sponsern, um das Problem auf seiner Todo-Liste nach oben zu verschieben.

Wenn Sie private Unterstützung benötigen, ziehen Sie eine kostenpflichtige Beratung in Betracht:

• Julian Oes Beratung

(Erstellen Sie eine Pull-Anfrage, wenn Sie hier aufgeführt werden möchten.)