Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 15 days 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 (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-02-20T15:39:52.000Z (over 6 years ago)
- Last Synced: 2024-10-03T22:12:24.365Z (about 1 month 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:[email protected]: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