mkim / pydrone Goto Github PK

#PyDrone - Python API for the ARDrone.

##Overview

PyDrone is a set of python libraries originally written by Bastian Venthur.

##Dependencies:

This software was tested with the following setup:

• Python python 2.7.5.
• Cython cython 0.19.1.
• setuptools setuptools.
• Pygame pygame 1.9.2 (only for the demo).

####Note: On OSX Python and PyGame were installed using [Homebrew] brew and PIP pip.

##Getting Started:

###Cython Modules

The pydrone modules are not included as pre-built binaries. To use this API generate the C source code and build it in-place by using the following commands:

cython pydrone/*.pyx
python setup.py build_ext --inplace

After building the pydrone libraries proceed to test the API and drone:

$ python
>>> from pydrone import libardrone
>>> drone = libardrone.ARDrone()
>>> # You might need to call drone.reset() before taking off if the drone is in
>>> # emergency mode
>>> drone.takeoff()
>>> drone.land()
>>> drone.halt()

The drone's property image contains always the latest image from the camera. The drone's property navdata contains always the latest navdata.

##Demo:

There is also a demo application included which shows the video from the drone and lets you remote-control the drone with the keyboard:

RETURN      - takeoff
SPACE       - land
BACKSPACE   - reset (from emergency)
a/d         - left/right
w/s         - forward/back
1,2,...,0   - speed
UP/DOWN     - altitude
LEFT/RIGHT  - turn left/right

##Repository:

The original public repository is located here:

git://github.com/venthur/python-ardrone.git

##License:

This software is published under the terms of the MIT License:

http://www.opensource.org/licenses/mit-license.php