WISE-75xx provides the MQTT Client function. It allows WISE-75xx to publish I/O channel status to the specified Broker, and automatically subscribe the topics to control the output channels and internal registers from MQTT messages. The configuration page for MQTT Setting is shown as below:

Follow the following steps:

1. Select “Enable” in the “Function Status” field to enable the MQTT function.

2. Enter the Broker IP address (or domain name) in the “Address” field.

3. Enter the Broker Port number in the “Port” field.

4. The value in “Keep Alive Time” field defines the maximum time that should pass without communication between the WISE-75xx and the Broker.

5. The value in “Periodical Publish Interval” field defines the time interval which all Publish Topics with the “Periodical Publish” attribute will be sent automatically periodically. If the value of the “Periodical Publish Interval” field is 0, it means to disable the “Periodical Publish” operation. The unit of the value is second.

6. In the “Digital Value” field, users can specify that the message content of digital channel values are published as OFF/ON or 0/1.

7. In the “QoS” field, users can specify the QoS(Quality of Service) for publish and subscription.

8. If the Broker requires account and password validation, please select the “Authentication” checkbox, and enter the login ID and password in the “ID” and “Password” fields to login into the Broker. If the Broker doesn’t need account and password validation, uncheck the “Authentication” checkbox and go directly to next step.

9. Click the “Last Will” checkbox will let the Broker to send the alarm Topic to others MQTT client devices when WISE-75xx is in Network disconnection status with the Broker. After click the “Last Will” checkbox, user has to complete the setting of Last Will Topic and Message content.

10. The table in the lower half area of the MQTT Setting Page is about the Publish Topic setting. Users can edit the topic string and publish timing of all I/O channels and enabled Internal Registers. Users can also select “User-Defined” tag in the table to edit the Publish Topic and its binding message by the free style editing interface. Click “Add Message” to create a new User-Defined topic, and click the “X” button in front of the message to remove it. The user interface is shown as below.



11. Edit the topics of all messages in the “Topic” field. Besides “User-defined” Topic, a Prefix will be added in front of all topics. Users can edit the Prefix at will, or press the buttons “Use Model Name”, “Use Model Name + IP”, and “Use Model Name + MAC” to use the default Prefixes. Press the “Preview” button to check the complete Topics.

12. There are two options as “Periodical” and “Change” in the “Publish Timing” field for the timing to publish topic. If user selects “Enable” in the “Periodical” field, it means the topic will be published at periodic time schedule base on the value in “Periodical Publish Interval” field at Step v. If user selects “Enable” in the “Change” field, it means user has to enter the difference value in the “Difference” field, and the system will automatically publish the topic when the I/O channel value change takes place and it is exceeds the difference value (The Change option is not supported in the “User-Defined” message). WISE-75xx can also publish a MQTT Topic to the Broker when an IF event is triggered.

13. After all MQTT settings are completed, click “Save” button to save the changes.

The MQTT setting page is shown as below:

The settings steps are as below:

1. Click the “Broker Setting” tab on the right-top corner of “MQTT Setting Page”.

2. Click on “Add new MQTT Broker” to add the new MQTT Broker. After clicking the “Add new MQTT Broker”, the MQTT Broker Setting Page will appear. The upper half area of the setting page is about the Broker parameters setting. It will be shown as below:



3. In the Broker parameters setting page, you can input the name of the Broker in the “Nickname” field and you could also input the description of this Broker in the “Description” field.

4. Check “Enable” or “Disable” in the “Initial Status” field to enable the initial connection status with the Broker. If the user clicks “Enable”, it means the WISE-284x / WISE-52xx / WISE-224x will start the communication with the Broker after it is powered on.

5. Enter the Broker IP address (or domain name) in the “Address” field.

6. Enter the Broker Port number in the “Port” field.

7. If the Broker requires account and password validation, please select the “Enable” checkbox in the “Authentication” field, and enter the login ID and password in the “ID” and “Password” fields to login into the Broker. If the Broker doesn’t need account and password validation, uncheck the “Enable” checkbox and go directly to next step.

8. Enter the Client ID information in the “Client ID” field. The Client ID is used for Broker to verify if the MQTT Client is allowed to connect to the Broker or not. If the Broker does not require Client ID for the connection, this field can be ignored.

9. If the SSL/TLS encryption mechanism is required for the connection between the Broker and the WISE-284x / WISE-52xx / WISE-224x via MQTT, click the “Enable” checkbox of the “Encryption” field to enable this function.

