Advertisement

Quick Links

OPTIMA MQTT Module Manual .
1
MQTT Module Manual
Version 3.0.0
REV01-20230221

Advertisement

Table of Contents
loading

Summary of Contents for Divus OPTIMA KNX MQTT Module

  • Page 1 OPTIMA MQTT Module Manual . MQTT Module Manual Version 3.0.0 REV01-20230221...
  • Page 2 OPTIMA MQTT Module Manual . GENERAL INFORMATION DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) - Italy Operating instructions, manuals and software are protected by copyright. All rights are reserved. Copying, multi- plication, translation and conversion, either partially or as a whole, is not permitted. You are allowed to make a single copy for backup purposes.
  • Page 3: Table Of Contents

    OPTIMA MQTT Module Manual . INDEX: OVERVIEW ____________________________________________________________________________________ 4 FOREWORD ________________________________________________________________________________ 4 PURPOSE OF THIS DOCUMENT _______________________________________________________________ 5 PREREAUISITES _____________________________________________________________________________ 6 MQTT BROKER _________________________________________________________________________________ 7 FOREWORD ________________________________________________________________________________ 7 BROKER-EINSTELLUNGEN____________________________________________________________________ 7 USERS _____________________________________________________________________________________ 8 MQTT CLIENT __________________________________________________________________________________ 9 FOREWORD ________________________________________________________________________________ 9 NEW CONNECTION_________________________________________________________________________ 10 ASSOCIATION OF OBJECTS _________________________________________________________________ 12 INTERNAL CONNECTION ____________________________________________________________________ 13...
  • Page 4: Overview

    FOREWORD DIVUS KNX SERVER can connect as a client to one or more MQTT brokers to publish them and receive data in real time. This function is useful for interacting with devices or systems running on cloud services other than those of DIVUS.
  • Page 5: Purpose Of This Document

    OPTIMA MQTT Module Manual . This prerogative can also be used to allow two or more KNX SERVERs to communicate with each other as shown in the following diagram: PURPOSE OF THIS DOCUMENT This manual contains all necessary information to activate and configure the MQTT broker integrated in KNX SERVER;...
  • Page 6: Prereauisites

    OPTIMA MQTT Module Manual . PREREQUISITES To integrate a KNX SERVER with one or more MQTT brokers, you must have the following • A KNX SERVER 3 that has been updated to version 3.0.0 or higher. To use the integrated MQTT broker on the device, you need: •...
  • Page 7: Mqtt Broker

    OPTIMA MQTT Module Manual . MQTT Broker FOREWORD The KNX SERVER 3 offers an MQTT broker, which can be used to connect not only the web server itself, but also third-party devices that support this protocol or other KNX SERVERs, provided they are located in the same LAN. This chapter explains how to set up the integrated MQTT broker of the KNX SERVER;...
  • Page 8: Users

    OPTIMA MQTT Module Manual . USERS If authentication is enabled, a user must be set up for each client device that is to connect to the Broker. You must also prepare login information for the KNX SERVER itself when it connects to your Broker, as described in more detail in the following chapter.
  • Page 9: Mqtt Client

    OPTIMA MQTT Module Manual . MQTT Client FOREWORD KNX SERVER allows the connection to more than one MQTT broker at the same time; it is advisable to keep the number of such connections as low as possible in order not to overload the system resources. One or more objects can be assigned to each MQTT connection: •...
  • Page 10: New Connection

    OPTIMA MQTT Module Manual . Conversely, when the KNX SERVER receives a value in the command topic, it executes it as a command for objects: In both cases, KNX SERVER expects numeric values to be exchanged via Topics, using the dot as decimal separator (if they are not integer values);...
  • Page 11 OPTIMA MQTT Module Manual . Enter the following information: NAME Identifies the connection within the project Specify "Use external broker" to connect to a service on the Internet or to another device on the LAN. BROKER SOURCE Otherwise, select "Use integrated broker " to connect to the internal broker of the KNX SERVER (see next section for details).
  • Page 12: Association Of Objects

    OPTIMA MQTT Module Manual . Enable if the service requires authentication AUTHENTICATION Access data of the service USERNAME PASSWORD Time interval in seconds for the anti-echo function. The default value is set to 10 seconds. Normally it is not necessary to adjust this parameter. ECHO TIMEOUT When all the data has been entered, press START to start communicating with the broker;...
  • Page 13: Internal Connection

    OPTIMA MQTT Module Manual . Before performing a test with the KNX SERVER, you should check the correct configuration and functionality of the broker. For this purpose, other known devices can be used or two instances of a test MQTT client software can be used, which write and receive each other on command and report topics.
  • Page 14: M2M Connection

    OPTIMA MQTT Module Manual . M2M CONNECTION It is possible to use the MQTT protocol to realise a bidirectional machine-to-machine communication between several KNX Servers as long as they are all connected to the same network. It must first be determined which KNX SERVER is to act as the "master" and the integrated MQTT broker must be activated on it.
  • Page 15 OPTIMA MQTT Module Manual . In other words, the topics must be crossed between the object to be commanded and the synchronised object on the other KNX-SERVER, as shown in the figure.
  • Page 16: Notes

    OPTIMA MQTT Module Manual . NOTES...
  • Page 17 OPTIMA MQTT Module Manual .

Table of Contents