Eclipse Hono provides uniform (remote) service interfaces for connecting large numbers of IoT devices to a (cloud) back end. It specifically supports scalable and secure data ingestion (telemetry data) as well as command & control type message exchange patterns and provides interfaces for provisioning & managing device identity and access control rules.

Getting started

Prerequisites

You will need to have access to a Docker daemon in order to build from sources and/or to run the pre-built Docker images we provide via Docker Hub. Please follow the instructions on the Docker web site in order to install Docker Engine on your platform. Running Hono will be a lot easier if you install the Docker Compose client as well because you can then startup and manage all components of a Hono installation as a whole.

Compiling from Source

If you do not already have a working Maven installation on your system please follow the installation instructions on the Maven home page. Then simply run the following from the command line.

$ mvn clean install -Pbuild-docker-image

This will build all libraries, docker images and example code.

Run the Demo Application

Please refer to Hono Example for details on how to run the demo application.

Using Hono

Please take a look at the example clients which illustrate how client code can interact with Hono to send and receive data.

Remote API

Clients can interact with Hono by means of AMQP 1.0 based message exchanges. Please refer to the corresponding Wiki pages for details:

• Device Registration API for registering new devices so that they can connect to Hono.
• Telemetry API for sending and receiving downstream telemetry data.
• Command & Control API for sending commands to devices and receiving replies.

Modules

• client: a Java client for accessing Hono based on vertx-proton
• adapters: implementation of core protocol adapters
  • rest-vertx: an HTTP protocol adapter exposing a RESTful API for Hono's Telemetry and Registration API
  • rest-mqtt: an MQTT protocol adapter exposing Hono's Telementry API as a topic to publish to
• example: simple example that uses the hono-client to send and receive messages via the hono-server
• server: the Hono server component exposing the Hono API via AMQP 1.0

Get in Touch

Please check out the Hono project home page for details. We are also available on #eclipse-hono IRC channel on Freenode and Hono Dev mailing list.

Build status

• 
• Hudson Build Status