[WWSTCERT-13462, WWSTCERT-13465] Sonoff SWV2C valve support

drivers/SmartThings/zigbee-valve/fingerprints.yml

@@ -39,5 +39,14 @@ zigbeeManufacturer :
     manufacturer: Compacta
     model: ZBVC1(1023A)
     deviceProfileName: valve-battery-powerSource
-
+  - id: SONOFF/SWV-ZF2U
+    deviceLabel: SONOFF Water Valve 2
+    manufacturer: SONOFF
+    model: SWV-ZF2U
+    deviceProfileName: valve-battery-2
+  - id: SONOFF/SWV-ZF2
+    deviceLabel: SONOFF Water Valve 2
+    manufacturer: SONOFF
+    model: SWV-ZF2
+    deviceProfileName: valve-battery-2
 

drivers/SmartThings/zigbee-valve/profiles/valve-battery-2.yml

@@ -0,0 +1,21 @@
+name: valve-battery-2
+components:
+- id: main
+  capabilities:
+  - id: valve
+    version: 1
+  - id: battery
+    version: 1
+  - id: powerSource
+    version: 1
+    config:
+      values:
+        - key: "powerSource.value"
+          enabledValues:
+            - battery
+  - id: firmwareUpdate
+    version: 1
+  - id: refresh
+    version: 1
+  categories:
+  - name: WaterValve

drivers/SmartThings/zigbee-valve/profiles/valve.yml

@@ -0,0 +1,10 @@
+name: valve
+components:
+- id: main
+  capabilities:
+  - id: valve
+    version: 1
+  - id: refresh
+    version: 1
+  categories:
+  - name: WaterValve

drivers/SmartThings/zigbee-valve/src/init.lua

@@ -1,7 +1,6 @@
 -- Copyright 2022 SmartThings, Inc.
 -- Licensed under the Apache License, Version 2.0
 
-
 local ZigbeeDriver = require "st.zigbee"
 local defaults = require "st.zigbee.defaults"
 

drivers/SmartThings/zigbee-valve/src/sonoff/can_handle.lua

@@ -0,0 +1,18 @@
+-- Copyright 2026 SmartThings, Inc.
+-- Licensed under the Apache License, Version 2.0
+
+local FINGERPRINTS = {
+  { mfr = "SONOFF", model = "SWV-ZF2U" },
+  { mfr = "SONOFF", model = "SWV-ZF2" }
+}
+
+local function sonoff_can_handle(opts, driver, device, ...)
+  for _, fingerprint in ipairs(FINGERPRINTS) do
+    if device:get_manufacturer() == fingerprint.mfr and device:get_model() == fingerprint.model then
+      return true, require "sonoff"
+    end
+  end
+  return false
+end
+
+return sonoff_can_handle

drivers/SmartThings/zigbee-valve/src/sonoff/init.lua

