ArduPilot/pymavlink — dự án mã nguồn mở — đang có 740 sao GitHub. python MAVLink interface and utilities
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
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
Rust generation and MAVSpec/mavio interoperability are documented in
generator/Rust/README.md.
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 :
- [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):
sudo apt install libxml2-dev libxslt-dev
Optional for FFT scripts and tests:
sudo apt install python3-numpy python3-pytest
Analogously you can install the required dependencies for pymavlink:
sudo apt install python3-lxml
Alternatively, in the unlikely event that your distribution (other than Debian and its derivatives like Ubuntu) does not feature that package, you may decide to use pip and install the missing dependency from its source tree:
Yet another alternative is to use brew, in perfect analogy to how it is described for the macOS.
On macOS
lxml's native dependencies (libxml2 and libxslt) can be installed with Homebrew :
brew install libxml2 libxslt
Install the Python dependencies with pip so they land in the same Python environment as pymavlink (Homebrew's numpy/pytest install into Homebrew's own Python interpreter, which is typically not the one running pymavlink) :
python3 -m pip install --upgrade lxml
Optional for FFT scripts and tests:
python3 -m pip install --upgrade numpy pytest
On Windows
Lxml can be installed with a Windows installer from here : https://pypi.org/project/lxml
Installation
For users
It is recommended to install pymavlink from PyPI with pip, that way dependencies should be auto installed by pip.
sudo python3 -m pip install --upgrade 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.
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:
python3 -m pip install .
Running the tests
From inside the pymavlink directory, fetch the message definitions alongside
the checkout and run the suite with pytest:
MDEF points at the message definitions used to generate the dialects; if you
already have an ArduPilot checkout, point it at that mavlink/message_definitions
instead. PYTHONPATH=.. imports the local checkout rather than a pip-installed
copy.
Ardupilot Custom Modes
By default, 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:
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.
ArduPilot/pymavlink có 740 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/ArduPilot/pymavlink. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
ArduPilot/pymavlink có phải mã nguồn mở không?
TopGit chưa ghi nhận license cho ArduPilot/pymavlink. Phần lớn repo public trên GitHub là mã nguồn mở, nhưng điều khoản khác nhau từng repo — mở file LICENSE để xác nhận.
ArduPilot/pymavlink có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho ArduPilot/pymavlink. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
ArduPilot/pymavlink là gì?
ArduPilot/pymavlink (ArduPilot/pymavlink) là dự án Python trên GitHub. Theo mô tả gốc: python MAVLink interface and utilities
Đọc thêm về ArduPilot/pymavlink ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/ArduPilot/pymavlink là nguồn chính thức.
Đọc đầy đủ README ở tab phía trên.
Muốn nghe thêm một ý kiến về pymavlink?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về pymavlink.