RoboticApp - Apps for your Robots
RoboControl

iRoboControl 3.0 User's Guide

Content

  1. Introduction
  2. Robot Setup
  3. Server Setup
  4. Client Setup
  5. Getting Started
  6. Controls and Sensors
  7. References
  8. Trademarks

Back to Documentation Library

Introduction

iRoboControl is a remote control for your robot. It sends commands to your robot and reads sensor data from your robot. It provides remote monitoring using your robot, an iPod touch and RoboWebCam which makes it perfect for monitoring your home while you’re away.

iRoboControl is an iOS application that can be installed and used on an iPhone, an iPod touch, an iPad or an iPad mini. It is optimized for the iPhone and iPod touch. It requires RoboServer to interact with your robot using Bluetooth wireless. No homemade electronics or programming is required. Basic computer skills are required.

Purpose

The purpose of this document is to provide users with a step-by-step guide on how to setup and use iRoboControl.

Scope

The scope of this document is limited to providing guidance on iRoboControl. For assistance on the hardware required by iRoboControl, contact the manufacturers of this hardware.

Architecture

iRoboControl can be used in one of two different configurations:

  • Basic configuration: Remote control of your robot with iRoboControl.
  • Remote monitoring configuration (optional): Remote control of your robot with iRoboControl, and remote monitoring with an iPod touch and RoboWebCam.

Basic Configuration

Basic Configuration

Remote Monitoring Configuration

Remote Monitoring Configuration

All components required for the two configurations are installed together on the same server computer. Everything described in this guide is required for the two configurations except when stated otherwise:

  • BA: required for basic configuration only.
  • RM: required for remote monitoring configuration only.

Features

iRoboControl provides the following features:

  • Native iOS remote control graphical user interface.
  • Send commands to your robot.
  • Receive sensor data from your robot.
  • Monitor your home remotely using the camera of an iPod touch mounted on your robot and RoboWebCam.
  • Email and SMS alerts with Gmail.
  • Sensors tracking dashboards with MyRobots and ThingSpeak.
  • Social networking with Facebook.
  • Client running on iPhone, iPod touch, iPad and iPad mini (optimized for iPhone/iPod touch).
  • Server running on Windows using RoboServer.
  • iOS native application.

iRoboControl requires RoboServer to provide these features.

Requirements

iRoboControl requires the following components:

  • iPhone, iPod touch, iPad or iPad mini with Internet connectivity (optimized for iPhone/iPod touch).
  • RoboServer on server computer required running Windows XP, Vista, 7 or 8 with Bluetooth wireless and Internet connectivity.
  • Roomba (any model manufactured after October 2005), Create or Mindstorms NXT.
  • RooTooth Bluetooth device (required for Roomba and Create only).
  • iPod touch 4th generation with mounting device and RoboWebCam (RM).
  • Solar charger with adhesive Velcro (RM for Roomba and Create only).

To view the robot components.

The Rootooth is a class 1 Bluetooth device which provides a range of 100 meters (330 feets). The Mindstorms NXT is equipped with a class 2 Bluetooth device which provides a range of 10 meters (33 feets). To get the best range and performance, you should have a Bluetooth class 1 radio on your server computer.

Robot Components

The robot components required by iRoboControl can be ordered from the following links:

Limitations

iRoboControl has limitations relative to response time and battery autonomy of the iPod touch:

  • Response time: There can be a perceivable delay between sending a command and the execution of that command by your robot when commands are sent through the Internet.
  • iPod touch battery autonomy: The iPod touch and solar charger fully charged can provide autonomy of your mounted iPod touch for up to 10 hours with the remote monitoring configuration (RM).

Assistance

If you need assistance in setting up or using iRoboControl, visit www.roboticapp.com/support.html or send us an email at support@roboticapp.com.

Overview

This document is organized into the following sections:

  • Introduction: Introduction to this document.
  • Robot setup: Steps to setup hardware on your robot.
  • Server setup: Steps to setup software on your server computer.
  • Client setup: Steps to setup software on your client device.
  • Getting started: Steps to start iRoboControl.
  • Controls and sensors: Instructions on how to control your robot and read its sensors using iRoboControl.
  • References: Useful references.
  • Trademarks: Trademarks used thoughout this document.

