The goal of this recipe is to get you started integrating your SmartMesh IP network into HiveMQ. After following these steps, you will be able to explore all the possibilities HiveMQ offers.

Overview

In this recipe, we show you atomic integration examples between your SmartMesh IP network and MQTT, enough to get you started on more complete integration for your application.

Tutorials

Publish Temperature to HiveMQ

We start with the most straightforward use case of HiveMQ: (sensor) data publishing.

Here is what the system you will build does:

1. a SmartMesh IP mote generates some (sensor) data
2. the mote sends it, through the SmartMesh IP mesh network, to the manager
3. the manager publishes the data through its serial port, as a data notification
4. this data notification is received by the JsonServer application (part of the SmartMesh SDK)
5. JsonServer sends it to a local instance of Node-RED
6. Node-RED publishes it to a HiveMQ broker, on topic "dustcloud/temperature"
7. anybody in the world who is connected to the same broker - and subscribed to that topic - gets a notification

In a nutshell, add publish/subscribe capabilities to your SmartMesh IP network in a couple of clicks!

Connect to the HiveMQ WebSocket Client

• Point your browser to http://www.hivemq.com/demos/websocket-client/
• Leave all the fields untouched, and click "Connect"

Subscribe to the dustcloud Topic

On the right-hand side, add a new subscription to the "dustcloud/temperature" topic.

Prepare your SmartMesh IP network

• Switch on your SmartMesh IP manager and motes

  We assume all SmartMesh IP motes are running the default firmware in master mode, and publish temperature data every 30 seconds.

• Start the SmartMesh IP JsonServer application and Node-RED, and connect the JsonServer application to your SmartMesh IP manager's serial API port.

  See the SmartMesh IP and Node-RED, revisited recipe to see how to do that.

Publish Temperature to HiveMQ

Almost there, this is the last step!

All we need to do is create a Node-RED flow which:

• listens for an HTTP POST request to URL /oap to receive the OAP notifications form the JsonServer
• filters temperature notifications, and extracts:
  • the MAC address of the mote publishing
  • the temperature
• publishes that information to the HiveMQ demo MQTT broker

This is what the resulting Node-RED flow looks like:

You can now see the notifications on any MQTT client in the world which is connected to this broker and subscribed to the "dustcloud" topic:

Actuate LEDs from the Cloud

Your SmartMesh IP mote can interface to virtually any sensor and actuator through analog and digital interfaces. The default firmware which is pre-loaded allows you to emulate this by doing the simplest remote actuation: setting an LED.

The TempMonitor sample application (part of the SmartMesh SDK) allows you to actuate a mote's LED from the manager. In this section, we take it one step further, and allow your to actuate and LED from the cloud!

Setup

We use the exact same setup as before, all we will do is change the Node-RED flow.

Subscribe to the "dustcloud/led" topic on HiveMQ

All we need to do is create a Node-RED flow which:

• connects to the HiveMQ demo MQTT broker and subscribes to the "dustcloud/led" topic
• when receiving a notification, issues the appropriate HTTP request to the JsonServer

This is what the resulting Node-RED flow looks like:

Actuate your mote's LED from anywhere in the world!

On your HiveMQ websocket client, publish the following message to the "dustcloud/led" topic

{
    "mac":   "00-17-0d-00-00-38-07-18",
    "value": 1
}

Set value to "1" to switch the LED on, set to "0" to switch it off.

Tada, the LED changes state!

Discussion

This recipe doesn't even scratch the surface of what HiveMQ and MQTT allow you to do.

Things you can build now:

• create a "control loop", where the data sent by one mote triggers an actuation on a different mote
• connect multiple SmartMesh IP networks logically together by having them publish/subscribe to the same HiveMQ broker
• use HiveMQ's websocket feature to include notifications directly into your web pages
• plug in analytics, databases, visualization tools, etc. to the MQTT broker to build a complete solution
• etc.

Some links for your further exploration.

• MQTT: http://mqtt.org/
• Details about the performance HiveMQ's solution: http://www.hivemq.com/benchmarks
• HiveMQ's clustering solution: http://www.hivemq.com/clustering-hivemq-paper/
• Integrate HiveMQ datastreams into your webpage using websockets: http://www.hivemq.com/docs/hivemq/latest/#websockets-chapter
• HiveMQ plugins: http://www.hivemq.com/extensions/plugins/