[Worxlandroid] Initial contribution

CODEOWNERS

@@ -442,6 +442,7 @@
 /bundles/org.openhab.binding.wlanthermo/ @CSchlipp
 /bundles/org.openhab.binding.wled/ @Skinah
 /bundles/org.openhab.binding.wolfsmartset/ @BoBiene
+/bundles/org.openhab.binding.worxlandroid/ @clinique
 /bundles/org.openhab.binding.wundergroundupdatereceiver/ @danieldemus
 /bundles/org.openhab.binding.x/ @computergeek1507
 /bundles/org.openhab.binding.xmltv/ @clinique

bom/openhab-addons/pom.xml

@@ -2186,6 +2186,11 @@
       <artifactId>org.openhab.binding.wolfsmartset</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.worxlandroid</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.wundergroundupdatereceiver</artifactId>

bundles/org.openhab.binding.worxlandroid/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.worxlandroid/pom.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://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>5.1.0-SNAPSHOT</version>
+  </parent>
+
+  <artifactId>org.openhab.binding.worxlandroid</artifactId>
+
+  <name>openHAB Add-ons :: Bundles :: Worx Landroid Binding</name>
+
+  <dependencies>
+    <dependency>
+      <groupId>software.amazon.awssdk.iotdevicesdk</groupId>
+      <artifactId>aws-iot-device-sdk</artifactId>
+      <version>1.27.4</version>
+      <scope>provided</scope>
+    </dependency>
+    <dependency>
+      <groupId>software.amazon.awssdk.crt</groupId>
+      <artifactId>aws-crt</artifactId>
+      <version>0.38.13</version>
+      <scope>provided</scope>
+    </dependency>
+  </dependencies>
+
+</project>

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

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<features name="org.openhab.binding.worxlandroid-${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-worxlandroid" description="Worx Landroid Binding" version="${project.version}">
+		<feature>openhab-runtime-base</feature>
+		<bundle start-level="80">mvn:org.openhab.addons.bundles/org.openhab.binding.worxlandroid/${project.version}</bundle>
+		<bundle dependency="true">mvn:org.openhab.osgiify/software.amazon.awssdk.iotdevicesdk.aws-iot-device-sdk/1.27.4</bundle>
+	</feature>
+</features>

bundles/org.openhab.binding.worxlandroid/src/main/java/org/openhab/binding/worxlandroid/internal/WorxLandroidBindingConstants.java

@@ -0,0 +1,110 @@
+/*
+ * Copyright (c) 2010-2025 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.worxlandroid.internal;
+
+import java.util.Set;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.openhab.core.thing.ThingTypeUID;
+
+/**
+ * The {@link WorxLandroidBindingConstants} class defines datCommon constants, which are
+ * used across the whole binding.
+ *
+ * @author Nils Billing - Initial contribution
+ */
+@NonNullByDefault
+public class WorxLandroidBindingConstants {
+
+    public static final String BINDING_ID = "worxlandroid";
+
+    // List of all Thing Type UIDs
+    public static final ThingTypeUID THING_TYPE_BRIDGE = new ThingTypeUID(BINDING_ID, "bridge");
+    public static final ThingTypeUID THING_TYPE_MOWER = new ThingTypeUID(BINDING_ID, "mower");
+
+    public static final Set<ThingTypeUID> SUPPORTED_THING_TYPES = Set.of(THING_TYPE_MOWER);
+
+    // Channel group ids
+    public static final String GROUP_COMMON = "common";
+    public static final String GROUP_CONFIG = "config";
+    public static final String GROUP_MULTI_ZONES = "multi-zones";
+    public static final String GROUP_SCHEDULE = "schedule";
+    public static final String GROUP_ONE_TIME = "one-time";
+    public static final String GROUP_BATTERY = "battery";
+    public static final String GROUP_ORIENTATION = "orientation";
+    public static final String GROUP_METRICS = "metrics";
+    public static final String GROUP_RAIN = "rain";
+    public static final String GROUP_WIFI = "wifi";
+    public static final String GROUP_AWS = "aws";
+
+    // List channel ids
+    // common
+    public static final String CHANNEL_ONLINE_TIMESTAMP = "online-timestamp";
+    public static final String CHANNEL_ACTION = "action";
+    public static final String CHANNEL_ENABLE = "enable";
+    public static final String CHANNEL_ONLINE = "online";
+    public static final String CHANNEL_LOCK = "lock";
+    public static final String CHANNEL_RSSI = "rssi";
+
+    // AWS
+    public static final String CHANNEL_POLL = "poll";
+    public static final String CHANNEL_CONNECTED = "connected";
+
+    // cfgCommon
+    public static final String CHANNEL_TIMESTAMP = "timestamp";
+    public static final String CHANNEL_COMMAND = "command";
+    public static final String CHANNEL_DELAY = "delay";
+
+    // cfgSc
+    public static final String CHANNEL_TIME_EXTENSION = "time-extension";
+    public static final String CHANNEL_MODE = "mode";
+    public static final String CHANNEL_START = "next-start";
+    public static final String CHANNEL_STOP = "next-stop";
+
+    // cfgScXXXday
+    public static final String CHANNEL_DURATION = "duration";
+    public static final String CHANNEL_EDGECUT = "edgecut";
+    public static final String CHANNEL_TIME = "time";
+
+    // datCommon
+    public static final String CHANNEL_WIFI_QUALITY = "wifi-quality";
+    public static final String CHANNEL_LAST_ZONE = "last-zone";
+    public static final String CHANNEL_STATUS_CODE = "status";
+    public static final String CHANNEL_ERROR_CODE = "error";
+
+    // datBattery
+    public static final String CHANNEL_TEMPERATURE = "temperature";
+    public static final String CHANNEL_VOLTAGE = "voltage";
+    public static final String CHANNEL_LEVEL = "level";
+    public static final String CHANNEL_CHARGE_CYCLES = "charge-cycles";
+    public static final String CHANNEL_CHARGE_CYCLES_TOTAL = "charge-cycles-total";
+    public static final String CHANNEL_CHARGING = "charging";
+
+    // datDmp
+    public static final String CHANNEL_PITCH = "pitch";
+    public static final String CHANNEL_ROLL = "roll";
+    public static final String CHANNEL_YAW = "yaw";
+
+    // datSt
+    public static final String CHANNEL_BLADE_TIME = "blade-time";
+    public static final String CHANNEL_BLADE_TIME_TOTAL = "blade-time-total";
+    public static final String CHANNEL_DISTANCE = "distance";
+    public static final String CHANNEL_TOTAL_TIME = "total-time";
+
+    // datRain
+    public static final String CHANNEL_RAIN_STATE = "state";
+    public static final String CHANNEL_RAIN_COUNTER = "counter";
+
+    public static final String CHANNEL_PREFIX_ALLOCATION = "allocation-%d";
+    public static final String CHANNEL_PREFIX_ZONE = "zone-%d";
+}

