User Tools

Site Tools


projects:crazyflie:android_client:user_guide

This is an old revision of the document!


Install instructions and user guide for the Crazyflie Android client

Screenshot:

Installation

Hardware requirements:

  • Crazyradio dongle
  • USB On-the-go (OTG) cable (aka. USB Host cable) with Micro USB to USB
  • 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://bitbucket.org/fredg02/crazyflie-android-client/downloads

  1. Open the URL in your Android device's browser and download the newest APK
  2. Make sure to “Allow installation of apps from sources other than the Play Store” (Settings → Security)
  3. Install the APK (e.g. CrazyflieControl_2013-10-15.apk) from the browser's download folder

Run the Crazyflie Android app

  1. Connect the Crazyradio dongle to the Android device with the USB OTG cable.
  2. A pop-up should ask you which app you'd like to use with the USB device.
  3. Select the Crazyflie app (“Crazyflie Control”).
  4. When you run the app for the first time, you can scan for the Crazyflie (must be switched on). (Menu → Radio Scan)
    • Or you can set channel and data rate in the preferences manually (Menu → Preferences)
  5. Once the channel and data rate is set, you can connect to it. (Menu → Connect)
  6. Use the on-screen controls to fly the 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:

  1. Connect a USB Host (OTG) adapter to your Android device
  2. Connect a USB Y-cable with the USB Host adapter
  3. Connect a wall-plug with the (red) power plug of the Y-cable (you need external power)
  4. Connect the upstream port of a USB hub with the socket of the Y-cable
  5. Plug the PS3 controller and the Crazyradio into the USB hub
  6. The Crazyflie Android client should say “Using external PS3 controller” and the Crazyradio's LEDs should light up for a second
  7. 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:


© DesTinY

Connect a PS3 Controller (over Bluetooth)

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) 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 ? 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.1396997861.txt.gz · Last modified: 2015-07-15 16:30 (external edit)