SONOFF SWV-ZNE


Model	SWV-ZNE
Vendor	SONOFF
Description	Zigbee smart water valve
Exposes	battery, switch (state), child_lock, manual_default_settings, irrigation_plan_settings, irrigation_plan_report, irrigation_plan_remove, irrigation_schedule_status, rain_delay, rain_delay_end_datetime, seasonal_watering_adjustment, real_time_irrigation_duration, hour_irrigation_duration, 24_hours_records, 30_days_records, 180_days_records, read_swvzf_records
Picture

OTA updates

This device supports OTA updates, for more information see OTA updates.

Options

How to use device type specific configuration

state_action: State actions will also be published as 'action' when true (default false). The value must be true or false

Remaining battery in %. Value can be found in the published state on the battery property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"battery": ""}. It's not possible to write (/set) this value. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Switch

The current state of this switch is in the published state under the state property (value is ON or OFF). To control this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"state": "ON"}, {"state": "OFF"} or {"state": "TOGGLE"}. To read the current state of this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"state": ""}.

On with timed off

When setting the state to ON, it might be possible to specify an automatic shutoff after a certain amount of time. To do this add an additional property on_time to the payload which is the time in seconds the state should remain on. Additionally an off_wait_time property can be added to the payload to specify the cooldown time in seconds when the switch will not answer to other on with timed off commands. Support depends on the switch firmware. Some devices might require both on_time and off_wait_time to work Examples : {"state" : "ON", "on_time": 300}, {"state" : "ON", "on_time": 300, "off_wait_time": 120}.

Child lock (binary)

Enables/disables physical input on the device. Value can be found in the published state on the child_lock property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"child_lock": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"child_lock": NEW_VALUE}. If value equals LOCK child lock is ON, if UNLOCK OFF.

Manual default settings (composite)

Single irrigation settings. Can be set by publishing to zigbee2mqtt/FRIENDLY_NAME/set with payload {"manual_default_settings": {"irrigation_duration": VALUE}} To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"manual_default_settings": ""}.

irrigation_duration (numeric): Irrigation duration min value is 1, max value is 719, unit is min

Irrigation plan settings (composite)

Set irrigation plan. Can be set by publishing to zigbee2mqtt/FRIENDLY_NAME/set with payload {"irrigation_plan_settings": {"plan_index": VALUE, "enable_state": VALUE, "loop_type_mode": VALUE, "loop_type_interval_days": VALUE, "loop_type_week_days": VALUE, "enable_date": VALUE, "start_time": VALUE, "irrigation_mode": VALUE, "irrigation_total_duration": VALUE, "irrigation_duration": VALUE, "interval_duration": VALUE, "create_datetime": VALUE}}

plan_index (numeric): Plan index max value is 5
enable_state (binary) allowed values: true or false
loop_type_mode (enum) allowed values: odd_days, even_days, day_interval, weekdays
loop_type_interval_days (numeric): Only effective when loop_type_mode is day_interval min value is 1, max value is 30
loop_type_week_days (composite): Only effective when loop_type_mode is weekdays
enable_date (text): Enable date in local YYYY-MM-DD format.
start_time (text): Start time in local HH:mm format (24-hour, zero-padded).
irrigation_mode (enum) allowed values: duration, duration_with_interval
irrigation_total_duration (numeric) max value is 719, unit is min
irrigation_duration (numeric) min value is 1, max value is 60, unit is min
interval_duration (numeric) min value is 1, max value is 60, unit is min
create_datetime (text): Create datetime in ISO format with timezone (e.g. YYYY-MM-DDTHH:mm:ss+08:00)

Irrigation plan report (composite)

Irrigation plan report.