bundles/org.openhab.binding.worxlandroid/src/main/java/org/openhab/binding/worxlandroid/internal/WorxLandroidHandlerFactory.java

@@ -0,0 +1,98 @@
+/*
+ * Copyright (c) 2010-2025 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.worxlandroid.internal;
+
+import static org.openhab.binding.worxlandroid.internal.WorxLandroidBindingConstants.*;
+
+import java.util.HashMap;
+import java.util.Hashtable;
+import java.util.Map;
+import java.util.Set;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.eclipse.jdt.annotation.Nullable;
+import org.openhab.binding.worxlandroid.internal.api.WorxApiHandler;
+import org.openhab.binding.worxlandroid.internal.discovery.MowerDiscoveryService;
+import org.openhab.binding.worxlandroid.internal.handler.WorxLandroidBridgeHandler;
+import org.openhab.binding.worxlandroid.internal.handler.WorxLandroidMowerHandler;
+import org.openhab.core.auth.client.oauth2.OAuthFactory;
+import org.openhab.core.config.discovery.DiscoveryService;
+import org.openhab.core.thing.Bridge;
+import org.openhab.core.thing.Thing;
+import org.openhab.core.thing.ThingTypeUID;
+import org.openhab.core.thing.ThingUID;
+import org.openhab.core.thing.binding.BaseThingHandlerFactory;
+import org.openhab.core.thing.binding.ThingHandler;
+import org.openhab.core.thing.binding.ThingHandlerFactory;
+import org.osgi.framework.ServiceRegistration;
+import org.osgi.service.component.annotations.Activate;
+import org.osgi.service.component.annotations.Component;
+import org.osgi.service.component.annotations.Reference;
+
+/**
+ * The {@link WorxLandroidHandlerFactory} is responsible for creating things and thing
+ * handlers.
+ *
+ * @author Nils Billing - Initial contribution
+ * @author Gaël L'hopital - Added oAuthFactory
+ */
+@NonNullByDefault
+@Component(configurationPid = "binding.worxlandroid", service = ThingHandlerFactory.class)
+public class WorxLandroidHandlerFactory extends BaseThingHandlerFactory {
+    private static final Set<ThingTypeUID> SUPPORTED_THING_TYPES_UIDS = Set.of(THING_TYPE_MOWER, THING_TYPE_BRIDGE);
+
+    private final Map<ThingUID, ServiceRegistration<?>> discoveryServiceRegs = new HashMap<>();
+    private final OAuthFactory oAuthFactory;
+    private final WorxApiHandler worxApiHandler;
+
+    @Activate
+    public WorxLandroidHandlerFactory(final @Reference OAuthFactory oAuthFactory,
+            final @Reference WorxApiHandler worxApiHandler) {
+        this.oAuthFactory = oAuthFactory;
+        this.worxApiHandler = worxApiHandler;
+    }
+
+    @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_BRIDGE.equals(thingTypeUID)) {
+            WorxLandroidBridgeHandler bridgeHandler = new WorxLandroidBridgeHandler((Bridge) thing, worxApiHandler,
+                    oAuthFactory);
+            MowerDiscoveryService discoveryService = new MowerDiscoveryService(bridgeHandler);
+            discoveryServiceRegs.put(thing.getUID(), bundleContext.registerService(DiscoveryService.class.getName(),
+                    discoveryService, new Hashtable<>()));
+
+            return bridgeHandler;
+        } else if (THING_TYPE_MOWER.equals(thingTypeUID)) {
+            return new WorxLandroidMowerHandler(thing, worxApiHandler.getDeserializer());
+        }
+        return null;
+    }
+
+    @Override
+    protected void removeHandler(ThingHandler handler) {
+        if (handler instanceof WorxLandroidBridgeHandler) {
+            ServiceRegistration<?> serviceReg = discoveryServiceRegs.remove(handler.getThing().getUID());
+            if (serviceReg != null) {
+                serviceReg.unregister();
+            }
+        }
+        super.removeHandler(handler);
+    }
+}