MDT Technologies Object Server VisuControl Easy II User manual

08/2023 - Version 1.0
Technical Manual
MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [e-mail] · www.mdt.de
Object Server VisuControl Easy II
VC-EASY.03
Further documents:
Data sheets:
https://www.mdt.de/en/for-professionals/downloads/datasheets.html
Assembly and operating instructions:
https://www.mdt.de/en/for-professionals/downloads/assembly-and-operation-instructions.html
Tips for MDT products:
https://www.mdt.de/en/for-professionals/tips-tricks.html

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 2/ 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
Content
2 Overview...........................................................................................................................................4
2.1 Device overview.......................................................................................................................................4
2.2 Functions .................................................................................................................................................5
2.3 Wiring diagram ........................................................................................................................................7
2.4 Structure & operation..............................................................................................................................7
2.5 Commissioning........................................................................................................................................8
2.6 Use as a KNX IP interface .......................................................................................................................8
2.6.1 Adjusting the IP settings ..................................................................................................................9
2.6.2 Tunnelling channels........................................................................................................................10
2.7 Security..................................................................................................................................................11
2.7.1 KNX Secure .....................................................................................................................................11
2.7.2 Project password ............................................................................................................................11
2.7.3 Commissioning with KNX Secure active ........................................................................................12
2.8 Resetting to factory settings .................................................................................................................12
3 Smartphone / Tablet application (app)............................................................................................13
3.1 Download...............................................................................................................................................13
3.2 Appearance and operation....................................................................................................................13
3.3 Settings..................................................................................................................................................14
3.3.1 Server administration .....................................................................................................................15
3.3.1.1 VPN (iOS) ..................................................................................................................................16
3.3.2 Grouping of functions .....................................................................................................................17
4 Communication objects ..................................................................................................................18
4.1 Default settings of the communication objects....................................................................................18
5 ETS parameters ..............................................................................................................................25
5.1 General settings ....................................................................................................................................25
5.1.1 General............................................................................................................................................25
5.1.2 Formatting of areas.........................................................................................................................27
5.1.3 Formatting the function types ........................................................................................................27
5.1.4 Weather data...................................................................................................................................28
5.1.5 Web interface..................................................................................................................................29
5.1.6 Time/Date .......................................................................................................................................31
5.2 Functions 1 - x.......................................................................................................................................32
5.2.1 Functions – General parameters....................................................................................................33
5.2.2 Function type 1: Switch (General)..................................................................................................35
5.2.3 Function type 2: Light .....................................................................................................................37
5.2.3.1 Light on/off ...............................................................................................................................37
5.2.3.2 Dimming ...................................................................................................................................39

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 3/ 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
5.2.4 Function type 3: Colour control (RGB/HSV)...................................................................................40
5.2.4.1 Control via RGB ........................................................................................................................40
5.2.4.2 Control via HSV.........................................................................................................................41
5.2.5 Function type 4: Blinds/Shutter .....................................................................................................43
5.2.5.1 Function selection: Blinds/Shutter ..........................................................................................43
5.2.5.2 Function selection: Blinds/Shutter with height position.........................................................44
5.2.5.3 Function selection: Blinds/Shutter with height and slat position...........................................44
5.2.6 Function type 5: Room temperature ..............................................................................................46
5.2.6.1 Function selection: Room temperature controller..................................................................47
5.2.6.2 Function selection: Room temperature controller with HVAC Mode......................................48
5.2.7 Function type 6: Scenes .................................................................................................................50
5.2.8 Function type 7: Multimedia...........................................................................................................51
5.2.9 Function type 8: Status...................................................................................................................52
5.2.10 Function type 9: Other..................................................................................................................55
5.2.11 Function type 10: Time switch.....................................................................................................61
5.3 Status logic ............................................................................................................................................62
5.4 Diagrams................................................................................................................................................64
5.5 Email functions......................................................................................................................................69
5.5.1 Status elements..............................................................................................................................69
5.5.2 Bit alarms........................................................................................................................................71
5.5.3 Text alarms (14 Byte) .....................................................................................................................73
5.5.4 Status reports .................................................................................................................................74
5.5.5 Special behaviour and error handling ............................................................................................76
6 Web interface .................................................................................................................................78
6.1 Calling up the web interface .................................................................................................................78
6.2 Web interface overview.........................................................................................................................78
6.3 Setting the email functionality..............................................................................................................79
6.4 Firmware update ...................................................................................................................................80
7 Index ..............................................................................................................................................81
7.1 List of gures .........................................................................................................................................81
7.2 List of tables ..........................................................................................................................................82
8 Appendix ........................................................................................................................................84
8.1 Legal provisions.....................................................................................................................................84
8.2 Disposal .................................................................................................................................................84
8.3 Assembly ...............................................................................................................................................84
8.4 History ...................................................................................................................................................84

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 4/ 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
2 Overview
2.1 Device overview
This manual applies to the following devices (order number printed in bold).
■ VC-EASY.03 Object Server VisuControl Easy II, 2SU MDRC, with Android or IOS App

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 5/ 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
2.2 Functions
Up to 200 functions can be selected from 10 function types:
■ Type 1: Switch (General)
■ Type 2: Light
■ Type 3: Colour control (RGB/HSV)
■ Type 4: Blinds / Shutter
■ Type 5: Room temperature
■ Type 6: Scenes
■ Type 7: Multimedia
■ Type 8: Status
■ Type 9: Other
■ Type 10: Time switch
The functions can be assigned to rooms, zones or function groups. In this way, different function types
(e.g. light, blinds/shutter and multimedia) can appear together in a room “living room” or in the zone
“ground floor”, or the entire lighting in the “Light” function group. The decisive factor here is the individual
operating concept.
Diagrams
A total of 8 data series can be recorded in the object server and displayed graphically in the app. The
datapoint type, recording interval, unit and scaling of each diagram are adjustable. The data series can be
displayed as lines or bar charts, for example to display a temperature curve or the amount of energy
supplied from a PV system.
Connection of the MDT time switch
In connection with a current MDT Time Switch from version .02 or (glass) Central Operation Unit Smart 68,
existing switching times can be conveniently adjusted and new switching times can be created directly in
the app.
Webcams
Images from up to 4 webcams can be displayed in the app. The refresh rate of the images is adjustable.
Weather data
The visualisation can display data provided via the KNX bus, such as outdoor temperature, wind speed and
brightness (for example from the “MDT Weather Station Home”) as well as rain and wind alarms.
IP interface with KNX Secure and time server
The MDT Object Server VisuControl Easy II can be used as a secure programming interface, with up to 4 parallel
KNX tunnelling connections. At the same time, the time and date can be made available by an NTP server
to the devices connected via the KNX bus.

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 6/ 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
Email functions
Status changes, bit alarms, 14-byte text alarms and status reports can be sent automatically by the object
server to up to 3 email recipients. For example, the collected status of up to 30 individual elements can be
sent weekly, or on a specic day of the month, as a status report in a single email. Bit alarms can send
faults from the heating or wallbox, for example.
Status logic
A status logic links up to ten 1-bit input objects logically and displays the result in the app. The logic
function can be AND, OR, NAND, NOR. This allows, for example, the status of all window contacts per floor
to be grouped and visualised.
Updateable via web interface
If necessary, the MDT Object Server VisuControl Easy II can be updated via the web interface.
Long frame support
The MDT Object Server VisuControl Easy II supports “Long Frames” (longer telegrams). These contain
more usable data per telegram, which signicantly reduces the programming time with the ETS.

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 7/ 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
2.3 Wiring diagram
Figure 1: Wiring diagram
2.4 Structure & operation
The following picture shows the structure of the device:
Figure 2: Structure & operation
1 = Bus connecting terminal
2 = Programming LED
3 = Programming button
4 = Function button
5 = Status LEDs
6 = RJ45 connector

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 8/ 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
2.5 Commissioning
1. Wiring of the device according to the wiring diagram.
2. Establish an Ethernet connection to the existing network.
3. Switch on the bus voltage.
4. Briefly press the programming button on the device (programming LED lights up)
5. Set and program the physical address in the ETS.
(Programming LED switches off)
6. Set and program the settings in the application program.
Note: After downloading the application program or after the bus voltage returns, the linked group
addresses are queried via the KNX bus for synchronisation.
2.6 Use as a KNX IP interface
The object server can be used as a KNX IP interface. Connections to the KNX bus can be established by
means of 4 tunnelling addresses.
In its initial condition, the object server expects an IP address from a DHCP server. As soon as the device
has received an IP address (for example from an Internet router), it appears as a programming interface
within the ETS and can be used to program the KNX components.
The interface is selected in the ETS6 (in the open project) in the top right-hand corner.
Figure 3: Interface selection in ETS6

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 9/ 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
2.6.1 Adjusting the IP settings
In its initial condition, the object server expects an IP address from a DHCP server.
If, on the other hand, a xed IP address is to be used, this must be set in the properties of the application
program.
The “Properties” window is called up by right-clicking (1) on the application program and opens at the
right edge of the screen. All general settings for a xed IP address can now be made via the “IP” tab (2).
Figure 4: Adjusting the IP settings

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 10 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
2.6.2 Tunnelling channels
A connection to the KNX bus can be established simultaneously via a total of 4 tunnelling channels. Each
tunnelling channel occupies a Individual Address in the KNX bus. The permissible address range is
between x.x.1 and x.x.255. The addresses of the tunnelling channels are accessed via the “Properties”
window. Enlarge application program (1), right-click on tunnelling channel -> “Properties” (2),
set Individual Address for tunnelling channel (3). After programming the application program, the new
tunnelling addresses are available.
Figure 5: Tunnelling channels

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 11 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
2.7 Security
2.7.1 KNX Secure
The use of the KNX Secure functionality requires the ETS as of version 5.7.
KNX Secure distinguishes between two mechanisms: IP Secure and Data Secure.
KNX IP Secure allows secure transmission in IP networks by encrypting and authenticating messages sent
out. IP Secure ensures that KNX tunnelling or routing messages cannot be read or manipulated at the IP
level. KNX IP Secure forms an additional security shell that protects the complete KNXnet IP data trafc.
KNX Data Secure ensures that the messages/telegrams sent out by KNX devices (independent of the KNX
medium) are encrypted and/or authenticated as long as both devices are KNX Data Secure capable. If one
of the devices does not support KNX Data Secure, the communication is still unencrypted.
Note: The Object Server VC-EASY.03 supports up to 50 group addresses with activated security.
FDSK (Factory Device Setup Key)
Each KNX Secure device is delivered with an FDSK. The system integrator/installer enters this key into the
ETS, which generates a device-specic tool key from it. The ETS sends the tool key via the KNX bus to the
device that is to be congured. This transmission is encrypted and authenticated with the FDSK. After
commissioning, the device only accepts the received tool key.
The FDSK is no longer required for further transmission unless the device is reset via a master reset
(see2.8 Resetting to factory settings). The FDSK of all devices in a project should be detached from the
device label after commissioning and kept on a project-specic basis. The FDSK is located on a detacha-
ble sticker on the side of the housing of the object server.
Secure mode
If a device has security activated, it operates in “Secure Mode” and transmits data in an encrypted format.
This is recognisable by the blue shield symbol.
Plain mode
If a device does not have security activated, it operates in “Plain Mode”. Data are transmitted unencrypted.
2.7.2 Project password
The ETS project password is required to activated KNX Secure. Without a project password, secure
commissioning is not possible and the devices are loaded in plain mode.

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 12 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
2.7.3 Commissioning with KNX Secure active
When the application program is imported into the KNX project, the necessity of a project password is
indicated. If you abort at this point, the device is loaded without KNX Secure functions. The FDSK
(Chapter 2.7.1) is entered at this point. If a webcam is connected, this can be done by scanning the QR
code; alternatively, the certicate can be entered via the keyboard.
Figure 6: Device certicate
Note: Commissioning with activated KNX Secure functionality requires ETS version > 5.7.x.
2.8 Resetting to factory settings
If the device has already been used or if commissioning has failed, reset the device to factory settings
according to the following procedure.
■ Press and hold the “Function” button for at least 8 seconds.
The two upper and lower LEDs then light up red/orange.
■ Now release the button briefly and press it again for at least 2 seconds until all LEDs go out. You can
now release the button.
■ The device will restart. It disappears briefly in the interface overview of ETS and then appears with
activated DHCP and the physical address 15.15.255.
The device is now reset.

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 13 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
3 Smartphone / Tablet application (app)
3.1 Download
Smartphones and tablets with the Android (from version 8) and iOS (from version 14) operating systems
are supported.
The app is available to download for free in the Google Play Store and Apple App Store.
App name: VisuControl II for KNX
3.2 Appearance and operation
The app can be used on a smartphone in portrait mode and on a tablet in portrait and landscape mode.
Choice of “bright” or “dark” appearance
Sample views of the home page:
Figure 7: Home page – Variants

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 14 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
3.3 Settings
You can access the app settings via the cogwheel symbol.
Figure 8: App – Settings
Server:
Display of the current connection status and management of up to 10 object servers,
see 3.3.1 Server administration
General setting:
Basic settings for the appearance of the app can be set here.
Information:
Display of imprint, data protection and licence information.

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 15 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
3.3.1 Server administration
The local search automatically lists all object servers detected in the network. The search uses so-called
“IGMP-Multicasting” to list the servers. If this procedure fails for the network components used, up to
10object servers can be saved manually in the app. In this case, the IP address of the object server can be
taken from the Internet router, for example.
Figure 9: Server administration
Figure 10: Saving a server
Name:
Free eld for the name of the object server
IP/URL:
Input eld for the IP address of the object server
Port: (optional)
Input eld for an alternative port
(Only used if the Standard Port 12005 is redirected to
another port)
Role:
Selecting the user role – Admin or User.
(Determines which password is required.)
Password: (optional)
Enter the password to connect the app to the object server.
(Depending on the role: Admin or User)
VPN: (iOS)
see 3.3.1.1 VPN (iOS)
Important:
Changes to the general server settings must be saved via the
diskette symbol (marked red).

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 16 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
3.3.1.1 VPN (iOS)
For iOS-based end devices, the “VisuControl for KNX App” offers integrated VPN support. The connection
to a VPN server is set up within the app and transferred to the operating system. The VPN connection is
automatically started when the app is used and automatically disconnected when it is closed.
Note: For Android-based end devices, the VPN connection must be established from the system settings
of the operating system.
The app supports the VPN types “IPSec” and “IKEv2”.
To activate the VPN functionality, a new server is rst added to the app.
see 3.3.1 Server administration
After the general server settings, activate the “VPN” function and select the desired method.
Figure 11: VPN activation
All input elds necessary for the connection are displayed. When using IKEV2, it is also possible to choose
between the authentications “username” and “Shared Secret”. The selection depends on the server used.
Important: Changes to the general server settings must be saved via the diskette symbol (marked red).
Figure 12: Saving a server

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 17 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
3.3.2 Grouping of functions
The app offers two options for grouping functions. Depending on the operating concept, a choice can be
made here between grouping by room or by function. The desired view can be selected in the app under
“Settings” --> “GROUP FUNCTIONS BY”.
Example:
Spot 1 is located both in the room “Living room”, as well as in the function “Light”.
Figure 13: Grouping of functions
Grouping
according to room
Grouping
according to function

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 18 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
4 Communication objects
4.1 Default settings of the communication objects
Default settings – General
No. Name Object function Length C R W T U
1 In operation Send status 1 Bit ■ ■ ■
2 Time Send current value 3 Byte ■ ■ ■
3 Date Send current value 3 Byte ■ ■ ■
4 Date / Time Send current values 8 Byte ■ ■ ■
51 Email buffer Overflow 1 Bit ■ ■ ■
52 Email Error code 1 Byte ■ ■ ■
53 NTP Time Server Error 1 Bit ■ ■ ■
54 Web interface Status: Lock 1 Bit ■ ■ ■
55 Web interface Lock 1 Bit ■ ■
1316 Weather data Status: Temperature 2 Byte ■ ■ ■ ■
1317 Weather data Status: Wind speed 2 Byte ■ ■ ■ ■
1318 Weather data Status: Brightness 2 Byte ■ ■ ■ ■
1319 Weather data Status: Rain alarm 1 Bit ■ ■ ■ ■
1320 Weather data Status: Wind alarm 1 Bit ■ ■ ■ ■
Table 1: Communication objects – Default settings: General

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 19 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
Default settings – Email functions
No. Name Object function Length C R W T U
5 Status report 1 Send email 1 Bit ■ ■
+1 Next status report (until status report 3)
8 Text alarm 1 Send email text 3 Byte ■ ■
+1 Next text alarm (until text alarm 3)
11 Bit alarm 1 Send email 1 Bit ■ ■
+1 Next bit alarm (up to bit alarm 10)
21 Status element 1 Switching status 1 Bit ■ ■
21 Status element 1 Day/Night 1 Bit ■ ■
21 Status element 1 Present/Absent 1 Bit ■ ■
21 Status element 1 Yes/No 1 Bit ■ ■
21 Status element 1 Heating/Cooling 1 Bit ■ ■
21 Status element 1 Open/Closed 1 Bit ■ ■
21 Status element 1 Top/Bottom 1 Bit ■ ■
21 Status element 1 Lock status 1 Bit ■ ■
21 Status element 1 Value (0...255) 1 Byte ■ ■
21 Status element 1 Percent value (0…100%) 1 Byte ■ ■
21 Status element 1 HVAC Status 1 Byte ■ ■
21 Status element 1 HVAC Mode 1 Byte ■ ■
21 Status element 1 Floating-point value 2 Byte ■ ■
21 Status element 1 Value unsigned 2 Byte ■ ■
21 Status element 1 Value signed 2 Byte ■ ■
21 Status element 1 Floating-point value 4 Byte ■ ■
21 Status element 1 Value unsigned 4 Byte ■ ■
21 Status element 1 Value signed 4 Byte ■ ■
21 Status element 1 Character ISO 8859-1 14 Byte ■ ■
+1 Next status element (up to status element 30)
Table 2: Communication objects – Default settings: Email functions

