[sungrow] added Backup Current/Power registers

CODEOWNERS

@@ -214,6 +214,7 @@
 /bundles/org.openhab.binding.modbus.sbc/ @fwolter
 /bundles/org.openhab.binding.modbus.stiebeleltron/ @pail23
 /bundles/org.openhab.binding.modbus.studer/ @giovannimirulla
+/bundles/org.openhab.binding.modbus.sungrow/ @soenkekueper
 /bundles/org.openhab.binding.modbus.sunspec/ @mrbig
 /bundles/org.openhab.binding.monopriceaudio/ @mlobstein
 /bundles/org.openhab.binding.mpd/ @stefanroellin

bom/openhab-addons/pom.xml

@@ -1061,6 +1061,11 @@
       <artifactId>org.openhab.binding.modbus.studer</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.modbus.sungrow</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.modbus.sunspec</artifactId>

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

@@ -0,0 +1,62 @@
+# Modbus Sungrow Binding
+
+<img src="./doc/sungrow_logo_25_pc.png" alt="Sungrow logo" align="right"/>
+
+This binding integrates the sungrow inverters into openHAB.
+It is based on the Sungrow specification "Communication Protocol of Residential Hybrid Inverter V1.0.23",
+which can be found here: https://github.com/bohdan-s/SunGather/issues/36.
+
+## Supported inverters
+
+As said within the spec the following inverters are supported (but not all are tested yet):
+
+- SH3K6
+- SH4K6
+- SH5K-20
+- SH5K-V13
+- SH3K6-30
+- SH4K6-30
+- SH5K-30
+- SH3.0RS
+- SH3.6RS
+- SH4.0RS
+- SH5.0RS
+- SH6.0RS
+- SH5.0RT
+- SH6.0RT
+- SH8.0RT
+- SH10RT
+
+## Supported Things
+
+The binding supports only one thing:
+
+- `sungrowInverter`: The sungrow inverter
+
+## Preparation
+
+The data from the inverter is read via Modbus. So you need to configure a Modbus Serial Slave `serial` or Modbus TCP Slave `tcp` as bridge first.
+If you are using a Modbus TCP Slave and the WiNet-S Communication Module please ensure:
+
+- that you have the correct IP-Address of your WiNet-S Device
+- that Modbus is enabled within the Communication Module
+- that you've the correct port number
+- that the white list is disabled or your openHAB instance IP is listed
+
+<img src="./doc/WiNet-S_Modbus.PNG" alt="WiNet-S Modbus configuration"/>
+
+## Thing Configuration
+
+Once you've configured the Modbus TCP Slave or Modbus Serial Slave as Bridge you can configure the Sungrow inverter thing.
+You just have to select the configured bridge and give the 
+
+### `sungrowInverter` Thing Configuration
+
+| Name            | Type    | Description                          | Default | Required | Advanced |
+|-----------------|---------|--------------------------------------|---------|----------|----------|
+| pollInterval    | integer | Interval the device is polled in ms.  | 5000    | no       | no       |
+
+## Channels
+
+The `sungrowInverter` thing has channels that serve the current state of the sungrow inverter,
+as you are used to from the iSolareCloud Website and App.

bundles/org.openhab.binding.modbus.sungrow/pom.xml

@@ -0,0 +1,27 @@
+<?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.0.0-SNAPSHOT</version>
+  </parent>
+
+  <artifactId>org.openhab.binding.modbus.sungrow</artifactId>
+
+  <name>openHAB Add-ons :: Bundles :: Modbus Sungrow Binding</name>
+
+  <dependencies>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.modbus</artifactId>
+      <version>${project.version}</version>
+      <scope>provided</scope>
+    </dependency>
+  </dependencies>
+
+
+</project>

