Recent changes to Miscellaneous

Miscellaneous modified by Boris Malinowsky

Boris Malinowsky — Sun, 14 Feb 2016 13:43:29 -0000

--- v4
+++ v5
@@ -49,13 +49,10 @@

 [KNX Controller](https://sites.google.com/site/knxcontroller/) uses Calimero and supports DPT 20 (8-bit integer enumeration) since version 1.0.18, maybe more. 

-The OpenHAB project has put their Calimero [fork on GitHub](https://github.com/openhab/calimero/). They have added new DPTs, including 14.056.
-
-For DPT 14, see also [this thread on the forum](http://sourceforge.net/p/calimero/discussion/485103/thread/2d85e03e). All DPT encodings can be freely downloaded from www.knx.org (Downloads/Support > Downloads; 03 - KNX Standard > KNX Standard Public Documents > 03_07_02 Datapoint Types ...).

 #### Considering changes to Calimero 2 in general ####

-* If you distribute a changed version of the Calimero library, you must also distribute source code for the changes. DPTxlators can be added without modifying Calimero source code, so, strictly speaking, this requirement does not hold for them - but it would simply be nice of you if you made them available as well, preferably under GPL + Classpath exception.
+* If you distribute a changed version of the Calimero library, you must also distribute source code for the changes. DPTXlators can be added without modifying Calimero source code, so, strictly speaking, this requirement does not hold for them - but it would simply be nice of you if you made them available as well, preferably under GPL + Classpath exception.
 * The easiest way to distribute your changed Calimero source is by including them in the JAR file. If this is not "clean" enough for your purpose (for example, because you want to keep your Android app package small), please put them on the web somewhere. Of course, according to the GPL v2, you only need to provide a written offer etc. pp., but... this is the 21st century, right?
 * The Classpath exception includes a clause that you can remove it from your changed version. If you do this, your whole application becomes ("plain") GPL.

@@ -74,27 +71,10 @@

  

-### Versioning ###
-
-Within a major release, for example, 1.x, updates to different parts of the library are indicated by incrementing the minor version count. Therefore, differing version numbers are possible, i.e., a tool might have version number 1.3, while the network library is still 1.2. For releases, I always refer to the core network library version.
-
-
- 
-
-### Release notes for 2.0.4 alpha ###
-
-* The DPT translators for date and time are added to the translator lookup list at library initialization by default, adding them explicitly in user code is not necessary anymore. Therefore, date/time translation is available from the calimero tools now.
-* KNXnet/IP connection setup with NAT enabled checks the IP/port fields in the setup response for 0 to decide whether to use or ignore them.
-
-
- 
-
 ### Ideas for improving the documentation ###

 * a starter section, providing information for Java & KNX newbies
 * a feature area, explaining the individual library features
-* code snippets, providing minimal runnable code examples
 * a FAQ, the list of frequently asked questions
-* user stories, feedback and scenarios by users

 Plus: follow-up on bugs and unexpected/strange behavior

Miscellaneous modified by Bernhard Haumacher

Bernhard Haumacher — Wed, 09 Oct 2013 20:18:43 -0000

--- v3
+++ v4
@@ -1,3 +1,4 @@
+[[include ref=Menu]]
 # Miscellaneous #

 This page/topic is a kind of "scratch pad" for (yet) unsorted stuff.

Miscellaneous modified by Georg Neugschwandtner

Georg Neugschwandtner — Sun, 06 Oct 2013 19:13:46 -0000

--- v2
+++ v3
@@ -66,7 +66,7 @@

 Calimero should work with _all_ KNXnet/IP compliant interfaces/routers. However, there may be bugs in Calimero - or those interfaces.

-Markus Haspl maintains a [list of devices working with KNX Controller]( https://sites.google.com/site/knxcontroller/working-devices). However, we do not know which Calimero version ("stock" 2.0a4, or maybe a patched version?) this refers to.
+Markus Haspl maintains a [list of devices working with KNX Controller](https://sites.google.com/site/knxcontroller/working-devices). However, we do not know which Calimero version ("stock" 2.0a4, or maybe a patched version?) this refers to.

 Reports are floating around on the web regarding problems with a Siemens N148/22, but these problems apparently were [not related to a bug in Calimero](http://knx-user-forum.de/knx-eib-forum/7748-visualisierung-ip-gateway-5.html). The capability of more recent KNXnet/IP devices to have more than one KNX individual address (for multiple KNXnet/IP Tunnelling connections) apparently adds a good bit of complexity.

WikiPage Miscellaneous modified by Georg Neugschwandtner

Georg Neugschwandtner — Thu, 31 Jan 2013 19:25:31 -0000

--- v1
+++ v2
@@ -26,6 +26,53 @@

  

+### Why isn't there...? ###
+
+Maybe because this feature is outside the scope of Calimero (which is to enable communication with KNX devices- not programming them, not offering a graphical interface for controlling your home... you get the idea).
+
+Or maybe because too many people just took what was they could get- and left. They may have all had good and legitimate reasons. Still, it's part of the answer to this question. You may find their enhancements to Calimero in their forked-off versions.
+
+
+ 
+
+### Known forks and "external" patches ###
+
+OpenRemote used Calimero for KNX communication in version 1, but they ["rewrote the stack" in 2011][1] and [replaced Calimero with an "own implementation"][2] in OpenRemote version 2. This "own implementation" is probably [based on][3] [iKNX][4], which [joined OpenRemote in early 2009][5]. Before that, however, they still wrote a ["Patch A" for Calimero to add Windows 7 compatibility][6]. The source code for this seems to be well hidden, however.
+
+ [1]: http://www.openremote.org/pages/viewpage.action?pageId=15138839
+ [2]: http://www.openremote.org/pages/viewpage.action?pageId=21039297
+ [3]: http://www.openremote.org/download/attachments/2425532/iKNX+goes+OpenRemote.pdf?version=1
+ [4]: http://www.openremote.org/display/iknx/OpenRemote+iKNX
+ [5]: http://www.openremote.org/display/HOME/2009/05/06/OpenRemote+April+Update+--+iKNX%2C+Amsterdam+Meetup%2C+M1+Developer+Release
+ [6]: http://lists.openremote.org/pipermail/openremote-svn/2011-March/003203.html
+
+[KNX Controller](https://sites.google.com/site/knxcontroller/) uses Calimero and supports DPT 20 (8-bit integer enumeration) since version 1.0.18, maybe more. 
+
+The OpenHAB project has put their Calimero [fork on GitHub](https://github.com/openhab/calimero/). They have added new DPTs, including 14.056.
+
+For DPT 14, see also [this thread on the forum](http://sourceforge.net/p/calimero/discussion/485103/thread/2d85e03e). All DPT encodings can be freely downloaded from www.knx.org (Downloads/Support > Downloads; 03 - KNX Standard > KNX Standard Public Documents > 03_07_02 Datapoint Types ...).
+
+#### Considering changes to Calimero 2 in general ####
+
+* If you distribute a changed version of the Calimero library, you must also distribute source code for the changes. DPTxlators can be added without modifying Calimero source code, so, strictly speaking, this requirement does not hold for them - but it would simply be nice of you if you made them available as well, preferably under GPL + Classpath exception.
+* The easiest way to distribute your changed Calimero source is by including them in the JAR file. If this is not "clean" enough for your purpose (for example, because you want to keep your Android app package small), please put them on the web somewhere. Of course, according to the GPL v2, you only need to provide a written offer etc. pp., but... this is the 21st century, right?
+* The Classpath exception includes a clause that you can remove it from your changed version. If you do this, your whole application becomes ("plain") GPL.
+
+
+
+ 
+
+### Compatible devices ###
+
+Calimero should work with _all_ KNXnet/IP compliant interfaces/routers. However, there may be bugs in Calimero - or those interfaces.
+
+Markus Haspl maintains a [list of devices working with KNX Controller]( https://sites.google.com/site/knxcontroller/working-devices). However, we do not know which Calimero version ("stock" 2.0a4, or maybe a patched version?) this refers to.
+
+Reports are floating around on the web regarding problems with a Siemens N148/22, but these problems apparently were [not related to a bug in Calimero](http://knx-user-forum.de/knx-eib-forum/7748-visualisierung-ip-gateway-5.html). The capability of more recent KNXnet/IP devices to have more than one KNX individual address (for multiple KNXnet/IP Tunnelling connections) apparently adds a good bit of complexity.
+
+
+ 
+
 ### Versioning ###

 Within a major release, for example, 1.x, updates to different parts of the library are indicated by incrementing the minor version count. Therefore, differing version numbers are possible, i.e., a tool might have version number 1.3, while the network library is still 1.2. For releases, I always refer to the core network library version.

WikiPage Miscellaneous modified by Georg Neugschwandtner

Georg Neugschwandtner — Wed, 30 Jan 2013 21:46:14 -0000

Miscellaneous

This page/topic is a kind of "scratch pad" for (yet) unsorted stuff.

Why put all content on this wiki instead of a "proper" website?

Maintenance-free
Very easy to learn and use
Convenient markup (efficient content generation)
Auditability
Virtually unlimited undo
Statements automatically get a date attached (makes it easier to see if information is potentially outdated)

Yes, including decorative images is a PITA (as is the header spacing), but decoration is currently not a priority.

"Calimero"?

It's an inside joke. Calimero is not a Falcon.

Versioning

Within a major release, for example, 1.x, updates to different parts of the library are indicated by incrementing the minor version count. Therefore, differing version numbers are possible, i.e., a tool might have version number 1.3, while the network library is still 1.2. For releases, I always refer to the core network library version.

Release notes for 2.0.4 alpha

The DPT translators for date and time are added to the translator lookup list at library initialization by default, adding them explicitly in user code is not necessary anymore. Therefore, date/time translation is available from the calimero tools now.
KNXnet/IP connection setup with NAT enabled checks the IP/port fields in the setup response for 0 to decide whether to use or ignore them.

Ideas for improving the documentation

a starter section, providing information for Java & KNX newbies
a feature area, explaining the individual library features
code snippets, providing minimal runnable code examples
a FAQ, the list of frequently asked questions
user stories, feedback and scenarios by users

Plus: follow-up on bugs and unexpected/strange behavior