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

Contents

  1. Add Turtlebot in Android Rocon Remocon
  2. Run Android Application
  3. Trouble shooting
    1. Disconnection with turtlebot
    2. Launching Not Installed App
    3. Can not see turtlebot default roles
    4. Failure of Launching Turtlebot rapp
  4. What Next?

Launch method regarding turtlebot android app by remocon

Add Turtlebot in Android Rocon Remocon

Follow up a below process to register turtlebot in android rocon remocon.

  1. Set network connection in android device

    • Android device and turtlebot should be in same network like PC network setting. Refer to network configuration.

  2. Add turtlebot connection information in remocon
    • Turtlebot is registered in android rocon remocon by tapping "Add a Master". The register ways are four.
      • 2-1. Manually Typing
        • Write the turtlebot ip include port in "Enter master URL" text box on popup dialog.

          add master

        2-2. Zeroconf
        • Tap "Scan the local network" and select turtlebot in list

          add master zeroconf

        2-3. QR code

        • TODO

        2-4. NFC Tag

        • TODO

Run Android Application

  • You can launch turtlebot android apps(ex. teleop) to use following instruction via android remocon. Other application can also launch with same process.
    1. Choose turtlebot
      • Select validated turtlebot in the list.

        • choose turtlebot

    2. Choose role
      • Android rocon remocon shows shows available role list from turtlebot interaction information in this step. Turtlebot basically offers two roles, "Android Pairing" and "Documentation". Choose "Android Pairing" on role list dialog to use turtlebot android apps.

        • choose role

        Refer Interacting with your Turtlebot if you want more detail information regarding role.

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

        • rapp chooser

        Select android app and then turtlebot launches the paired rapp as chosen androdi app. When beginning rapp in turtlebot is finished successfully, following popup is on.

        • 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. You just tab "Yes"

    link to play store

Can not see turtlebot default roles

  • Tap android back button and retry to select turtlebot like step 1 in Run Android Application when you can not see default roles(Android Pairing, Documentation).

Failure of Launching Turtlebot rapp

  • A following dialog pops when beginning turtlebot rapp is failure. In this case, tab "cancel" and wait until turtlebot rapp shutdown. Try to select turtlebot app, again!

    rapp started dialog failure

What Next?

Wiki: turtlebot/Tutorial/indigo/Android Interactions/How to Run Turtlebot Andorid Application (last edited 2015-04-03 05:58:42 by DongWookLee)

Except where otherwise noted, the ROS wiki is licensed under the
Creative Commons Attribution 3.0