Forked from espdrone-clients-python (esp-drone branch)

edclient: Espdrone Clients

The ESP-Drone PC client enables interfacing with the esp drone with espdrone clients backend. It implements the user interface and high-level control (for example gamepad handling). The communication with espdrone and the implementation of the CRTP protocol to control the espdrone is handled by the edlib project.

For more info see our wiki.

Dependencies

The Espdrone PC client has the following dependencies:

• Installed from system packages
  • Python 3.6
  • PyQt5 == "5.13.2"
  • A pyusb backend: libusb 0.X/1.X
• Installed from PyPI using PIP:
  • PyUSB
  • PyQtGraph
  • ZMQ
  • appdirs
  • PyYAML

Running from source

The espdrone client requires edlib. If you want to develop with the lib too, follow the edlib readme to install it.

Windows (7/8/10)

Running from source on Windows is tested using the official python build from python.org. The client works with python version 3.6. The procedure is tested with 64bit python.

To run the client you should install python, make sure to check the "add to path" checkbox during install. You should also have git installed and in your path. Use git to clone the espdrone client project.

Open a command line window and move to the espdrone clients folder (the exact command depends of where the project is cloned):

cd espdrone-clients-python

Install the client in development mode:

pip install -e .

You can now run the clients with the following commands:

edclient

Mac OSX

Using homebrew

IMPORTANT NOTE: The following will use Homebrew and its own Python distribution. If you have a lot of other 3rd party python stuff already running on your system they might or might not be affected by this.

1. Install homebrew

   See the Homebrew site

2. Install the brew bottles needed

   brew install python3 sdl sdl2 sdl_image sdl_mixer sdl_ttf libusb portmidi pyqt5 == "5.13.2"
   

3. Install the client

   pip3 install -e .
   

4. You now have all the dependencies needed to run the client. The client can now be started from any location by:

   edclient
   

Linux

Launching the GUI application

If you want to develop with the lib, install edlib from https://github.com/bitcraze/espdrone-lib-python

Cfclient requires Python3, pip and pyqt5 to be installed using the system package manager. For example on Ubuntu/Debian:

sudo apt-get install python3 python3-pip python3-pyqt5 python3-pyqt5.qtsvg

Install edclient to run it from source. From the source folder run (to install for your user only you can add --user to the command):

pip3 install -e .

To launch the GUI application in the source folder type: python3 bin/edclient

To launch the GUI after a systemwide installation, execute edclient or python3 -m edclient.gui

Known Limitations

The edclient have several limitations that have not been developed yet. Here are some list of known issues/limitations:

• The camera streaming is not implemented in the edclient. To see the camera stream, go to your browser and type [YOUR DRONE's IP]/stream.jpg (eg. 192.168.0.100/stream.jpg) on the address bar

• Not fully tested on Mac OS.