Expose Eclipse Hono devices as MsgFlo participants
CoffeeScript JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
src
.gitignore
README.md
package.json

README.md

Eclipse Hono connector for MsgFlo

This tool discovers devices on an Eclipse Hono service and makes them participants in a MsgFlo network.

With MsgFlo you can easily connect any Hono-enabled sensors to any arbitrary data processing functionality, be it a NoFlo graph, a Rust or Python program, or a MsgFlo-connected IoT actuator.

For example, here is a Bosch XDK talking to a NoFlo graph, with Flowhub IDE showing the live data flowing through:

XDK in MsgFlo

Installation

You need access to a Hono installation, and a MsgFlo-compatible message queue. You also need Node.js. Install the Hono MsgFlo connector with:

$ npm install -g msgflo-hono

Running

The msgflo-hono tool accepts the following arguments:

  • hono: URL (including authentication) to a Hono instance
  • msgflo: MsgFlo message broker URL
  • tenant: Hono tenant identifier
  • filter: (optional) filter for device identifiers to expose

Example:

$ msgflo-hono --hono amqp://username:password@hono.bosch-iot-suite.com:15672 --msgflo mqtt://localhost --tenant bcx --filter xdk

Working principle

What this tool does is:

  • Subscribe to Hono telemetry information
  • Collect telemetry and produce device information based on the telemetry data
  • Register discovered devices as MsgFlo foreign participants
  • Forward telemetry from Hono to the MsgFlo network