--- layout: documentation title: plugInDimmer - ZWave --- {% include base.html %} # plugInDimmer Plug-in Dimmer This describes the Z-Wave device *plugInDimmer*, manufactured by *[BeNext](http://www.benext.eu/)* with the thing type UID of ```benext_plugindimmer_00_000```. The device is in the category of *Power Outlet*, defining Small devices to be plugged into a power socket in a wall which stick there. ![plugInDimmer product image](https://opensmarthouse.org/zwavedatabase/226/image/) The plugInDimmer supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is also able to participate in the routing of data between other devices in the mesh network. ## Overview Basic operations * The Plug-in Dimmer can be operated both manually as with Z-Wave. * The Plug-in Dimmer can dim up to 125Watt. * The Plug-in Dimmer is easy to install and configured. * The Plug-in Dimmer can measure and report energy. How it operates A lamp can be switched on and off, manually by pressing the button or by Z-Wave using the basic command class. A (dimmable) lamp can be dimmed to a level, manually by pressing and holding the button or by Z-Wave using the switch multilevel command class. ### Inclusion Information When the lamp and indicator light are off (!) press and hold the button. After circa 2 seconds, when the indicator light starts blinking, release the button to start the inclusion process. ### Exclusion Information When the lamp and indicator light are off (!) press and hold the button. After circa 2 seconds, when the indicator led starts blinking, release the button to start the exclusion process. ## Channels The following table summarises the channels available for the plugInDimmer -: | Channel Name | Channel ID | Channel Type | Category | Item Type | |--------------|------------|--------------|----------|-----------| | Dimmer | switch_dimmer | switch_dimmer | DimmableLight | Dimmer | | Electric meter (kWh) | meter_kwh | meter_kwh | Energy | Number | | Electric meter (watts) | meter_watts | meter_watts | Energy | Number | ### Dimmer The brightness channel allows to control the brightness of a light. It is also possible to switch the light on and off. The ```switch_dimmer``` channel is of type ```switch_dimmer``` and supports the ```Dimmer``` item and is in the ```DimmableLight``` category. ### Electric meter (kWh) Indicates the energy consumption (kWh). The ```meter_kwh``` channel is of type ```meter_kwh``` and supports the ```Number``` item and is in the ```Energy``` category. This is a read only channel so will only be updated following state changes from the device. ### Electric meter (watts) Indicates the instantaneous power consumption. The ```meter_watts``` channel is of type ```meter_watts``` and supports the ```Number``` item and is in the ```Energy``` category. This is a read only channel so will only be updated following state changes from the device. ## Device Configuration The following table provides a summary of the 10 configuration parameters available in the plugInDimmer. Detailed information on each parameter can be found in the sections below. | Param | Name | Description | |-------|-------|-------------| | 1 | Reset to factory settings | Set all configuration values to default values (factory settings). | | 4 | Enable dimming | Enable dimming | | 6 | Maximum powerload | Maximum powerload | | 7 | Dimming speed | Dimming speed | | 8 | Fading up speed | Fading up speed | | 11 | Auto meter report: percentage | Auto meter report: percentage | | 12 | Auto meter report: watt | Auto meter report: watt | | 13 | Auto meter report: time | Auto meter report: time | | 14 | Last known status | Last known status | | 15 | Fading down speed | Fading down speed | | | Switch All Mode | Set the mode for the switch when receiving SWITCH ALL commands | ### Parameter 1: Reset to factory settings Set all configuration values to default values (factory settings). Values in the range 0 to 255 may be set. The manufacturer defined default value is ```0```. This parameter has the configuration ID ```config_1_1``` and is of type ```INTEGER```. ### Parameter 4: Enable dimming Enable dimming This parameter is used to enable the dimming option of the product. When disabled the dimming and fading routine are disabled. The following option values may be configured -: | Value | Description | |--------|-------------| | 0 | Disable | | 1 | Enable | The manufacturer defined default value is ```0``` (Disable). This parameter has the configuration ID ```config_4_1``` and is of type ```INTEGER```. ### Parameter 6: Maximum powerload Maximum powerload The maximum powerload in watts when light is turned on, when measured higher then this value the Plugin Dimmer is automatically stops with dimming or is turned off. Values in the range 25 to 150 may be set. The manufacturer defined default value is ```125```. This parameter has the configuration ID ```config_6_2``` and is of type ```INTEGER```. ### Parameter 7: Dimming speed Dimming speed The speed of dimming when activated (manual and RF). Dim speed is 1% per value (* 10 ms) Values in the range 0 to 255 may be set. The manufacturer defined default value is ```3```. This parameter has the configuration ID ```config_7_1``` and is of type ```INTEGER```. ### Parameter 8: Fading up speed Fading up speed The speed of fading up when activated (manual and RF). Fade speed is 1% per value (* 10 ms) Values in the range 0 to 255 may be set. The manufacturer defined default value is ```1```. This parameter has the configuration ID ```config_8_1``` and is of type ```INTEGER```. ### Parameter 11: Auto meter report: percentage Auto meter report: percentage A percentage that an energy value must be different compared to a previous sent value before an unsolicited meter report is sent. Minimum value = 1%  Maximum value = 100% Values in the range 0 to 255 may be set. The manufacturer defined default value is ```1```. This parameter has the configuration ID ```config_11_1``` and is of type ```INTEGER```. ### Parameter 12: Auto meter report: watt Auto meter report: watt A watt value that an energy value must be different compared to a previous sent value before an unsolicited meter report is sent. Minimum value = 5 watt  Maximum value = 255 watt Values in the range 0 to 255 may be set. The manufacturer defined default value is ```5```. This parameter has the configuration ID ```config_12_1``` and is of type ```INTEGER```. ### Parameter 13: Auto meter report: time Auto meter report: time A time value that has to be passed compared to a previous sent value before a unsolicited meter report is sent. Minimum value = 10 seconds  Maximum value = 255 seconds Values in the range 0 to 255 may be set. The manufacturer defined default value is ```10```. This parameter has the configuration ID ```config_13_1``` and is of type ```INTEGER```. ### Parameter 14: Last known status Last known status What to do with lamp status when power applied. If 0x00: Always switch light off when power applied. If > 0x00: Switch lamp on/off depending on last known lampstatus before power was disconnected. Values in the range 0 to 255 may be set. The manufacturer defined default value is ```0```. This parameter has the configuration ID ```config_14_1``` and is of type ```INTEGER```. ### Parameter 15: Fading down speed Fading down speed The speed of fading down when activated (manual and RF). Fade speed is 1% per value (* 10 ms) Values in the range 0 to 255 may be set. The manufacturer defined default value is ```1```. This parameter has the configuration ID ```config_15_1``` and is of type ```INTEGER```. ### Switch All Mode Set the mode for the switch when receiving SWITCH ALL commands. The following option values may be configured -: | Value | Description | |--------|-------------| | 0 | Exclude from All On and All Off groups | | 1 | Include in All On group | | 2 | Include in All Off group | | 255 | Include in All On and All Off groups | This parameter has the configuration ID ```switchall_mode``` and is of type ```INTEGER```. ## Association Groups Association groups allow the device to send unsolicited reports to the controller, or other devices in the network. Using association groups can allow you to eliminate polling, providing instant feedback of a device state change without unnecessary network traffic. The plugInDimmer supports 2 association groups. ### Group 1: Group 1 Receives BASIC SET commands Association group 1 supports 8 nodes. ### Group 2: Group 2 Receives METER and MULTILEVEL_SWITCH commands Association group 2 supports 1 node. ## Technical Information ### Endpoints #### Endpoint 0 | Command Class | Comment | |---------------|---------| | COMMAND_CLASS_NO_OPERATION_V1| | | COMMAND_CLASS_BASIC_V1| | | COMMAND_CLASS_SWITCH_MULTILEVEL_V1| Linked to BASIC| | COMMAND_CLASS_SWITCH_ALL_V1| | | COMMAND_CLASS_SENSOR_MULTILEVEL_V5| | | COMMAND_CLASS_METER_V2| | | COMMAND_CLASS_CONFIGURATION_V1| | | COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1| | | COMMAND_CLASS_POWERLEVEL_V1| | | COMMAND_CLASS_ASSOCIATION_V1| | | COMMAND_CLASS_VERSION_V1| | ### Documentation Links * [User Manual](https://opensmarthouse.org/zwavedatabase/226/reference/plugindimmer.pdf) --- Did you spot an error in the above definition or want to improve the content? You can [contribute to the database here](https://opensmarthouse.org/zwavedatabase/226).