To import the configuration of a KNX project into a management application like an OPC server, the ETS offers an export function called "Export OPC". This export functionality provides only basic information about the KNX installation.

The NETx BMS App Secure is a user-friendly way to import the entire KNX project and its meta-information into the NETx BMS Platform Core Server. The output of the NETx BMS App Secure for ETS is an enhanced export file that contains the used KNX group addresses, the deployed KNXnet/IP routers and interfaces, and the full ETS project structure including the network topology (areas, lines, devices, and communication objects) as well as the building and trade view.

In addition, the app detects the configured IP addresses of the KNXnet/IP routers and interfaces. For KNXnet/IP routers and interfaces that support KNXnet/IP Security, the necessary security configuration is exported, too. Based on the topology of the KNX project, the app automatically assigns the KNX group addresses to the respective routers and interfaces that are later used to access them. Thus, a manual, time-consuming and error-prone assignment of the KNX group addresses to the KNXnet/IP routers and interfaces is not necessary anymore. Using the NETx BMS App Secure, the entire KNX project including the well-known ETS view can be imported into the NETx BMS Platform Core Server in a fast and intuitive way.

All ETS apps have to be validated by the KNX Association. In addition, an ETS app can only be installed with a valid ETS license (ETS lite, ETS Pro or ETS Supplementary) – ETS apps cannot be used with the demo mode of ETS. The following steps explain how the NETx BMS App Secure can be installed within your ETS installation.

How does the NETx BMS App Secure work?

During the export, the app searches for all communication objects of all devices in all lines which are connected to KNX group addresses. The KNX group address is the identifier to communicate with the communication object. Since we use IP we also need to know the IP address of the KNXnet/IP router or interface that we have to use. So, to communicate with a communication object we need both the KNX group address and the IP address.

The ETS App automatically searches for routers and interfaces that have a static IP address set. It searches first in the KNX line where the group address is assigned. If no valid router or interface is found, it searches within the main line. If still nothing was found, it searches within the backbone. If there is also no router or interface with a static IP address, it will ask you to enter one. Here you have the opportunity to enter a new IP address or choose an existing router or interface.

This is the correct and most reliable way to import KNX data. Although the Core Server provides the BROADCAST gateway that sends to all gateways simultaneously, using the BROADCAST gateway should be avoided. The reason is that BROADCAST means “all KNXnet/IP routers and interfaces together”. This in turn means that if you send a telegram from OPC to a group address that is assigned to BROADCAST, the BMS server sends a group telegram to EACH gateway. If you have 50 gateways it will send 50 telegrams to each router. Since KNXnet/IP routers also forward telegrams between their lines (based on filtering), this generates a lot of traffic there. Therefore, BROADCAST should only be used if KNXnet/IP routing (routing between KNX lines) is not activated.

Installation

Get the NETx BMS App Secure and a license for free from my.knx.org and go through the installation process.

1. Open the KNX online shop located at https://my.knx.org and log in with your KNX account. Use your KNX account name (starting with "KNX") and your password.
   
2. Although our NETx BMS App Secure is free of charge, you have to "order" it within the KNX online shop. Change to the tab "Shop" and then to "ETS Apps". Locate our the NETx BMS App Secure within the list of available apps. The easiest way is to select the category "Project Export". Click on the "Buy" button to add it to your basket.
   
3. Then click on the "basket" and press "Checkout" to start the ordering. Follow the instructions of the ordering wizard. As mentioned before, the NETx BMS App Secure is completely free of charge. However, you have to finish the ordering process to get a valid NETx BMS App Secure license.
   
   
   
4. After having finished the ordering process, change to the tab "My Products" and locate the NETx BMS App Secure within your product list. Next, download the ETS app installation package. This is done by clicking on the button "Download". You will get a file called "nxaETSBMSAppSecure.etsapp". Store it on your hard disk.
   
   
   
   
5. Install the ETS app to your ETS: Open the ETS and click on "Apps ... active" within the bottom right corner of the status bar of ETS. Within the list, click on the "+" button and select the installation packages "nxaETSBMSAppSecure.etsapp" that you have downloaded before.
   
   
   
   
6. Although our NETx BMS App Secure is free of charge, a license has to be installed. This license is coupled to your ETS license. Therefore, it is only possible to use an ETS app if you have valid ETS license (lite, professional or supplementary).
   First, the dongle ID of your ETS license has to be determined. Open the ETS and click on "License ..." within the bottom right corner of the status bar of ETS. Within the license dialog, you will find your dongle ID (starting with "KNX- ..."). Copy the dongle ID to the clipboard by pressing the "copy" button and write down the dongle ID.
   
   
   
   
7. Now, go back to KNX online shop which your web browser (log in again if you have been logged out in meantime). Change to "My Account" and to the tab "My Products", and locate the NETx BMS App Secure within your product list. Within the column "Product License" paste in the dongle ID. Afterwards, click on the button "Add Key". This will generate a new license file which can be downloaded via the link that is named after your dongle ID. Download the ZIP file and extract it on your hard disk. You will get a file with the extension ".license".
   
8. Now go back to your ETS. Click again on  "License ..." in the bottom right corner of the status bar of ETS. In the license dialog, click on the "+" button and select the license file that you have downloaded before. If everything is working you will find a new entry "NETx BMS App Secure".
   
9. Close the license dialog and click again on "Apps ... active" within the bottom right corner of the status bar of ETS. Within the apps list, you should find now our NETx BMS App Secure as active with a valid license.
   

Starting the NETx BMS App Secure

After installation and licensing of the NETx BMS App Secure, the NETx BMS App Secure should be available within your ETS. Open any ETS project and open the menu "Extras". Within this menu you will find a sub menu "NETxAutomation Software GmbH". Open the sub menu and select the entry "NETx BMS App Secure".

The user interface of our NETx BMS App Secure will be shown.

Further information

Changelog