10. The value in “keep alive Time” field defines the maximum time that should pass without communication between the WISE-284x / WISE-52xx / WISE-224x and the Broker. The WISE-284x / WISE-52xx / WISE-224x will ensure that at least one message travels across the network within each keep alive period. In the absence of a data-related message during the time period, the WISE-284x / WISE-52xx / WISE-224x sends a very small MQTT “ping” message, which the Broker will acknowledge. The keep “alive interval” enables the WISE-284x / WISE-52xx / WISE-224x to detect when the Broker is no longer available without having to wait for the long TCP/IP timeout. The unit of the value is second.

11. To verify whether your Broker setting is correct, click “Testing” in the “Connection Test” section, then WISE-284x / WISE-52xx / WISE-224x will try to connect to the Broker and reply the connection status.

12. Click the “Enable” checkbox in the “Last Will” field to allow the Broker to send the alarm Topic to other MQTT client devices when WISE-284x / WISE-52xx / WISE-224x lost connection to the Broker. After clicking the “Enable” checkbox, the setting of Last Will Topic, Message content and QoS will be brought up.



13. The value in “Periodical Publish Interval” field defines the time interval (in second) to send all Publish Topics with the “Periodical Publish” attribute automatically and periodically. If the value of the “Periodical Publish Interval” field is 0, it means the “Periodical Publish” operation is disabled.

14. The “Topic Prefix” field is for setting up a string as Topic Prefix. The prefix can be used in the Publish Topic or Subscribe Topic to simply the Topic editing. The default string of the “Topic Prefix” will be the model name of the WISE-284x / WISE-52xx / WISE-224x. If there are more than one WISE-284x / WISE-52xx / WISE-224x controllers in a system for MQTT connection, please remember to change the “Topic Prefix” setting to distinguish the Publish Topic/Subscribe Topic setting of each WISE-284x / WISE-52xx / WISE-224x controllers.

15. The lower half area of the MQTT Broker Setting Page is for the Publish Message and Subscribe Topic setting. User can click the “Publish” tab or “Subscribe” tab on the right-top corner of “Publish & Subscribe Setting” to edit the Publish Message and Subscribe Topic. The Interface will be shown as below:



16. Click the “Publish” tab to edit the Publish Message. Click on “Add new Publish Message” to add a new Publish Message. The Interface will be shown as below:



17. Input a name in the “Nickname” field and you could also input the description of this Publish Message in the “Description” field.

18. In the “Message Type” field, select the “Channel Data” to prepare a Publish Message with the I/O channel value. Based on the “Channel Data” interface, user can select a specific I/O channel value or “All” I/O channel value for the Publish Message. If the user selects a specific I/O channel, it means the I/O channel value will be bound with the Publish Message. If the user select “All” I/O channels, it mean all I/O channel values will be added into the Publish Message List. After completing the “Channel Data” setting, the system will automatically generate the default Topic content in the “Topic” field. User can modify the content of the “Topic” field if require. If the “Use Prefix” checkbox is enabled, the string in the “Topic Prefix” field will be used as the prefix of the Publish Topic.



The user can select “User-Defined Data” in “Message Type” field to edit the Publish Topic and its binding message on the free style editing interface. The user interface is shown as below.



19. In the “QoS” field, user can select 0, 1, 2 for the QoS(Quality of Service) setting for the Publish Message.

20. In the “Retain” field, user can click the “Enable” checkbox to keep the Publish Message in the Broker.

21. The timing to publish message is set in the “Auto Publish” field, there are two options: “When the I/O channel data changed and the variation exceeds xxx” and “Periodical Publish”. If the “When the I/O channel data changed and the variation exceeds xxx” is selected, the system will automatically publish the topic when the I/O channel value is changed and exceeds the evaluation value (This option only support “Channel Data” setting in “Message Type”). If user selects “Periodical Publish”, it mean the topic will be published at periodic time schedule base on the value in “Periodical Publish Interval” field.

22. After completing all settings of Publish Topic, please click “OK” button to add the Publish Topic to the Publish Message List.

23. Click the “Subscribe” tab to edit the Subscribe Topic. The user interface is shown as below.



24. Click on “Add new Subscribe Topic” to add a new Subscribe Topic. The Interface will be shown as below:



25. Input a name of the Subscribe Topic in the “Nickname” field, and you could also input the description of this Subscribe Topic in the “Description” field. In the “Topic” field, user can input the content of the Subscribe Topic. After completing all settings of Subscribe Topic, please click “Add” button to add the Subscribe Topic to the Subscribe Topic List.

The value of the Subscribe Topic can be used in the IF-THEN-ELSE logic evaluation, and also be recorded in the MQTT Data Logger. In addition, all Internal Registers and the I/O modules connected to WISE-284x / WISE-52xx / WISE-224x have their own default definition of Subscribe Topic. It allows user to change the value of the Internal Register and the value of the output channel of I/O module by MQTT protocol.

26. After completing all settings of the Broker, please click “OK” button to return to add the MQTT Setting Page. And then click “Save” button to save all MQTT Broker settings.