{"id":16017808,"url":"https://github.com/calimero-project/calimero.distribution","last_synced_at":"2026-02-24T09:06:04.173Z","repository":{"id":30176932,"uuid":"33727427","full_name":"calimero-project/calimero.distribution","owner":"calimero-project","description":"Contains the maven POM for creating Calimero distributions","archived":false,"fork":false,"pushed_at":"2021-03-02T13:56:15.000Z","size":37,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-07-27T17:55:23.235Z","etag":null,"topics":["distribution","sourceforge"],"latest_commit_sha":null,"homepage":null,"language":"Roff","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/calimero-project.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-10T12:32:20.000Z","updated_at":"2023-02-15T20:31:40.000Z","dependencies_parsed_at":"2022-07-25T18:30:07.726Z","dependency_job_id":null,"html_url":"https://github.com/calimero-project/calimero.distribution","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/calimero-project/calimero.distribution","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calimero-project%2Fcalimero.distribution","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calimero-project%2Fcalimero.distribution/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calimero-project%2Fcalimero.distribution/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calimero-project%2Fcalimero.distribution/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/calimero-project","download_url":"https://codeload.github.com/calimero-project/calimero.distribution/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calimero-project%2Fcalimero.distribution/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29777662,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T04:54:30.205Z","status":"ssl_error","status_checked_at":"2026-02-24T04:53:58.628Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["distribution","sourceforge"],"created_at":"2024-10-08T16:23:12.751Z","updated_at":"2026-02-24T09:06:04.139Z","avatar_url":"https://github.com/calimero-project.png","language":"Roff","funding_links":[],"categories":[],"sub_categories":[],"readme":"Calimero Project\n================\n\nThe Calimero Project provides a collection of libraries and tools for \nKNX network access and management.\nThe name Calimero origins from an inside joke: Calimero is not a falcon, referring to the Windows DCOM KNX Falcon driver library.\n\n* Current development versions on Github: \u003chttps://github.com/calimero-project/\u003e\n* Distributions on SourceForge: \u003chttp://sourceforge.net/projects/calimero/\u003e\n* Calimero group identifier for artifacts in Maven: com.github.calimero\n\n\nWhat's in the Egg\n=================\n\n1) The Calimero-core library, providing access protocols, network links, and higher-layer process communication and management APIs\n\n2) Additional connection support for serial communication:\n\n  * serialcom-jni.zip, an optional way of serial port access using the Java Native Interface (JNI)\n  * calimero-rxtx jar archive, an optional way of serial port access using RXTX, or any compatible library\n\n3) A collection of Calimero tools to access KNX networks from the terminal\n\n4) The Calimero KNXnet/IP server, an extensible KNXnet/IP server implementation. The server does not have a client-side connection limit (like 1 or 4 connections with many other hardware) and can be run out-of-the-box, also supporting KNXnet/IP client access for other interfaces/protocols, e.g., TP-UART, USB, FT1.2.\n\n5) The Calimero KNX device, a library to implement your own KNX device in Java\n\n6) The Calimero GUI, a graphical user interface to access KNX networks, based on the Standard Widget Toolkit (SWT)\n\n7) properties.xml contains the KNX property definitions, used with APIs that access KNX properties\n\n8) XSLT stylesheets for converting ETS project files for use with Calimero\n\n\nHatch Calimero\n==============\n\nExtract the content of this archive into a directory of your choice.\n\n\nLearn to Fly\n============\n\nOpen a terminal and change to the directory with the extracted distribution files.\nEnsure a Java interpreter is available by executing\n\n\tjava \n\non the terminal. The minimum required Java runtime environment is Java 8. The command\n\n\tjava -jar calimero-core-2.4.jar\n\nshould print some information about the library. That information can also be queried directly in software through methods of the class `tuwien.auto.calimero.Settings`.\n\nNote, that on Windows the separator for classpath entries (`-cp`) is `;`, Linux/MacOS uses `:`.\nAll of the Calimero tools offer a `--help` option, which prints a list of supported command line options.\n\nTo discover KNXnet/IP routers\n\n\tjava -cp \"calimero-core-2.4.jar;calimero-tools-2.4.jar\" tuwien.auto.calimero.tools.Discover -s\n\t\nor, relying on the information from the jar Manifest, one can also just type\n\n\tjava -jar calimero-tools-2.4.jar discover\n\nTo print a list of all supported tool commands (similiar to `discover` that we've just used), simply type\n\t\n\tjava -jar calimero-tools-2.4.jar\n\n\nAsking for the KNXnet/IP self-description of a KNXnet/IP server using its IP address\t\n\n\tjava -jar calimero-tools-2.4.jar describe 192.168.10.12\n\nTo query the IP configuration of a KNXnet/IP server using its IP address\n\n\tjava -jar calimero-tools-2.4.jar ipconfig 192.168.10.12\n\nTo busmonitor a KNX network using a KNXnet/IP server\n\n\tjava -jar calimero-tools-2.4.jar monitor 192.168.10.10\n\nAnd so on ...\n\n### Graphical User Interface\n\nLaunch the graphical user interface using\n\n\tjava -jar calimero-gui-2.2.jar\n\nOn MacOS, use\n\t\n\tjava -XstartOnFirstThread -jar calimero-gui-2.2.jar\n\n### KNXnet/IP server\n\nTo run the server out-of-the-box, start it in a terminal supplying the `server-config.xml` configuration file customized to your setup:\n\n\tjava -cp \"./*\" tuwien.auto.calimero.server.Launcher server-config.xml \n\n Make sure to adjust the configuration template `server-config.xml` to your setup!\n\n### KNX Device\nCalimero KNX device provides the network stack to run your own Java-based KNX device. An example of a 2-state push-button device over KNX IP is shown in the GitHub introduction repository ([PushButtonDevice.java](https://github.com/calimero-project/introduction/blob/master/src/main/java/PushButtonDevice.java)).\n\nNetwork Interfaces with KNXnet/IP\n---------------------------------\nWhen using KNXnet/IP, make sure that your network interfaces are configured and firewalls do not block KNXnet/IP traffic. \nTake care when using IPv6 addresses, Network Address Translation (NAT), or multiple network interfaces. Each of those things might be a problematic factor if something does not work as expected.\n\n* If you experience problems with IPv6, passing `-Djava.net.preferIPv4Stack=true` as VM argument helps. It does exactly what it says: prefer the IPv4 network stack over IPv6.\n* Calimero KNXnet/IP allows you to specify the outgoing network interface, and the use of NAT-aware communication where necessary (see the corresponding command line options or JavaDoc).\n\n\nFT1.2 and TP-UART Connections\n-------------------------\nThe FT1.2 protocol and TP-UART require access to a serial port communication resource.\nCalimero supports two ways of access to a serial port, with availability checked in the following order:\n  \n1. Calimero built-in support using JNI and the serialcom library. The C++ source code is provided for Windows and Unix/MacOS platforms. Compiled .dll libraries for Windows and .so for Linux are available (see the corresponding READMEs for system and compiler versions). The sources should compile on any compliant Windows 32/64 platform as well as common Linux platforms. The simplest way to ensure the Java runtime detects the serial library is to put it into the current working directory. The better way is to use the dedicated Java library lookup path, e.g., on Microsoft Windows, \\\u003cjava-home\\\u003e\\bin.\n  \n2. Use of RXTX (or any compatible) library, if such library is available and configured, i.e., accessible via the class path so the Java class loader finds it. The calimero-rxtx jar archive, being the Calimero adapter to access the RXTX library, has to be on the Java class path, too.\n\nIf any of the connection prerequisites is not met, i.e., you do not have a Java ME environment, you do not want to use additional native (JNI) code, or you do not have a RXTX library, that way of accessing the serial port is skipped by Calimero. \nIn other words, you have to ensure at least one way of connection support for serial communication.\n\n\n\nHave fun exploring and using Calimero!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalimero-project%2Fcalimero.distribution","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcalimero-project%2Fcalimero.distribution","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalimero-project%2Fcalimero.distribution/lists"}