ETS XML Import

Transform ETS XML source documents to Calimero XML

License

License

GNU Lesser General Public License (LGPL), version 2.1
GroupId

GroupId

com.github.calimero
ArtifactId

ArtifactId

import-ets-xml
Last Version

Last Version

2.4-rc2
Release Date

Release Date

Type

Type

pom
Description

Description

ETS XML Import
Transform ETS XML source documents to Calimero XML
Project URL

Project URL

https://github.com/calimero-project/import-ets-xml
Source Code Management

Source Code Management

https://github.com/calimero-project/import-ets-xml.git

Download import-ets-xml

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.calimero/import-ets-xml/ -->
<dependency>
    <groupId>com.github.calimero</groupId>
    <artifactId>import-ets-xml</artifactId>
    <version>2.4-rc2</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/com.github.calimero/import-ets-xml/
implementation 'com.github.calimero:import-ets-xml:2.4-rc2'
// https://jarcasting.com/artifacts/com.github.calimero/import-ets-xml/
implementation ("com.github.calimero:import-ets-xml:2.4-rc2")
'com.github.calimero:import-ets-xml:pom:2.4-rc2'
<dependency org="com.github.calimero" name="import-ets-xml" rev="2.4-rc2">
  <artifact name="import-ets-xml" type="pom" />
</dependency>
@Grapes(
@Grab(group='com.github.calimero', module='import-ets-xml', version='2.4-rc2')
)
libraryDependencies += "com.github.calimero" % "import-ets-xml" % "2.4-rc2"
[com.github.calimero/import-ets-xml "2.4-rc2"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Import ETS XML into Calimero XML

Transform KNX datapoints of ETS source XML documents to Calimero XML source documents.

Copyright (C) 2010, 2011 Thomas Wimmer
Copyright (C) 2015, 2018 Boris Malinowsky
Documentation by Wolfgang Granzer, Boris Malinowsky
Licensed under the GNU Lesser General Public License (LGPL), version 2.1

Tested with ETS 4.0.3 and ETS 5.x (latest v5.6.4). ETS 5.7 or later is not supported!

Required steps

  1. Export your ETS project: click on ETS, select your project, and click Export... . You get a file with the extension .knxproj (a ZIP archive).
  2. Check your ETS version (ETS 4/5)
  3. Transform to Calimero XML using XSLT, either by using Gradle, Maven, or do it manually (see below).

Know your ETS version!

Note: namespace version ≥ 20 is not supported.

Select the correct version inside the calimero xsl file (line 5) you want to use. If you don't know the version, use try and error with versions 11 to 14. With the wrong version, the transformed output file will not contain any datapoints! This adjustment of the version is necessary due to ETS .knxproj files using versioned XML namespaces.

  • ETS 4 uses http://knx.org/xml/project/11 or http://knx.org/xml/project/12
  • ETS 5 uses http://knx.org/xml/project/13 or http://knx.org/xml/project/14

By default, the transformation assumes a recent ETS 5 with namespace version 14.

Import using Gradle

  • Copy the .knxproj archives into src/main/resources (do not extract the archives).
  • On the command line, execute ./gradlew. The imported calimero.xml` file of each archive is written to the corresponding build/imports/<Project Name> folder.

Import using Maven

  • Copy the .knxproj archives into src/main/resources (do not extract the archives).
  • Execute the Maven goal process-resources. For example, in the terminal change to the directory where the pom.xml file resides, and type mvn process-resources. The output files are written to target/generated-resources/xml/xslt.

Manual import

  • Choose the appropriate XSL style sheet (see below).
  • Copy the chosen XSL file into the root directory of the extracted ETS project.
  • Invoke an appropriate XSLT tool. On Linux/MacOS you can use xsltproc, i.e., xsltproc -o <output_XML_file> <XSL_file> <source_XML_file>. On Microsoft Windows, you may use Saxon (http://saxon.sourceforge.net/).

Choose the appropriate XSL style sheet:

  • ets_calimero_group.xsl: Generates for each KNX group address one single datapoint. The resulting file can be loaded by Calimero.
  • ets_calimero_group_name.xsl: Generates for each KNX group address one single datapoint where the KNX group address name is used as name for the datapoint. The resulting file can be loaded by Calimero.
  • ets_calimero.xsl: Generates for each application object one single datapoint. Note that different application objects may have the same group address. Therefore, the output cannot be imported into Calimero! However, it can be used for further (manual) processing.

The source XML file is called 0.xml which is contained within the sub directory that begins with a P, e.g., P-0497.

Example invocation

xsltproc -o calimero.xml ets_calimero_group_name.xsl P-0497/0.xml


Developed at the A-Lab, Automation Systems Group
Vienna University of Technology
www.auto.tuwien.ac.at/a-lab

Versions

Version
2.4-rc2
2.4-rc1