https://github.com/msgflo/msgflo-hono
Expose Eclipse Hono devices as MsgFlo participants
https://github.com/msgflo/msgflo-hono
hono iot iot-middleware msgflo
Last synced: 11 months ago
JSON representation
Expose Eclipse Hono devices as MsgFlo participants
- Host: GitHub
- URL: https://github.com/msgflo/msgflo-hono
- Owner: msgflo
- Created: 2017-03-15T08:57:10.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-02-20T15:39:52.000Z (almost 8 years ago)
- Last Synced: 2025-03-06T15:41:13.694Z (11 months ago)
- Topics: hono, iot, iot-middleware, msgflo
- Language: CoffeeScript
- Size: 7.81 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Eclipse Hono connector for MsgFlo
=================================
This tool discovers devices on an [Eclipse Hono](http://www.eclipse.org/hono/) service and makes them participants in a [MsgFlo](https://msgflo.org/) network.
With MsgFlo you can easily connect any Hono-enabled sensors to any arbitrary data processing functionality, be it a [NoFlo](https://noflojs.org) graph, a Rust or Python program, or a MsgFlo-connected IoT actuator.
For example, here is a [Bosch XDK](https://xdk.bosch-connectivity.com/) talking to a NoFlo graph, with [Flowhub IDE](https://flowhub.io) 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:
```bash
$ 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:
```bash
$ 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](https://msgflo.org/docs/foreign/)
* Forward telemetry from Hono to the MsgFlo network