Back to top

Robot Setup

To setup your robot:

  1. Setup Robot Hardware.
  2. Install RoboWebCam on iPod touch (RM).
  3. Configure RoboWebCam (RM).
  4. Configure Auto-Lock (RM).

1. Setup Robot Hardware

iRoboControl uses the RooTooth Bluetooth device with the Roomba or Create, or the Bluetooth capabilities of the Mindstorms NXT to communicate with your robot wirelessly. It uses an iPod touch mounted on your robot as a wireless camera to provide remote monitoring (RM). The iPod touch is mounted on your robot using a standard car dashboard mount (RM). The iPod touch is connected to a solar charger to increase the autonomy of its battery using a standard iPod touch USB cable (RM). The solar charger is mounted on your robot using adhesive Velcro (RM).

To setup your robot hardware on a Roomba or a Create:

  1. Remove your robot from its docking station.
  2. Turn off your robot by pressing and holding the "CLEAN/POWER" button until it powers down.
  3. Remove the faceplate or serial port protector from your Roomba, or the serial port protector from your Create.
  4. Connect the RooTooth to your Roomba or Create 7 pin mini din serial port.
  5. Turn on your robot by pressing the "CLEAN/POWER" button.
  6. Attach the iPod touch dashboard mount to your Roomba or Create using the suction cup (use an adhesive base if necessary) (RM).
  7. Attach the iPod touch to the dashboard mount (RM).
  8. Put one Velcro adhesive strip on your robot (RM).
  9. Put another Velcro adhesive strip on the back of the solar charger (RM).
  10. Attach the solar charger to your robot (RM).
  11. Connect the solar charger to iPod touch (RM).

To view the procedure with screenshots.

To setup your robot hardware on a Mindstorms NXT:

  1. Build an iPod touch mount at the front of your robot using Lego bricks (RM).
  2. Attach the iPod touch to the support (RM).

To view the procedure with screenshots.

2. Install RoboWebCam on iPod touch (RM)

RoboWebCam provides mobile remote monitoring with your robot and an iPod touch.

To install RoboWebCam on your iPod touch:

  1. Start the iPod touch mounted on your robot.
  2. Press the "App Store" app.
  3. Press "Search".
  4. In the search field, enter "RoboWebCam" and press "Search".
  5. Press the "RoboWebCam" app.
  6. Press "$9.99".
  7. Press "Buy Now".

To view the procedure with screenshots.

3. Configure RoboWebCam (RM)

RoboWebCam needs to have its port and password set before being used. The default port is "12346" and the default password is "password". The modified port and password will persist even after shutting down RoboWebCam or turning off your iPod touch.

To configure RoboWebCam:

  1. Start the iPod touch mounted on your robot.
  2. Press the "RoboWebCam" app.
  3. Press the "Settings" button to navigate to the "Settings" panel.
  4. Press the "WebCam" button.
  5. Set the port number to be used to connect to RoboWebCam and press "Continue".
  6. Press the "Padlock" button.
  7. Set the password to be used to connect to RoboWebCam and press "Continue".

To view the procedure with screenshots.

4. Configure Auto-Lock on iPod touch (RM)

Auto-Lock must be set to "Never" on the iPod touch when using RoboWebCam.

To configure auto-lock on your iPod touch:

  1. Start the iPod touch mounted on your robot.
  2. Press the "Settings" app.
  3. Press "General".
  4. Press "Auto-Lock".
  5. Press "Never".
  6. Press "General".

To view the procedure with screenshots.

Back to top

Server Setup

iRoboControl requires RoboServer. To order and download your copy of RoboServer. To install and setup RoboServer.

Back to top

Client Setup

To setup iRoboControl on your client device:

  1. Install iRoboControl.
  2. Configure iRoboControl.

1. Install iRoboControl

iRoboControl can be installed on an iPhone, an iPod touch, an iPad or an iPad mini.