MDT technologies GmbH · Papiermühle 1 · 51766 Engelskirchen · Germany
Telephone [phone] · [email protected] · www.mdt.de 20 / 84
Technical Manual
Object Server VisuControl Easy II [VC-EASY.03]
08/2023 - Version 1.0
Default settings – Functions
No. Name Object function Length C R W T U
116 F1: Switch 1 Bit ■ ■
116 F1: Toggle 1 Bit ■ ■
116 F1: Play 1 Bit ■ ■ ■
116 F1: Open/Close 1 Bit ■ ■
116 F1: Up/Down 1 Bit ■ ■
116 F1: Lock/Unlock 1 Bit ■ ■
116 F1: Switch: Heating/Cooling 1 Bit ■ ■
116 F1: Switch: Present/Absent 1 Bit ■ ■
116 F1: Day/Night 1 Bit ■ ■
116 F1: Switch: Summer/Winter 1 Bit ■ ■
116 F1: Switch: Armed/Disarmed 1 Bit ■ ■
116 F1: Tilt/Close 1 Bit ■ ■
116 F1: Tilt/Close (Window) 1 Bit ■ ■
116 F1: Blinds Up/Down 1 Bit ■ ■
116 F1: Switch 1 Bit ■ ■ ■ ■
116 F1: Heating/Cooling 1 Bit ■ ■ ■ ■
116 F1: Present/Absent 1 Bit ■ ■ ■ ■
116 F1: LED display 1 Bit ■ ■ ■ ■
116 F1: Summer/Winter 1 Bit ■ ■ ■ ■
116 F1: Armed/Disarmed 1 Bit ■ ■ ■ ■
116 F1: Alarm 1 Bit ■ ■ ■ ■
116 F1: Error 1 Bit ■ ■ ■ ■
116 F1: Tilted/Closed 1 Bit ■ ■ ■ ■
116 F1: Day/Night 1 Bit ■ ■ ■ ■
116 F1: Open/Closed 1 Bit ■ ■ ■ ■
116 F1: Up/Down 1 Bit ■ ■ ■ ■
116 F1: Lock/Unlock 1 Bit ■ ■ ■ ■
116 F1: Dimming relative 4 Bit ■ ■
116 F1: Call up scene 1 Byte ■ ■