Build Status

Pymavlink

This is a Python implementation of the MAVLink protocol. It includes a source code generator (generator/mavgen.py) to create MAVLink protocol implementations for other programming languages as well. Also contains tools for analyzing flight logs.

Documentation

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

For realtime discussion please see the pymavlink Gitter channel

Examples can be found in the repository or in the ArduSub book

Installation

Pymavlink supports Python 3. Python 2 support has been removed.

The following instructions assume you are using a Debian-based (like Ubuntu) installation.

Dependencies

Pymavlink has several dependencies :

- [future](http://python-future.org/) : for interoperability
- [lxml](http://lxml.de/installation.html) : for checking and parsing xml file

Optional :

- numpy : for FFT
- pytest : for tests

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

Optional for FFT scripts and tests:

sudo apt-get install python3-numpy python3-pytest

Using pip you can install the required dependencies for leaf-pymavlink :

sudo python3 -m pip install --upgrade future lxml

On Windows

Use pip to install future as for Linux. Lxml can be installed with a Windows installer from here : https://pypi.org/project/lxml

Installation

For users

It is recommended to install leaf-pymavlink from PyPI with pip, that way dependencies should be auto installed by pip.

sudo python3 -m pip install --upgrade leaf-pymavlink

Mavnative

Starting from September 2022, mavnative, a C extension for parsing mavlink, was deprecated and removed. Mavnative development was stalled for long time, it only supports MAVLink1 and doesn't get any fix on the protocol.

For developers

From the pymavlink directory, you can use :

sudo MDEF=PATH_TO_message_definitions python3 -m pip install . -v

[!NOTE] PATH_TO_message_definitions should point to the directory containing the message definition files. Typically, this is the message_definitions folder in the mavlink repository. e.g. /home/droneleaf/petal-app-manager-dev/mavlink/message_definitions/v1.0

Since pip installation is executed from /tmp, it is necessary to point to the directory containing message definitions with MDEF. MDEF should not be set to any particular message version directory but the parent folder instead. If you have cloned from mavlink/mavlink then this is /mavlink/message_definitions . Using pip should auto install dependencies and allow you to keep them up-to-date.

Or:

sudo python3 setup.py install

Ardupilot Custom Modes

By default, leaf-pymavlink will map the Ardupilot mode names to mode numbers per the definitions in the ardupilotmega.xml file. However, during development, it can be useful to add to or update the default mode mappings.

To do this:

  • create a folder named .pymavlink in your home directory (i.e. $HOME on Linux, $USERPROFILE on Windows); and
  • add a JSON file called custom_mode_map.json to this new .pymavlink folder.

The JSON file is a dictionary that maps vehicle MAV_TYPE value to a dictionary of mode numbers to mode names. An example that duplicates the existing mapping for MAV_TYPE_FIXED_WING (enum value of 1) vehicles is as follows:

{
    "1": {
        "0":  "MANUAL",
        "1":  "CIRCLE",
        "2":  "STABILIZE",
        "3":  "TRAINING",
        "4":  "ACRO",
        "5":  "FBWA",
        "6":  "FBWB",
        "7":  "CRUISE",
        "8":  "AUTOTUNE",
        "10": "AUTO",
        "11": "RTL",
        "12": "LOITER",
        "13": "TAKEOFF",
        "14": "AVOID_ADSB",
        "15": "GUIDED",
        "16": "INITIALISING",
        "17": "QSTABILIZE",
        "18": "QHOVER",
        "19": "QLOITER",
        "20": "QLAND",
        "21": "QRTL",
        "22": "QAUTOTUNE",
        "23": "QACRO",
        "24": "THERMAL"
        "25": "LOITERALTQLAND",
        "26": "AUTOLAND",
    }
}

This custom_mode_map.json file can be used to:

  • change the display name of an existing mode (e.g. change "TAKEOFF" to "LAUNCH");
  • add a new mode (e.g. add "25": "NEW_MODE"); and
  • add a mapping for an unsupported vehicle type (e.g. add a mapping for MAV_TYPE_AIRSHIP (enum value of 7) vehicles).

Notes:

  • Whilst the MAV_TYPE and mode numbers are integers, they need to be defined as strings in the JSON file, as raw integers can't be used as dictionary keys in JSON.
  • This feature updates the default definitions. You can use it to change the name-to-number mapping for a mode, but you completely can't remove an existing mapping.

License

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

The source code generated by generator/mavgen.py is available under the permissive MIT License.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.26)

Owner

PyPI data
Data sourced directly from PyPI's database.

License

GNU Lesser General Public License v3 (LGPLv3) (LGPLv3)

Classifiers

Report project as malware

Release files for leaf-pymavlink 0.1.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for leaf-pymavlink 0.1.25
File Size Uploaded
leaf_pymavlink-0.1.25.tar.gz 8.2 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for leaf-pymavlink 0.1.25
File
leaf_pymavlink-0.1.25-cp313-cp313-win_amd64.whl 8.3 MB CPython 3.13 CPython 3.13 Windows x86-64 Details
leaf_pymavlink-0.1.25-cp313-cp313-win32.whl 8.3 MB CPython 3.13 CPython 3.13 Windows x86-32 Details
leaf_pymavlink-0.1.25-cp313-cp313-musllinux_1_2_x86_64.whl 8.6 MB CPython 3.13 CPython 3.13 Linux musl 1.2+ x86-64 Details
leaf_pymavlink-0.1.25-cp313-cp313-musllinux_1_2_i686.whl 8.6 MB CPython 3.13 CPython 3.13 Linux musl 1.2+ x86-32 Details
leaf_pymavlink-0.1.25-cp313-cp313-musllinux_1_2_aarch64.whl 8.6 MB CPython 3.13 CPython 3.13 Linux musl 1.2+ ARM64 Details
leaf_pymavlink-0.1.25-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 8.6 MB CPython 3.13 CPython 3.13 Linux glibc 2.17+ x86-64 Details
leaf_pymavlink-0.1.25-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 8.6 MB CPython 3.13 CPython 3.13 Linux glibc 2.17+ ARM64 Details
leaf_pymavlink-0.1.25-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl 8.6 MB CPython 3.13 CPython 3.13 Linux glibc 2.5+ x86-32, Linux glibc 2.17+ x86-32 Details
leaf_pymavlink-0.1.25-cp313-cp313-macosx_11_0_arm64.whl 8.3 MB CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details
leaf_pymavlink-0.1.25-cp313-cp313-macosx_10_13_x86_64.whl 8.3 MB CPython 3.13 CPython 3.13 macOS 10.13+ x86-64 Details
leaf_pymavlink-0.1.25-cp313-cp313-macosx_10_13_universal2.whl 8.3 MB CPython 3.13 CPython 3.13 macOS 10.13+ universal2 (ARM64, x86-64) Details
leaf_pymavlink-0.1.25-cp312-cp312-win_amd64.whl 8.3 MB CPython 3.12 CPython 3.12 Windows x86-64 Details
leaf_pymavlink-0.1.25-cp312-cp312-win32.whl 8.3 MB CPython 3.12 CPython 3.12 Windows x86-32 Details
leaf_pymavlink-0.1.25-cp312-cp312-musllinux_1_2_x86_64.whl 8.6 MB CPython 3.12 CPython 3.12 Linux musl 1.2+ x86-64 Details
leaf_pymavlink-0.1.25-cp312-cp312-musllinux_1_2_i686.whl 8.6 MB CPython 3.12 CPython 3.12 Linux musl 1.2+ x86-32 Details
leaf_pymavlink-0.1.25-cp312-cp312-musllinux_1_2_aarch64.whl 8.6 MB CPython 3.12 CPython 3.12 Linux musl 1.2+ ARM64 Details
leaf_pymavlink-0.1.25-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 8.6 MB CPython 3.12 CPython 3.12 Linux glibc 2.17+ x86-64 Details
leaf_pymavlink-0.1.25-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 8.6 MB CPython 3.12 CPython 3.12 Linux glibc 2.17+ ARM64 Details
leaf_pymavlink-0.1.25-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl 8.6 MB CPython 3.12 CPython 3.12 Linux glibc 2.17+ x86-32, Linux glibc 2.5+ x86-32 Details
leaf_pymavlink-0.1.25-cp312-cp312-macosx_11_0_arm64.whl 8.3 MB CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details
leaf_pymavlink-0.1.25-cp312-cp312-macosx_10_13_x86_64.whl 8.3 MB CPython 3.12 CPython 3.12 macOS 10.13+ x86-64 Details
leaf_pymavlink-0.1.25-cp312-cp312-macosx_10_13_universal2.whl 8.3 MB CPython 3.12 CPython 3.12 macOS 10.13+ universal2 (ARM64, x86-64) Details
leaf_pymavlink-0.1.25-cp311-cp311-win_amd64.whl 8.3 MB CPython 3.11 CPython 3.11 Windows x86-64 Details
leaf_pymavlink-0.1.25-cp311-cp311-win32.whl 8.3 MB CPython 3.11 CPython 3.11 Windows x86-32 Details
leaf_pymavlink-0.1.25-cp311-cp311-musllinux_1_2_x86_64.whl 8.6 MB CPython 3.11 CPython 3.11 Linux musl 1.2+ x86-64 Details
leaf_pymavlink-0.1.25-cp311-cp311-musllinux_1_2_i686.whl 8.6 MB CPython 3.11 CPython 3.11 Linux musl 1.2+ x86-32 Details
leaf_pymavlink-0.1.25-cp311-cp311-musllinux_1_2_aarch64.whl 8.6 MB CPython 3.11 CPython 3.11 Linux musl 1.2+ ARM64 Details
leaf_pymavlink-0.1.25-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 8.6 MB CPython 3.11 CPython 3.11 Linux glibc 2.17+ x86-64 Details
leaf_pymavlink-0.1.25-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 8.6 MB CPython 3.11 CPython 3.11 Linux glibc 2.17+ ARM64 Details
leaf_pymavlink-0.1.25-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl 8.6 MB CPython 3.11 CPython 3.11 Linux glibc 2.5+ x86-32, Linux glibc 2.17+ x86-32 Details
leaf_pymavlink-0.1.25-cp311-cp311-macosx_11_0_arm64.whl 8.3 MB CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details
leaf_pymavlink-0.1.25-cp311-cp311-macosx_10_9_x86_64.whl 8.3 MB CPython 3.11 CPython 3.11 macOS 10.9+ x86-64 Details
leaf_pymavlink-0.1.25-cp311-cp311-macosx_10_9_universal2.whl 8.3 MB CPython 3.11 CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64) Details
leaf_pymavlink-0.1.25-cp310-cp310-win_amd64.whl 8.3 MB CPython 3.10 CPython 3.10 Windows x86-64 Details
leaf_pymavlink-0.1.25-cp310-cp310-win32.whl 8.3 MB CPython 3.10 CPython 3.10 Windows x86-32 Details
leaf_pymavlink-0.1.25-cp310-cp310-musllinux_1_2_x86_64.whl 8.6 MB CPython 3.10 CPython 3.10 Linux musl 1.2+ x86-64 Details
leaf_pymavlink-0.1.25-cp310-cp310-musllinux_1_2_i686.whl 8.5 MB CPython 3.10 CPython 3.10 Linux musl 1.2+ x86-32 Details
leaf_pymavlink-0.1.25-cp310-cp310-musllinux_1_2_aarch64.whl 8.6 MB CPython 3.10 CPython 3.10 Linux musl 1.2+ ARM64 Details
leaf_pymavlink-0.1.25-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 8.6 MB CPython 3.10 CPython 3.10 Linux glibc 2.17+ x86-64 Details
leaf_pymavlink-0.1.25-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 8.6 MB CPython 3.10 CPython 3.10 Linux glibc 2.17+ ARM64 Details
leaf_pymavlink-0.1.25-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl 8.5 MB CPython 3.10 CPython 3.10 Linux glibc 2.17+ x86-32, Linux glibc 2.5+ x86-32 Details
leaf_pymavlink-0.1.25-cp310-cp310-macosx_11_0_arm64.whl 8.3 MB CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details
leaf_pymavlink-0.1.25-cp310-cp310-macosx_10_9_x86_64.whl 8.3 MB CPython 3.10 CPython 3.10 macOS 10.9+ x86-64 Details
leaf_pymavlink-0.1.25-cp310-cp310-macosx_10_9_universal2.whl 8.3 MB CPython 3.10 CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64) Details
leaf_pymavlink-0.1.25-cp39-cp39-win_amd64.whl 8.3 MB CPython 3.9 CPython 3.9 Windows x86-64 Details
leaf_pymavlink-0.1.25-cp39-cp39-win32.whl 8.3 MB CPython 3.9 CPython 3.9 Windows x86-32 Details
leaf_pymavlink-0.1.25-cp39-cp39-musllinux_1_2_x86_64.whl 8.6 MB CPython 3.9 CPython 3.9 Linux musl 1.2+ x86-64 Details
leaf_pymavlink-0.1.25-cp39-cp39-musllinux_1_2_i686.whl 8.5 MB CPython 3.9 CPython 3.9 Linux musl 1.2+ x86-32 Details
leaf_pymavlink-0.1.25-cp39-cp39-musllinux_1_2_aarch64.whl 8.6 MB CPython 3.9 CPython 3.9 Linux musl 1.2+ ARM64 Details
leaf_pymavlink-0.1.25-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 8.6 MB CPython 3.9 CPython 3.9 Linux glibc 2.17+ x86-64 Details
leaf_pymavlink-0.1.25-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 8.6 MB CPython 3.9 CPython 3.9 Linux glibc 2.17+ ARM64 Details
leaf_pymavlink-0.1.25-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl 8.5 MB CPython 3.9 CPython 3.9 Linux glibc 2.17+ x86-32, Linux glibc 2.5+ x86-32 Details
leaf_pymavlink-0.1.25-cp39-cp39-macosx_11_0_arm64.whl 8.3 MB CPython 3.9 CPython 3.9 macOS 11.0+ ARM64 Details
leaf_pymavlink-0.1.25-cp39-cp39-macosx_10_9_x86_64.whl 8.3 MB CPython 3.9 CPython 3.9 macOS 10.9+ x86-64 Details
leaf_pymavlink-0.1.25-cp39-cp39-macosx_10_9_universal2.whl 8.3 MB CPython 3.9 CPython 3.9 macOS 10.9+ universal2 (ARM64, x86-64) Details
leaf_pymavlink-0.1.25-cp38-cp38-win_amd64.whl 8.3 MB CPython 3.8 CPython 3.8 Windows x86-64 Details
leaf_pymavlink-0.1.25-cp38-cp38-win32.whl 8.3 MB CPython 3.8 CPython 3.8 Windows x86-32 Details
leaf_pymavlink-0.1.25-cp38-cp38-musllinux_1_2_x86_64.whl 8.5 MB CPython 3.8 CPython 3.8 Linux musl 1.2+ x86-64 Details
leaf_pymavlink-0.1.25-cp38-cp38-musllinux_1_2_i686.whl 8.5 MB CPython 3.8 CPython 3.8 Linux musl 1.2+ x86-32 Details
leaf_pymavlink-0.1.25-cp38-cp38-musllinux_1_2_aarch64.whl 8.5 MB CPython 3.8 CPython 3.8 Linux musl 1.2+ ARM64 Details
leaf_pymavlink-0.1.25-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 8.5 MB CPython 3.8 CPython 3.8 Linux glibc 2.17+ x86-64 Details
leaf_pymavlink-0.1.25-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 8.5 MB CPython 3.8 CPython 3.8 Linux glibc 2.17+ ARM64 Details
leaf_pymavlink-0.1.25-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl 8.5 MB CPython 3.8 CPython 3.8 Linux glibc 2.17+ x86-32, Linux glibc 2.5+ x86-32 Details
leaf_pymavlink-0.1.25-cp38-cp38-macosx_11_0_arm64.whl 8.3 MB CPython 3.8 CPython 3.8 macOS 11.0+ ARM64 Details
leaf_pymavlink-0.1.25-cp38-cp38-macosx_10_9_x86_64.whl 8.2 MB CPython 3.8 CPython 3.8 macOS 10.9+ x86-64 Details
leaf_pymavlink-0.1.25-cp38-cp38-macosx_10_9_universal2.whl 8.3 MB CPython 3.8 CPython 3.8 macOS 10.9+ universal2 (ARM64, x86-64) Details

Total release size: 564.6 MB

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page