To install iRoboControl on your client device:

  1. Start iPhone, iPod touch, iPad or iPad mini.
  2. Press the "App Store" app.
  3. Press "Search".
  4. In the search field, enter "iRoboControl" and press "Search".
  5. Press the "iRoboControl" app.
  6. Press "$9.99".
  7. Press "Buy Now".

To view the procedure with screenshots.

2. Configure iRoboControl

iRoboControl requires the domain name or IP address and port number of your server computer running RoboServer. It also requires the domain name or IP address and port number of RoboWebCam in the remote monitoring configuration (RM).

To configure iRoboControl on your client device:

  1. Start your iPhone, iPod touch, iPad or iPad mini.
  2. Press on the "iRoboControl" icon app on your iPhone, iPod touch, iPad or iPad mini.
  3. Press the "Settings" button.
  4. Press the "Bluetooth" button.
  5. Enter the RoboServer domain name or IP address, port number and license number, and press "Continue" using the format: "your domain name or IP address:your port number:your license number" (For example: www.xelaration.net:12345:262054443359375).
  6. Press the "WebCam" button.
  7. Enter the RoboWebCam domain name or IP address and port number, and press "Continue" using the format: "your domain name or IP address:your port number" (For example: www.xelaration.net:12346).

To view the procedure with screenshots.

Back to top

Getting Started

To get started:

  1. Start iRoboControl.
  2. Start iRoboControl with RoboWebCam (RM).

1. Start iRoboControl

iRoboControl controls your robot wirelessly using RoboServer and a Bluetooth connection.

To start iRoboControl:

  1. Press on the "iRoboControl" icon app on your iPhone, iPod touch, iPad or iPad mini.
  2. Control your robot and get sensor data as described in section Controls and Sensors.

2.Start iRoboControl with RoboWebCam (RM)

iRoboControl has two components in the RM configuration:

  • iRoboControl
  • RoboWebCam

iRoboControl runs on an iPhone, an iPod touch, an iPad or iPad mini. RoboWebCam runs on an iPod touch mounted on your robot.

To start iRoboControl with RoboWebCam:

  1. Press on the "iRoboControl" icon app on your iPhone, iPod touch, iPad or iPad mini.
  2. Start the iPod touch mounted on your robot.
  3. Press the "RoboWebCam" app.
  4. Go back to iRoboControl on your iPhone, iPod touch, iPad or iPad mini.
  5. Press the "WebCam" button on the "Controls" panel (WebCam icon at the top of the "Controls" panel located between the Bluetooth and the battery icons).
  6. When prompted to authenticate, enter any user id and the RoboWebCam password (default is "password"), and click "Log In".
  7. Control your robot and get sensor data as described in section Controls and Sensors.

Back to top

Controls and Sensors

iRoboControl is organized in 6 different panels:

  • Controls: Controls to send commands to your robot.
  • Sensors: State of your robot sensors.
  • Schedule: Management of the cleaning schedule.
  • Piano: Piano keyboard.
  • Favorites: Emoticon, geometric patterns, musical tunes and dance.
  • Settings: Settings and instructions.

To view the list of all valid controls.

Back to top

References

  1. iRobot Roomba Open Interface (ROI) Specification (Adobe Reader required).
  2. iRobot Create Open Interface (Adobe Reader required).
  3. iRobot Roomba 500 Open Interface (OI) Specification (Adobe Reader required).
  4. RoboDynamic RooTooth User Guide (Adobe Reader required).
  5. Mindstorms Support.

Back to top

Trademarks

  1. iRoboControl, RoboServer and RoboWebCam are trademarks of Xelaration Software Corporation.
  2. Xelaration is a registered trademark of Xelaration Holding Corporation.
  3. Roomba and Create are registered trademarks of iRobot Corporation in the United States.
  4. Mindstorms is a trademark of the LEGO Group.
  5. Windows is a registered trademark of Microsoft Corporation in the United States and other countries.
  6. iPhone, iPod touch and iPad are trademarks of Apple Inc., registered in the United States and other countries.
  7. Cisco and Linksys are registered trademarks of Cisco Systems Incorporated.

Back to top