[huesync][WIP] Hue Play HDMI Sync Box Binding - Initial contribution

CODEOWNERS

@@ -152,6 +152,7 @@
 /bundles/org.openhab.binding.hpprinter/ @cossey
 /bundles/org.openhab.binding.http/ @openhab/add-ons-maintainers
 /bundles/org.openhab.binding.hue/ @cweitkamp @andrewfg
+/bundles/org.openhab.binding.huesync/ @pgfeller
 /bundles/org.openhab.binding.hydrawise/ @digitaldan
 /bundles/org.openhab.binding.hyperion/ @tavalin
 /bundles/org.openhab.binding.iammeter/ @lewei50

bom/openhab-addons/pom.xml

@@ -756,6 +756,11 @@
       <artifactId>org.openhab.binding.hue</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.huesync</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.hydrawise</artifactId>

bundles/org.openhab.binding.huesync/.gitignore

@@ -0,0 +1 @@
+scripts

bundles/org.openhab.binding.huesync/AUTHORS

@@ -0,0 +1,15 @@
+# This is the list of huesync's significant contributors.
+#
+# This does not necessarily list everyone who has contributed code,
+# To see the full list of contributors, see the revision history in
+# source control.
+
+@pgfeller - Patrik Gfeller <patrik.gfeller@proton.me>
+
+# The binding used work from the following developvers as reference 
+# and base for the implementation:
+@HHomey-GER - Marco Kawon (https://github.com/Homey-GER/openhab-addons)
+
+@andrewfg   - Andrew Fiddian-Green (hue binding) 
+@cweitkamp  - Christoph Weitkamp (hue binding)
+

bundles/org.openhab.binding.huesync/NOTICE

@@ -0,0 +1,13 @@
+This content is produced and maintained by the openHAB project.
+
+* Project home: https://www.openhab.org
+
+== Declared Project Licenses
+
+This program and the accompanying materials are made available under the terms
+of the Eclipse Public License 2.0 which is available at
+https://www.eclipse.org/legal/epl-2.0/.
+
+== Source Code
+
+https://github.com/openhab/openhab-addons

bundles/org.openhab.binding.huesync/pom.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>org.openhab.addons.bundles</groupId>
+    <artifactId>org.openhab.addons.reactor.bundles</artifactId>
+    <version>4.2.0-SNAPSHOT</version>
+  </parent>
+
+  <artifactId>org.openhab.binding.huesync</artifactId>
+
+  <name>openHAB Add-ons :: Bundles :: Hue Play HDMI Sync Box Binding</name>
+
+</project>

bundles/org.openhab.binding.huesync/src/main/feature/feature.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<features name="org.openhab.binding.huesync-${project.version}" xmlns="http://karaf.apache.org/xmlns/features/v1.4.0">
+	<repository>mvn:org.openhab.core.features.karaf/org.openhab.core.features.karaf.openhab-core/${ohc.version}/xml/features</repository>
+
+	<feature name="openhab-binding-huesync" description="Hue HDMI Sync Box Binding" version="${project.version}">
+		<feature>openhab-runtime-base</feature>
+		<feature>openhab-transport-mdns</feature>
+		<bundle start-level="80">mvn:org.openhab.addons.bundles/org.openhab.binding.huesync/${project.version}</bundle>
+	</feature>
+</features>

bundles/org.openhab.binding.huesync/src/main/java/org/openhab/binding/huesync/internal/HueSyncConstants.java

@@ -0,0 +1,96 @@
+/**
+ * Copyright (c) 2010-2024 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.huesync.internal;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.openhab.core.thing.ThingTypeUID;
+
+/**
+ * The {@link HueSyncConstants} class defines common constants, which are
+ * used across the whole binding.
+ *
+ * @author Patrik Gfeller - Initial contribution
+ */
+@NonNullByDefault
+public class HueSyncConstants {
+    public static class ENDPOINTS {
+        public static final String DEVICE = "device";
+        public static final String REGISTRATIONS = "registrations";
+        public static final String HDMI = "hdmi";
+        public static final String EXECUTION = "execution";
+    }
+
+    public static class CHANNELS {
+        public static class DEVICE {
+            public static class INFORMATION {
+                public static final String FIRMWARE = "device-firmware#firmware";
+                public static final String FIRMWARE_AVAILABLE = "device-firmware#available-firmware";
+            }
+        }
+
+        public static class HDMI {
+            public static class IN_1 {
+                public static final String NAME = "device-hdmi-in-1#name";
+                public static final String TYPE = "device-hdmi-in-1#type";
+                public static final String STATUS = "device-hdmi-in-1#status";
+                public static final String MODE = "device-hdmi-in-1#mode";
+            }
+
+            public static class IN_2 {
+                public static final String NAME = "device-hdmi-in-2#name";
+                public static final String TYPE = "device-hdmi-in-2#type";
+                public static final String STATUS = "device-hdmi-in-2#status";
+                public static final String MODE = "device-hdmi-in-2#mode";
+            }
+
+            public static class IN_3 {
+                public static final String NAME = "device-hdmi-in-3#name";
+                public static final String TYPE = "device-hdmi-in-3#type";
+                public static final String STATUS = "device-hdmi-in-3#status";
+                public static final String MODE = "device-hdmi-in-3#mode";
+            }
+
+            public static class IN_4 {
+                public static final String NAME = "device-hdmi-in-4#name";
+                public static final String TYPE = "device-hdmi-in-4#type";
+                public static final String STATUS = "device-hdmi-in-4#status";
+                public static final String MODE = "device-hdmi-in-4#mode";
+            }
+
+            public static class OUT {
+                public static final String NAME = "device-hdmi-out#name";
+                public static final String TYPE = "device-hdmi-out#type";
+                public static final String STATUS = "device-hdmi-out#status";
+                public static final String MODE = "device-hdmi-out#mode";
+            }
+        }
+    }
+
+    public static final String APPLICATION_NAME = "openHAB";
+
+    /** Minimal API Version required. Only apiLevel >= 7 is supported. */
+    public static final Integer MINIMAL_API_VERSION = 7;
+
+    public static final String BINDING_ID = "huesync";
+    public static final String THING_TYPE_ID = "huesyncthing";
+    public static final ThingTypeUID THING_TYPE_UID = new ThingTypeUID(BINDING_ID, THING_TYPE_ID);
+
+    public static final String PARAMETER_HOST = "host";
+    public static final String PARAMETER_PORT = "port";
+
+    public static final Integer REGISTRATION_INITIAL_DELAY = 3;
+    public static final Integer REGISTRATION_INTERVAL = 1;
+
+    public static final String REGISTRATION_ID = "registrationId";
+    public static final String API_TOKEN = "apiAccessToken";
+}

bundles/org.openhab.binding.huesync/src/main/java/org/openhab/binding/huesync/internal/api/dto/device/HueSyncDeviceDto.java

@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) 2010-2024 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.huesync.internal.api.dto.device;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.eclipse.jdt.annotation.Nullable;
+
+/**
+ * HDMI Sync Box Device Information DTO
+ * 
+ * @author Patrik Gfeller - Initial Contribution
+ * 
+ * @see <a href=
+ *      "https://developers.meethue.com/develop/hue-entertainment/hue-hdmi-sync-box-api/#Resource%20Table">Hue
+ *      HDMI Sync Box API</a>
+ */
+@NonNullByDefault
+public class HueSyncDeviceDto {
+    /** Friendly name of the device */
+    public @Nullable String name;
+    /** Device Type identifier */
+    public @Nullable String deviceType;
+    /**
+     * Capitalized hex string of the 6 byte / 12 characters device id without
+     * delimiters. Used as unique id on label, certificate common name, hostname
+     * etc.
+     */
+    public @Nullable String uniqueId;
+    /**
+     * Increased between firmware versions when api changes. Only apiLevel >= 7 is
+     * supported.
+     */
+    public int apiLevel = 0;
+    /**
+     * User readable version of the device firmware, starting with decimal major
+     * .minor .maintenance format e.g. “1.12.3”
+     */
+    public @Nullable String firmwareVersion;
+    /**
+     * Build number of the firmware. Unique for every build with newer builds
+     * guaranteed a higher number than older.
+     */
+    public int buildNumber = 0;
+
+    public boolean termsAgreed;
+
+    /** uninitialized, disconnected, lan, wan */
+    public @Nullable String wifiState;
+    public @Nullable String ipAddress;
+
+    public @Nullable HueSyncDeviceDtoCapabilitiesInfo capabilities;
+
+    public boolean beta;
+    public boolean overheating;
+    public boolean bluetooth;
+}

