[ddwrt] Initial contribution of DD-WRT/OpenWrt/Tomato SSH based binding

CODEOWNERS

@@ -81,6 +81,7 @@
 /bundles/org.openhab.binding.dali/ @rs22
 /bundles/org.openhab.binding.danfossairunit/ @pravussum
 /bundles/org.openhab.binding.dbquery/ @lujop
+/bundles/org.openhab.binding.ddwrt/ @ballle98
 /bundles/org.openhab.binding.deconz/ @J-N-K
 /bundles/org.openhab.binding.denonmarantz/ @jwveldhuis
 /bundles/org.openhab.binding.deutschebahn/ @soenkekueper

bom/openhab-addons/pom.xml

@@ -391,6 +391,11 @@
       <artifactId>org.openhab.binding.dbquery</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.ddwrt</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.deconz</artifactId>

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

@@ -0,0 +1,37 @@
+<?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 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>5.2.0-SNAPSHOT</version>
+  </parent>
+
+  <artifactId>org.openhab.binding.ddwrt</artifactId>
+
+  <name>openHAB Add-ons :: Bundles :: ddwrt Binding</name>
+
+  <properties>
+    <bnd.importpackage>org.apache.tomcat.jni;resolution:="optional",org.bouncycastle.*;resolution:="optional",sun.security.x509;resolution:="optional"</bnd.importpackage>
+    <sshd.version>2.17.1</sshd.version>
+    <eddsa.version>0.3.0</eddsa.version>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>org.apache.sshd</groupId>
+      <artifactId>sshd-osgi</artifactId>
+      <version>${sshd.version}</version>
+    </dependency>
+    <!-- For ed25519 support -->
+    <dependency>
+      <groupId>net.i2p.crypto</groupId>
+      <artifactId>eddsa</artifactId>
+      <version>${eddsa.version}</version>
+    </dependency>
+  </dependencies>
+
+</project>

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

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<features name="org.openhab.binding.ddwrt-${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-ddwrt" description="DD-WRT Binding" version="${project.version}">
+		<feature>openhab-runtime-base</feature>
+		<bundle dependency="true">mvn:org.apache.sshd/sshd-osgi/2.17.1</bundle>
+		<bundle dependency="true">mvn:net.i2p.crypto/eddsa/0.3.0</bundle>
+		<bundle start-level="80">mvn:org.openhab.addons.bundles/org.openhab.binding.ddwrt/${project.version}</bundle>
+	</feature>
+</features>

bundles/org.openhab.binding.ddwrt/src/main/java/org/openhab/binding/ddwrt/internal/DDWRTBindingConstants.java

