Skip to main content

Lemonbeat Connector

Support
  • Updated

You can use the Lemonbeat Connector to retrieve data from devices connected through the Lemonbeat IoT Platform.

System Architecture

The Lemonbeat Connector is based on a specific micro-service letting Servitly to communicate with the AMQP server, the endpoint where IoT data are initially collected.

Lemonbeat Architecture

Periodically (every 5 minutes) through the API, the connector retrieves from each customer the AMQP connection information.

In this way, the connector verifies the presence of new connections to be established with an AMQP server or invalid ones to be evicted.

This means that when a new customer is created within Servitly or a Lemonbeat Connector configuration is updated (e.g. expired certificate), IoT data may take at most 5 minutes to be read and displayed within the dashboards.

 

Data Listening

Here is described the data flow from the remote device to Servitly.

  1. A device data is published to the AMQP server.

  2. An LsDl message is notified to the Lemonbeat Connector.

  3. The LsDl message is parsed and converted to the Servitly standard JSON format, using the field names as metric names.

  4. The transformed message is forwarded to Servitly by using the standard MQTT channel and the device UUID and topic part.

 

Data Publishing

Here is described the data flow from Servitly to the remote device.

  1. A user changes a configuration parameter or executes a command from the dashboard.

  2. A message is published on the MQTT channel and made available to the Lemonbeat Connector.

  3. An LsBl message is created encapsulating the data.

  4. The LsBl message is sent to the Lemonbeat backend through the REST API and finally dispatched to the remote device.

Plugin Configuration

First of all, the Lemonbeat plugin must be enabled by entering the Administration / Plugins page.

 

Lemonbeat Plugin
Optionally the plugin allows defining the back-end endpoint and credentials which can be used to manage Automation. If automation has been configured, the connector automatically performs:
  • Location information pushing from Servitly to the Lemonbeat platform. This allows technicians to have an updated list of locations when configuring a new building. 

Connector Configuration

Once enabled, on the tenant level or for each customer, it is possible to configure the Lemonbeat Connector.

 

Lemonbeat Configuration

 

The connector configuration requires to provide:

 

  • broker endpoints and credentials for listening to device IoT data.

  • backend credentials for performing REST API requests.

  • certificates for client authentication and secure channel establishment.

 

Related articles

Comments

0 comments

Please sign in to leave a comment.