Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
74 lines (43 sloc) 4.83 KB

IBM IoT Connected Vehicle Insights - OBDII Fleet Management App for Android


The IBM IoT Connected Vehicle Insights - Mobility Starter Application uses the IBM IoT Platform that is available on IBM Cloud to help you to quickly build a smart fleet management solution. The solution consists of a mobile app and a server component which is the IBM IoT Connected Vehicle Insights - Fleet Management Starter Web Application.

Mobile app

The starter app provides a mobile app to connect to an OBDII dongle plugged in to your car. If you are a user of the application, you can use the mobile app to do the following tasks:

  • See real-time data from your car on the screen
  • Beam the data to the IBM IoT Platform, which will automatically get synced to the Fleet Management Web Application

While you drive the car, the service tracks your location and also records the health of your car. This will happen in the background, which means you could lock your phone in the meantime or use other applications.

Once you want to stop the application from recording your data, simply press "End Session", and the application will close.

You can currently download and install the mobile app on your Android mobile device.

Server component

The "IBM IoT Connected Vehicle Insights - OBDII Fleet Management App" interacts with a server component. The server component provides the back-end fleet management and system monitoring service that provides more features for fleet management companies. By default, the mobile app connects to a test server that is provided by IBM. You can also choose to deploy your own server instance to IBM Cloud and connect your mobile app to that instance instead of the test system. For more information about deploying the fleet management server component, see ibm-watson-iot/iota-starter-server-fm.


Before you deploy the Android application, ensure that the following prerequisites are met:

  • Install the Android Studio integrated development environment (IDE) V2.1.1 or later.
  • Install an Android emulator device that is running on at least API Level 21.
  • The sample source code for the mobile app is supported only for use with an Android device and is intended to be used in conjunction with officially licensed Android development tools and further customized tools that are distributed under the terms and conditions of your licensed Android Developer Program.

Deploying the mobile app

To try the Android application using Android Emulator, complete the following steps:

  1. Clone the source code repository for the mobile app by using the following git command:

    $ git clone

  2. Open the project in Android Studio.

    If you encounter the following dialog, press 'OK'.

    Gradle Sync Dialog

  3. Edit the iota-starter-obd-android/app/java/ file, and set the defaultOrganizationId variable to your Organization's ID, and the defaultApiKey and defaultApiToken variables to your API key and Auth Token, respectively, from your instance of the IoT Platform.

  4. In Android Studio, run the application by pressing Run 'app'.

    If you use a virtual device, make sure that you use one with API level 21 or later as seen in the following dialog.

    Deployment Target

  5. To deploy the mobile app on your device, see Build and Run Your App.

Reporting defects

To report a defect with the IBM IoT Connected Vehicle Insights - Mobility Starter Application mobile app, go to the Issues section.

Privacy notice

The "IBM IoT Connected Vehicle Insights - OBDII Fleet Management App for Android" on IBM Cloud stores all of the driving data that is obtained while you use the mobile app.

Questions, comments or suggestions

For your questions, comments or suggestions to us, visit [IBM IoT Connected Vehicle Insights Application community site] (

Useful links