User Tools

Site Tools


projects:crazyflie:pc_utils:install

This is an old revision of the document!


Crazyflie PC client installation

The Crazyflie PC utilities are developed using Python 2.7. The Crazyflie library is used from the command line tools as well as a graphical user interface. On Windows an installer permits to run the client without having to install any dependencies, on linux the client can easily be run from source code.

Installing on windows

Download and run the installer from the binaries download page. A link called “Crazyflie client” will be created in the start menus.

To install the Crazyradio dongle follow the instruction Install crazyradio driver on Windows 7. The procedure is similar for windows XP to 8.

Installing on Linux

The following has to be installed for the PC utilities to work:

  • Python 2.7
  • pyGame
  • PyUSB (0.X or 1.X)
  • libusb

For the graphical userinterface to work the following is also needed:

  • Python bindings for Qt4

Fedora

The following has been tested on Fedora 16 to 18. Note that this will pull in a lot of dependencies.

sudo yum install pygame pyusb PyQt4

Ubuntu

The following has been tested on Ubuntu 10.04/11.10/12.04. Note that this will pull in a lot of dependencies

sudo apt-get install python2.7 python-usb python-pygame python-qt4

Fix udev premissions on Linux

In order to fix the permissions so it's possible to use the USB Radio without being root do the following steps.

sudo groupadd plugdev
sudo usermod -a -G plugdev <username>

Create a file named /etc/udev/rules.d/99-crazyradio.rules and add the following:

SUBSYSTEM=="usb", ATTRS{idVendor}=="1915", ATTRS{idProduct}=="7777", MODE="0664", GROUP="plugdev"

Restart the computer and you are now able to access the USB radio dongle without being root.

Running the client

Decompress the source code in a folder, open a console and type:

cd <cfclient folder>
python2 bin/cfclient

Running source code on Windows

This procedure is required if you want to develop with the Crazyflie client on Windows. If you just want to run and fly the Carzyflie follow the instruction to install the client above.

Windows XP

The following has to be downloaded/installed for the PC utilities to work:

For the graphical userinterface to work the following is also needed:

Windows Vista/7 32/64-bit

Even if you have a 64-bit install you should download the 32-bit versions of the libraries since this makes everything easier.

The following has to be downloaded/installed for the PC utilities to work:

For the graphical userinterface to work the following is also needed:

Installing on Mac OSX

IMPORTANT NOTE: The following will use homebrew and it's own python distribution. If you have a lot of other 3rd party python stuff already running on your system they might or might not affected of this.

  1. Open a terminal and install homebrew
    ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"

    You also need to install Command Line Tools for Xcode or Xcode if you don't already have them installed.

  2. With homebrew installed, install it's distribution of Python:
    brew install python

    This will also pull pip witch we will use later to install some Python modules that ain't distributed through homebrew.

  3. Now make sure that the new python version is used for non-homebrew applications. To do this we need to prepend this installation to our PYTHONPATH:
    echo 'export PYTHONPATH=/usr/local/lib/python2.7/site-packages:$PYTHONPATH' >> ~/.bashrc
    source ~/.bashrc
  4. Install SDL for Python:
    brew install sdl sdl_image sdl_mixer sdl_ttf portmidi
  5. Install PyQT:
    brew install pyqt
  6. Now use pip to install pyGame:
    pip install hg+http://bitbucket.org/pygame/pygame

    As of 2013-05-08 the non-hg doesn't build correctly with brew installed SDL. Please update this when the fix as been pushed into the release version.

  7. Install pyusb:
    pip install pyusb

You now have all the dependencies needed to run the client. Download and extract the client and then start it by running the following in a terminal:

python bin/cfclient
projects/crazyflie/pc_utils/install.1368094941.txt.gz · Last modified: 2015-07-15 16:30 (external edit)