Collect IoT data with IoTool and a smartphone to IBM Watson IoT Quickstart

Collect IoT data with IoTool and a smartphone to IBM Watson IoT Quickstart


Skill Level: Any Skill Level

For anyone with a basic knowledge how to install an Android application from Google Play

This recipe describes how to connect an Android smartphone to the IBM Watson IoT Quickstart using the IoTool app. Use different Sensors (integrated, wired, wireless), Virtual sensors (algorithms), Triggers, Actions or your own extensions.


  • Android device with the latest IoTool application



  1. About IoTool

    IoTool, a multi-awards winning smartphone gateway and API, allows IoT researching and fast prototyping with minimal costs in domains: IoT, eHealth, sport&wellnessI4.0, HomeAutomation, Industry 4.0 and Logistics.

    Currently IoTool supports more than 100 different sensors with more than 277 sensor readings (like, Arduino, Audio, Bosch XDK, Internal Smartphone, TI SensorTag, Video and similar), 50 actuators (like Arduino, Flic, Internal Smartphone, Lifx and similar) and different types of triggers connected to ordinary smartphone through a very flexible extensions system. Any new sensor, action, actuator, algorithm, trigger or cloud sync uses its own extension (similar like printer drivers). External developers can develop their own extension (usually extension can be made in hours) and their own UI for any type of IoT solutions.

    IoTool works on Android devices (phone, tablet, Android TV, Raspberry PI with Android OS installed). IoTool on a smartphone can process (collect, encrypt, store, show values and diagrams, sync to Cloud) up to 24.000 records per second, for example, 12 lead ECG with 2000Hz per lead.

    IoTool modules:

    dashboard nav dark Dashboard

    IoTool Dashboard 1

    sensors nav dark Sensors and virtual sensors nav dark Virtual sensors (algorithms)

    IoTool Sensors 1

    messages nav dark Messages

    IoTool Messages 1

    triggers nav dark Triggers, actions nav dark Actions, and recipes nav dark Recipes

    IoTool Triggers 1 IoTool Actions 1

    IoTool Recipes 1

    cloud nav dark Cloud

    IoTool Sync 1
  2. IoTool installation

    • Register and Login to
    • Select extensions needed for a project


    • Download IoTool.apk (link is on main page)
    • Select and download sensor extensions ( / EXTENSIONS / SENSORS) to your smartphone. If you wish to use only internal Android sensors, use “Android sensors – Service: Device internal”.


  3. IoTool setup and test

    • Read the User manual ( / SUPPORT / USER MANUALS / IoTool User manual) and set up sensors and IoTool dashboard to get the Sensor readings you wish.
    • NOTE: all selected Sensor readings from IoTool dashboard will be sent to IBM Watson IoT Quickstart.
    • After the dashboard START button is pressed, you should get all selected Sensor readings to the IoTool dashboard in real-time.

    IoTool screen

  4. IoTool IBM Watson IoT Cloud extension download and synchronization settings

    IoTool Synchronization settings

    Now we will configure IoTool to actually connect to IBM Watson IoT Quickstart. You can find the settings if you open navigation drawer in your IoTool app -> Settings -> Cloud-> IBM Watson IoT Settings. Note that in Cloud settings both Use cloud and Send data must be checked and IBM Watson IoT service selected.

    Connection parameters

    The following information is required when connecting your device:

    • URL: ssl://
      Do not forget to use the “ssl://” prefix!
    • Port:8883
    • Device identifier: d:quickstart:mosquitto:<device_id>
      The <device_id> parameter uniquely identifies your device. You can use it to monitor the readings with IBM Watson IoT Quickstart
    • Username: /
      Leave empty for Quickstart.
    • Password: /
      Leave empty for Quickstart.
    • Event topic format: iot-2/evt/<event_id>/fmt/json
      The <event_id> specifies the event name that is shown in Watson IoT Platform.
    • Quality of Service: 0
      Quickstart offers no confirmation of receipt and does not support MQTT quality of service (QoS) levels greater than zero.

    You can read more about connecting devices here.

    Path to settings

    IoTool settings 1

    IoTool settings 2

    IoTool settings 3

    IoTool settings 4

    IoTool settings 5

  5. Test the dashboard and communication

    START a dashboard. To make sure that service is running, check your notification bar

    IoTool Sync

    and the IoTool monitor.

    IoTool monitor quickstart

    Collected Sensors readings should be synced to IBM Watson Quickstart.