User Tools

Site Tools


projects:crazyflie:pc_utils:install

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
projects:crazyflie:pc_utils:install [2013-05-11 18:20]
skube [Installing on Mac OSX]
projects:crazyflie:pc_utils:install [2015-09-10 11:00] (current)
macke
Line 1: Line 1:
-====== Crazyflie PC client installation ====== +In the interest of not duplicating instructions all the install instructions have been moved to [[https://github.com/bitcraze/crazyflie-clients-python/blob/develop/README.md README on GitHub]].
- +
-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 [[projects:crazyflie:binaries:index|binaries download page]]. A link called "Crazyflie client" will be created in the start menus. +
- +
-To install the Crazyradio dongle follow the instruction [[projects:crazyradio:install_win7|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. +
-<code> +
-sudo yum install pygame pyusb PyQt4 +
-</code> +
-==== Ubuntu ==== +
-The following has been tested on Ubuntu 10.04/11.10/12.04. Note that this will pull in a lot of dependencies +
-<code> +
-sudo apt-get install python2.7 python-usb python-pygame python-qt4 +
-</code> +
- +
-==== 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. +
-<code> +
-sudo groupadd plugdev +
-sudo usermod -a -G plugdev <username> +
-</code> +
- +
-Create a file named /etc/udev/rules.d/99-crazyradio.rules and add the following: +
-<code> +
-SUBSYSTEM=="usb", ATTRS{idVendor}=="1915", ATTRS{idProduct}=="7777", MODE="0664", GROUP="plugdev" +
-</code> +
- +
-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: +
-<code> +
-cd <cfclient folder> +
-python2 bin/cfclient +
-</code> +
- +
-===== 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: +
-  * [[http://www.python.org/download/releases/ | Python 2.7]] (for Windows the last available binary version of Python 2.7 is [[http://www.python.org/ftp/python/2.7.3/python-2.7.3.msi|Python 2.7.3]]) +
-  * [[http://pygame.org/download.shtml | pyGame]] for reading the input devices +
-  * [[http://sourceforge.net/projects/pyusb/files/latest/download | PyUSB 1.X]] for communicating with the Crazyradio +
-  * [[http://sourceforge.net/projects/libusb-win32/files/latest/download | libusb]] needed as backend for PyUSB +
- +
-For the graphical userinterface to work the following is also needed: +
-  * [[http://www.riverbankcomputing.co.uk/software/pyqt/download | PyQt4]] bindings for QT4 +
- +
-==== 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: +
-  * [[http://www.python.org/download/releases/ | Python 2.7]] (for Windows the last available binary version of Python 2.7 is [[http://www.python.org/ftp/python/2.7.3/python-2.7.3.msi|Python 2.7.3]]) +
-  * [[http://pygame.org/download.shtml | pyGame]] for reading the input devices +
-  * [[http://sourceforge.net/projects/pyusb/files/latest/download | PyUSB 1.X]] for communicating with the Crazyradio +
-  * [[http://sourceforge.net/projects/libusb-win32/files/latest/download | libusb]] needed as backend for PyUSB +
- +
-For the graphical userinterface to work the following is also needed: +
-  * [[http://www.riverbankcomputing.co.uk/software/pyqt/download | PyQt4]] bindings for QT4 +
- +
-===== 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. +
- +
-  - Open a terminal and install [[http://mxcl.github.io/homebrew/|homebrew]]<code>ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"</code> You also need to install Command Line Tools for Xcode or [[https://developer.apple.com/xcode/|Xcode]] if you don't already have them installed. +
-  With homebrew installed, install it's distribution of Python: <code>brew install python</code> This will also pull [[http://www.pip-installer.org/en/latest/|pip]] which we will use later to install some Python modules that are not distributed through homebrew. +
-  - 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: <code> +
-echo 'export PYTHONPATH=/usr/local/lib/python2.7/site-packages:$PYTHONPATH' >> ~/.bashrc +
-source ~/.bashrc</code> +
-  - Install SDL for Python:<code>brew install sdl sdl_image sdl_mixer sdl_ttf portmidi</code> +
-  - Install PyQT:<code>brew install pyqt</code> +
-  - Install Mercurial: <code>brew install mercurial</code> +
-  - Now use pip to install pyGame:<code>pip install hg+http://bitbucket.org/pygame/pygame</code> //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.// +
-  - Install pyusb:<code>pip install pyusb</code> +
- +
-You now have all the dependencies needed to run the client. [[projects:crazyflie:binaries:index#host_software|Download and extract the client]] and then start it by running the following in a terminal:<code>python bin/cfclient</code>+
projects/crazyflie/pc_utils/install.1368289245.txt.gz · Last modified: 2015-07-15 16:30 (external edit)