Skip to main content

A lifeline for ArduPilot craft.

Project description

Parachute

Parachute is a swiss army knife for ArduPilot settings. It helps you quickly and easily back up all your parameters to a file (and restore them). It also lets you get/set them, filter them, diff them, restore them or convert them to parameter files compatible with Mission Planner/QGroundControl.

Installation

Installing Parachute is simple. You can use pipx (recommended):

$ pipx install parachute

Or pip (less recommended):

$ pip install parachute

You can also download pre-built binaries for Windows and Linux from the artifacts page.

Usage

Parachute is called like so:

$ parachute backup <craft name>

For example:

$ parachute backup Mini-Drak

To restore:

$ parachute restore backup.chute

Conversion

You can also convert a Parachute file to a file compatible with Mission Planner or QGroundControl:

$ parachute convert qgc Mini-Drak_2021-03-02_02-29.chute Mini-Drak.params

Filtering

You can filter parameters based on a regular expression:

$ parachute filter "serial[123]_" Mini-Drak_2021-03-02_02-29.chute filtered.chute

Since all parameter names are uppercase, the regex is case-insensitive, for convenience.

You can also filter when converting:

$ parachute convert --filter=yaw mp Mini-Drak_2021-03-02_02-29.chute -

Comparing

You can compare parameters in a backup with parameters on the craft:

$ parachute compare backup.chute

Getting/setting

You can get and set parameters:

$ parachute get BATT_AMP_OFFSET BATT_AMP_PERVLT
$ parachute set BATT_AMP_OFFSET=-0.0135 BATT_AMP_PERVLT=63.8826

You can get and set a single bit like so:

$ parachute get --binary FLIGHT_OPTIONS
$ parachute set FLIGHT_OPTIONS:5=1

Shell completions

Parachute includes shell completion for AP parameters for various shells. After you've enabled completions, you can get parameter completion for the get and set commands. For example, try typing parachute get acr<TAB>.

The way to enable it depends on your shell:

fish

Save the completion script to ~/.config/fish/completions/parachute.fish:

_PARACHUTE_COMPLETE=fish_source parachute > ~/.config/fish/completions/parachute.fish

bash

Save the completion script somewhere.

_PARACHUTE_COMPLETE=bash_source parachute > ~/.parachute-complete.bash

Source the file in ~/.bashrc.

. ~/.parachute-complete.bash

zsh

Save the completion script somewhere.

_PARACHUTE_COMPLETE=zsh_source parachute > ~/.parachute-complete.zsh

Source the file in ~/.zshrc.

. ~/.parachute-complete.zsh

Changelog

v0.4.3 (2023-01-27)

Fixes

  • Complain if get and set are mixed up. [Stavros Korokithakis]

v0.4.2 (2023-01-07)

Features

  • Add the force-accept-calibration command. [Stavros Korokithakis]

Fixes

  • Fix parameter display order. [Stavros Korokithakis]

v0.4.1 (2022-11-05)

Features

  • Don't exit on missing parameters when restoring. [Stavros Korokithakis]

Fixes

  • Fix bug where negative numbers were erroneously not accepted. [Stavros Korokithakis]

v0.4.0 (2022-07-02)

Features

  • Add getting and setting bits directly. [Stavros Korokithakis]

  • Add the "--binary" parameter to display bit indexes. [Stavros Korokithakis]

Fixes

  • Remove unused code. [Stavros Korokithakis]

v0.3.11 (2022-02-26)

Features

  • Add "--compare" flag to "restore" [Stavros Korokithakis]

Fixes

  • Name files a bit better. [Stavros Korokithakis]

v0.3.10 (2021-12-17)

Fixes

  • Improve autodetection even more again. [Stavros Korokithakis]

  • Improve autodetection even more. [Stavros Korokithakis]

  • Improve autodetection default. [Stavros Korokithakis]

v0.3.9 (2021-11-02)

Fixes

  • Show the correct parameter name when diffing. [Stavros Korokithakis]

v0.3.8 (2021-10-29)

Features

  • Colorize tables. [Stavros Korokithakis]

  • Make table Markdown-compatible. [Stavros Korokithakis]

Fixes

  • Fix inverted compare display. [Stavros Korokithakis]

v0.3.7 (2021-10-23)

Features

  • Include parameter completions. [Stavros Korokithakis]

  • Add --baud-rate cli option` [Stavros Korokithakis]

Fixes

  • Display accurate names when diffing. [Stavros Korokithakis]

  • Fix port detection on Windows. [Stavros Korokithakis]

v0.3.6 (2021-08-29)

Fixes

  • Make messages more consistent. [Stavros Korokithakis]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

parachute-0.4.3.tar.gz (36.9 kB view details)

Uploaded Source

Built Distribution

parachute-0.4.3-py3-none-any.whl (35.0 kB view details)

Uploaded Python 3

File details

Details for the file parachute-0.4.3.tar.gz.

File metadata

  • Download URL: parachute-0.4.3.tar.gz
  • Upload date:
  • Size: 36.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.16

File hashes

Hashes for parachute-0.4.3.tar.gz
Algorithm Hash digest
SHA256 d9ce17ef55d4ed3d40bc48e1bc1296e640eb1df3641d0c1157881b9d624dab3a
MD5 8c3842ef8bfafb2a3f2b748bb65f3225
BLAKE2b-256 4aa7a968ee01dd7cbef2725a34094e2c11ddd30cd9636d19f8b88137f0d14e32

See more details on using hashes here.

Provenance

File details

Details for the file parachute-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: parachute-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 35.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.16

File hashes

Hashes for parachute-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 efdf8e45b0a26b574cf8c3defb2ab534786de0460f66b18b5b582c22ab19d715
MD5 0e2c9b509495f1b46cfbcf070cf5832c
BLAKE2b-256 5fbc923f23250c52572b21462838cd273de2749fcb4636ee0fdc3e4c1a8cd49d

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page