demus/openhab-addons
1
0
Fork 0
mirror of https://github.com/danieldemus/openhab-addons synced 2026-07-31 13:34:22 +02:00
Code Issues Packages Projects Releases Wiki Activity

Fix (#19141)

Browse Source 
Signed-off-by: Leo Siepel <leosiepel@gmail.com>
This commit is contained in:
lsiepel
2025-08-14 11:46:47 +02:00
committed by GitHub
parent 4d403ea438
commit 787242d982
2 changed files with 25 additions and 69 deletions
Download Patch File Download Diff File Expand all files Collapse all files
bundles/org.openhab.binding.homematic/README.md
+23 -67
View File
@@ -134,73 +134,29 @@ However, the install mode is not automatically enabled in this situation because
There are several settings for a bridge:
- **gatewayAddress** (required)
Network address of the Homematic gateway
- **gatewayType**
Hint for the binding to identify the gateway type (auto|ccu|noccu) (default = "auto").
- **callbackHost**
Callback network address of the system runtime, default is auto-discovery. This value must not contain any white spaces.
- **xmlCallbackPort**
Callback port of the binding's XML-RPC server, default is 9125 and counts up for each additional bridge
- **binCallbackPort**
Callback port of the binding's BIN-RPC server, default is 9126 and counts up for each additional bridge
- **timeout**
The timeout in seconds for connections to a Homematic gateway (default = 15)
- **discoveryTimeToLive**
The time to live in seconds for discovery results of a Homematic gateway (default = -1, which means infinite)
- **socketMaxAlive**
The maximum lifetime of a socket connection to and from a Homematic gateway in seconds (default = 900)
- **rfPort**
The port number of the RF daemon (default = 2001)
- **wiredPort**
The port number of the HS485 daemon (default = 2000)
- **hmIpPort**
The port number of the HMIP server (default = 2010)
- **cuxdPort**
The port number of the CUxD daemon (default = 8701)
- **groupPort**
The port number of the Group daemon (default = 9292)
- **callbackRegTimeout**
Maximum time in seconds for callback registration in the Homematic gateway (default = 120s).
For a CCU2, the value may need to be increased to 180s.
- **installModeDuration**
Time in seconds that the controller will be in install mode when a device discovery is initiated (default = 60)
- **unpairOnDeletion**
If set to true, devices are automatically unpaired from the gateway when their corresponding things are deleted.<br>
**Warning:** The option "factoryResetOnDeletion" also unpairs a device, so in order to avoid unpairing on deletion completely, both options need to be set to false! (default = false)
- **factoryResetOnDeletion**
If set to true, devices are automatically factory reset when their corresponding things are removed.
Due to the factory reset, the device will also be unpaired from the gateway, even if "unpairOnDeletion" is set to false! (default = false)
- **bufferSize**
If a large number of devices are connected to the gateway, the default buffersize of 2048 kB may be too small for communication with the gateway.
In this case, e.g. the discovery fails.
With this setting the buffer size can be adjusted. The value is specified in kB.
- **useAuthentication**
Username and password are send to the gateway to authenticate the access to the gateway.
- **userName**
Username for Authentication to the gateway.
- **password**
Password for Authentication to the gateway.
| Setting | Description | Default Value |
|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|
| gatewayAddress | Network address of the Homematic gateway. | - |
| gatewayType | Hint for the binding to identify the gateway type (`auto`, `ccu`, `noccu`). | auto |
| callbackHost | Callback network address of the system runtime. This value must not contain any white spaces. | - |
| xmlCallbackPort | Callback port of the binding's XML-RPC server. Counts up for each additional bridge. | 9125 |
| binCallbackPort | Callback port of the binding's BIN-RPC server. Counts up for each additional bridge. | 9126 |
| timeout | Timeout in seconds for connections to a Homematic gateway. | 15 |
| discoveryTimeToLive | Time to live in seconds for discovery results of a Homematic gateway. Use `-1` for infinite. | -1 |
| socketMaxAlive | Maximum lifetime of a socket connection to and from a Homematic gateway in seconds. | 900 |
| rfPort | Port number of the RF daemon. | 2001 |
| wiredPort | Port number of the HS485 daemon. | 2000 |
| hmIpPort | Port number of the HMIP server. | 2010 |
| cuxdPort | Port number of the CUxD daemon. | 8701 |
| groupPort | Port number of the Group daemon. | 9292 |
| callbackRegTimeout | Maximum time in seconds for callback registration in the Homematic gateway. For a CCU2, this value may need to be increased to 180 seconds. | 120 |
| installModeDuration | Time in seconds that the controller will be in install mode when a device discovery is initiated. | 60 |
| unpairOnDeletion | If set to `true`, devices are automatically unpaired from the gateway when their corresponding things are deleted. **Warning:** To avoid unpairing completely, set this and `factoryResetOnDeletion` to `false`. | false |
| factoryResetOnDeletion | If set to `true`, devices are automatically factory reset when their corresponding things are removed. This also unpairs the device, even if `unpairOnDeletion` is set to `false`. | false |
| bufferSize | Adjusts the buffer size in kB for communication with the gateway. Increase if discovery fails due to a large number of devices. | 2048 |
| useAuthentication | If set to `true`, username and password are sent to the gateway to authenticate access. | false |
| userName | Username for authentication to the gateway. | - |
| password | Password for authentication to the gateway. | - |
The syntax for a bridge is:
bundles/org.openhab.binding.homematic/src/main/java/org/openhab/binding/homematic/internal/discovery/HomematicDeviceDiscoveryService.java
+2 -2
View File
@@ -46,7 +46,7 @@ public class HomematicDeviceDiscoveryService
extends AbstractThingHandlerDiscoveryService<@NonNull HomematicBridgeHandler> {
private final Logger logger = LoggerFactory.getLogger(HomematicDeviceDiscoveryService.class);
private static final int DISCOVER_TIMEOUT_SECONDS = 300;
private static final int MINIMAL_SCAN_TIMEOUT_SECONDS = 120;
private Future<?> loadDevicesFuture;
private volatile boolean isInInstallMode = false;
private volatile Object installModeSync = new Object();
@@ -102,7 +102,7 @@ public class HomematicDeviceDiscoveryService
@Override
public int getScanTimeout() {
return getInstallModeDuration();
return Math.max(MINIMAL_SCAN_TIMEOUT_SECONDS, getInstallModeDuration());
}
@Override