VSmart HS-SW300ZB-VNM


Model	HS-SW300ZB-VNM
Vendor	VSmart
Description	Wall switch 3 gang
Exposes	switch (state), led_indicator_color_on, led_indicator_color_off, vibration_intensity, time_periods, morning_led_intensity, evening_led_intensity, night_led_intensity, led_brightness_levels
Picture

Notes

Pairing

Put the device in pairing mode by pressing and holding the button on the device for 5 seconds until the LED indicator flashes rapidly.

Reset

To reset the device, press and hold the button for 10 seconds until the LED indicator flashes 3 times.

Installation

Turn off power at the circuit breaker before installation
Remove existing switch and connect wires according to the wiring diagram
Ensure proper grounding
Maximum load per channel: 10A resistive, 6A inductive

Multi-Endpoint Control

This device supports 3 independent switches:

Switch 1: Controls first electrical load
Switch 2: Controls second electrical load
Switch 3: Controls third electrical load
Each switch can be controlled independently via MQTT

LED Indicator Features

ledIndicatorColorOn: Set LED color when switch is ON (hex format: #RRGGBB)
ledIndicatorColorOff: Set LED color when switch is OFF (hex format: #RRGGBB)
morningLedIntensity: LED intensity for morning period (0-100%)
eveningLedIntensity: LED intensity for evening period (0-100%)
nightLedIntensity: LED intensity for night period (0-100%)
ledBrightnessLevels: Configure low/medium/high brightness levels

Vibration Feedback

vibrationIntensity: Button vibration intensity (0-100%)
Provides tactile feedback when button is pressed

Time Period Settings

timePeriods: Configure morning, evening, and night periods
Morning must start before evening, evening must start before night
LED behavior changes based on time periods

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

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

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}.

Switch (2 endpoint)

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

On with timed off

Switch (3 endpoint)

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

On with timed off

Led indicator color on (text)

LED indicator color when switch is ON (hex format: #RRGGBB, e.g., #ff0000 for red). 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 {"led_indicator_color_on": NEW_VALUE}.

Led indicator color off (text)

LED indicator color when switch is OFF (hex format: #RRGGBB, e.g., #ffffff for white). 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 {"led_indicator_color_off": NEW_VALUE}.

Vibration intensity (numeric)

Button vibration intensity (0-100%). 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 {"vibration_intensity": NEW_VALUE}. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Time periods (composite)

Time period settings for switch behavior. Morning must start before evening, evening must start before night.. Can be set by publishing to zigbee2mqtt/FRIENDLY_NAME/set with payload {"time_periods": {"morning_start_hour": VALUE, "evening_start_hour": VALUE, "night_start_hour": VALUE}}

morning_start_hour (numeric): Morning period start hour (0-23) max value is 23, unit is h
evening_start_hour (numeric): Evening period start hour (0-23) max value is 23, unit is h
night_start_hour (numeric): Night period start hour (0-23) max value is 23, unit is h

Morning led intensity (numeric)

LED intensity for morning period (0-100%). 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 {"morning_led_intensity": NEW_VALUE}. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Evening led intensity (numeric)

LED intensity for evening period (0-100%). 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 {"evening_led_intensity": NEW_VALUE}. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Night led intensity (numeric)

LED intensity for night period (0-100%). 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 {"night_led_intensity": NEW_VALUE}. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Led brightness levels (composite)

LED brightness levels for different intensity settings. Low must be lower than medium, Medium must be lower than high.. Can be set by publishing to zigbee2mqtt/FRIENDLY_NAME/set with payload {"led_brightness_levels": {"low_brightness_percent": VALUE, "medium_brightness_percent": VALUE, "high_brightness_percent": VALUE}}

low_brightness_percent (numeric): Low brightness level percentage (0-100%) max value is 100, unit is %
medium_brightness_percent (numeric): Medium brightness level percentage (0-100%) max value is 100, unit is %
high_brightness_percent (numeric): High brightness level percentage (0-100%) max value is 100, unit is %