plan_index (numeric)
enable_state (binary) allowed values: true or false
loop_type_mode (enum) allowed values: odd_days, even_days, day_interval, weekdays
loop_type_interval_days (numeric): Effective when loop_type_mode is day_interval
loop_type_week_days (composite): Effective when loop_type_mode is weekdays
enable_date (text): Enable date in local YYYY-MM-DD format (local day start)
start_time (text): Start time in local HH:mm format (24-hour)
irrigation_mode (enum) allowed values: duration, duration_with_interval
irrigation_total_duration (numeric)
irrigation_duration (numeric)
interval_duration (numeric)
create_datetime (text): Create datetime in ISO format with timezone (e.g. YYYY-MM-DDTHH:mm:ss+08:00)

Irrigation plan remove (composite)

Remove irrigation plan. Can be set by publishing to zigbee2mqtt/FRIENDLY_NAME/set with payload {"irrigation_plan_remove": {"plan_index": VALUE}}

plan_index (numeric): The index of the irrigation plan to remove max value is 5

Irrigation schedule status (composite)

Irrigation schedule execution status. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"irrigation_schedule_status": ""}.

schedule_status (enum): Schedule status allowed values: start, end, running, standby
schedule_index (numeric): Schedule index
schedule_type (enum): Schedule type allowed values: automatic, manual
irrigation_mode (enum): Irrigation mode allowed values: duration, duration_with_interval
start_time (text): Schedule start time
expected_end_time (text): Expected end time
actual_end_time (text): Actual end time

Rain delay (text)

Schedule delay end time in ISO format with timezone (e.g. YYYY-MM-DDTHH:mm:ss+08:00), or "0" to disable. Value will not be published in the state. It's not possible to read (/get) this value. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"rain_delay": NEW_VALUE}.

Rain delay end datetime (text)

User triggered delay end time.. Value can be found in the published state on the rain_delay_end_datetime property. It's not possible to read (/get) or write (/set) this value.

Seasonal watering adjustment (composite)

Monthly watering adjustment multiplier (1.0 = 100%, 2.0 = 200%). Can be set by publishing to zigbee2mqtt/FRIENDLY_NAME/set with payload {"seasonal_watering_adjustment": {"january": VALUE, "february": VALUE, "march": VALUE, "april": VALUE, "may": VALUE, "june": VALUE, "july": VALUE, "august": VALUE, "september": VALUE, "october": VALUE, "november": VALUE, "december": VALUE}} To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"seasonal_watering_adjustment": ""}.

january (numeric): Adjustment multiplier for january min value is 0.1, max value is 2
february (numeric): Adjustment multiplier for february min value is 0.1, max value is 2
march (numeric): Adjustment multiplier for march min value is 0.1, max value is 2
april (numeric): Adjustment multiplier for april min value is 0.1, max value is 2
may (numeric): Adjustment multiplier for may min value is 0.1, max value is 2
june (numeric): Adjustment multiplier for june min value is 0.1, max value is 2
july (numeric): Adjustment multiplier for july min value is 0.1, max value is 2
august (numeric): Adjustment multiplier for august min value is 0.1, max value is 2
september (numeric): Adjustment multiplier for september min value is 0.1, max value is 2
october (numeric): Adjustment multiplier for october min value is 0.1, max value is 2
november (numeric): Adjustment multiplier for november min value is 0.1, max value is 2
december (numeric): Adjustment multiplier for december min value is 0.1, max value is 2

Real time irrigation duration (numeric)

Real-time irrigation duration. Value can be found in the published state on the real_time_irrigation_duration property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"real_time_irrigation_duration": ""}. It's not possible to write (/set) this value. The unit of this value is min.

Hour irrigation duration (numeric)

Hourly irrigation duration. Value can be found in the published state on the hour_irrigation_duration property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"hour_irrigation_duration": ""}. It's not possible to write (/set) this value. The unit of this value is min.

type (enum): Reading type allowed values: 24_hours, 30_days, 6_months
time_start (text): Start time in ISO format with timezone (e.g. YYYY-MM-DDTHH:mm:ss+08:00)
time_end (text): End time in ISO format with timezone (e.g. YYYY-MM-DDTHH:mm:ss+08:00)