Contents

Description

Gravio is a node computing platform that enables anyone to build business applications from aggregated data in a low code environment. Gravio connects to various data sources by integrating with industry standards like MQTT, TensorFlow (Computer Vision), Databases (SQL etc) and many others. Users will also be able to deploy Gravio Platform at the Edge or in the Cloud depending on their requirements.

 

Milesight has already integrated with MQTT Standard and that is where we can bridge data across easily from Milesight to Gravio. With this integration, users will be able to build business processes from IoT data that is collected from Milesight sensors.


Requirements

  1. Gravio Account - Please register for a Gravio Account through our sign up page.
  2. Gravio Studio(Application) - (Download it from the App Store on MacOS/Windows)
  3. Gravio HubKit installed on your Local Machine (Windows, Mac or Ubuntu 20.04) or Cloud Instance. You can download Gravio HubKit here.
  4. Alternatively, you can follow our Getting Started Guide first before coming back to this documentation.
  5. You will also need to set up or host your own MQTT Broker first. You can use Mosquitto or HiveMQ or any of your own brokers.
  6. Milesight account to publish MQTT data.


Configuration Steps

Step 1 - Login to Milesight IoT web GUI, connect to your MQTT Broker and Publish data

You can find the detailed steps in Milesight documentation for preparing your data, connecting to a MQTT broker and Publishing. Alternatively, we will cover the brief steps here.

In Milesight web GUI, please go to Network Server > Applications > Edit button.

Click on the ‘+’ button and select MQTT as the Data Transmission type.

 

Now, there will be new fields being populated and in here, you will enter your MQTT broker credentials and if it is successful, it should say, “connected”.

 

 Note: If you have difficulties connecting to your broker, you can try enabling the TLS box for “CA Signed Certificates”. Or you could reach out to the Milesight team for help.

 

Next, we can finally Publish your data via MQTT. You will just need to scroll down and input in the text field, your desired Topic.


Once you have completed this step, please select “Save” and your data should be Publishing to your MQTT Broker.

 

Note: MQTT uplink content can be programmed as steps on How to Use Payload Codec on Milesight Gateway.

 

Step 2 - Setting Up Gravio Studio and Connecting Gravio Node

Once you have downloaded and installed Gravio Studio and Gravio HubKit (please look at the Requirements section to get links), please launch Gravio HubKit service. In your system tray you should be able to see HubKit service running.

 

 

When the service is started, please launch Gravio Studio and Login. After logging in, you can add your Gravio Node into Gravio Studio.

 

Note: Gravio nodes can be any device that has Gravio HubKit service installed and running within the same network. (Raspberry Pi, any other PC)

 

Select the ‘+’ sign and then add your Gravio node using the node’s IP address. If you are using Localhost as the Gravio node, you can add your local IP address. Then, double click and access your Gravio node.


 

Step 3 - Connecting to an MQTT Broker and Subscribing to a Topic

 

In the home page, select the “MQTT” icon to start connecting to a new broker. Press “+” in the next page and then “List” and then “+” again to start adding a new broker.



After entering your broker credentials, go back to the Setting MQTT Broker Topic Entry page in the same window by pressing the “Back button”.

 

Here we will subscribe to the topic. Give it a meaningful name and then select the broker you have connected to from the Dropdown box. Then, enter the Topic you have used Milesight web GUI to publish to. Finally, select “update”.

 

 

By this step, you should have connected to the MQTT broker successfully and also subscribed to the topic of the MQTT broker. The next step is to manage your data appropriately. To do that you will need to create an “Area” and add “Layers”.


 

 

In the pop up box, name your sensor and select “MQTT JSON” as the Layer. Then select Save.

 

Next we need to bind the ‘device’ to the software Layer. To do that, select the Layer and then find the “+” sign on the right hand side and select it.

 

You will see a pop up box with your available MQTT Topics that you have subscribed to. Select “Bind” on the Topic which is the same as the Published data from Milesight.


Ensure that the binded Layer toggle is in the “on” position.

 

You have successfully connected bridged data across from Milesight to Gravio!

 

Step 4 - Checking for Data Stream from Milesight to Gravio

 

In Gravio Studio, there is a Data Viewer tab, select it. Ensure that the “Live button” is on and you will be able to see live data streams whenever a data set is published to your MQTT broker from Milesight.

 

 

Step 5 - What’s next after Data collection?

 

 

You can now use the data that is bridged from Milesight to trigger events and build business applications. To find out more, you can reach out to the Gravio team for more help or visit YouTube channel and Blog to learn about creating Triggers and Actions.