The Pennsylvania State University
Library for controlling ArduPilot from an external computer via pymavlink.
For detailed documentation on pymavlink, visit mavlink.io. "Standard Messages/Commands" > "common.xml" is a particularly useful resource.
- In a terminal window, run
git clone [email protected]:UnmannedAerialSystems/MAVez.git - Switch into the newly cloned directory by running
cd MAVez - Install the package locally in editable mode
pip install -e .
While not required, it is highly recommended that you utilize ArduPilot's Software in the Loop (SITL) simulator to make testing significantly easier. Install instructions are provided for Windows and MacOS in the appendix. For Linux or WSL instructions, refer to the ArduPilot setup page
Below is a simple script designed to work with SITL. This example is provided at /examples/basic.py/
from MAVez import flight_controller
from MAVez.safe_logger import configure_logging
import asyncio
logger = configure_logging()
async def main():
controller = flight_controller.FlightController(connection_string='tcp:127.0.0.1:5762', baud=57600, logger=logger)
await controller.set_geofence("./examples/sample_missions/sample_fence.txt")
await controller.arm()
await controller.takeoff("./examples/sample_missions/sample1.txt")
controller.append_mission("./examples/sample_missions/sample2.txt")
controller.append_mission("./examples/sample_missions/sample3.txt")
await controller.auto_send_next_mission()
await controller.auto_send_next_mission()
await controller.wait_for_landing()
await controller.disarm()
if __name__ == "__main__":
asyncio.run(main())This project is licensed under the GNU General Public License v3.0.
Ted Tasman Declan Emery Vlad Roiban
SITL comes precompiled for Windows as part of Mission Planner. Installing Mission Planner is the most painless method for using SITL on Windows.
- Install prerequisites:
brew install python3 gcc
pip install future pymavlink MAVProxy opencv-python- Clone ArduPilot repository
git clone https://github.com/ArduPilot/ardupilot.git
cd ardupilot
git submodule update --init --recursive- Install environment
cd Tools/environment_install
./install-prereqs-mac.sh # decline all prompts- Compile the binaries
Return to ./ardupilot
./waf configure --board sitl
./waf copter
./waf plane- Run SITL
./Tools/autotest/sim_vehicle.py -v ArduCopter --console --map