Mavelous is an open source browser-based ground control station (GCS) for drones/UAVs/micro air vehicles.
Here's a screenshot of Mavelous running in a desktop web browser:
Mavelous running on an iPhone:
Here's a video of Mavelous being used in the field with an iPad to fly an ArduCopter:
Situational awareness. Mavelous will show you a vehicle's current position on a map. It also has a primary flight display that displays attitude, speed and altitude.
Tap-the-map navigation. You can double tap on the map, and the vehicle will switch to GUIDED mode and fly to that position.
First clone the mavelous and mavlink repositories:
$ cd src $ git clone https://github.com/wiseman/mavlink # Fork required to fix bugs $ git clone firstname.lastname@example.org:wiseman/mavelous.git
Then install CherryPy, Flask and pyserial. The easiest way is with pip:
$ pip install cherrypy flask pyserial
How to run it
The online demo of Mavelous runs completely within the browser. The simulated drone is very low fidelity and simply follows a fixed path. It will not respond to navigation commands such as guided mode.
You can also run the demo on your own machine by cloning the repository and
opening the html page in your browser via the filesystem. The
file can be found at:
With a real drone
Connect your ArduCopter or ArduPlane to your computer with an Xbee or 3DR Radio. Power on the vehicle.
Start mavproxy, specifying the serial port and data rate. On Linux, the serial port is probably named something like
/dev/ttyUSB1. For 3DR Radios, the data rate is usually 57600. For example:
$ cd src/mavelous $ python mavproxy.py --module mavelous --master=/dev/ttyUSB0 --baud=57600
You can then point at browser at http://localhost:9999.
You'll be able to use the Mavelous interface to control Guided mode once in flight. Find out more about guided mode on ArduCopter.
Software in the loop simulation ArduCopter
Compile the ArduCopter firmware for Software in the loop similation (SITL). You'll need to use the ardupilot-mega project's Makefile build system: see details on the ardupilot-mega wiki.
$ make sitl
Run the ArduCopter executable in desktop mode. For example:
$ ~/ardupilot-mega/tmp/ArduCopter.build/ArduCopter.elf -H 20
On some systems, this directory will be found at
Start the simulated multicopter. For example:
$ python ~/ardupilot-mega/Tools/autotest/pysim/sim_multicopter.py \ --frame=+ --rate=400 --home=34.092047,-118.267136,20,0 --wind=6,45,.3
$ python mavproxy.py --master=tcp:127.0.0.1:5760 --out=127.0.0.1:14550 \ --aircraft=test.ArduCopter --sitl=127.0.0.1:5501 --out=127.0.0.1:19550 \ --quadcopter --streamrate=5 --module mavelous
A web browser will open showing you the Mavelous interface, or you can point a browser to http://localhost:9999.
Take off. Soon, arducopter may support automated take-off. Until then:
GUIDED> switch 6 # Stabilize mode GUIDED> rc 3 1510 # Take-off throttle
* Drone | *---+---* | * ^ | | Radio link | V ............................................. . Mavelous . . . . +--------+ +-----------------+ . . | | HTTP | Front end, runs | . . | Server |<-------->| in browser | . . | | | | . . +--------+ +-----------------+ . .............................................
Mavelous has two main parts:
Front end. This is the HTML application that runs in a browser. It uses many HTML5 features, so you'll need a reasonably modern browser.
Server. The server manages communication between the front end and the drone. It has a web server that talks to the front end, and it sends and receives drone commands using a wireless modem (like an XBee radio or a 3D Robotics radio).
The front end and the server can run on the same computer, or on two different computers.
Portability. Controlling a drone with an iPad is kind of awesome, and there are currently no open-source ground control stations that can run on an iPhone or iPad--Mavelous can (at least the front end can).
The most popular ArduCopter GCS, APM Mission Planner, is primarily a Windows application. It can run under OS X and Linux with Mono, but the experience is not always smooth.
The goal of Mavelous is to have a highly portable GCS that can talk to anything that speaks the MAVLink protocol (and hopefully ROS devices, too, some day).
Currently Mavelous is capable of monitoring and guiding a drone in flight.
- You can see basic flight data (speed, altitude, attitude) on the primary flight display.
- You can double click/tap on the map to send the drone to that location.
- Multiple users can control the same drone.
- Arm/Disarm, loiter, and land an ArduCopter (or other drones that obey Mavlink Navigation Commands).
We're working to add the following features soon:
- Control auto takeoff
- Mission creation and editing
- Offline support (map caching)
I'd like to add these features:
- Multi-vehicle control
There is a public mailing list for Mavelous users and developers.
To lint the code:
$ make lint
To fix some lint issues automatically:
$ make lintfix
$ make deps
The Mavelous backend is based on Mavproxy,a command line ground station by Andrew Tridgell.
Mavelous is covered by the MIT license, see the accompanying file LICENSE.md for details.
This repository contains additional code that may be covered by other licenses, including MAVProxy, which uses the GPL license.