Differences

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

--- misc:hacks:rasberrypi [2013-05-12 01:23]
skube [Install the headless client]
+++ misc:hacks:rasberrypi [2021-06-24 16:45] (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>
 ====== Using the Raspberry Pi as a base station for flying ======
-You should setup the CF Headless client (see [[#current_state_of_the_headless_client|below]]) instead of the regular PC client on your Pi, since the UI seems to a bit too heavyweight for the Pi (controlling got **very** laggy during tests).
+In order to make it easy for users that have a Raspberry Pi to test out our headless client we prepared an SD-card image that is ready to use out of the box.
+The full SD-card image, and instructions on how to install it are located [[http://wiki.bitcraze.se/projects:crazyflie:binaries:raspberrypi|here.]]
+Instead of the official Python headless client, there is also a working Ruby version of the headless client, developed by a user.  This version, called Crubyflie, can be installed on top of the SD-card image described above or on a standalone version of Linux/Debian/Raspbian.  It allows you to adjust control variables (like X-mode or max thrust) by changing the values in a configuration file.  For more information visit [[https://github.com/hsanjuan/crubyflie|the Crubyflie installation page.]]
+====== Manual Installation =====
+As an alternative to a full SD-card image, you can manually install the headless Python client as a program on your Pi.  You should setup the CF Headless client (see [[#current_state_of_the_headless_client|below]]) instead of the regular PC client on your Pi, since the UI seems to a bit too heavyweight for the Pi (controlling got **very** laggy during tests).
 For the following installation instructions it is assumed that you are running the popular [[http://www.raspbian.org|Raspbian]] distrubution on your Pi.
@@ Line 19: / Line 30: @@
   hg up dev-headless
-This installs the necessary dependencies for running the client, checks out the current development version from BitBucket and then switches to the branch containing the headless client. If you want to use a custom configuration for the controller of your choice copy it to ''~/crazyflie-pc-client/conf/input''. Then edit the file ''~/crazyflie-pc-client/lib/cfheadless.py''. You'll need to change the URI of your Crazyradio and -- if you want a different one than ''PS3_Mode_1'' -- configure the correct input mapping to use. The corresponding lines can be found at the [[https://bitbucket.org/bitcraze/crazyflie-pc-client/src/0bd761d9eb4576861025128ef996334721b8f0a3/lib/cfheadless.py?at=dev-headless#cl-108|end of the file]]:
+This installs the necessary dependencies for running the client, checks out the current development version from BitBucket and then switches to the branch containing the headless client.
-<code python>
+If you are using an XBox Controller w/ Wireless Gaming Receiver, you might need to also install the userspace driver:
-    app = HeadlessClient(sys.argv,link_uri="radio://0/10/250K",
-                         input_config="<your input config>")
+  sudo apt-get install xboxdrv
-</code>
+and start it: ''sudo xboxdrv''
+<WRAP center round tip 80%>
+**NOTE**
+All modern Linux distribution now have a kernel driver for the x-box gamepad. Thus it is unlikely the //xboxdrv// user-space driver is needed.
+</WRAP>
-If you are using an XBox Controller w/ Wireless Gaming Receiver, you might need to also install drivers:
+Plugin your Crazyradio and your controller, power up the Crazyflie and start the client (via SSH and Ethernet or by using an USB hub to connect Crazyradio, controller and keyboard)((If you get an error message that ''python2'' could not be found, edit ''~/crazyflie-pc-client/bin/cfheadless'' and change the ''python2'' in the first line to ''python'')):
-    sudo apt-get install xboxdrv
-Plugin your Crazyradio and your controller, power up the Crazyflie and start the client((If you get an error message that ''python2'' could not be found, edit ''~/crazyflie-pc-client/bin/cfheadless'' and change the ''python2'' in the first line to ''python'')): (though I'm not sure how since there are only 2 usb ports, so how do type the command?)
-  python ~/crazyflie-pc-client/bin/cfheadless
+  python ~/crazyflie-pc-client/bin/cfheadless -u radio://0/10/250K -i <your input config (without the .json suffix)>
 The client should start up, hopefully find your Crazyradio dongle, your Crazyflie and your controller and start accepting commands:
 <code>
-pi@raspberrypi ~ $ ~/crazyflie-pc-client/bin/cfheadless
+pi@raspberrypi ~ $ ~/crazyflie-pc-client/bin/cfheadless -u radio://0/10/250K -i <your input config>
 Info: Using config path:  /home/pi/crazyflie-pc-client/lib/../conf
 Info: sys.path= ['/home/pi/crazyflie-pc-client/lib', '/home/pi/crazyflie-pc-client/lib/../conf', '/home/pi/crazyflie-pc-client/bin', '/usr/lib/python2.7', '/usr/lib/python2.7/plat-linux2', '/usr/lib/python2.7/lib-tk', '/usr/lib/python2.7/lib-old', '/usr/lib/python2.7/lib-dynload', '/usr/local/lib/python2.7/dist-packages', '/usr/lib/python2.7/dist-packages', '/usr/lib/python2.7/dist-packages/gtk-2.0', '/usr/lib/pymodules/python2.7']
@@ Line 84: / Line 100: @@
 </code>
+===== Manually Customizing Your .json Configuration File =====
+If you created a customized .json file for your xbox controller using a Windows PC and the cfclient GUI and are planning to copy it over to your Raspberry Pi, here is some advice:
+-save the new .json file as something different than the default, so you can recognize it easily.  e.g. xbox360new.json
+-the new .json file is not located in the Program Files(x64)/cfclient/input folder along with all the other default .json files; it's actually located in a hidden folder in your home directory.  Use the run... command from the start menu to get to it.  Type C:\Users\<your user name>\AppData\Roaming\cfclient\input\ to get to the right location of your new .json file
+-copy your new .json file into the correct RPi folder: /crazyflie-pc-client/conf/input/ Getting your customized .json file from your windows pc to your raspberry pi can be tricky.  Emailing it to yourself and accessing it using a RPi internet browser (like Midori) won't work because most email sites (hotmail, Gmail, etc.) require Java to access and RPi can't use Java.  USB flash drives need to be formatted correctly and that's a pain.  Try using WinSCP to move files from your Windows PC to the RPi: (http://winscp.net/eng/index.php) I also found a solution if you have access to a Mac-- install Netatalk on your Mac (http://gettingstartedwithraspberrypi.tumblr.com/post/24398167109/file-sharing-with-afp-and-auto-discovery-with-bonjour) and your RPi will show up magically in the finder window on your Mac.
+<code>sudo apt-get install netatalk</code>
+Verify netatalk was installed successfully on your RPi by checking the Finder window on your Mac for a "Raspberry Pi" shared drive. On your windows machine, copy your new .json file to a flash drive and plug it into your Mac. Then you can just drag/drop your new .json file from the flash drive into the /crazyflie-pc-client/conf/input/ folder using your Mac (thanks to Netatalk).
+-the cfheadless client on RPi may not recognize the same controller channel "id" numbers that were correct for your .json file when it worked on your Windows machine.  Mine didn't recognize the roll command, so when I flew, the CF just had pitch, yaw, and thrust using the controller sticks--no roll, but the right trigger would roll the CF hard to the right.  Using nano <my xbox config file>.json, I viewed/edited my .json file to identify which "id" was associated with the Right trigger and swapped it with the roll "id" number:  Had to change the roll "id" from 4 to 0 and whatever input was associated with 4, I changed the "id" of that one to 0.  Bottom line: If your .json file isn't controlling your CF correctly, experiment with the "id" numbers in your .json file.  Just remember not to duplicate any "id" numbers.  A number can only be used once in the file.  Here's what worked for me:
+Xbox Controller Input = id#
+Left stick vertical = 1
+Left stick horizontal = 0
+Right stick vertical = 3
+Right stick horizontal = 2
+Right trigger = 4
+Customize your flying configuration anyway you like using the inputs/id's above as a reference.
+**Note**: If you have more than one controller attached, you can select the one to use using the commandline parameter ''-c''. See ''cfheadless -h'' for available command line options:
+<code>
+usage: cfheadless [-h] [-u URI] [-i INPUT] [-d] [-c CONTROLLER]
+                  [--controllers]
+optional arguments:
+  -h, --help            show this help message and exit
+  -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>
+**Note**: If you still have an old version of the headless client you'll need to manually change the URI of your Crazyradio from the default 1M to 250K (make sure the K is uppercase). If you want to use a custom configuration (other than ''PS3_Mode_1'') for the controller or mapping of your choice, copy the .json configuration file to ''~/crazyflie-pc-client/conf/input'' and edit the file ''~/crazyflie-pc-client/lib/cfheadless.py'' (at the [[https://bitbucket.org/bitcraze/crazyflie-pc-client/src/0bd761d9eb4576861025128ef996334721b8f0a3/lib/cfheadless.py?at=dev-headless#cl-108|end of the file]]) with the corresponding filename:
+<code python>
+    app = HeadlessClient(sys.argv,link_uri="radio://0/10/250K",
+                         input_config="<your input config>")
+</code>
+You can then startup the client without any command line arguments and it should hopefully work as well: ''~/crazyflie-pc-client/bin/cfheadless''.
 ===== Current state of the headless client =====
 [[http://forum.bitcraze.se/viewtopic.php?p=417#p417|Marcus added]] the following things to note when using the headless client since it is a very early version:
-  * Still dependent on QT (the plan is to remove this very soon)
+  * <del>Still dependent on QT (the plan is to remove this very soon)</del> Not dependent on QT anymore
-  * Not much error handling yet (the plan is to improve this)
+  * <del>Not much error handling yet (the plan is to improve this)</del> Better error handling. If something does wrong the client exists.
-  * Values are still hardcoded in the script (like mapping and URI for Crazyflie). They can be changed at the bottom in lib/cfheadless.py
+  * <del>Values are still hardcoded in the script (like mapping and URI for Crazyflie). They can be changed at the bottom in lib/cfheadless.py</del> -> **Update** [[https://bitbucket.org/bitcraze/crazyflie-pc-client/pull-request/7/command-line-options-for-radio-uri/diff|A pull request]] adding some command line options for setting the input mapping and radio URI to use has been accepted, update your client to use that.
-  * The headless client will open the first input-device found (so don't plug more than one)
+  * <del>The headless client will open the first input-device found (so don't plug more than one)</del> -> **Update** [[https://bitbucket.org/bitcraze/crazyflie-pc-client/pull-request/7/command-line-options-for-radio-uri/diff|A pull request]] adding some command line option for selecting the used input device has been accepted, update your client to use that.
-  * No good way to quit it yet so you will have to kill the process
+  * <del>No good way to quit it yet so you will have to kill the process</del> Press Ctrl-C or pull the dongle
 ===== Make the client startup automatically on Crazyradio plug in =====
@@ Line 103: / Line 174: @@
 </code>
-and (as root) create a file ''/root/bin/cfheadless'' with the following contents:
+and (as root) you will create a file ''/root/bin/cfheadless'' using the instructions below, with the following contents:
 <code bash>
@@ Line 109: / Line 180: @@
 if test "$ACTION" = "add"
 then
-        /usr/bin/sudo -u pi /home/pi/crazyflie-pc-client/bin/cfheadless > /tmp/cfheadless.log 2>&1 &
+        /usr/bin/sudo -u pi /home/pi/crazyflie-pc-client/bin/cfheadless -u radio://0/10/250K -i <your input config without the .json extension> > /tmp/cfheadless.log 2>&1 &
         echo $! > /tmp/cfheadless.pid
 else
@@ Line 121: / Line 192: @@
 </code>
-Don't forget to make it executable: ''chmod +x /root/bin/cfheadless''. This should now take care to startup the headless client when you plug in the dongle and (hopefully ;-)) kill it again when you unplug. If you need any additional setup to get your controller working, you can add a similar udev-rule for that to take care of everything upon plugging in the controller as well. An example for the Microsoft Wireless XBox360 controller for PC can be found [[http://forum.bitcraze.se/viewtopic.php?p=490#p490|in this forums post]].
+You can only create the cfheadless file above in the /root/bin/ folder by being root--not pi or any other user name.  Switch to root: ''sudo -i'' and then navigate to the /root/bin/ folder: ''cd /bin/''.  Create the cfheadless file by typing: <code bash>touch cfheadless</code> to create the file.  Then <code bash>nano cfheadless</code> to edit the file, adding the code shown above ('sudo' prefix not needed because you're already root).  Remember to substitute your desired config file in the appropriate place in the code above (replace: <your input config...>).  Use the same method for the xbox360 file described in the section below if using a xbox360 controller:
+For the XBox360 Controller (after an "apt-get install xboxdrv"):
+Create a udev file ''/etc/udev/rules.d/99-xbox360.rules'' with contents (if using a Microsoft wireless gaming receiver):
+<code bash>SUBSYSTEM=="usb", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="0719", RUN+="/root/bin/xbox360"</code>
+and (as root) create a file ''/root/bin/xbox360'' with the following contents:
+<code bash>#!/bin/sh
+if test "$ACTION" = "add"
+then
+        /usr/bin/xboxdrv &
+else
+        killall -9 xboxdrv
+fi</code>
+Don't forget to make your files executable after you've created them: ''chmod +x /bin/cfheadless'' and ''chmod +x /bin/xbox360''. Once you've created the cfheadless file (and xbox360 file, if needed), exit the root mode by typing Ctl + D.  You may have to restart your RPi in order for all new udev rules to take effect. Rather than unplug/replug your RPi, consider the following command:
+<code bash>sudo shutdown -h now -r
+</code>
+The -h halts all processes, the -r is the command to reboot after shutdown.
+This should now take care to startup the headless client when you plug in the dongle and (hopefully ;-)) kill it again when you unplug. If you need any additional setup to get your controller working, you can add a similar udev-rule for that to take care of everything upon plugging in the controller as well.
+:!: **Important** :!: Due to the current state of the client, you **must** make sure to first connect your controller and power up the Crazyflie before connecting the Crazyradio dongle and thus starting the client. If the client can't find either controller or Crazyflie, it will just hang and you'll have to re-plug the dongle again.
+**Troubleshooting**
+If it still doesn't appear to work, try looking at the logs in the each of the following areas:
+  * /tmp/cfheadless.log (If this log indicates that there's no reference to Python2, edit crazyflie-pc-client/bin/cfheadless in order to change the 'python2' to 'python' in the beginning lines of the code.)
+  * /var/log/syslog
+Also, if xboxdrv can't be run without the sudo command, or there are other permissions issues with the xbox wireless usb controller, try adding the the xbox360 wireless receiver to a group you created that has root privileges, like 'plugdev'.  This can be done by adding: GROUP="plugdev", to the 99-xbox360.rules udev rule (similar to the code in the crazyradio udev rule):
+<code bash>SUBSYSTEM=="usb", ATTRS{idVendor}=="045e", ATTRS{idProduct}=="0719", GROUP="plugdev", RUN+="/root/bin/xbox360"</code>
+Also, if running the xboxdrv command from a terminal window gives you the following error:
+<code bash>Error couldn't claim the USB interface: LIBUSB_ERROR_BUSY</code>
-:!: **Important** :!: Due to the current state of the client, you **must** make sure to first connect (and -- if it's wireless -- also power up) your controller and power up the Crazyflie before connecting the Crazyradio dongle and thus starting the client. If the client can't find either controller or Crazyflie, it will just hang and you'll have to re-plug the dongle again.
+...your controller may very well have already started automatically per the udev rule you created above and could be working correctly and currently is in use.  Make sure your wireless xbox controller is powered on and connected (green arc showing), turn on your crazyflie and then plug in your crazyradio.  Once the green light on your crazyflie flashes on, you have a connection and are ready to fly!
 ===== Make your base station portable =====

Bitcraze Wiki

User Tools

Site Tools

Differences

Page Tools