[knx] Minor documentation update (#13918)

Slightly change wording of docs related to localSourceAddress to avoid
address conflicts during initial setup.
Add remark about knxd.
Fixes #13602.

Signed-off-by: Holger Friedrich <mail@holger-friedrich.de>

diff --git a/bundles/org.openhab.binding.knx/README.md b/bundles/org.openhab.binding.knx/README.md
index ffd2e146f276f4c95bee61f42ee7552645748e43..ca316ee591fcdc20c2dc292b67889db22bf04378 100644 (file)
--- a/bundles/org.openhab.binding.knx/README.md
+++ b/bundles/org.openhab.binding.knx/README.md
@@ -33,7 +33,7 @@ The IP Gateway is the most commonly used way to connect to the KNX bus. At its b
 | ipAddress           | for `TUNNEL` | Network address of the KNX/IP gateway. If type `ROUTER` is set, the IPv4 Multicast Address can be set.       | for `TUNNEL`: \<nothing\>, for `ROUTER`: 224.0.23.12 |
 | portNumber          | for `TUNNEL` | Port number of the KNX/IP gateway                                                                            | 3671                                                 |
 | localIp             | No           | Network address of the local host to be used to set up the connection to the KNX/IP gateway                  | the system-wide configured primary interface address |
-| localSourceAddr     | No           | The (virtual) individual address for identification of this KNX/IP gateway within the KNX bus <br/><br/>Note: Use a free address, not the one of the interface. Or leave it at `0.0.0` and let openHAB decide which address to use.                | 0.0.0                                                |
+| localSourceAddr     | No           | The (virtual) individual address for identification of this openHAB Thing within the KNX bus <br/><br/>Note: Use a free address, not the one of the interface. Or leave it at `0.0.0` and let openHAB decide which address to use. When using knxd, make sure _not to use_ one of the addresses reserved for tunneling clients.  | 0.0.0                                                |
 | useNAT              | No           | Whether there is network address translation between the server and the gateway                              | false                                                |
 | readingPause        | No           | Time in milliseconds of how long should be paused between two read requests to the bus during initialization | 50                                                   |
 | responseTimeout     | No           | Timeout in seconds to wait for a response from the KNX bus                                                   | 10                                                   |

diff --git a/bundles/org.openhab.binding.knx/src/main/resources/OH-INF/i18n/knx.properties b/bundles/org.openhab.binding.knx/src/main/resources/OH-INF/i18n/knx.properties
index 93efd991625e67244e47ecdbf347ff8eac227787..c285499685617408b13d544e8c3171d890d645c7 100644 (file)
--- a/bundles/org.openhab.binding.knx/src/main/resources/OH-INF/i18n/knx.properties
+++ b/bundles/org.openhab.binding.knx/src/main/resources/OH-INF/i18n/knx.properties
@@ -31,7 +31,7 @@ thing-type.config.knx.ip.ipAddress.description = Network address of the KNX/IP g
 thing-type.config.knx.ip.localIp.label = Local Network Address
 thing-type.config.knx.ip.localIp.description = Network address of the local host to be used to set up the connection to the KNX/IP gateway
 thing-type.config.knx.ip.localSourceAddr.label = Local Device Address
-thing-type.config.knx.ip.localSourceAddr.description = The Physical Address (Individual Address) in x.y.z notation for identification of this KNX/IP gateway within the KNX bus
+thing-type.config.knx.ip.localSourceAddr.description = The Physical Address (Individual Address) in x.y.z notation for identification of this openHAB Thing within the KNX bus
 thing-type.config.knx.ip.portNumber.label = Port
 thing-type.config.knx.ip.portNumber.description = Port number of the KNX/IP gateway
 thing-type.config.knx.ip.readRetriesLimit.label = Read Retries Limit

diff --git a/bundles/org.openhab.binding.knx/src/main/resources/OH-INF/thing/ip.xml b/bundles/org.openhab.binding.knx/src/main/resources/OH-INF/thing/ip.xml
index a97c739c18d6bfc5684c7930c0b760d79a2d1fcf..1e9fcef550302596b3a262d8120869dc76e424d0 100644 (file)
--- a/bundles/org.openhab.binding.knx/src/main/resources/OH-INF/thing/ip.xml
+++ b/bundles/org.openhab.binding.knx/src/main/resources/OH-INF/thing/ip.xml
@@ -41,7 +41,7 @@
                        </parameter>
                        <parameter name="localSourceAddr" type="text">
                                <label>Local Device Address</label>
-                               <description>The Physical Address (Individual Address) in x.y.z notation for identification of this KNX/IP gateway
+                               <description>The Physical Address (Individual Address) in x.y.z notation for identification of this openHAB Thing
                                        within the KNX bus</description>
                                <default>0.0.0</default>
                        </parameter>