[dolbycp] Initial Contribution

CODEOWNERS

@@ -77,6 +77,7 @@
 /bundles/org.openhab.binding.digitalstrom/ @openhab/add-ons-maintainers
 /bundles/org.openhab.binding.dlinksmarthome/ @MikeJMajor
 /bundles/org.openhab.binding.dmx/ @openhab/add-ons-maintainers
+/bundles/org.openhab.binding.dolbycp/ @Cybso
 /bundles/org.openhab.binding.dominoswiss/ @Friesoch
 /bundles/org.openhab.binding.doorbird/ @mhilbush
 /bundles/org.openhab.binding.draytonwiser/ @andrew-schofield

bom/openhab-addons/pom.xml

@@ -376,6 +376,11 @@
       <artifactId>org.openhab.binding.dmx</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.dolbycp</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.dominoswiss</artifactId>

bundles/org.openhab.binding.dolbycp/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.dolbycp/README.md

@@ -0,0 +1,49 @@
+# DolbyCP Binding
+
+This binding is intended to connect to a _Dolby Digital Cinema Processor CP750_.
+Support for CP950 may be added in future (if someone who owns one helps to test it).
+
+It uses ASCII commands send over a TCP connection on port 61408. Please note that the CP750 only accepts up to 20 simultaneous connection and will discard the oldest connection if a 21st connection is established. So be sure to grateful shutdown each connection using the client's close() method, or it's AutoCloseable functionality.
+
+This binding wraps the CP750 Java library from https://github.com/Cybso/cp750-java/.
+
+This project is NOT affiliated with, funded, or in any way associated with Dolby Laboratories, Inc.
+
+Currently, only _Fader_, _Mute_ and _Input Mode_ channels are implemented.
+
+## Supported Things
+
+- `cp750`
+
+## Thing Configuration
+
+Normally, only the hostname or IP address must be configured.
+
+### `sample` Thing Configuration
+
+| Name              | Type    | Description                                       | Default | Required | Advanced |
+|-------------------|---------|---------------------------------------------------|---------|----------|----------|
+| hostname          | text    | Hostname or IP address of the device              | N/A     | yes      | no       |
+| port              | integer | TCP port if different from 61408                  | 61408   | no       | no       |
+| refreshInterval   | integer | Interval the device is polled in sec.             | 5       | no       | no       |
+| reconnectInterval | integer | Interval a new connection is tried after IO error | 10      | no       | no       |
+
+## Channels
+
+_Here you should provide information about available channel types, what their meaning is and how they can be used._
+
+_Note that it is planned to generate some part of this based on the XML files within ```src/main/resources/OH-INF/thing``` of your binding._
+
+| Channel | Type   | Read/Write | Description                                                                                                     |
+|---------|--------|------------|-----------------------------------------------------------------------------------------------------------------|
+| version | Switch | R          | Version as reported by the device                                                                               |
+| fader   | Dimmer | RW         | Fader value (0 to 100)                                                                                          | 
+| mute    | Switch | RW         | Mute (ON or OFF)                                                                                                |
+| input   | String | RW         | Input channel as string (one of "analog", "dig-1", "dig-2", "dig-3", "dig-4", "non-sync" or "mic")              |
+| analog  | Switch | RW         | Is ON if input mode is 'analog'. When an ON command is retrieved, input mode will be changed to this channel.   |
+| dig1    | Switch | RW         | Is ON if input mode is 'dig-1'. When an ON command is retrieved, input mode will be changed to this channel.    |
+| dig2    | Switch | RW         | Is ON if input mode is 'dig-2'. When an ON command is retrieved, input mode will be changed to this channel.    |
+| dig3    | Switch | RW         | Is ON if input mode is 'dig-3'. When an ON command is retrieved, input mode will be changed to this channel.    |
+| dig4    | Switch | RW         | Is ON if input mode is 'dig-4'. When an ON command is retrieved, input mode will be changed to this channel.    |
+| nonsync | Switch | RW         | Is ON if input mode is 'non-sync'. When an ON command is retrieved, input mode will be changed to this channel. |
+| mic     | Switch | RW         | Is ON if input mode is 'mic'. When an ON command is retrieved, input mode will be changed to this channel.      |

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

@@ -0,0 +1,26 @@
+<?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.dolbycp</artifactId>
+
+  <name>openHAB Add-ons :: Bundles :: DolbyCP Binding</name>
+
+  <dependencies>
+    <dependency>
+      <groupId>de.cybso.cp750</groupId>
+      <artifactId>cp750</artifactId>
+      <version>0.2</version>
+      <scope>compile</scope>
+    </dependency>
+  </dependencies>
+
+</project>

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

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<features name="org.openhab.binding.dolbycp-${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-dolbycp" description="DolbyCP Binding" version="${project.version}">
+		<feature>openhab-runtime-base</feature>
+		<bundle start-level="80">mvn:org.openhab.addons.bundles/org.openhab.binding.dolbycp/${project.version}</bundle>
+	</feature>
+</features>

bundles/org.openhab.binding.dolbycp/src/main/java/org/openhab/binding/dolbycp/internal/DolbyCPBindingConstants.java

@@ -0,0 +1,44 @@
+/**
+ * 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.dolbycp.internal;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.openhab.core.thing.ThingTypeUID;
+
+/**
+ * The {@link DolbyCPBindingConstants} class defines common constants, which are
+ * used across the whole binding.
+ *
+ * @author Roland Tapken - Initial contribution
+ */
+@NonNullByDefault
+public class DolbyCPBindingConstants {
+
+    private static final String BINDING_ID = "dolbycp";
+
+    // List of all Thing Type UIDs
+    public static final ThingTypeUID THING_TYPE_SAMPLE = new ThingTypeUID(BINDING_ID, "connection");
+
+    // List of all Channel ids
+    public static final String CHANNEL_FADER = "channel-fader";
+    public static final String CHANNEL_MUTE = "channel-mute";
+    public static final String CHANNEL_INPUT = "channel-input";
+    public static final String CHANNEL_ANALOG = "channel-analog";
+    public static final String CHANNEL_DIG1 = "channel-dig1";
+    public static final String CHANNEL_DIG2 = "channel-dig2";
+    public static final String CHANNEL_DIG3 = "channel-dig3";
+    public static final String CHANNEL_DIG4 = "channel-dig4";
+    public static final String CHANNEL_NONSYNC = "channel-nonsync";
+    public static final String CHANNEL_MIC = "channel-mic";
+    public static final String CHANNEL_VERSION = "channel-version";
+}

bundles/org.openhab.binding.dolbycp/src/main/java/org/openhab/binding/dolbycp/internal/DolbyCPConfiguration.java

@@ -0,0 +1,43 @@
+/**
+ * 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.dolbycp.internal;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+
+/**
+ * The {@link DolbyCPConfiguration} class contains fields mapping thing configuration parameters.
+ *
+ * @author Roland Tapken - Initial contribution
+ */
+@NonNullByDefault
+public class DolbyCPConfiguration {
+    /**
+     * Hostname or IP address of the CP750 device
+     */
+    public String hostname = "";
+
+    /**
+     * TCP Port to connect o (default: 61408)
+     */
+    public int port = 61408;
+
+    /**
+     * Interval to update channels
+     */
+    public int refreshInterval = 5;
+
+    /**
+     * Reconnect interval after a broken TCP connection
+     */
+    public int reconnectInterval = 10;
+}