DroneKit Python DroneKit Python
DroneKit-Python helps you create powerful apps for UAVs. O DroneKit-Python ajuda você a criar aplicativos poderosos para os UAVs.
Overview visão global
DroneKit-Python (formerly DroneAPI-Python) contains the python language implementation of DroneKit. O DroneKit-Python (antigo DroneAPI-Python) contém a implementação em linguagem python do DroneKit.
The API allows developers to create Python apps that communicate with vehicles over MAVLink. A API permite que os desenvolvedores criem aplicativos em Python que se comunicam com veículos por meio do MAVLink. It provides programmatic access to a connected vehicle's telemetry, state and parameter information, and enables both mission management and direct control over vehicle movement and operations. Ele fornece acesso programático à telemetria de um veículo conectado, informações de estado e parâmetros, e permite o gerenciamento da missão e o controle direto sobre o movimento e as operações do veículo.
The API is primarily intended for use in onboard companion computers (to support advanced use cases including computer vision, path planning, 3D modelling etc). A API é destinada principalmente para uso em computadores complementares integrados (para suportar casos de uso avançados, incluindo visão computacional, planejamento de caminho, modelagem 3D, etc.). It can also be used for ground station apps, communicating with vehicles over a higher latency RF-link. Ele também pode ser usado para aplicativos de estações terrestres, comunicando-se com veículos por meio de um link RF de maior latência.
Getting Started Começando
The Quick Start guide explains how to set up DroneKit on each of the supported platforms (Linux, Mac OSX, Windows) and how to write a script to connect to a vehicle (real or simulated). O Guia de Início Rápido explica como configurar o DroneKit em cada uma das plataformas suportadas (Linux, Mac OSX, Windows) e como escrever um script para se conectar a um veículo (real ou simulado).
A basic script looks like this: Um script básico é assim:
from dronekit import connect de dronekit import connect
# Connect to UDP endpoint. # Conecte-se ao terminal UDP.
vehicle = connect( ' 127.0.0.1:14550 ' , wait_ready = True ) vehicle = connect ( ' 127.0.0.1:14550 ' , wait_ready = True )
# Use returned Vehicle object to query device state - eg to get the mode: # Use o objeto Vehicle retornado para consultar o estado do dispositivo - por exemplo, para obter o modo:
print ( " Mode: %s " % vehicle.mode.name) print ( " Modo: % s " % vehicle.mode.name) Once you've got DroneKit set up, the guide explains how to perform operations like taking off and flying the vehicle. Depois de configurar o DroneKit, o guia explica como executar operações como decolar e voar no veículo. You can also try out most of the tasks by running the examples . Você também pode experimentar a maioria das tarefas executando os exemplos .
Resources Recursos
The project documentation is available at python.dronekit.io . A documentação do projeto está disponível em python.dronekit.io . This includes guide , example and API Reference material. Isso inclui guia , exemplo e material de referência da API .
The example source code is hosted here on Github as sub-folders of /dronekit-python/examples . O código-fonte do exemplo está hospedado aqui no Github como subpastas de / dronekit-python / examples .
The DroneKit Forums are the best place to ask for technical support on how to use the library. Os Fóruns do DroneKit são o melhor lugar para pedir suporte técnico sobre como usar a biblioteca. You can also check out our Gitter channel though we prefer posts on the forums where possible. Você também pode conferir nosso canal Gitter, embora prefiramos postagens nos fóruns sempre que possível.
- Documentation: http://python.dronekit.io/ Documentação: http://python.dronekit.io/
- Guides: http://python.dronekit.io/guide/index.html Guias: http://python.dronekit.io/guide/index.html
- API Reference: http://python.dronekit.io/automodule.html Referência da API: http://python.dronekit.io/automodule.html
- Examples: /dronekit-python/examples Exemplos: / dronekit-python / examples
- Forums: http://discuss.dronekit.io/ Fóruns: http://discuss.dronekit.io/
- Gitter: https://gitter.im/dronekit/dronekit-python though we prefer posts on the forums where possible. Gitter: https://gitter.im/dronekit/dronekit-python, embora prefiramos postagens nos fóruns sempre que possível.
Users and contributors wanted! Usuários e colaboradores queriam!
We'd love your feedback and suggestions about this API and are eager to evolve it to meet your needs, please feel free to create an issue to report bugs or feature requests. Adoraríamos seus comentários e sugestões sobre essa API e estamos ansiosos para evoluí-la para atender às suas necessidades. Sinta-se à vontade para criar um problema para denunciar bugs ou solicitações de recursos.
If you've created some awesome software that uses this project, let us know on the forums here ! Se você criou algum software incrível que usa este projeto, nos avise nos fóruns aqui !
If you want to contribute, see our Contributing guidelines, we welcome all types of contributions but mostly contributions that would help us shrink our issues list . Se você quiser contribuir, consulte nossas diretrizes de Contribuições. Damos boas-vindas a todos os tipos de contribuições, mas principalmente às contribuições que nos ajudariam a reduzir nossa lista de problemas .
Licence Licença
DroneKit-Python is made available under the permissive open source Apache 2.0 License . O DroneKit-Python é disponibilizado sob a licença Permissive open source Apache 2.0 .
Copyright 2015 3D Robotics, Inc. Copyright 2015 3D Robotics, Inc.
