SiteWhere Android SDK
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

![SiteWhere] (

SiteWhere Android SDK

This software development kit allows Android devices to interact with SiteWhere. By default, the MQTT protocol is used to create a persistent connection between the application and a SiteWhere instance. Devices can register with the system, publish events using the provided API and receive commands which can be used to execute code on the device.

Developer Setup


Step 1. Clone this repository.

Step 2. Create a new Project.

Step 3. Add the following to the settings.gradle file:

include ':sitewhere-android-sdk'
project(':sitewhere-android-sdk').projectDir = new File('../sitewhere-android-sdk') // <- points to the 'sitewhere-android-sdk' folder inside local repository cloned in Step 1 

Step 4. Select "Open Module Settings" and add module "sitewhere-android-sdk" in the Dependencies tab.

Sample Application

The sample app can be found in the SiteWhereExample folder. The app demostrates how an Android device can be an IoT gateway and/or client device for SiteWhere. As an IoT gateway you can register an Android device with SiteWhere and send location and measurement events. As an IoT client you can register to have events pushed in real-time to an Android device. Configuring what events get pushed to a specific device is done using server side filters and groovy scripts. The sample app uses the device's current location and accelerometer.


Join the discussion -!forum/sitewhere