Difference between revisions of "MQTTBroker Utility"

From HSYCO
Jump to navigation Jump to search
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
[[Category:Manager]]
 
[[Category:Manager]]
The MQTTBroker Utility application provides a graphical interface to configure a [[MQTTBROKER | MQTTBROKER I/O Server]]. When a MQTTBROKER I/O Server is defined in HSYCO, the MQTTBroker Utility will appear among the applications of the manager.
+
The MQTTBroker Utility application provides a user interface to configure a [[MQTTBROKER | MQTTBROKER I/O Server]]. When a MQTTBROKER I/O Server is defined in HSYCO, the MQTTBroker Utility will appear among the applications of the manager.
  
To configure the MQTT clients to be used with HSYCO, enable auto-discovery ("Auto-discovery" checkbox).
+
To configure MQTT clients to be used with HSYCO, enable auto-discovery ("Auto-discovery" checkbox).
 
MQTT clients transmitting will appear in the list:
 
MQTT clients transmitting will appear in the list:
 +
 +
 +
[[File:MQTTBROKER_Util_discovery.png|border|600px|center|Clients discovery]]
 +
 +
 +
From the list, click on each client to add, edit and save its configuration.
 +
 +
[[File:MQTTBROKER_Util_config.png|thumb|400px|Client configuration]]
 +
 +
'''Parameters''':
 +
 +
*'''ID''': the ID to assign to the client. It cannot be empty. The default value corresponds to the IP address of the client
 +
*'''Username''': client's username
 +
*'''Password''': client's password
 +
 +
 +
To manually add a device click on the "+" button at the bottom-left corner of the page.
 +
 +
To remove a device, click on it from the list, click on "Delete" and confirm. If the auto-discovery is enabled, the device will reappear upon the next received frame from it.
 +
 +
Disable the auto-discovery when all the required devices have been configured.
 +
 +
The devices list shows the following fields:
 +
* '''ID''': ID of the device
 +
* '''Online''': connection status of the client with the MQTT broker
 +
* '''Last seen''': date and time of the last received valid frame
  
 
== Committing the configuration ==
 
== Committing the configuration ==
When all clients are configured (not greyed-out in the lists), click on the "Commit" button on the top-right corner of the main page. The configuration will be persisted and the MQTTBroker I/O Server will restart with the new configuration.
+
When all clients are configured, click on the "Commit" button on the top-right corner of the main page. The configuration will be persisted and the MQTTBroker I/O Server will restart with the new configuration.

Latest revision as of 15:47, 1 October 2021

The MQTTBroker Utility application provides a user interface to configure a MQTTBROKER I/O Server. When a MQTTBROKER I/O Server is defined in HSYCO, the MQTTBroker Utility will appear among the applications of the manager.

To configure MQTT clients to be used with HSYCO, enable auto-discovery ("Auto-discovery" checkbox). MQTT clients transmitting will appear in the list:


Clients discovery


From the list, click on each client to add, edit and save its configuration.

Client configuration

Parameters:

  • ID: the ID to assign to the client. It cannot be empty. The default value corresponds to the IP address of the client
  • Username: client's username
  • Password: client's password


To manually add a device click on the "+" button at the bottom-left corner of the page.

To remove a device, click on it from the list, click on "Delete" and confirm. If the auto-discovery is enabled, the device will reappear upon the next received frame from it.

Disable the auto-discovery when all the required devices have been configured.

The devices list shows the following fields:

  • ID: ID of the device
  • Online: connection status of the client with the MQTT broker
  • Last seen: date and time of the last received valid frame

Committing the configuration

When all clients are configured, click on the "Commit" button on the top-right corner of the main page. The configuration will be persisted and the MQTTBroker I/O Server will restart with the new configuration.