This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
projects:crazyflie:pc_utils:install [2015-07-15 16:31] 127.0.0.1 external edit |
projects:crazyflie:pc_utils:install [2015-09-10 11:00] (current) macke |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Crazyflie Python client installation ====== | + | In the interest of not duplicating instructions all the install instructions have been moved to [[https:// |
- | + | ||
- | 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, | + | |
- | ===== Installing on windows ===== | + | |
- | + | ||
- | Download and run the installer from the [[projects: | + | |
- | + | ||
- | To install the Crazyradio dongle follow the instruction [[doc: | + | |
- | + | ||
- | ===== Installing on Linux ===== | + | |
- | The firmware and Python client can be downloaded as binaries from the | + | |
- | + | ||
- | To run the client after downloading it without installation, | + | |
- | < | + | |
- | cd < | + | |
- | python2 bin/ | + | |
- | </ | + | |
- | + | ||
- | You might want to [[doc: | + | |
- | + | ||
- | ==== Automatic system-wide install using setup.sh ==== | + | |
- | By running the '' | + | |
- | + | ||
- | < | + | |
- | cd crazyflie-clients-python | + | |
- | sudo sh setup.sh | + | |
- | </ | + | |
- | + | ||
- | The client can then be run from any location using | + | |
- | < | + | |
- | cfclient | + | |
- | </ | + | |
- | + | ||
- | ==== Manual installation ==== | + | |
- | + | ||
- | === Install dependencies === | + | |
- | The following has to be installed for the PC utilities to work: | + | |
- | * Python 2.7 | + | |
- | * pyGame | + | |
- | * PyUSB (0.X or 1.X) | + | |
- | * libusb | + | |
- | * Python bindings for Qt4 | + | |
- | + | ||
- | The following will install these dependencies on Fedora (tested for 16 to 18). | + | |
- | < | + | |
- | sudo yum install pygame pyusb PyQt4 | + | |
- | </ | + | |
- | + | ||
- | Or to install them on Ubuntu (tested for 10.04/ | + | |
- | < | + | |
- | sudo apt-get install python2.7 python-usb python-pygame python-qt4 | + | |
- | </ | + | |
- | + | ||
- | This will install the dependencies in OpenSUSE (tested for 11.3): | + | |
- | < | + | |
- | sudo zypper install python-pygame libusb python-usb | + | |
- | </ | + | |
- | + | ||
- | Note that these commands will pull in a lot of dependencies. | + | |
- | + | ||
- | === Fix udev permissions (Linux, Debian, Raspbian Wheezy, etc.)=== | + | |
- | The following steps make it possible to use the USB Radio without being root. | + | |
- | + | ||
- | Note: If using a fresh Debian install, you may need to install sudo first (executing exit command to exit from root shell first): | + | |
- | < | + | |
- | apt-get install sudo</ | + | |
- | + | ||
- | Note - installing sudo is probably not required if using Raspbian Wheezy on a Raspberry Pi | + | |
- | + | ||
- | Check if there is a plugdev group: | + | |
- | < | + | |
- | groups | + | |
- | </ | + | |
- | + | ||
- | If there is not a plugdev group, then add a plugdev group: | + | |
- | < | + | |
- | sudo groupadd plugdev | + | |
- | </ | + | |
- | + | ||
- | Now execute the following command: | + | |
- | < | + | |
- | sudo usermod -a -G plugdev < | + | |
- | </ | + | |
- | + | ||
- | Create a file named / | + | |
- | < | + | |
- | sudo touch / | + | |
- | </ | + | |
- | and open the nano editor to edit the newly created 99-crazyradio.rules file you created | + | |
- | < | + | |
- | sudo nano / | + | |
- | </ | + | |
- | + | ||
- | The nano display will show there' | + | |
- | < | + | |
- | SUBSYSTEM==" | + | |
- | </ | + | |
- | and hit Ctl-O to 'write out' (i.e. save) the new line into the file. Then Ctl-X to exit. | + | |
- | + | ||
- | Restart the computer and you are now able to access the USB radio dongle without being root. | + | |
- | + | ||
- | ===== 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 Crazyflie follow the instruction to install the client above. | + | |
- | ==== Windows XP ==== | + | |
- | The following has to be downloaded/ | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | + | ||
- | ==== Windows Vista/7 32/ | + | |
- | 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/ | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | + | ||
- | ===== Installing on Mac OSX ===== | + | |
- | There are a few different options for getting setup on your Mac, choose one of the methods below: | + | |
- | + | ||
- | ====Using homebrew==== | + | |
- | **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:// | + | |
- | | + | |
- | - Now make sure that the new python | + | |
- | echo ' | + | |
- | source ~/ | + | |
- | - Install SDL for Python:< | + | |
- | - Install PyQT:< | + | |
- | - Install libusb:< | + | |
- | - Install Mercurial: < | + | |
- | - Now use pip to install pyGame:< | + | |
- | - Install pyusb:< | + | |
- | + | ||
- | You now have all the dependencies needed to run the client. [[projects: | + | |
- | ====Using MacPorts==== | + | |
- | - If you do not have MacPorts installed yet please follow the [[http:// | + | |
- | - If you just installed MacPorts you can skip this step, otherwise make sure you update before you continue: < | + | |
- | sudo port upgrade outdated</ | + | |
- | - Then go ahead and install the dependencies needed for the crazyflie client, this will also bring in lots of other dependencies, | + | |
- | - To make it easier to run MacPorts binaries add ''/ | + | |
- | - To ensure we use the MacPorts Python installation, | + | |
- | - No you're good to go! [[projects: | + |