User Tools

Site Tools


projects:crazyflie:android_client:user_guide

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:android_client:user_guide [2014-07-17 01:54]
fred [Connecting an external controller]
projects:crazyflie:android_client:user_guide [2021-06-24 16:56] (current)
kimberly
Line 1: Line 1:
-====== Install instructions and user guide for the Crazyflie Android client ====== +<WRAP center round important 60%> 
- +This page has deprecated and will be archivedPlease go to [[https://www.bitcraze.io/]]. 
-Screenshot: +</WRAP
- +This topic has been moved [[doc:crazyflie:client:cfandroid:index|here]]
-{{:projects:crazyflie:android_client:crazyfliecontrolscreenshot.png?200 |}} +
- +
-===== Installation ===== +
- +
-==== Hardware requirements: ==== +
-  * [[projects:crazyflie:index|Crazyflie]] +
-  * [[projects:crazyradio:index|Crazyradio]] dongle +
-  * USB On-the-go (OTG) cable (aka. USB Host cable) with Micro USB to USB  +
-    * e.g. from [[http://www.amazon.com/s/ref=sr_nr_n_1?rh=n%3A464394%2Ck%3Ausb+cable+%22on+the+go%22&keywords=usb+cable+%22on+the+go%22&ie=UTF8&qid=1381870811&rnid=2941120011|Amazon]] +
-  * Android device with Android version 4.0 (API Level 14) or higher +
-  * Optional: PS3 controller (or compatible) +
- +
-==== Downloading the app ==== +
- +
-There is no official version in the Google Play Store yet, but you can download a compiled version from:\\ +
-https://github.com/fredg02/crazyflie-android-client/releases +
-(older versions can also be found here: https://bitbucket.org/fredg02/crazyflie-android-client/downloads) +
- +
-  - Open the URL in your Android device's browser and download the newest APK +
-  - Make sure to "Allow installation of apps from sources other than the Play Store" (Settings -Security) +
-  - Install the APK (e.g. **CrazyflieControl_2013-10-15.apk**) from the browser's download folder +
-    * If this does not work, use a file manager like [[https://play.google.com/store/apps/details?id=com.metago.astro&hl=en|ASTRO File Manager]] to open the file.  +
- +
-==== Run the Crazyflie Android app ==== +
- +
-  - Connect the [[projects:crazyradio:index|Crazyradio]] dongle to the Android device with the USB OTG cable. +
-  - A pop-up should ask you which app you'd like to use with the USB device. +
-  - Select the Crazyflie app ("Crazyflie Control"). +
-  - When you run the app for the first time, you can scan for the [[projects:crazyflie:index|Crazyflie]] (must be switched on). (Menu -> Radio Scan) +
-    * Or you can set channel and data rate in the preferences manually (Menu -> Preferences) +
-  - Once the channel and data rate is set, you can connect to it. (Menu -> Connect) +
-    * The green LEDs on the [[projects:crazyflie:index|Crazyflie]] and the [[projects:crazyradio:index|Crazyradio]] should blink rapidly. +
-  - Use the on-screen controls to fly the [[projects:crazyflie:index|Crazyflie]]. +
-    * **WARNING: Be careful with the controls, they are harder to use than a gamepad.** +
- +
-===== Connecting an external controller ===== +
- +
-Instead of using the on-screen controls, you can also connect an external controller like a PS3 Controller (or compatible): +
- +
-=== Connect a PS3 Controller (over USB) === +
- +
-In addition to the USB OTG cable, you'll also need: +
-  * USB Y-Cable +
-  * USB Hub +
-  * PS3 Controller (or compatible joystick/gamepad) +
- +
-Setup: +
-  - Connect a USB Host (OTG) adapter to your Android device +
-  - Connect a USB Y-cable with the USB Host adapter +
-  - Connect a wall-plug with the (red) power plug of the Y-cable (you need external power) +
-  - Connect the upstream port of a USB hub with the socket of the Y-cable +
-  - Plug the PS3 controller and the [[projects:crazyradio:index|Crazyradio]] into the USB hub +
-  - The [[projects:crazyflie:index|Crazyflie]] Android client should say "Using external PS3 controller" and the [[projects:crazyradio:index|Crazyradio]]'s LEDs should light up for a second +
-  - Press the "PS" button and move the analog sticks (the pitch/roll/thrust/yaw on-screen values should change) +
- +
-Alternative setup without a USB Y-cable: +
- +
-{{:projects:crazyflie:android_client:cf_android_app_with_controller.jpg?300|}} \\ © DesTinY +
- +
-=== Connect a PS3 Controller (over Bluetooth) === +
-  * Some Android devices made by Sony, like the Xperia Z1, support the PS3 controller natively ([[http://forum.bitcraze.se/viewtopic.php?f=11&t=920|forum post]]) +
-  * Otherwise your Android device must be rooted +
-  * [[https://play.google.com/store/apps/details?id=com.dancingpixelstudios.sixaxiscontroller&hl=en|Sixaxis Controller app]] +
- +
-Setup: +
- FIXME +
- +
-===== Android device compatibility ===== +
- +
-^ Manufacturer ^ Name ^ Android version ^ Status ^ +
-| Asus | Nexus 7 (2012) | 4.3 | compatible | +
-| HP | Touchpad | Cyanogenmod 9 (Android 4.0.4) | [[http://forum.bitcraze.se/viewtopic.php?f=6&t=362|Crazyradio is not recognized]] | +
-| HTC | Desire | 2.1 | Unsupported Android version | +
-| LG | Nexus 5 | 4.4 | compatible (Crazyradio firmware version 0.51+ is required!) | +
-| Motorola | Moto G | 4.3 | compatible | +
-| Samsung | Galaxy Nexus | 4.2.2/4.3 | compatible | +
-| Samsung | Galaxy S2 | ? | compatible | +
-| Samsung | Galaxy S3 | ? | compatible | +
-| Samsung | Galaxy S4 | ? | compatible? | +
-| Sony | Tablet S | ? | [[http://forum.bitcraze.se/viewtopic.php?f=6&t=362|Crazyradio is not recognized]] | +
- +
-===== Known issues ===== +
-  * Flight data from the Crazyflie is not displayed +
-  * Size of on-screen controls can not be changed +
-  * Larger screen size of tablets is not used efficiently +
-  * No reliable connection quality indicator +
-  * Repeatedly connecting and disconnecting the Crazyradio can cause problems +
- +
-More can be found here: https://github.com/bitcraze/crazyflie-android-client/issues +
- +
-===== Reporting bugs ===== +
- +
-Bugs and feature requests should be added as Bitbucket issues: https://github.com/bitcraze/crazyflie-android-client/issues +
projects/crazyflie/android_client/user_guide.1405554898.txt.gz · Last modified: 2015-07-15 16:30 (external edit)