python MAVLink interface and utilities
Python C C++ Swift Objective-C C# Other
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
APM_Mavtest pymavlink: move maintainence to submodule Sep 3, 2016
dialects add more files to ignore Jan 19, 2018
examples Add index table to the examples folder Apr 8, 2018
files/archlinux pymavlink: move maintainence to submodule Sep 3, 2016
generator Correct kibibyte and mebibyte units Aug 2, 2018
mavnative mavnative: fix compiler warning on missing case Jul 26, 2018
tests Added tests for rotmat.py Jul 14, 2018
tools mavlogdump: default to mavlink2 Aug 1, 2018
.gitignore ignore some generated files Mar 31, 2017
.gitmodules removing jspack submodule, the version we require is available throug… Jun 24, 2015
.travis.yml added test_generator.sh to travis Jul 27, 2018
COPYING update copying file per community / developer discussion May 16, 2016
DFReader.py DFReader: correct check for vehicle type Jun 4, 2018
README.md Update web link for documentation Mar 1, 2018
__init__.py Update web link for documentation Mar 1, 2018
fgFDM.py all: remove list(range()) Oct 10, 2016
mavexpression.py pymavlink: move maintainence to submodule Sep 3, 2016
mavextra.py added quaternion viewing functions Apr 15, 2017
mavparm.py mavparm: break out a show_param_value method Oct 18, 2016
mavutil.py mavutil: add support for autoreconnect on tcp: connections Jun 15, 2018
mavwp.py mavwp: added colour for inclusion/exclusion zones Aug 12, 2018
mission.proto pymavlink: move maintainence to submodule Sep 3, 2016
mission2.pb pymavlink: move maintainence to submodule Sep 3, 2016
pytest.ini Re-organised tests into the ./tests folder and now using pytest for t… Jul 14, 2018
quaternion.py All: remove str import as it is not need Oct 10, 2016
requirements.txt Generator: remove genxml & minixsv in favor of standart lxml Oct 6, 2016
rotmat.py Added tests for rotmat.py Jul 14, 2018
setup.py release 2.2.10 Jun 20, 2018
test_generator.sh added test_generator.sh to travis Jul 27, 2018

README.md

Build Status

Pymavlink

This is a python implementation of the MAVLink protocol.

Documentation

Please see http://ardupilot.org/dev/docs/mavlink-commands.html for documentation.

For realtime discussion please see the pymavlink gitter channel here https://gitter.im/ArduPilot/pymavlink

Installation

Recommendation

Pymavlink is currently a Python 2 package. It is recommended to install and use it with Python 2.

However an initial Python 3 support is given. The following instructions assume you are using Python 2 and a Debian-based (like Ubuntu) installation.

Dependencies

Pymavlink requires 3 dependencies :

- future : for python 2 and python 3 interoperability (http://python-future.org/)
- lxml : for checking and parsing xml file (http://lxml.de/installation.html)
- python-dev : for mavnative

On linux

lxml has some additional dependencies that can be installed with your package manager (here with apt-get) :

sudo apt-get install libxml2-dev libxslt-dev python-dev

Using pip you can install the required dependencies for pymavlink :

sudo pip2 install -U future lxml

The -U parameter allows updating future and lxml version if it is already installed.

On Windows

Use pip to install future as for linux. Lxml can be installed with a windows installer from here : https://pypi.python.org/pypi/lxml/3.6.0

Installation

For users

It is recommended to install pymavlink from PyPi with pip, that way dependencies should be auto install by pip.

sudo pip2 install -U pymavlink

The -U parameter allow to update pymavlink version if it is already installed.

For developers

On the pymavlink directory, you can use :

sudo MDEF=PATH_TO_message_definitions pip2 install . -v

The -v parameter will output the installation commands on the terminal. The MDEF usage is require as pip install is done from /tmp directory, so it is necessary to use MDEF variable to point on the message_definitions directory. Use pip should auto install dependencies and allow to keep them up-to-date with pip.

Or

sudo python2 setup.py install

Advance usage

Please see Pip documentation : https://pip.pypa.io/en/stable/

License


pymavlink is released under the GNU Lesser General Public License v3 or later.

Join the chat at https://gitter.im/ArduPilot/pymavlink