msgflo-hono v0.2.0

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:

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