@@ -0,0 +1,131 @@
+-- Copyright 2026 SmartThings, Inc.
+-- Licensed under the Apache License, Version 2.0
+
+local capabilities = require "st.capabilities"
+local log = require "log"
+local zcl_clusters = require "st.zigbee.zcl.clusters"
+local Basic = zcl_clusters.Basic
+local OnOff = zcl_clusters.OnOff
+local PowerConfiguration = zcl_clusters.PowerConfiguration
+local st_device = require "st.device"
+local utils = require "st.utils"
+
+local CONFIGURATION = {
+  {
+    cluster = PowerConfiguration.ID,
+    attribute = PowerConfiguration.attributes.BatteryPercentageRemaining.ID,
+    minimum_interval = 30,
+    maximum_interval = 21600,
+    data_type = PowerConfiguration.attributes.BatteryPercentageRemaining.base_type,
+    reportable_change = 1
+  },
+  {
+    cluster = OnOff.ID,
+    attribute = OnOff.attributes.OnOff.ID,
+    minimum_interval = 0,
+    maximum_interval = 600,
+    data_type = OnOff.attributes.OnOff.base_type
+  }
+}
+
+local function find_child(parent, ep_id)
+  return parent:get_child_by_parent_assigned_key(string.format("%02X", ep_id))
+end
+
+--- OnOff Property Reporting → Valve Capability Point Event
+local function onoff_attr_handler(driver, device, value, zb_rx)
+  local ep = zb_rx.address_header.src_endpoint.value
+  local target = device
+  if ep == 0x02 then
+    local child = find_child(device, 2)
+    if child then target = child end
+  end
+  log.info(string.format("[SWV] OnOff report ep=%s value=%s", tostring(ep), tostring(value.value)))
+  if value.value == true or value.value == 1 then
+    target:emit_event(capabilities.valve.valve.open())
+  else
+    target:emit_event(capabilities.valve.valve.closed())
+  end
+end
+
+--- Battery Percentage Attribute Handler
+local function battery_percentage_handler(driver, device, value)
+  device:emit_event(capabilities.battery.battery(utils.round(value.value / 2)))
+end
+
+--- Lifecycle initialization handler
+local function device_init(driver, device)
+  if device.network_type == st_device.NETWORK_TYPE_ZIGBEE then
+    device:set_find_child(find_child)
+    for _, attribute in ipairs(CONFIGURATION) do
+      device:add_configured_attribute(attribute)
+    end
+  end
+end
+
+--- doConfigure
+local function do_configure(driver, device)
+  if device.network_type == st_device.NETWORK_TYPE_ZIGBEE then
+    device:refresh()
+    device:configure()
+  end
+end
+
+--- added
+local function device_added(driver, device)
+  if device.network_type == st_device.NETWORK_TYPE_ZIGBEE then
+    if find_child(device, 2) == nil then
+      driver:try_create_device({
+        type = "EDGE_CHILD",
+        label = string.format("%s 2", device.label),
+        profile = "valve",
+        parent_device_id = device.id,
+        parent_assigned_child_key = string.format("%02X", 2),
+        vendor_provided_label = string.format("%s 2", device.label),
+      })
+    end
+  end
+  device:refresh()
+end
+
+--- driverSwitched
+local function driver_switched(driver, device)
+  device_added(driver, device)
+end
+
+--- Identity cluster handler：button pressed on the device, sync valve states
+local function identify_handler(driver, device, zb_rx)
+  log.info("[SWV] Identify received, syncing valve states")
+  device.thread:call_with_delay(2, function()
+    device:send(OnOff.attributes.OnOff:read(device))
+    device:send(OnOff.attributes.OnOff:read(device):to_endpoint(0x02))
+  end)
+end
+
+local sonoff_valve_handler = {
+  NAME = "SONOFF Water Valve Handler",
+  lifecycle_handlers = {
+    init = device_init,
+    added = device_added,
+    doConfigure = do_configure,
+    driverSwitched = driver_switched,
+  },
+  zigbee_handlers = {
+    attr = {
+      [OnOff.ID] = {
+        [OnOff.attributes.OnOff.ID] = onoff_attr_handler
+      },
+      [PowerConfiguration.ID] = {
+        [PowerConfiguration.attributes.BatteryPercentageRemaining.ID] = battery_percentage_handler
+      }
+    },
+    cluster = {
+      [Basic.ID] = {
+        [Basic.server.commands.ResetToFactoryDefaults.ID] = identify_handler
+      }
+    }
+  },
+  can_handle = require "sonoff.can_handle",
+}
+
+return sonoff_valve_handler

drivers/SmartThings/zigbee-valve/src/sub_drivers.lua

@@ -5,5 +5,6 @@ local lazy_load_if_possible = require "lazy_load_subdriver"
 local sub_drivers = {
    lazy_load_if_possible("sinope"),
    lazy_load_if_possible("ezex"),
+   lazy_load_if_possible("sonoff")
 }
 return sub_drivers