[boschshc] Bridge and Device Discovery (openhab#14197)

* openhab#14195 Bridge and Device Discovery Bridge discovery is implemented via mDNS, local IP addresses are checked. If a GET returns the public SHC information, then this shcIpAddress is reported as a discovered bridge. Devices are always discovered after successful pairing, but a manual scan is also possible. Added unit tests for Bridge and Device Discovery. Signed-off-by: Gerd Zanker <gerd.zanker@web.de>
FordPrfkt · Apr 19, 2023 · b800c7f · b800c7f
1 parent ddc0744
commit b800c7f
Show file tree

Hide file tree

Showing 16 changed files with 1,042 additions and 106 deletions.
diff --git a/bundles/org.openhab.binding.boschshc/README.md b/bundles/org.openhab.binding.boschshc/README.md
@@ -206,12 +206,15 @@ The smoke detector warns you in case of fire.
 
 ## Limitations
 
-- Discovery of Things
-- Discovery of Bridge
+No major limitation known.
+Check list of [openhab issues with "boshshc"](https://github.com/openhab/openhab-addons/issues?q=is%3Aissue+boschshc+) 
 
 ## Discovery
 
-Configuration via configuration files or UI (see below).
+Bridge discovery is supported via mDNS.
+Things discovery is started after successful pairing.
+
+Configuration via configuration files or UI supported too (see below).
 
 ## Bridge Configuration
 
@@ -239,19 +242,10 @@ Alternatively, the log can be viewed using the OpenHab Log Viewer (frontail) via
 Example:
 
 ```bash
-2020-08-11 12:42:49.490 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Heizung id=hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX
-2020-08-11 12:42:49.495 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=-RoomClimateControl- id=roomClimateControl_hz_1
-2020-08-11 12:42:49.497 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=-VentilationService- id=ventilationService
-2020-08-11 12:42:49.498 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Großes Fenster id=hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX
-2020-08-11 12:42:49.501 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=-IntrusionDetectionSystem- id=intrusionDetectionSystem
-2020-08-11 12:42:49.502 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Rollladen id=hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX
-2020-08-11 12:42:49.502 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Heizung id=hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX
-2020-08-11 12:42:49.503 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Heizung Haus id=hdm:ICom:819410185:HC1
-2020-08-11 12:42:49.503 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=-RoomClimateControl- id=roomClimateControl_hz_6
-2020-08-11 12:42:49.504 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=PhilipsHueBridgeManager id=hdm:PhilipsHueBridge:PhilipsHueBridgeManager
-2020-08-11 12:42:49.505 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Rollladen id=hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX
-2020-08-11 12:42:49.506 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Rollladen id=hdm:HomeMaticIP:3014F711A000XXXXXXXXXXXX
-2020-08-11 12:42:49.507 [INFO ] [chshc.internal.BoschSHCBridgeHandler] - Found device: name=Central Heating id=hdm:ICom:819410185
+2023-03-20 20:30:48.026 [INFO ] [g.discovery.internal.PersistentInbox] - Added new thing 'boschshc:security-camera-eyes:yourBridgeName:hdm_Cameras_XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' to inbox.
+2023-03-20 20:30:48.026 [INFO ] [g.discovery.internal.PersistentInbox] - Added new thing 'boschshc:smoke-detector:yourBridgeName:hdm_HomeMaticIP_XXXXXXXXXXXXXXXXXXXXXXXX' to inbox.
+2023-03-20 20:30:48.027 [INFO ] [g.discovery.internal.PersistentInbox] - Added new thing 'boschshc:twinguard:yourBridgeName:hdm_ZigBee_XXXXXXXXXXXXXXXX' to inbox.
+2023-03-20 20:30:48.028 [INFO ] [g.discovery.internal.PersistentInbox] - Added new thing 'boschshc:smart-bulb:yourBridgeName:hdm_PhilipsHueBridge_HueLight_XXXXXXXXXXXXXXXX-XX_XXXXXXXXXXXX' to inbox.
 ```
 
 ## Thing Configuration

diff --git a/...hc/src/main/java/org/openhab/binding/boschshc/internal/devices/BoschSHCDeviceHandler.java b/...hc/src/main/java/org/openhab/binding/boschshc/internal/devices/BoschSHCDeviceHandler.java
@@ -53,7 +53,6 @@ public BoschSHCDeviceHandler(Thing thing) {
 
  @Override
  public void initialize() {
-
  var config = this.config = getConfigAs(BoschSHCConfiguration.class);
 
  String deviceId = config.id;

diff --git a/...boschshc/src/main/java/org/openhab/binding/boschshc/internal/devices/BoschSHCHandler.java b/...boschshc/src/main/java/org/openhab/binding/boschshc/internal/devices/BoschSHCHandler.java
@@ -124,7 +124,6 @@ protected BoschSHCHandler(Thing thing) {
  */
  @Override
  public void initialize() {
-
  // Initialize device services
  try {
  this.initializeServices();
@@ -304,7 +303,6 @@ protected <TService extends BoschSHCService<TState>, TState extends BoschSHCServ
  protected <TService extends BoschSHCService<TState>, TState extends BoschSHCServiceState> void registerService(
  TService service, Consumer<TState> stateUpdateListener, Collection<String> affectedChannels,
  boolean shouldFetchInitialState) throws BoschSHCException {
-
  String deviceId = verifyBoschID();
  service.initialize(getBridgeHandler(), deviceId, stateUpdateListener);
  this.registerService(service, affectedChannels);
@@ -325,7 +323,6 @@ protected <TService extends BoschSHCService<TState>, TState extends BoschSHCServ
  */
  private <TService extends BoschSHCService<TState>, TState extends BoschSHCServiceState> void fetchInitialState(
  TService service, Consumer<TState> stateUpdateListener) {
-
  try {
  @Nullable
  TState serviceState = service.getState();
@@ -353,7 +350,6 @@ private <TService extends BoschSHCService<TState>, TState extends BoschSHCServic
  */
  protected <TService extends AbstractBoschSHCService> void registerStatelessService(TService service)
  throws BoschSHCException {
-
  String deviceId = verifyBoschID();
  service.initialize(getBridgeHandler(), deviceId);
  // do not register in service list because the service can not receive state updates

diff --git a/...c/src/main/java/org/openhab/binding/boschshc/internal/devices/bridge/BoschHttpClient.java b/...c/src/main/java/org/openhab/binding/boschshc/internal/devices/bridge/BoschHttpClient.java
@@ -65,13 +65,22 @@ public BoschHttpClient(String ipAddress, String systemPassword, SslContextFactor
  }
 
  /**
- * Returns the public information URL for the Bosch SHC clients, using port 8446.
+ * Returns the public information URL for the Bosch SHC client addressed with the given IP address, using port 8446
  * See https://github.com/BoschSmartHome/bosch-shc-api-docs/blob/master/postman/README.md
  *
  * @return URL for public information
  */
+ public static String getPublicInformationUrl(String ipAddress) {
+ return String.format("https://%s:8446/smarthome/public/information", ipAddress);
+ }
+
+ /**
+ * Returns the public information URL for the current Bosch SHC client.
+ *
+ * @return URL for public information
+ */
  public String getPublicInformationUrl() {
- return String.format("https://%s:8446/smarthome/public/information", this.ipAddress);
+ return getPublicInformationUrl(this.ipAddress);
  }
 
  /**
@@ -316,11 +325,12 @@ public <TContent> TContent sendRequest(Request request, Class<TContent> response
  if (errorResponseHandler != null) {
  throw errorResponseHandler.apply(statusCode, textContent);
  } else {
- throw new ExecutionException(String.format("Request failed with status code %s", statusCode), null);
+ throw new ExecutionException(String.format("Send request failed with status code %s", statusCode),
+ null);
  }
  }
 
- logger.debug("Received response: {} - status: {}", textContent, statusCode);
+ logger.debug("Send request completed with success: {} - status code: {}", textContent, statusCode);
 
  try {
  @Nullable