bundles/org.openhab.binding.modbus.sungrow/src/main/java/org/openhab/binding/modbus/sungrow/internal/ConversionConstants.java

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2010-2023 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.modbus.sungrow.internal;
+
+import java.math.BigDecimal;
+import java.math.BigInteger;
+import java.util.function.Function;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+
+/**
+ * Constants for converting values.
+ *
+ * @author Sönke Küper - Initial contribution
+ */
+@NonNullByDefault
+final class ConversionConstants {
+
+    private ConversionConstants() {
+    }
+
+    /**
+     * Multiplicand for 0.1.
+     */
+    static final BigDecimal DIV_BY_TEN = new BigDecimal(BigInteger.ONE, 1);
+
+    /**
+     * Value conversion from Celsius to Kelvin.
+     */
+    static final Function<BigDecimal, BigDecimal> CELSIUS_TO_KELVIN = (BigDecimal celsius) -> celsius
+            .add(new BigDecimal(273.15f));
+}

bundles/org.openhab.binding.modbus.sungrow/src/main/java/org/openhab/binding/modbus/sungrow/internal/ModbusSungrowBindingConstants.java

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) 2010-2023 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.modbus.sungrow.internal;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.openhab.binding.modbus.ModbusBindingConstants;
+import org.openhab.core.thing.ThingTypeUID;
+
+/**
+ * The {@link ModbusSungrowBindingConstants} class defines common constants, which are
+ * used across the whole binding.
+ *
+ * @author Sönke Küper - Initial contribution
+ */
+@NonNullByDefault
+public class ModbusSungrowBindingConstants {
+
+    /**
+     * ThingType-ID for Inverter.
+     */
+    public static final ThingTypeUID THING_TYPE_INVERTER = new ThingTypeUID(ModbusBindingConstants.BINDING_ID,
+            "sungrow-inverter");
+}

bundles/org.openhab.binding.modbus.sungrow/src/main/java/org/openhab/binding/modbus/sungrow/internal/ModbusSungrowHandlerFactory.java

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) 2010-2023 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.modbus.sungrow.internal;
+
+import static org.openhab.binding.modbus.sungrow.internal.ModbusSungrowBindingConstants.*;
+
+import java.util.Set;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.eclipse.jdt.annotation.Nullable;
+import org.openhab.core.thing.Thing;
+import org.openhab.core.thing.ThingTypeUID;
+import org.openhab.core.thing.binding.BaseThingHandlerFactory;
+import org.openhab.core.thing.binding.ThingHandler;
+import org.openhab.core.thing.binding.ThingHandlerFactory;
+import org.osgi.service.component.annotations.Component;
+
+/**
+ * The {@link ModbusSungrowHandlerFactory} is responsible for creating things and thing
+ * handlers.
+ *
+ * @author Sönke Küper - Initial contribution
+ */
+@NonNullByDefault
+@Component(configurationPid = "binding.sungrow", service = ThingHandlerFactory.class)
+public class ModbusSungrowHandlerFactory extends BaseThingHandlerFactory {
+
+    private static final Set<ThingTypeUID> SUPPORTED_THING_TYPES_UIDS = Set.of(THING_TYPE_INVERTER);
+
+    @Override
+    public boolean supportsThingType(ThingTypeUID thingTypeUID) {
+        return SUPPORTED_THING_TYPES_UIDS.contains(thingTypeUID);
+    }
+
+    @Override
+    protected @Nullable ThingHandler createHandler(Thing thing) {
+        ThingTypeUID thingTypeUID = thing.getThingTypeUID();
+
+        if (THING_TYPE_INVERTER.equals(thingTypeUID)) {
+            return new SungrowInverterHandler(thing);
+        }
+
+        return null;
+    }
+}

bundles/org.openhab.binding.modbus.sungrow/src/main/java/org/openhab/binding/modbus/sungrow/internal/SungrowInverterConfiguration.java

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2010-2023 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.modbus.sungrow.internal;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+
+/**
+ * The {@link SungrowInverterConfiguration} class contains fields mapping thing configuration parameters.
+ *
+ * @author Sönke Küper - Initial contribution
+ */
+@NonNullByDefault
+public class SungrowInverterConfiguration {
+
+    public int pollInterval;
+}