How To Guide: Mnubo Connector Plugin

 

June 01, 2016  |  By Dale Rankine

The Mnubo Connector Plugin is now available in the Reekoh Plugin Store and ready to be installed in your instance.

 
This plugin enables your registered devices in Reekoh to integrate with Mnubo Objects & Events. We’ll show you how to use this plugin in the guide below.
 
To start off, log in to your Reekoh account and then navigate to Devices > Register New Device. Complete the form that comes next. You can also use any existing registered device in Reekoh, if you have one.
 
N1
 
After registering your device, install the plugins you will be using: Mnubo Connector and MQTT Gateway (this will enable you to ingest device data via MQTT protocol). Locate these plugins in the Plugin Store, and then install them to your instance.
 
N1
 
Then, create your topology by navigating to Topologies > Build New Topology. Complete the form that comes next.
 
N1
 
Once you’ve created your topology, configure your installed plugins. Look for the category of your plugin in your topology; for example, the Mnubo plugin should be configured under the Connector category. Click Configure New, and then complete the form that follows.
 
N1
 
N1
 
Upon reaching the Configure Plugin page, you will be required to provide the Client ID and Secret of your Mnubo instance. To get these details, log in to your Mnubo account and then go to Sandbox > Security. Select the client id and secret from the list of scopes available.
 
N1
 
Go back to the Configure Plugin page to continue with completing the form. Paste the details in their respective fields, and then select Sandbox as your Environment.
 
N1
 
After you’ve configured both plugins, you should be able to see them in your topology.
 
N1
 
Next, specify the attributes of the data you’ll be sending in Mnubo. Go back to the platform and navigate to Admin > Data Modeler > TimeSeries, and then click the Add Timeseries button. Complete the form that follows.
 
N1
 
Make sure that the attributes you indicate here are similar with the data you’ll be sending in Mnubo. For example, if your device data is {“time”:”2015-11-11T08:38:11+00:00″, “temp”: 37}, then your specified attributes should be time and temp.
 
In this example, the attribute we’ve specified is temp since the data we’ll be sending is {“temp”:37}.
 
N1
 
You should be able to see the added attribute in the Timeseries list.
 
N1
 
After you’re done adding your attribute, download or install any MQTT simulator from the Chrome Web Store to be able to send device data to the Mnubo platform. We’ll be using MQTTLens for this example. Open the application, and then create a connection for your device by completing the form that comes next.
 
N1
 
N1
 
Once a connection has been established, enter or paste your JSON device data in the Message field; then supply any Topic for your data. Click Publish to send it to the Mnubo platform.
 
N1
 
To check if your data has been received, you need to create a chart in Mnubo by going to Sandbox > Analytics > On Demand. Fill out the form that comes next with the following details (refer to the highlighted fields in the image below).
 
N1
 
Click Run. You should be able to see the data you’ve sent in the generated chart at the bottom of the page.
N1
 
You can check out our Basic Starter guide in the Reekoh Help Center for more info.