Differences

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

--- projects:crazyflie:pc_utils:index [2012-03-10 16:51]
arnaud [gamepadCtrl.py]
+++ projects:crazyflie:pc_utils:index [2021-06-24 16:52] (current)
kimberly
@@ Line 1: / Line 1: @@
+<WRAP center round important 60%>
+This page has deprecated and will be archived. Please go to [[https://www.bitcraze.io/]].
+</WRAP>
 ====== Crazyflie PC utilities ======
-The Crazyflie PC utilities are developed using Python 2.6. The Crazyflie library is used from the command line tools as well as a graphical user interface.
+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. For install instructions of PC side software please see [[projects:crazyflie:pc_utils:install|this page]].
-===== Common install instructions =====
+====== Crazyflie Python Library ======
-The following has to be installed for the PC utilities to work:
+The Crazyflie library can be used to easily integrate control and communication with the Crazyflie quadcopter into an application. Currently the only implementation is done in Python and can be found [[projects:crazyflie:pc_utils:pylib|here]].
-  * [[http://www.python.org/download/releases/ | Python 2.6]] (for Windows the last available binary version of Python 2.6 is [[http://www.python.org/download/releases/2.6.6/|Python 2.6.6]])
-  * [[http://pygame.org/download.shtml | pyGame]] for reading the input devices
-  * [[http://sourceforge.net/projects/pyusb/ | pyUSB]] for communicating with the USBRadio
-===== Graphical User Interface =====
+====== List of applications ======
-==== Install instructions ====
+===== Crazyflie control UI =====
-Besides the common bindings the following has to be installed for the user interface to work:
+The Crazyflie control UI is used to pilot the Crazyflie using a graphical user interface. A userguide for the GUI application can be found [[doc:crazyflie:client:pycfclient:index|here]]. Normally this is started from the start menu (or similar) if you have used an installer. There's also the option of starting it from the command line:
-  * [[http://www.riverbankcomputing.co.uk/software/pyqt/download | PyQt4]] bindings for QT4
-  * [[http://pyqwt.sourceforge.net/download.html | PyQwt5]] for plotting data
-==== Using the GUI ====
-===== Command line tools =====
-==== Install instructions ====
-Besides the common bindings nothing has to be installed.
-==== Link driver model ====
-All command line tools used the same link diver model. The link driver to use in order to communicate with the copter is chosen with the ''-l'' command line argument. Also the tools accepts the ''-h'' argument that will display help about the link driver as well as the default driver used if none is provided:
 <code>
-crazyclient$ python gamepadCtrl.py -h
+usage: cfclient [-h] [--debug DEBUG]
-CRTP Driver loader options:
----------------------------
- -l <driver_uri> : Load the link driver with the requested URI
- -h              : Print this help message
-Unless otherwise specified the URI "radio://0" will be used
+cfclient - Crazyflie graphical control client
-</code>
-The available drivers are:
+optional arguments:
+  -h, --help            show this help message and exit
-  * **%%radio://n[/channel[/speed]]%%** Radio dongle number 'n' (many can be connected to the computer) communicating on a specified channel with a specified speed. The speed and channel are optional, default channel is 2 and default speed is 2M. The speed can be 2M, 1M or 250K. For example:
+  --debug DEBUG, -d DEBUG
-    * **%%radio://0%%** uses radio dongle 0 to communicate on channel 2 at 2Mbit/sec
+                        set debug level [minimal, info, debug, debugfile]
-    * **%%radio://0/77%%** uses radio dongle 0 to communicate on channel 77 at 2Mbit/sec
-    * **%%radio://0/77/250K%%** uses radio dongle 0 to communicates on channel 77 at 250Kbit/sec
-  * **%%loop://%%** Loopback driver. Mainly aims at testing tools without having them to crash because of the missing radio link |
-==== gamepadCtrl.py ====
-//gamepadctrl.py// is the 'legacy' control software for Crazyflie. It works with a playstation 3 gamepad and display rudimentary information about the axis position:
-<code>
-crazyclient$ python gamepadCtrl.py -l radio://0/77
 </code>
-{{:projects:crazyflie:pc_utils:gamepadctrl.png|}}
-The gamepad mapping is as follow:
+===== Crazyflie headless client =====
-^ Control ^ Gamepad Key/axis ^
+The Crazyflie headless client is intended to be run on the Raspberry Pi (see [[misc:hacks:rasberrypi|this page]] for more info), but can also be used from a normal PC.
-| Pitch   | LX               |
-| Roll    | LY               |
-| Thrust  | RX               |
-| Yaw rate| RY               |
-| Emergency stop | Ps button |
-==== crazyload.py ====
-//crazyload.py// permits to update the copter firmware using the Crazyload radio bootloader. This is a self-documented command line tool (launch ''python crazyload.py -h'').
-To program a copter with a firmware compile in bootloader mode (see build environment documentation):
 <code>
-$ python crazyload.py -c flash cflie.bin
+usage: cfheadless [-h] [-u URI] [-i INPUT] [-d] [-c CONTROLLER]
-</code>
+                  [--controllers]
-Here //cflie.bin// is the binary file of the firmware to be flashed. After launching this command the copter has to be restarted and the flash procedure will start. When the flash procedure is finished the copter has to be restarted again and will boot the new firmware.
-The bootloader is normally able to automatically reset the copter in bootloader and firmware mode. This functionality requires to know the CPU-ID of the copter (which can be recovered with the command line tool //getinfo.py//). Knowing the copter CPU id, it can be reprogrammed without manipulation as follow;
+optional arguments:
-<code>
+  -h, --help            show this help message and exit
-$ python crazyload.py -i 32:00:6e:06:58:37:35:32:60:58:01:43 -l radio://0/77 flash cflie.bin
+  -u URI, --uri URI     URI to use for connection to the Crazyradio dongle,
+                        defaults to radio://0/10/250K
+  -i INPUT, --input INPUT
+                        Input mapping to use for the controller, defaults to
+                        PS3_Mode_1
+  -d, --debug           Enable debug output
+  -c CONTROLLER, --controller CONTROLLER
+                        Use controller with specified id, id defaults to 0
+  --controllers         Only display available controllers and exit
 </code>
-This command is an example that would work if the copter is currently running a crazyflie firmware with radio configured to channel 77.
-==== getinfo.py ====
-//getinfo.py// recovers some information about a running copter. This tool is slightly bugged but fulfills its purpose (mainly getting the copter CPU ID). Its usage is quite classical:
-<code>
-crazyclient$ sudo python getinfo.py -l radio://0/77
-Detected CrazyRadio dongle version 0.32
-Channel 77
-Data rate 2M
-CPU ID: 52:ff:70:06:48:89:49:53:15:31:10:87
-Battery voltage: 3.764599V
-CrazyCopter version: 0.9.0
-Copter class name: CrazyFlie
-CPU ID: 52:ff:70:06:48:89:49:53:15:31:10:87
-crazyclient$
-</code>

Bitcraze Wiki

User Tools

Site Tools

Differences

Page Tools