Get started

UniShare application allows user to pass data from mobile device to Pachube. Before using the application should be configured. Configuration involves defining Pachube recieving feed, Pachube API access key, period of updates and data source on the device.

Step 1. Pachube registration.

UniShare as a Pachube application requires account on Pachube. There are different types of free and paid accounts. UniShare is working with any of them. If you have already registered on Pachube just skip this step.

Step 2. Feed creation.

Pachube Feed (Environment) will be used for storing a particular context-specific collection of measured data. For instance, you may create a Feed called “My car” which will store the geolocation, mileage and other sort of data of that particular car. Each feed should have one or more datastream under a particular feed. Each datastream represents a single device or sensor that can push data to Pachube. A datastream has a unique ID within the Feed. You should define “tag(s)” for their data that helps to identify datastreams later in the application. Going back to the previous example of “My car” feed, the user can create two datastreams for longitude, latitude and mileage. More about Pachube Feeds you can find in User Manual.

Step 3. UniShare web installation.

UniShare also needs to be installed as a web-based application on Pachube AppStore. This will provide you with necessary data for the applicaiton configuration. Log-in to the AppStore with you account credentials and find UniShare Feed Authentication. Select a feed where you want to stream your data and install the application. Application should show you feed ID and API key information.

Step 4. Mobile application configuration.
Add Stream Screen

Firstly, UniShare should be able to connect to Pachube Feed. Go to “Add stream” screen and put there information from UniShare Feed Authentication web-application.

  • Name: any name you would like to see on “Streams” screen.
  • Feed ID: feed ID from web application.
  • API key: the key from web application.
  • Update period: select update period of the feed.

For convenience, you can open web application again in mobile browser and copy/paste feed data.

Now you can see newly created stream on “Streams” screen. Click on it to see more detailed information. On stream overview screen you can see basic configuration data, streaming status and substreams’ list based on datastreams in the feed. Do not forget to turn stream on before usage.

Stream Overview Screen

Secondly, UniShare should undestand what data and where to put. For these reasons you should configure substreams. Blue icon of a substream means that it is configured to stream data to it.

To configure a substream click on its name on stream overview screen. Clicking on configured substream will allow you to edit it. On “Add Substreams” screen you are able to choose datastream/receiver and device sensor/data source.

Finally, to make application work it should be put into background. Just click on hardware button and it will start to stream data from your device to Pachube.