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
andset
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | d9ce17ef55d4ed3d40bc48e1bc1296e640eb1df3641d0c1157881b9d624dab3a |
|
MD5 | 8c3842ef8bfafb2a3f2b748bb65f3225 |
|
BLAKE2b-256 | 4aa7a968ee01dd7cbef2725a34094e2c11ddd30cd9636d19f8b88137f0d14e32 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | efdf8e45b0a26b574cf8c3defb2ab534786de0460f66b18b5b582c22ab19d715 |
|
MD5 | 0e2c9b509495f1b46cfbcf070cf5832c |
|
BLAKE2b-256 | 5fbc923f23250c52572b21462838cd273de2749fcb4636ee0fdc3e4c1a8cd49d |