Using an import file to insert field points - Metasys - LIT-12013148 - System Integration - KNX Vendor Integration - 13.0

Network Engine Commissioning for KNX Vendor Integration Application Note
Product
Building Automation Systems > Utilities and Integrations > KNX Vendor Integration
Document type
Application Note
Document number
LIT-12013148
Version
13.0
Revision date
2023-10-18

About this task

You require a .esf file from ETS5 Suites to complete the steps to insert field points using an import file. You can use the .esf file with the Mass Changes Tool (MCT) to create an import file (.imp file), which you use to insert field points. If you do not have an .esf file, contact the KNX programmer.

You can also use an .knxprojfile from ETS Utility. You can use the .knxproj file with the Mass Changes Tool (MCT) to create an import file (.imp file), which you use to insert field points. If you do not have an .knxproj file, contact the KNX programmer.

If you do not have the MCT installed on your computer, you can retrieve the most recent MCT from the License Portal. The program and support files for the MCT are provided. You can run the MCT in demo mode until it is licensed. You must have a licensed version in order to complete the directions in this section.

To license the MCT software, open the MCT and navigate to Help > About Mass Changes Tool. Click Load License File (JCI Internal Only) or Create License Request Form (External Users). After you license the MCT, complete the following steps.

Procedure

  1. Run the Mass Changes Tool.
  2. Navigate to File > New. The New File - Type window appears.
    Figure 1. New File - Type

  3. In the window, click KNX Integration, and then click Next. The New File - KNX Integration window appears.
    Figure 2. New File - KNX integration
  4. Click the browse button in this window and in the next window, and browse to the .knxproj file and click Open.
  5. If the ETS5 project file is password protected, enter your password and click OK.
  6. The Import KNX File window appears and displays the file details.
    Figure 3. Import KNX File

  7. In the Import KNX File window, which displays the file details, use the drag and drop action to add the KNX Points from the resource tree.
  8. Modify the Point Type, Data Type, Update at Startup, Special Handler, and Bit Mask parameters as desired for each point by clicking the pulldown and selecting the appropriate value.
    Note: Points that are defined as Uncertain by the .esf file may be modified like any other point.
    Figure 4. Selecting the data type

  9. When you are finished the changes, click OK. The New File - KNX Integration window appears again.
  10. Click into each field to edit the General Data and Vendor Configuration Data as necessary.
    Note: These values must match the attributes in Metasys UI. See Table 1 for a list of parameter descriptions.
    Table 1. Device parameters

    Category

    Description

    Unique ID

    The Unique ID of the gateway under which all KNX data points are saved. The Unique ID is part of the Object Name.

    Name

    The Object Name attribute on the Metasys field device object.

    Description

    The Description attribute on the Metasys field device object.

    Vendor Reference

    The Vendor Reference attribute on the Metasys field device object.

    Vendor Configuration Data

    The IP Address in the Vendor Configuration Data attribute (parameter 1 of the field device object). It is the IP address of the KNX IP interface/router device.

    Vendor Configuration Data

    Tunneling or Routing mode.
  11. Click Next. The New File Points window appears.
    Figure 5. New File - Points

  12. Configure the data points as requires. You can modify any value that has a drop-down menu.
  13. Click Next. The New File Points Selection window appears.
    Figure 6. New File - Points Selection

  14. Click a data point that you want to import, and then click > to move it to the panel on the right. Repeat until all desired points are on the right. Click >> if you want to move all data points to the right.
  15. Click Finish.
    Figure 7. Import file window

  16. Click the device name in the navigation menu on the left, and then click Update. All of the configured points for the import file appear in the window.
    Figure 8. Points for import file