bundles/org.openhab.binding.huesync/src/main/java/org/openhab/binding/huesync/internal/api/dto/device/HueSyncDeviceDtoCapabilitiesInfo.java

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2010-2024 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.huesync.internal.api.dto.device;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+
+/**
+ * HDMI Sync Box Device Information Capabilities DTO
+ * 
+ * @author Patrik Gfeller - Initial Contribution
+ * 
+ * @see <a href=
+ *      "https://developers.meethue.com/develop/hue-entertainment/hue-hdmi-sync-box-api/#Resource%20Table">Hue
+ *      HDMI Sync Box API</a>
+ */
+@NonNullByDefault
+public class HueSyncDeviceDtoCapabilitiesInfo {
+    /** The total number of IR codes configurable */
+    public int maxIrCodes;
+    /** The total number of Presets configurable */
+    public int maxPresets;
+}

bundles/org.openhab.binding.huesync/src/main/java/org/openhab/binding/huesync/internal/api/dto/device/HueSyncDeviceDtoDetailed.java

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) 2010-2024 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.huesync.internal.api.dto.device;
+
+import java.util.Date;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.eclipse.jdt.annotation.Nullable;
+
+/**
+ * HDMI Sync Box Device Information DTO - Extended information (only available
+ * to registered clients)
+ * 
+ * @author Patrik Gfeller - Initial Contribution
+ * 
+ * @see <a href=
+ *      "https://developers.meethue.com/develop/hue-entertainment/hue-hdmi-sync-box-api/#Resource%20Table">Hue
+ *      HDMI Sync Box API</a>
+ */
+@NonNullByDefault
+public class HueSyncDeviceDtoDetailed extends HueSyncDeviceDto {
+    public @Nullable HueSyncDeviceDtoDetailedWifiInfo wifi;
+    public @Nullable HueSyncDeviceDtoDetailedUpdateInfo update;
+
+    /** UTC time when last check for update was performed. */
+    public @Nullable Date lastCheckedUpdate;
+    /**
+     * Build number that is available to update to. Item is set to null when there
+     * is no update available.
+     */
+    public int updatableBuildNumber;
+    /**
+     * User readable version of the firmware the device can upgrade to. Item is set
+     * to null when there is no update available.
+     */
+    public @Nullable String updatableFirmwareVersion;
+    /**
+     * 1 = regular;
+     * 0 = off in powersave, passthrough or sync mode;
+     * 2 = dimmed in powersave or passthrough mode and off in sync mode
+     */
+    public int ledMode = -1;
+
+    /** none, doSoftwareRestart, doFirmwareUpdate */
+    public @Nullable String action;
+    public @Nullable String pushlink;
+}

bundles/org.openhab.binding.huesync/src/main/java/org/openhab/binding/huesync/internal/api/dto/device/HueSyncDeviceDtoDetailedUpdateInfo.java

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2010-2024 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.huesync.internal.api.dto.device;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+
+/**
+ * HDMI Sync Box Device Information DTO - Automatic Firmware update
+ * 
+ * @author Patrik Gfeller - Initial Contribution
+ * 
+ * @see <a href=
+ *      "https://developers.meethue.com/develop/hue-entertainment/hue-hdmi-sync-box-api/#Resource%20Table">Hue
+ *      HDMI Sync Box API</a>
+ */
+@NonNullByDefault
+public class HueSyncDeviceDtoDetailedUpdateInfo {
+    /**
+     * Sync Box checks daily for a firmware update. If true, an available update
+     * will automatically be installed. This will be postponed if Sync Box is
+     * passing through content to the TV and being used.
+     */
+    public boolean autoUpdateEnabled;
+    /**
+     * TC hour when the automatic update will check and execute, values 0 – 23.
+     * Default is 10. Ideally this value should be set to 3AM according to user’s
+     * timezone.
+     */
+    public int autoUpdateTime;
+}