@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2010-2026 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.ddwrt.internal;
+
+import java.util.HashSet;
+import java.util.Objects;
+import java.util.Set;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.openhab.core.thing.ThingTypeUID;
+
+/**
+ * The {@link DDWRTBindingConstants} class defines common constants, which are
+ * used across the whole binding.
+ *
+ * @author Lee Ballard - Initial contribution
+ */
+@NonNullByDefault
+public class DDWRTBindingConstants {
+
+    private DDWRTBindingConstants() {
+    }
+
+    private static final String BINDING_ID = "ddwrt";
+
+    // List of all Thing Type UIDs
+    public static final ThingTypeUID BRIDGE_TYPE_NETWORK = new ThingTypeUID(BINDING_ID, "network");
+    public static final ThingTypeUID THING_TYPE_DEVICE = new ThingTypeUID(BINDING_ID, "device");
+    public static final ThingTypeUID THING_TYPE_RADIO = new ThingTypeUID(BINDING_ID, "radio");
+    public static final ThingTypeUID THING_TYPE_CLIENT = new ThingTypeUID(BINDING_ID, "client");
+    public static final ThingTypeUID THING_TYPE_FIREWALL_RULE = new ThingTypeUID(BINDING_ID, "firewall-rule");
+
+    public static final Set<ThingTypeUID> DISCOVERABLE_THING_TYPES_UIDS = Objects
+            .requireNonNull(Set.of(THING_TYPE_DEVICE, THING_TYPE_RADIO, THING_TYPE_CLIENT, THING_TYPE_FIREWALL_RULE));
+
+    public static final Set<ThingTypeUID> SUPPORTED_THING_TYPES_UIDS = new HashSet<>(DISCOVERABLE_THING_TYPES_UIDS);
+    static {
+        SUPPORTED_THING_TYPES_UIDS.add(BRIDGE_TYPE_NETWORK);
+    }
+
+    // List of network (bridge) channel ids
+    public static final String CHANNEL_TOTAL_CLIENTS = "total-clients";
+    public static final String CHANNEL_WIRELESS_CLIENTS = "wireless-clients";
+    public static final String CHANNEL_WIRED_CLIENTS = "wired-clients";
+    public static final String CHANNEL_DHCP_LEASES = "dhcp-leases";
+    public static final String CHANNEL_DHCP_REMAINING = "dhcp-remaining";
+    public static final String CHANNEL_WAN_IP = "wan-ip";
+    public static final String CHANNEL_WAN_IN = "wan-in";
+    public static final String CHANNEL_WAN_OUT = "wan-out";
+
+    // List of common channel ids
+    public static final String CHANNEL_ONLINE = "online";
+    public static final String CHANNEL_UPTIME = "uptime";
+
+    // List of device channel ids
+    public static final String CHANNEL_DEVICE_WIRELESS_CLIENTS = "device-wireless-clients";
+    public static final String CHANNEL_CPU_LOAD = "cpu-load";
+    public static final String CHANNEL_CPU_TEMP = "cpu-temp";
+    public static final String CHANNEL_IF_IN = "if-in";
+    public static final String CHANNEL_IF_OUT = "if-out";
+    public static final String CHANNEL_REBOOT = "reboot";
+
+    // List of radio channel ids
+    public static final String CHANNEL_ENABLED = "enabled";
+    public static final String CHANNEL_CHANNEL = "channel";
+    public static final String CHANNEL_SSID = "ssid";
+    public static final String CHANNEL_MODE = "mode";
+    public static final String CHANNEL_CLIENT_COUNT = "client-count";
+    public static final String CHANNEL_ASSOCLIST = "assoc-list";
+
+    // List of client channel ids
+    public static final String CHANNEL_MAC_ADDRESS = "mac-address";
+    public static final String CHANNEL_HOSTNAME = "hostname";
+    public static final String CHANNEL_IP_ADDRESS = "ip-address";
+    public static final String CHANNEL_AP = "ap";
+    public static final String CHANNEL_AP_MAC = "ap-mac";
+    public static final String CHANNEL_SIGNAL = "signal";
+    public static final String CHANNEL_SNR = "snr";
+    public static final String CHANNEL_RX_RATE = "rx-rate";
+    public static final String CHANNEL_TX_RATE = "tx-rate";
+    public static final String CHANNEL_LAST_SEEN = "last-seen";
+    public static final String CHANNEL_CONNECTION_TYPE = "connection-type";
+
+    // List of firewall rule channel ids
+    public static final String CHANNEL_DESCRIPTION = "description";
+
+    // Syslog follower health
+    public static final String CHANNEL_SYSLOG_CONNECTED = "syslog-connected";
+
+    // List of syslog event channel ids (modeled after logreader binding)
+    public static final String CHANNEL_LAST_WARNING_EVENT = "last-warning-event";
+    public static final String CHANNEL_LAST_ERROR_EVENT = "last-error-event";
+    public static final String CHANNEL_WARNING_EVENTS = "warning-events";
+    public static final String CHANNEL_ERROR_EVENTS = "error-events";
+    public static final String CHANNEL_LAST_DHCP_EVENT = "last-dhcp-event";
+    public static final String CHANNEL_LAST_WIRELESS_EVENT = "last-wireless-event";
+    public static final String CHANNEL_WARNING_EVENT = "warning-event";
+    public static final String CHANNEL_ERROR_EVENT = "error-event";
+    public static final String CHANNEL_DHCP_EVENT = "dhcp-event";
+    public static final String CHANNEL_WIRELESS_EVENT = "wireless-event";
+
+    // List of all configuration parameters
+    public static final String HOSTNAME = "hostname";
+    public static final String HOSTNAMES = "hostnames";
+    public static final String PORT = "port";
+    public static final String USER = "user";
+    public static final String PASSWORD = "password";
+    public static final String REFRESH_INTERVAL = "refreshInterval";
+    public static final String INTERFACE_ID = "interfaceId";
+    public static final String PARENT_DEVICE_MAC = "parentDeviceMac";
+    public static final String MAC = "mac";
+    public static final String RULE_ID = "ruleId";
+    public static final String CHIPSET = "chipset";
+}

bundles/org.openhab.binding.ddwrt/src/main/java/org/openhab/binding/ddwrt/internal/DDWRTClientConfiguration.java

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2010-2026 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.ddwrt.internal;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+
+/**
+ * Configuration for a DD-WRT client thing.
+ *
+ * @author Lee Ballard - Initial contribution
+ */
+@NonNullByDefault
+public class DDWRTClientConfiguration {
+
+    public String hostname = "";
+    public String mac = "";
+}

bundles/org.openhab.binding.ddwrt/src/main/java/org/openhab/binding/ddwrt/internal/DDWRTDeviceConfiguration.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2010-2026 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.ddwrt.internal;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+
+/**
+ * The {@link DDWRTDeviceConfiguration} class contains fields mapping thing configuration parameters for
+ * {@link DDWRTDeviceThingHandler}.
+ *
+ * @author Lee Ballard - Initial contribution
+ */
+@NonNullByDefault
+public class DDWRTDeviceConfiguration {
+
+    public String hostname = "";
+    public String user = "root";
+    public boolean useSystemUser = false;
+    public String password = "";
+    public int port = 0;
+    public int refreshInterval = 3;
+    public String syslogPriority = "warning";
+
+    /**
+     * Returns the effective username for SSH connections.
+     * When {@link #useSystemUser} is true, returns empty string so the SSH client
+     * resolves from ~/.ssh/config or the system username.
+     */
+    public String getEffectiveUser() {
+        return useSystemUser ? "" : user;
+    }
+}