Calimero-core

Calimero-core library for Java SE, specifically Java SE Embedded 8. The minimum required runtime environment is the profile compact1.

Code examples for using this library are shown in introduction.

Download

# Either using git
$ git clone https://github.com/calimero-project/calimero-core.git

# Or using hub
$ hub clone calimero-project/calimero-core

Supported Features

Access Protocols

• KNXnet/IP
  • Discovery and Self-description
  • Tunneling
  • Routing
  • Busmonitor
  • Device Management
• KNX IP
• KNX RF USB
• KNX USB
• KNX FT1.2 Protocol (serial connections)
• TP-UART (access TP1 networks over serial connections)

Process Communication

• DPT encoding/decoding of Java/KNX data types
• Process Communicator client
• Group Monitor

Supported Datapoint Types (DPTs)

• 1.x - Boolean, e.g., Switch, Alarm
• 2.x - Boolean controlled, e.g., Switch Controlled, Enable Controlled
• 3.x - 3 Bit controlled, e.g., Dimming, Blinds
• 5.x - 8 Bit unsigned value, e.g., Scaling, Tariff information
• 6.x - 8 Bit signed value, e.g., Percent (8 Bit), Status with mode
• 7.x - 2 octet unsigned value, e.g., Unsigned count, Time period
• 9.x - 2 octet float value, e.g., Temperature, Humidity
• 10.x - Time
• 11.x - Date
• 12.x - 4 octet unsigned value
• 13.x - 4 octet signed value, e.g., Counter pulses, Active Energy
• 14.x - 4 octet float value, e.g., Acceleration, Electric charge
• 16.x - String, e.g., ASCII string, ISO-8859-1 string (Latin 1)
• 17.x - Scene number
• 18.x - Scene control
• 19.x - Date with time
• 20.x - 8 Bit enumeration, e.g., Occupancy Mode, Blinds Control Mode
• 21.x - Bit array of length 8, e.g., General Status, Room Heating Controller Status
• 22.x - Bit array of length 16, implemented are DPT 22.101 and DPT 22.1000
• 28.x - UTF-8 string
• 29.x - 64 Bit signed value, e.g., Active Energy, Apparent energy
• 229.001 - M-Bus metering value, with the various M-Bus VIF/VIFE codings
• 232.x - RGB color value

Network Monitor / Busmonitor

Access via KNXnet/IP, KNX USB, KNX RF USB, TP-UART, and FT1.2

Raw Frame Decoding

• TP1
• KNX IP
• PL110
• RF

Management

• KNX Management Layer
• KNX Management Procedures
• cEMI Local Device Management

EMI Support

• cEMI standard and extend L-Data
• cEMI Busmonitor
• cEMI Device Management
• EMI1/2 standard L-Data
• EMI1/2 Busmonitor

Network Buffer

• State/command-based datapoint buffer to answer .reqs, buffer incoming .ind updates

Logging

Calimero uses the Simple Logging Facade for Java (slf4j). Bind any desired logging frameworks of your choice. The default maven dependency is the Simple Logger. It logs everything to standard output. The simple logger can be configured via the file simplelogger.properties, JVM system properties, or java command line options, e.g., -Dorg.slf4j.simpleLogger.defaultLogLevel=warn.

Testing

For unit tests, Calimero provides a test network, consisting of a KNXnet/IP server and a virtual KNX network with two KNX devices. The complete test network is implemented in software, and can be executed in any J2SE runtime environment. It provides the remote KNXnet/IP endpoint for executing unit tests for KNXnet/IP tunneling, busmonitoring, routing, device management, and KNX IP protocols. The same setup is used for Calimero Travis CI.

Before running any KNXnet/IP or KNX IP tests, start the test network (gradle run) in the directory calimero-core/test/testnetwork-launcher. When using Gradle, KNXnet/IP tests can be excluded via junitPlatform.filters.exclude 'knxnetip'.

Currently, the TP-UART and FT1.2 protocols can only be tested if the corresponding hardware is available.

Embedded Profile

Beginning with calimero version 2.4, Java SE Embedded 8 (compact1) is required. Java SE Embedded 8 with the compact1 profile is similar to Java ME CDC and Foundation Profile, providing an environment for headless applications on embedded devices that require a small footprint.

Because of the big step in the minimum required runtime environment, the Calimero public API for Embedded 8 is not kept binary compatible to Calimero for Java ME CDC. Overall, the required modifications are minimal.

Main breaking changes from earlier versions of Calimero

• Some API methods got updated to use @FunctionalInterfaces
• Use of enums
• XML processing defaults to the Streaming API for XML (StAX)
• Use of the Simple Logging Facade for Java (slf4j)
• Remove or replace @Deprecated parts of the library

More Features, Tools, Examples

• introduction provides code examples for programming with Calimero.

• calimero-tools offers command-line tools for KNX process communication, monitoring, and management.

• calimero-gui provides a graphical user interface (based on SWT) for process communication, monitoring, and management.

• calimero-server is the Calimero KNXnet/IP Server, providing KNXnet/IP access to KNX networks.

• calimero-device is the communication stack to implement a KNX device.

• serial-native provides native libraries for serial port access (using JNI) on Windows, Linux, and MacOS.

• import-ets-xml allows importing ETS XML KNX datapoints for use with Calimero.