Note: This tutorial assumes that you have completed the previous tutorials: TurtleBot Bringup, network configuration, Download Turtlebot Android Apps from Play Store.
(!) Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags.

How to Run Turtlebot Andorid Application

Description: Instructions how to run turtlebot android application

Tutorial Level: BEGINNER

Next Tutorial: Turtlebot Android Apps Dev Tutorials

Launching process of turtlebot android app

Add Turtlebot in Android Rocon Remocon

  1. Configure network connection of android device
    • Android device and turtlebot should be in the same network like PC network setting. Refer to network configuration.

  2. Add connection information of turtlebot
    • Turtlebot is registered in android rocon remocon with "Add a Master". There are four ways.
      • 2-1. Manual
        • add master

        2-2. Zeroconf
        • add master zeroconf

        2-3. QR code
        • TODO

        2-4. NFC Tag
        • TODO

Run Android Application

  • This step will explain how to begin turtlebot android apps(ex. teleop) via android remocon.
    1. Choose turtlebot
      • Select available turtlebot in the list.
        • choose turtlebot

    2. Choose role
      • Android rocon remocon shows available role list in this stage. Turtlebot provides two roles by default, "Android Pairing" and "Documentation". Choose "Android Pairing" on role list dialog. Please, refer Interacting with your Turtlebot for more detail information regarding role.

        • choose role

    3. Choose Application
      • Android rocon remocon shows a list of launchable applications for selected role.
        • rapp chooser

        When android app is selected, turtlebot prepares the paired rapp. The popup below will show when the robot is ready.
        • rapp start

    4. Enjoy turtlebot application!
      • Now, use turtlebot apps in your android device.
        • teleop main

Trouble shooting

Disconnection with turtlebot

  • Android rocon remocon shows turtlebot icon and name as following figure when the connection with turtlebot is success. On the other hands, a warning icon and Unknown name is displayed if android device do not connected with turtlebot. In this case, try to do following ways.
    1. Check turtlebot bringup status.
    2. Check each network status of turtlebot and android.
    3. Check turtlebot network configuration.

    connection result

Launching Not Installed App

  • Rocon Remcon links to Play store for download when you select application not installed.

    link to play store

Can not see turtlebot default roles

  • There are some reasons why default roles (Android Pairing, Documentation) is not shown.
    1. Broken interactions setting files
      • In this case, please check turtlebot interactions files in "TURTLEBOT_INTERACTIONS_LIST" env variable.
    2. Do not set up environment variable regarding interactions
      • In this case, please check whether TURTLEBOT_INTERACTIONS_LIST env variable is right
    3. Too fast Connect with turtlebot
      • In this case, tap android back button and retry to select turtlebot like step 1 in Run Android Application .

Failure of Launching Turtlebot rapp

  • A following dialog will pop when beginning turtlebot rapp is failure. This is because following reasons.
    1. The paired rapp launched by other remocon.
    2. The paired rapp is shutting down.
    3. Launching paired rapp is failure.
    In these case, try to tab "cancel" and wait until paired rapp in turtlebot shutdown. Try to select turtlebot app, again!

    rapp started dialog failure

What Next?

Wiki: turtlebot/Tutorials/indigo/Android Interactions/How to Run Turtlebot Andorid Application (last edited 2015-04-15 05:47:06 by DongWookLee)