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.
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.
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;...
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: •...
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;...
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.
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: •...
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).
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;...
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.
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.