Difference between revisions of "MQTTBroker Utility"

From HSYCO
Jump to navigation Jump to search
 
(9 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|Devices discovery]]
+
[[File:MQTTBROKER_Util_discovery.png|border|600px|center|Clients discovery]]
  
  
From the list, click on each device to add, edit and save its configuration.
+
From the list, click on each client to add, edit and save its configuration.
  
[[File:LoRaWAN_Util_dev_config.png|thumb|400px|Device configuration]]
+
[[File:MQTTBROKER_Util_config.png|thumb|400px|Client configuration]]
  
 
'''Parameters''':
 
'''Parameters''':
  
*'''ID''': the ID to assign to the related datapoints of the LoRaWAN I/O Server (i.e. "dev.<id>.*"). The default value corresponds to the device address.
+
*'''ID''': the ID to assign to the client. It cannot be empty. The default value corresponds to the IP address of the client
*'''Address''': Device address, 4 bytes, hexadecimal format (e.g. 01aac0)
+
*'''Username''': client's username
*'''Class''': Device class: A and C are supported
+
*'''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.