MAVSDK

Description

MAVSDK est un ensemble de bibliothèques fournissant une API de haut niveau à MAVLink. Il vise à être :

• Facile à utiliser avec une API simple prenant en charge à la fois les appels d'API synchrones (bloquants) et les appels d'API asynchrones à l'aide de rappels.
• Rapide et léger.
• Multiplateforme (Linux, macOS, Windows, iOS, Android).
• Extensible (à l'aide du plugin MavlinkPassthrough).
• Entièrement conforme à la norme/définitions MAVLink.

Afin de prendre en charge plusieurs langages de programmation, MAVSDK implémente un serveur gRPC en C++ qui permet aux clients de différents langages de programmation de se connecter. L'API est définie par le proto IDL (fichiers proto). Cette architecture permet aux clients d'être implémentés selon des modèles idiomatiques, utilisant ainsi les outils et la syntaxe attendus par les utilisateurs finaux. Par exemple, la bibliothèque Python peut être installée depuis PyPi en utilisant pip .

La partie MAVSDK C++ se compose de :

• La bibliothèque principale implémentant la communication de base MAVLink.
• Les bibliothèques de plugins implémentant la communication MAVLink spécifique à une fonctionnalité.
• Le mavsdk_server implémentant le serveur gRPC pour les clients de langue.

Repos

• MAVSDK - ce dépôt contenant le code source du noyau C++.
• MAVSDK-Proto - Définitions d'interface communes pour l'API spécifiées sous forme de fichiers proto utilisés par gRPC entre les clients de langage et mavsdk_server.
• MAVSDK-Python - Client MAVSDK pour Python (publié pour la première fois sur Pypi 2019).
• MAVSDK-Swift - Client MAVSDK pour Swift (utilisé en production, première sortie en 2018).
• MAVSDK-Java - Client MAVSDK pour Java (publié pour la première fois sur MavenCentral en 2019).
• MAVSDK-JavaScript - Client MAVSDK en JavaScript (preuve de concept, 2019).
• MAVSDK-Rust - Client MAVSDK pour Rust (preuve de concept, 2019).
• MAVSDK-CSharp - Client MAVSDK pour CSharp (preuve de concept, 2019).
• Documents - Source de la documentation MAVSDK.

Documents

Des instructions sur l'utilisation de la bibliothèque C++ peuvent être trouvées dans la documentation MAVSDK (des liens vers d'autres langages de programmation peuvent être trouvés dans la barre latérale de la documentation).

Liens rapides :

• Commencer
• Présentation de l'API C++
• Référence API
• Installation de la bibliothèque
• Construire la bibliothèque
• Exemples
• FAQ

Licence

Ce projet est sous licence BSD 3-clause permissive, voir LICENSE.md.

Entretien

Ce projet est maintenu par des bénévoles :

• Julian Oes (sponsoring, conseil).
• Jonas Vautherin

La maintenance n'est sponsorisée par aucune société, cependant l'hébergement des docs et du forum est assuré par la Fondation Dronecode.

Assistance et problèmes

Si vous avez juste une question, pensez à la poser sur le forum.

Si vous avez rencontré un problème, découvert un bug ou souhaitez demander une fonctionnalité, créez un problème. Si cela est important ou urgent pour vous, envisagez de parrainer l'un des responsables pour faire remonter le problème sur sa liste de tâches.

Si vous avez besoin d'un accompagnement privé, pensez au conseil payant :

• Julian Oes conseil

(Créez une pull request si vous souhaitez être répertorié ici.)