Samotech SM309-S
Model | SM309-S |
Vendor | Samotech |
Description | Zigbee dimmer 400W with power and energy metering |
Exposes | light (state, brightness), effect, power_on_behavior, power, current, voltage, energy, linkquality |
Picture |
Options
How to use device type specific configuration
-
transition
: Controls the transition time (in seconds) of on/off, brightness, color temperature (if applicable) and color (if applicable) changes. Defaults to0
(no transition). The value must be a number with a minimum value of0
-
state_action
: State actions will also be published as ‘action’ when true (default false). The value must betrue
orfalse
-
power_calibration
: Calibrates the power value (percentual offset), takes into effect on next report of device. The value must be a number. -
power_precision
: Number of digits after decimal point for power, takes into effect on next report of device. The value must be a number with a minimum value of0
and with a with a maximum value of3
-
current_calibration
: Calibrates the current value (percentual offset), takes into effect on next report of device. The value must be a number. -
current_precision
: Number of digits after decimal point for current, takes into effect on next report of device. The value must be a number with a minimum value of0
and with a with a maximum value of3
-
voltage_calibration
: Calibrates the voltage value (percentual offset), takes into effect on next report of device. The value must be a number. -
voltage_precision
: Number of digits after decimal point for voltage, takes into effect on next report of device. The value must be a number with a minimum value of0
and with a with a maximum value of3
-
energy_precision
: Number of digits after decimal point for energy, takes into effect on next report of device. The value must be a number with a minimum value of0
and with a with a maximum value of3
-
energy_calibration
: Calibrates the energy value (percentual offset), takes into effect on next report of device. The value must be a number.
Exposes
Light
This light supports the following features: state
, brightness
.
state
: To control the state publish a message to topiczigbee2mqtt/FRIENDLY_NAME/set
with payload{"state": "ON"}
,{"state": "OFF"}
or{"state": "TOGGLE"}
. To read the state send a message tozigbee2mqtt/FRIENDLY_NAME/get
with payload{"state": ""}
.brightness
: To control the brightness publish a message to topiczigbee2mqtt/FRIENDLY_NAME/set
with payload{"brightness": VALUE}
whereVALUE
is a number between0
and254
. To read the brightness send a message tozigbee2mqtt/FRIENDLY_NAME/get
with payload{"brightness": ""}
.
Transition
For all of the above mentioned features it is possible to do a transition of the value over time. To do this add an additional property transition
to the payload which is the transition time in seconds.
Examples: {"brightness":156,"transition":3}
, {"color_temp":241,"transition":1}
.
Moving/stepping
Instead of setting a value (e.g. brightness) directly it is also possible to:
- move: this will automatically move the value over time, to stop send value
stop
or0
. - step: this will increment/decrement the current value by the given one.
The direction of move and step can be either up or down, provide a negative value to move/step down, a positive value to move/step up.
To do this send a payload like below to zigbee2mqtt/FRIENDLY_NAME/set
NOTE: brightness move/step will stop at the minimum brightness and won’t turn on the light when it’s off. In this case use brightness_move_onoff
/brightness_step_onoff
{
"brightness_move": -40, // Starts moving brightness down at 40 units per second
"brightness_move": 0, // Stop moving brightness
"brightness_step": 40 // Increases brightness by 40
}
Effect (enum)
Triggers an effect on the light (e.g. make light blink for a few seconds).
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 {"effect": NEW_VALUE}
.
The possible values are: blink
, breathe
, okay
, channel_change
, finish_effect
, stop_effect
.
Power_on_behavior (enum)
Controls the behavior when the device is powered on after power loss.
Value can be found in the published state on the power_on_behavior
property.
To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"power_on_behavior": ""}
.
To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"power_on_behavior": NEW_VALUE}
.
The possible values are: off
, on
, toggle
, previous
.
Power (numeric)
Instantaneous measured power.
Value can be found in the published state on the power
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is W
.
Current (numeric)
Instantaneous measured electrical current.
Value can be found in the published state on the current
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is A
.
Voltage (numeric)
Measured electrical potential value.
Value can be found in the published state on the voltage
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is V
.
Energy (numeric)
Sum of consumed energy.
Value can be found in the published state on the energy
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is kWh
.
Linkquality (numeric)
Link quality (signal strength).
Value can be found in the published state on the linkquality
property.
It’s not possible to read (/get
) or write (/set
) this value.
The minimal value is 0
and the maximum value is 255
.
The unit of this value is lqi
.