MQTT

This chapter summarizes the MQTT feature available in ELIONA.

MQTT - The standard for IoT messaging

MQTT is an OASIS standard messaging protocol for the Internet of Things (IoT). It is designed as a lightweight publish/subscribe message transport that is ideal for connecting remote devices with low code footprint and minimal network bandwidth. MQTT is used in a wide range of industries today, such as automotive, manufacturing, telecommunications, oil and gas, etc. An MQTT broker is a server that receives all messages from the MQTT clients (publishers) and then forwards the messages to the corresponding target clients (subscribers). The broker is the heart of every publish/subscribe protocol.

MQTT Overview

In Eliona, you can click on the Connection icon in the sidebar menu to set up MQTT connections.

MQTT Overview

1. Connections: List of all created Connections/Brokers.

2. Create connection: Click to create a new connection.
3. Search connection: Click to search for connections.
4. Sort connection: Sort the connections.

5. Open Connection: Click the arrow or name to open the connections.

6. Remove Connection: Click to remove the connection.

Create Connection/Broker

After you click on , you can enter the necessary data for the connection in the following form.

MQTT Connection Configuration

1. Enable connection: Click to enable/disable the connection.
2. Test connection: Click to test the connection.
3. Remove connection: Click to remove the connection.
4. Name: Enter the name of the connection.

5. Client ID: Enter the client ID.

6. Host: Enter the host.

7. Port: Enter the port.

8. User name: Enter the login of a user.
9. Password: Enter the password of the user.
10. Connection Timeout: Time in seconds to wait for a timeout to occur.

11. Maintain connection: Time in seconds that the connection should be maintained.

12. SOCKS5 Proxy Host: Enter the host name for the SOCKS5 proxy server.

13. SOCKS5 Proxy Port: Enter the port for the SOCKS5 proxy server.

14. Proxy Login: Enter the login for the proxy server.

15. Proxy Password: Enter the password of the proxy login.

16. Save: Click the Save button to keep the changes.

17. Connection Status: Here you can see whether the connection is enabled or disabled.

18. Documentation: Click to access this documentation.
19. Subscriptions list: List of existing subscriptions.
20. Create subscriptions: Click to create a new subscription.
21. Remove Subscription: Click to remove the subscription.
22. Configure Subscription: Click > to configure the subscription.
23. Publication List: List of existing publications.
24. Create publication: Click to create a new publication.
25. Remove publication: Click to remove the publication.
26. Configure publication: Click > to configure the publication.

Subscription

After the broker has been set up, any number of target clients can be connected, e.g. a mobile device. Subscriptions must be set up for this.

Subscription Configuration

1. Activate subscription: Click to enable/disable the subscription.
2. Remove Subscription: Click to remove the subscription.
3. MQTT Explorer: Select a file in the file structure to get the path of the file.

4. Documentation: Click to access this documentation.
5. Name: Enter the name of the subscription.

6. Topic: Enter the topic of the subscription.

7. QoS: Select QoS.

8. Single/Multiple Formats: Select single or multiple formats.
9. Create Format: Click to create a new format.
10. Configure pair: How should the messages received with this subscription be decoded? Single: Each message will be decoded according to a selected format. Multiple: Define any number of "pattern - format" pairs. This option is available only for subscriptions with topics containing a wildcard (+ and/or #). It allows messages to be forwarded to different formats based on the actual topic in which the message was received. For example, if you subscribe to the topic "building/storey/level_one/#" and there are messages from different sensors with different payload layouts under the "#" placeholder, you can forward them as follows: 'building/storey/level_one/ambi*' → format01, 'building/storey/level_one/hum*' →. Format02, etc.
11. Add pair: Click to create a new pair.
12. Save: Click the Save button to keep the changes.

Publication

Publikation Configuration

1. Test publication: Click to test the publication.
2. Remove publication: Click to remove the publication.
3. Name: Enter the name of the subscription.

4. Topic: Enter the topic of the subscription.

5. QoS: Select QoS.

6. Select Format: Select a format.
7. Create Format: Click to create a new format.
8. Save: Click the Save button to keep the changes.

9. Documentation: Click to access this documentation.