WB-LED Modbus register map
Description
For firmware update instructions, see the device page under “Firmware updates and resetting settings”.
| RO / RW | Read only / Read/Write |
| Shown in bold | Default register value |
| xN | Multiply the register value by this factor to obtain the value in the stated units.
If omitted, assume 1 |
| ⚡ | This register supports data transmission using events in Fast Modbus. |
| FW | Firmware version that introduced the register. Blank means it has always been available. |
| Error: | Value on error |
| Grey cell | Service register: purpose, format and contents may change in later firmware |
| Address | Register parameters | Channel | Description | Values | FW | |||
|---|---|---|---|---|---|---|---|---|
| Dec | Hex | Type | Access | Format | ||||
| Input states and press counters | ||||||||
| 0 | 0x0000 | Discrete Input ⚡ | RO | bool | Input 1 | State |
0 — open, |
|
| 1 | 0x0001 | Input 2 | ||||||
| 2 | 0x0002 | Input 3 | ||||||
| 3 | 0x0003 | Input 4 | ||||||
| 32 | 0x0020 | Input ⚡ | RO | u16 | Input 1 | Contact closure counter | 0 − 65535 with wraparound |
|
| 33 | 0x0021 | Input 2 | ||||||
| 34 | 0x0022 | Input 3 | ||||||
| 35 | 0x0023 | Input 4 | ||||||
| 464 | 0x01D0 | Input ⚡ | RO | u16 | Input 1 | Short press counter | 0 − 65535 with wraparound |
|
| 465 | 0x01D1 | Input 2 | ||||||
| 466 | 0x01D2 | Input 3 | ||||||
| 467 | 0x01D3 | Input 4 | ||||||
| 480 | 0x01E0 | Input ⚡ | RO | u16 | Input 1 | Long press counter | 0 − 65535 with wraparound |
|
| 481 | 0x01E1 | Input 2 | ||||||
| 482 | 0x01E2 | Input 3 | ||||||
| 483 | 0x01E3 | Input 4 | ||||||
| 496 | 0x01F0 | Input ⚡ | RO | u16 | Input 1 | Double press counter | 0 − 65535 with wraparound |
|
| 497 | 0x01F1 | Input 2 | ||||||
| 498 | 0x01F2 | Input 3 | ||||||
| 499 | 0x01F3 | Input 4 | ||||||
| 512 | 0x0200 | Input ⚡ | RO | u16 | Input 1 | Short-then-long press counter | 0 − 65535 with wraparound |
|
| 513 | 0x0201 | Input 2 | ||||||
| 514 | 0x0202 | Input 3 | ||||||
| 515 | 0x0203 | Input 4 | ||||||
| Configuring actions for latching switches. For pushbutton configuration, see #Configuring press actions | ||||||||
| 416 | 0x01A0 | Holding | RW | u16 | Input 1 | Input operating mode Before firmware 3.5.0 this register is unavailable and all channels operate in Pushbutton mode |
0 - pushbutton 1 - latching switch |
3.5.0 |
| 417 | 0x01A1 | Input 2 | ||||||
| 418 | 0x01A2 | Input 3 | ||||||
| 419 | 0x01A3 | Input 4 | ||||||
| 704 | 0x02C0 | Holding | RW | u16 | Input 1 | Channel affected in the OFF position Select the Latching switch input mode |
0 - ignore event |
3.5.0 |
| 705 | 0x02C1 | Input 2 | ||||||
| 706 | 0x02C2 | Input 3 | ||||||
| 707 | 0x02C3 | Input 4 | ||||||
| 720 | 0x02D0 | Holding | RW | u16 | Input 1 | Channel affected in the ON position Select the Latching switch input mode |
3.5.0 | |
| 721 | 0x02D1 | Input 2 | ||||||
| 722 | 0x02D2 | Input 3 | ||||||
| 723 | 0x02D3 | Input 4 | ||||||
| 736 | 0x02E0 | Holding | RW | u16 | Input 1 | Action in the OFF position Select the Latching switch input mode |
0 - switch off 1 - switch on 2 - toggle state |
3.5.0 |
| 737 | 0x02E1 | Input 2 | ||||||
| 738 | 0x02E2 | Input 3 | ||||||
| 739 | 0x02E3 | Input 4 | ||||||
| 752 | 0x02F0 | Holding | RW | u16 | Input 1 | Action in the ON position Select the Latching switch input mode |
3.5.0 | |
| 753 | 0x02F1 | Input 2 | ||||||
| 754 | 0x02F2 | Input 3 | ||||||
| 755 | 0x02F3 | Input 4 | ||||||
| Channel state control | ||||||||
| 0 | 0x0000 | Coil ⚡ | RW | bool | Channel 1 | Individual channel state Wx
|
0 - off, |
|
| 1 | 0x0001 | Channel 2 | ||||||
| 2 | 0x0002 | Channel 3 | ||||||
| 3 | 0x0003 | Channel 4 | ||||||
| 4 | 0x0004 | Coil ⚡ | RW | bool | Channels 1 and 2 | Channel pair state W1 + W2 (parallel)
|
0 - off, |
|
| 5 | 0x0005 | Channels 3 and 4 | Channel pair state W3 + W4 (parallel)
| |||||
| 6 | 0x0006 | Channels 1, 2, 3, 4 | State of all channels W1 + W2 + W3 + W4 (parallel)
| |||||
| 7 | 0x0007 | Coil ⚡ | RW | bool | Channels 1 and 2 | Channel pair state CCT1 Warm White and CCT1 Cool White
|
0 - off, |
|
| 8 | 0x0008 | Channels 3 and 4 | Channel pair state CCT2 Warm White and CCT2 Cool White
| |||||
| 9 | 0x0009 | Coil ⚡ | RW | bool | Channels 1, 2, 3 | Channel state R, G, B when operating an RGB strip
|
0 - off, |
|
| 10 | 0x000A | Coil ⚡ | RW | bool | Channels 1, 2, 3 | Continuous RGB strip colour change |
0 - off, |
|
| 11 | 0x000B | Coil ⚡ | RW | bool | Channels 1, 2, 3, 4 | State of all channels CCT1 + CCT2 (parallel)
|
0 - off, 1 - on |
3.8.0 |
| Channel brightness control | ||||||||
| 2000 | 0x07D0 | Holding ⚡ | RW | u16 | Channel 1 | Individual channel brightness Wx
|
% 0 - 100 (50) Error: 0xFFFF |
|
| 2001 | 0x07D1 | Channel 2 | ||||||
| 2002 | 0x07D2 | Channel 3 | ||||||
| 2003 | 0x07D3 | Channel 4 | ||||||
| 2004 | 0x07D4 | Channels 1 and 2 | Channel pair brightness W1 + W2 (parallel)
|
% 0 - 100 (50) Error: 0xFFFF |
||||
| 2005 | 0x07D5 | Channels 3 and 4 | Channel pair brightness W3 + W4 (parallel)
| |||||
| 2006 | 0x07D6 | Channels 1, 2, 3, 4 | Brightness of all channels W1 + W2 + W3 + W4 (parallel)
| |||||
| 2007 | 0x07D7 | Channels 1 and 2 | CCT1 strip colour temperature | % 0 - 100 (50) * 0 - warm colour * 100 - cool colour Error: 0xFFFF |
||||
| 2008 | 0x07D8 | Channels 1 and 2 | CCT1 strip brightness | % 0 - 100 (50) Error: 0xFFFF |
||||
| 2009 | 0x07D9 | Channels 3 and 4 | CCT2 strip colour temperature | % 0 - 100 (50) * 0 - warm colour * 100 - cool colour Error: 0xFFFF |
||||
| 2010 | 0x07DA | Channels 3 and 4 | CCT2 strip brightness | % 0 - 100 (50) Error: 0xFFFF |
||||
| 2011 | 0x07DB | R component | of the RGB strip colour, RGB palette | 0 - 255 (127) Error: 0xFFFF |
||||
| 2012 | 0x07DC | G component | ||||||
| 2013 | 0x07DD | B component | ||||||
| 2014 | 0x07DE | H component | of the RGB strip colour, HSV palette | ° 0 - 360 Error: 0xFFFF |
||||
| 2015 | 0x07DF | S component | % 0 - 100 Error: 0xFFFF | |||||
| 2016 | 0x07E0 | V component | % 0 - 100 (50) Error: 0xFFFF | |||||
| 2017 | 0x07E1 | Continuous RGB colour change speed: period for increasing Hue by 1 degree | ms 3 - 10000 (30) Error: 0xFFFF |
|||||
| 2018 | 0x07E2 | Channels 1, 2, 3, 4 | Colour temperature of CCT1 and CCT2 strips | % 0 - 100 (50) * 0 - warm colour * 100 - cool colour Error: 0xFFFF |
3.8.0 | |||
| 2019 | 0x07E3 | Channels 1, 2, 3, 4 | Brightness of CCT1 and CCT2 strips | % 0 - 100 (50) Error: 0xFFFF |
3.8.0 | |||
| Duplicate control channels with automatic switch-on | ||||||||
| 2100 | 0x0834 | Holding ⚡ | RW | u16 | Channel 1 | Individual channel brightness WxWriting > 0 switches on the associated output and sets brightness; writing 0 clears the coil register |
% 0 - 100 (50) Error: 0xFFFF |
3.8.0 |
| 2101 | 0x0835 | Channel 2 | ||||||
| 2102 | 0x0836 | Channel 3 | ||||||
| 2103 | 0x0837 | Channel 4 | ||||||
| 2104 | 0x0838 | Channels 1 and 2 | Channel pair brightness W1 + W2 (parallel)Writing > 0 switches on the associated output and sets brightness; writing 0 clears the coil register | |||||
| 2105 | 0x0839 | Channels 3 and 4 | Channel pair brightness W3 + W4 (parallel)Writing > 0 switches on the associated output and sets brightness; writing 0 clears the coil register | |||||
| 2106 | 0x083A | Channels 1, 2, 3, 4 | Brightness of all channels W1 + W2 + W3 + W4 (parallel)Writing > 0 switches on the associated output and sets brightness; writing 0 clears the coil register | |||||
| 2107 | 0x083B | Channels 1 and 2 | CCT1 strip colour temperature Any write switches on the associated output and sets its value |
% 0 - 100 (50) * 0 - warm colour * 100 - cool colour Error: 0xFFFF | ||||
| 2108 | 0x083C | Channels 1 and 2 | CCT1 strip brightness Writing > 0 switches on the associated output and sets brightness; writing 0 clears the coil register |
% 0 - 100 (50) Error: 0xFFFF | ||||
| 2109 | 0x083D | Channels 3 and 4 | CCT2 strip colour temperature Any write switches on the associated output and sets its value |
% 0 - 100 (50) * 0 - warm colour * 100 - cool colour Error: 0xFFFF | ||||
| 2110 | 0x083E | Channels 3 and 4 | CCT2 strip brightness Writing > 0 switches on the associated output and sets brightness; writing 0 clears the coil register |
% 0 - 100 (50) Error: 0xFFFF | ||||
| 2111 | 0x083F | R component | of the RGB strip colour, RGB palette Any write switches on the associated output and sets its value |
0 - 255 (127) Error: 0xFFFF | ||||
| 2112 | 0x0840 | G component | ||||||
| 2113 | 0x0841 | B component | ||||||
| 2114 | 0x0842 | H component | of the RGB strip colour, HSV palette Any write switches on the associated output and sets its value |
° 0 - 360 Error: 0xFFFF | ||||
| 2115 | 0x0843 | S component | % 0 - 100 Error: 0xFFFF | |||||
| 2116 | 0x0844 | V component | of the RGB strip colour, HSV palette Writing > 0 switches on the associated output and sets brightness; writing 0 clears the coil register |
% 0 - 100 (50) Error: 0xFFFF | ||||
| 2117 | 0x0845 | Continuous RGB colour change speed: period for increasing Hue by 1 degree Any write switches on the associated output and sets its value |
ms 3 - 10000 (30) Error: 0xFFFF | |||||
| 2118 | 0x0846 | Channels 1, 2, 3, 4 | Colour temperature of CCT1 and CCT2 strips Any write switches on the associated output and sets its value |
% 0 - 100 (50) * 0 - warm colour * 100 - cool colour Error: 0xFFFF | ||||
| 2119 | 0x0847 | Channels 1, 2, 3, 4 | Brightness of CCT1 and CCT2 strips Writing > 0 switches on the associated output and sets brightness; writing 0 clears the coil register |
% 0 - 100 (50) Error: 0xFFFF | ||||
| Remote smooth adjustment of lighting parameters | ||||||||
| Each lighting parameter has an action register (2200..2219) and a step-period register (2300..2319). Registers for a parameter unused in the current dimmer mode retain their addresses, but writing an action produces no visible change. For a detailed description, see the WB-LED page. | ||||||||
| 2200 | 0x0898 | Holding ⚡ | RW | u16 | Channel 1 | Remote smooth adjustment action for the lighting parameter | 0 - stop 1 - decrease 2 - increase 3 - increase/decrease |
3.8.0 |
| 2201 | 0x0899 | Channel 2 | ||||||
| 2202 | 0x089A | Channel 3 | ||||||
| 2203 | 0x089B | Channel 4 | ||||||
| 2204 | 0x089C | Channels 1, 2 | ||||||
| 2205 | 0x089D | Channels 3, 4 | ||||||
| 2206 | 0x089E | Channels 1, 2, 3, 4 | ||||||
| 2207 | 0x089F | CCT1: colour temperature | ||||||
| 2208 | 0x08A0 | CCT1: brightness | ||||||
| 2209 | 0x08A1 | CCT2: colour temperature | ||||||
| 2210 | 0x08A2 | CCT2: brightness | ||||||
| 2211 | 0x08A3 | RGB: red | ||||||
| 2212 | 0x08A4 | RGB: green | ||||||
| 2213 | 0x08A5 | RGB: blue | ||||||
| 2214 | 0x08A6 | RGB: hue | ||||||
| 2215 | 0x08A7 | RGB: saturation | ||||||
| 2216 | 0x08A8 | RGB: brightness | ||||||
| 2217 | 0x08A9 | Hue change speed | ||||||
| 2218 | 0x08AA | CCT1 + CCT2: colour temperature | ||||||
| 2219 | 0x08AB | CCT1 + CCT2: brightness | ||||||
| 2300 | 0x08FC | Holding | RW | u16 | Channel 1 | Step period for remote smooth parameter adjustment | ms/unit 5 – 500 (20) |
3.8.0 |
| 2301 | 0x08FD | Channel 2 | ||||||
| 2302 | 0x08FE | Channel 3 | ||||||
| 2303 | 0x08FF | Channel 4 | ||||||
| 2304 | 0x0900 | Channels 1, 2 | ||||||
| 2305 | 0x0901 | Channels 3, 4 | ||||||
| 2306 | 0x0902 | Channels 1, 2, 3, 4 | ||||||
| 2307 | 0x0903 | CCT1: colour temperature | ||||||
| 2308 | 0x0904 | CCT1: brightness | ||||||
| 2309 | 0x0905 | CCT2: colour temperature | ||||||
| 2310 | 0x0906 | CCT2: brightness | ||||||
| 2311 | 0x0907 | RGB: red | ||||||
| 2312 | 0x0908 | RGB: green | ||||||
| 2313 | 0x0909 | RGB: blue | ||||||
| 2314 | 0x090A | RGB: hue | ||||||
| 2315 | 0x090B | RGB: saturation | ||||||
| 2316 | 0x090C | RGB: brightness | ||||||
| 2317 | 0x090D | Hue change speed | ||||||
| 2318 | 0x090E | CCT1 + CCT2: colour temperature | ||||||
| 2319 | 0x090F | CCT1 + CCT2: brightness | ||||||
| Output configuration and direct output PWM control | ||||||||
| 70 | 0x0046 | Holding | RW | u16 | Channel 1 | Minimum PWM | 1 – 2048 (6) | |
| 71 | 0x0047 | Channel 2 | ||||||
| 72 | 0x0048 | Channel 3 | ||||||
| 73 | 0x0049 | Channel 4 | ||||||
| 80 | 0x0050 | Holding | RW | u16 | Channel 1 | Maximum PWM | 1 – 2048 | |
| 81 | 0x0051 | Channel 2 | ||||||
| 82 | 0x0052 | Channel 3 | ||||||
| 83 | 0x0053 | Channel 4 | ||||||
| 90 | 0x005A | Holding | RW | u16 | Channel 1 | Direct control | 0 – 2048 | |
| 91 | 0x005B | Channel 2 | ||||||
| 92 | 0x005C | Channel 3 | ||||||
| 93 | 0x005D | Channel 4 | ||||||
| Press type detection | ||||||||
| 1100 | 0x044C | Holding | RW | u16 | Input 1 | Long press time
A press lasting longer than this value is considered long |
ms 500 – 5000 (1000) |
|
| 1101 | 0x044D | Input 2 | ||||||
| 1102 | 0x044E | Input 3 | ||||||
| 1103 | 0x044F | Input 4 | ||||||
| 1120 | 0x0460 | Holding | RW | u16 | Input 1 | Parameter adjustment speed while holding the button
Smaller values make the parameter change faster |
ms/unit 5 – 500 (20) |
|
| 1121 | 0x0461 | Input 2 | ||||||
| 1122 | 0x0462 | Input 3 | ||||||
| 1123 | 0x0463 | Input 4 | ||||||
| 1140 | 0x0474 | Holding | RW | u16 | Input 1 | Second press waiting time
If no second press occurs within this time, the press is treated as a single press. 0 disables all press types except short and long presses |
ms 0 – 2000 (300) |
|
| 1141 | 0x0475 | Input 2 | ||||||
| 1142 | 0x0476 | Input 3 | ||||||
| 1143 | 0x0477 | Input 4 | ||||||
| 1160 | 0x0488 | Holding | RW | u16 | Input 1 | Debounce time
Set this 5–10 times shorter than the second-press waiting time. If double presses are disabled, any value is allowed. When connecting an encoder, 2–5 ms is recommended. |
ms 2 – 2000 (50) |
|
| 1161 | 0x0489 | Input 2 | ||||||
| 1162 | 0x048A | Input 3 | ||||||
| 1163 | 0x048B | Input 4 | ||||||
| Value adjustment step for presses | ||||||||
| 1200 | 0x04B0 | Holding | RW | u16 | Input 1 | Controlled channel value step for a single short press. Applies to Increase value and Decrease value actions | 1 – 10000 (1) | 3.8.0 |
| 1201 | 0x04B1 | Input 2 | ||||||
| 1202 | 0x04B2 | Input 3 | ||||||
| 1203 | 0x04B3 | Input 4 | ||||||
| 1220 | 0x04C4 | Holding | RW | u16 | Input 1 | Controlled channel value step for a double press. Applies to Increase value and Decrease value actions | 1 – 10000 (1) | 3.8.0 |
| 1221 | 0x04C5 | Input 2 | ||||||
| 1222 | 0x04C6 | Input 3 | ||||||
| 1223 | 0x04C7 | Input 4 | ||||||
| Safety Mode | ||||||||
| 8 | 0x0008 | Holding | RW | u16 | Communication loss timeout before entering safe mode | s 1 - 65534 (10) |
3.5.0 | |
| 640 | 0x0280 | Holding | RW | u16 | Input 1 | Input control in Safety Mode |
0 - do not block |
3.5.0 |
| 641 | 0x0281 | Input 2 | ||||||
| 642 | 0x0282 | Input 3 | ||||||
| 643 | 0x0283 | Input 4 | ||||||
| 648 | 0x0288 | Holding | RW | u16 | Channel 1 | Channel action when entering safe mode. Channels depend on the selected dimmer operating mode. #Channel mapping by dimmer mode |
0 - do nothing |
3.5.0 |
| 649 | 0x0289 | Channel 2 | ||||||
| 650 | 0x028A | Channel 3 | ||||||
| 651 | 0x028B | Channel 4 | ||||||
| 656 | 0x0290 | Holding | RW | u16 | Channel 1 | Channel brightness on entering safe mode (only with action 3) | % 1 - 100 (50) |
3.5.0 |
| 657 | 0x0291 | Channel 2 | ||||||
| 658 | 0x0292 | Channel 3 | ||||||
| 659 | 0x0293 | Channel 4 | ||||||
| Dimmer power-on behaviour | ||||||||
| 664 | 0x0298 | Holding | RW | u16 | Channel 1 | Channel action at dimmer power-on Channels depend on the selected dimmer operating mode. #Channel mapping by dimmer mode |
0 - switch off |
3.5.0 |
| 665 | 0x0299 | Channel 2 | ||||||
| 666 | 0x029A | Channel 3 | ||||||
| 667 | 0x029B | Channel 4 | ||||||
| 672 | 0x02A0 | Holding | RW | u16 | Channel 1 | Channel brightness at dimmer power-on (only with action 3) | % 1 - 100 (50) |
3.5.0 |
| 673 | 0x02A1 | Channel 2 | ||||||
| 674 | 0x02A2 | Channel 3 | ||||||
| 675 | 0x02A3 | Channel 4 | ||||||
| Brightness, colour temperature and saturation transition times | ||||||||
| 3000 | 0x0BB8 | Holding | RW | u16 | Channel 1 | Brightness increase time for independent operation | ms 0 – 30000 (1000) |
|
| 3001 | 0x0BB9 | Channel 2 | ||||||
| 3002 | 0x0BBA | Channel 3 | ||||||
| 3003 | 0x0BBB | Channel 4 | ||||||
| 3004 | 0x0BBC | Holding | RW | u16 | Channels 1 and 2 | Brightness increase time for parallel operation | ms 0 – 30000 (1000) |
|
| 3005 | 0x0BBD | Channels 3 and 4 | ||||||
| 3006 | 0x0BBE | Channels 1, 2, 3, 4 | ||||||
| 3007 | 0x0BBF | Holding | RW | u16 | Channels 1 and 2 | CCT strip colour temperature increase time | ms 0 – 30000 (1000) |
|
| 3008 | 0x0BC0 | Holding | RW | u16 | Channels 1 and 2 | CCT strip brightness increase time | ms 0 – 30000 (1000) |
|
| 3009 | 0x0BC1 | Holding | RW | u16 | Channels 3 and 4 | CCT strip colour temperature increase time | ms 0 – 30000 (1000) |
|
| 3010 | 0x0BC2 | Holding | RW | u16 | Channels 3 and 4 | CCT strip brightness increase time | ms 0 – 30000 (1000) |
|
| 3011 | 0x0BC3 | Holding | RW | u16 | HSV-H | RGB strip hue increase time | ms 0 – 30000 (1000) |
|
| 3012 | 0x0BC4 | Holding | RW | u16 | HSV-S | RGB strip saturation increase time | ms 0 – 30000 (1000) |
|
| 3013 | 0x0BC5 | Holding | RW | u16 | HSV-V | RGB strip brightness increase time | ms 0 – 30000 (1000) |
|
| 3014 | 0x0BC6 | Holding | RW | u16 | Channels 1, 2, 3, 4 | CCT1 + CCT2 strip colour temperature increase time | ms 0 – 30000 (1000) |
3.8.0 |
| 3015 | 0x0BC7 | Holding | RW | u16 | Channels 1, 2, 3, 4 | CCT1 + CCT2 strip brightness increase time | ms 0 – 30000 (1000) |
3.8.0 |
| 3100 | 0x0C1C | Holding | RW | u16 | Channel 1 | Brightness decrease time for independent operation | ms 0 – 30000 (1000) |
|
| 3101 | 0x0C1D | Channel 2 | ||||||
| 3102 | 0x0C1E | Channel 3 | ||||||
| 3103 | 0x0C1F | Channel 4 | ||||||
| 3104 | 0x0C20 | Holding | RW | u16 | Channels 1 and 2 | Brightness decrease time for parallel operation | ms 0 – 30000 (1000) |
|
| 3105 | 0x0C21 | Channels 3 and 4 | ||||||
| 3106 | 0x0C22 | Channels 1, 2, 3, 4 | ||||||
| 3107 | 0x0C23 | Holding | RW | u16 | Channels 1 and 2 | CCT strip colour temperature decrease time | ms 0 – 30000 (1000) |
|
| 3108 | 0x0C24 | Holding | RW | u16 | Channels 1 and 2 | CCT strip brightness decrease time | ms 0 – 30000 (1000) |
|
| 3109 | 0x0C25 | Holding | RW | u16 | Channels 3 and 4 | CCT strip colour temperature decrease time | ms 0 – 30000 (1000) |
|
| 3110 | 0x0C26 | Holding | RW | u16 | Channels 3 and 4 | CCT strip brightness decrease time | ms 0 – 30000 (1000) |
|
| 3111 | 0x0C27 | Holding | RW | u16 | HSV-H | RGB strip hue decrease time | ms 0 – 30000 (1000) |
|
| 3112 | 0x0C28 | Holding | RW | u16 | HSV-S | RGB strip saturation decrease time | ms 0 – 30000 (1000) |
|
| 3113 | 0x0C29 | Holding | RW | u16 | HSV-V | RGB strip brightness decrease time | ms 0 – 30000 (1000) |
|
| 3114 | 0x0C2A | Holding | RW | u16 | Channels 1, 2, 3, 4 | CCT1 + CCT2 strip colour temperature decrease time | ms 0 – 30000 (1000) |
3.8.0 |
| 3115 | 0x0C2B | Holding | RW | u16 | Channels 1, 2, 3, 4 | CCT1 + CCT2 strip brightness decrease time | ms 0 – 30000 (1000) |
3.8.0 |
| CCT strip settings | ||||||||
| 3200 | 0x0C80 | Holding | RW | u8 | Channels 1 and 2 | CCT strip power normalization | 0 – disable 1 – enable |
3.7.0 |
| 3201 | 0x0C81 | Channels 3 and 4 | ||||||
| 3202 | 0x0C82 | Holding | RW | u8 | Channels 1, 2, 3, 4 | CCT1 + CCT2 strip power normalization | 0 – disable 1 – enable |
3.8.0 |
| Encoder support | ||||||||
| 364 | 0x016C | Input ⚡ | RO | u16 | Encoder 1 | Encoder step counter, accounting for the Pulses per step parameter | 0 - 65535 | 3.8.0 |
| 365 | 0x016D | Encoder 2 | ||||||
| 368 | 0x0170 | Holding | RW | s32 | Encoder 1 | Encoder position in pulses. Writable to set an initial value | −2147483648 - 2147483647 (0) | |
| 370 | 0x0172 | Encoder 2 | ||||||
| 376 | 0x0178 | Holding | RW | u16 | Encoder 1 | Encoder connection type.
When connecting an encoder, reduce input debounce time (registers 1160–1163) to 2–5 ms |
0 - unused 1 - AB type | |
| 377 | 0x0179 | Encoder 2 | ||||||
| 384 | 0x0180 | Holding | RW | u16 | Encoder 1 | Pulses per logical encoder step | 1 - 65535 (4) | |
| 385 | 0x0181 | Encoder 2 | ||||||
| 388 | 0x0184 | Holding | RW | u16 | Encoder 1 | Controlled channel. Available values depend on the dimmer mode | 0 - control disabled 1 - channel 1 2 - channel 2 3 - channel 3 4 - channel 4 5 - channels 1, 2 6 - channels 3, 4 7 - channels 1, 2, 3, 4 8 - CCT1 colour temperature 9 - CCT1 brightness 10 - CCT2 colour temperature 11 - CCT2 brightness 12 - red brightness 13 - green brightness 14 - blue brightness 15 - RGB strip hue (HSV-H) 16 - RGB strip saturation (HSV-S) 17 - RGB strip brightness (HSV-V) 18 - continuous RGB strip hue change time 19 - CCT1, CCT2 colour temperature 20 - CCT1, CCT2 brightness | |
| 389 | 0x0185 | Encoder 2 | ||||||
| 392 | 0x0188 | Holding | RW | u16 | Encoder 1 | Controlled channel value adjustment step | 1 - 10000 (1) | |
| 393 | 0x0189 | Encoder 2 | ||||||
| 396 | 0x018C | Holding | RW | u16 | Encoder 1 | Behaviour below minimum brightness | 0 - switch the channel off 1 - retain minimum brightness | |
| 397 | 0x018D | Encoder 2 | ||||||
| Settings common to all modes | ||||||||
| 9 | 0x0009 | Holding | RW | u16 | Output PWM frequency setting | 1 – 240 (8) F = 24 kHz / value |
||
| 4000 | 0x0FA0 | Holding | RW | u16 | Dimmer operating mode setting | Find the mode code in the operating mode table 256 |
||
| Diagnostic data | ||||||||
| 400 | 0x190 | Input | RO | s16 | Dimmer board temperature. Used to detect overheating and reduce maximum power when overheating occurs. | -55 .. +150 °C | WB-LED | |
| 401 | 0x0191 | Input | RO | u16 | Permitted dimmer power as a percentage of maximum. Below 70 °C board temperature, the dimmer operates at 100% power. Above 70 °C, maximum output PWM is limited; at 80 °C the outputs switch off completely. | 0 .. 100 % | WB-LED | |
| 402 | 0x0192 | Input | RO | u16 | Hardware overcurrent and short-circuit protection state. After a trip, the outputs switch off for 3 s, then ramp up one at a time. | 1 - protection tripped | WB-LED | |
Configuring press actions
| Address | Register parameters | Channel | Description | Values | FW | |||
|---|---|---|---|---|---|---|---|---|
| Dec | Hex | Type | Access | Format | ||||
| 1000 | 0x03E8 | Holding | RW | u16 | Input 1 | Short press action. See the calculation formula below. |
0x3009 | |
| 1001 | 0x03E9 | Input 2 | 0x900E | |||||
| 1002 | 0x03EA | Input 3 | 0x3003 | |||||
| 1003 | 0x03EB | Input 4 | 0 | |||||
| 1020 | 0x03FC | Holding | RW | u16 | Input 1 | Long press action. See the calculation formula below. |
0xB010 | |
| 1021 | 0x03FD | Input 2 | 0x900E | |||||
| 1022 | 0x03FE | Input 3 | 0xB003 | |||||
| 1023 | 0x03FF | Input 4 | 0 | |||||
| 1040 | 0x0410 | Holding | RW | u16 | Input 1 | Double press action. See the calculation formula below. |
0 | |
| 1041 | 0x0411 | Input 2 | ||||||
| 1042 | 0x0412 | Input 3 | ||||||
| 1043 | 0x0413 | Input 4 | ||||||
| 1060 | 0x0424 | Holding | RW | u16 | Input 1 | Short-then-long press action. See the calculation formula below. |
0 | |
| 1061 | 0x0425 | Input 2 | ||||||
| 1062 | 0x0426 | Input 3 | ||||||
| 1063 | 0x0427 | Input 4 | ||||||
To configure a press-type action, write a number constructed as follows to the corresponding register:
0000 0000 0000 0000
The upper 4 bits specify the action type:
- 0 - no action
- 0b0001 - set the coil register to 0
- 0b0010 - set the coil register to 1
- 0b0011 - toggle the coil register 0 <-> 1
- 0b0100 - set all coil registers to 0 (switch all channels off). Available since firmware 3.3.0
- 0b1001 - increase the holding register value (by 1 per button event)
- 0b1010 - decrease the holding register value (by 1 per button event)
- 0b1011 - decrease/increase the holding register value. Direction changes with each new press.
0000 0000 0000 0000
The lower 12 bits specify the register number, without the base address, to which the action applies. Coil addresses start at zero, so the register number equals its address. Data register addresses start at 2000 (0x07D0), the base address. Subtract 2000 from the holding register address and put the result (0 to 17) in the lower 12 bits. For Switch all channels off, set the lower 12 bits to zero.
Value = (action << 12) | (reg_number - 0x07D0)
Buttons change Modbus register values. Only enable coils (coil 0–10) and data holding registers (2000–2017) can be changed.
useful example on the support portal
Channel mapping by dimmer mode
The table below maps dimmer operating modes to the action configuration registers for safe mode and power-on behaviour.
The intersection of an operating mode and a configuration register identifies the channel type whose action is stored in that register.
- means that the configuration register is unused in this operating mode.
| Operating mode | Configuration register 1 | Configuration register 2 | Configuration register 3 | Configuration register 4 |
|---|---|---|---|---|
| W+W+W+W: | W1 | W2 | W3 | W4 |
| 2W+W+W | W1 + W2 (parallel) | - | W3 | W4 |
| CCT+W+W | CCT1 strip colour temperature | CCT1 strip brightness | W3 | W4 |
| W+W+2W | W1 | W2 | W3 + W4 (parallel) | - |
| 2W+2W | W1 + W2 (parallel) | - | W3 + W4 (parallel) | - |
| CCT+2W | CCT1 strip colour temperature | CCT1 strip brightness | W3 + W4 (parallel) | - |
| W+W+CCT | W1 | W2 | CCT2 strip colour temperature | CCT2 strip brightness |
| 2W+CCT | W1 + W2 (parallel) | - | CCT2 strip colour temperature | CCT2 strip brightness |
| CCT+CCT | CCT1 strip colour temperature | CCT1 strip brightness | CCT2 strip colour temperature | CCT2 strip brightness |
| RGB+W | HSV-H | HSV-S | HSV-V | W4 |
| 4W | W1 + W2 + W3 + W4 (parallel) | - | - | - |
| 2*CCT | Colour temperature of CCT1 and CCT2 strips | Brightness of CCT1 and CCT2 strips | - | - |
Action mapping by dimmer mode for safe mode and power-on behaviour
The table shows the permitted actions for each channel type.
| Channel type | Available actions on entering safe mode | Available actions at power-on |
|---|---|---|
|
0 - do nothing 1 - switch off 2 - switch on 3 - switch on and set brightness |
0 - switch off 1 - restore previous state 2 - switch on 3 - switch on and set brightness |
|
0 - do nothing 3 - set value |
0 - do nothing 3 - set value |
Example:
The selected operating mode is 2W+CCT. Configure these actions:
- on entering safe mode:
- for channel
W1 + W2 (parallel)- do nothing - for channel
CCT2 strip colour temperature- set value to 85 - for channel
CCT2 strip brightness- switch on and set brightness to 40
- for channel
- at power-on:
- for channel
W1 + W2 (parallel)- restore previous state - for channel
CCT2 strip colour temperature- do nothing - for channel
CCT2 strip brightness- switch on
- for channel
Write the following values to the registers:
- safe-mode behaviour settings:
- actions:
648-0650-3651-3
- levels:
658-85659-40
- actions:
- power-on behaviour settings:
- actions:
664-1666-0667-2
- actions:
Common registers
| Address | Register parameters | Description | Values | Note | |||
|---|---|---|---|---|---|---|---|
| Dec | Hex | Type | Access | Format | |||
| Connection settings | |||||||
| 110 | 0x006E | Holding | RW | u16 | RS-485 baud rate. RS-485 connection parameter settings |
×100, baud 12 — 1200 bit/s, 24 — 2400 bit/s, 48 — 4800 bit/s, 96 — 9600 bit/s, 192 — 19200 bit/s, 384 — 38400 bit/s, 576 — 57600 bit/s, 1152 — 115200 bit/s |
|
| 111 | 0x006F | Holding | RW | u16 | RS-485 parity setting | 0 — no parity (none), 1 — odd, 2 — even |
|
| 112 | 0x0070 | Holding | RW | u16 | RS-485 stop bits See: stop-bit tolerance |
1, 2 | |
| 128 | 0x0080 | Holding | RW | u16 | Device Modbus address (details) | ||
| 200-219 | 0x00C8 - 0x00DB | Input | RO | string | Device model | ||
| 220-244 | 0x00DC - 0x00F4 | Input | RO | string | Firmware build commit hash and branch name (2 characters per register) | ||
| 250-265 | 0x00FA - 0x0109 | Input | RO | string | Firmware version | ||
| 266-269 | 0x010A - 0x010D | Input | RO | u64 | Serial number extension | ||
| 270-271 | 0x010E - 0x010F | Input | RO | u32 | Serial number | ||
| 290-301 | 0x0122 - 0x012D | Input | RO | string | Firmware signature | ||
| 320 | 0x0140 | Input | RO | u16 | Firmware version in numeric format (details) | MAJOR | |
| 321 | 0x0141 | MINOR | |||||
| 322 | 0x0142 | PATCH | |||||
| 323 | 0x0143 | s16 | SUFFIX | ||||
| 324-325 | 0x0144 - 0x0145 | Input | RO | u32 | Firmware version in numeric format | ||
| 326-327 | 0x0146 - 0x0147 | Input | RO | u32 | Firmware version in big-endian format | ||
| Other information | |||||||
| 104-105 | 0x0068 - 0x0069 | Input | RO | u32 | Uptime since boot | seconds | |
| 120 | 0x0078 | Holding | RW | u16 | Reboot device without saving state | Any non-zero value reboots the device | |
| 129 | 0x0081 | Holding | RW | u16 | Enter firmware update mode for 2 minutes | Any non-zero value enters firmware update mode | |
| 330-337 | 0x014A - 0x0151 | Input | RO | string | Bootloader version | ||
| 130 | 0x0082 | Holding | RW | u16 | Disable Status LED | 0 — enabled 1 — disabled |
|
| 131 | 0x0083 | Holding | RW | u16 | Enter firmware update mode using the current communication settings. To check whether the firmware and bootloader support this feature, read this register. If reading succeeds and returns 0, the feature is supported.
|
Writing 1 enters firmware update mode | Since firmware 3.4.2 |
| 113 | 0x0071 | Holding | RW | u16 | Delay before replying to a Modbus request | 0 - 254 ms | |
| 114 | 0x0072 | Holding | RW | u16 | Continuous reading across register gaps | 0 - disabled 1 - enabled 2 - enabled, retained after reboot |
|
| 121 | 0x0079 | Input | RO | u16 | Current supply voltage | mV | |
| 122 | 0x007A | Input | RO | u16 | Minimum supply voltage since boot, without averaging | mV | |
| 125 | 0x007D | Input | RO | u16 | Current supply voltage, without averaging | mV | |
| 119 | 0x0077 | Input | RO | u16 | Minimum microcontroller supply voltage since boot, before averaging | mV | |
| 123 | 0x007B | Input | RO | u16 | Microcontroller supply voltage | mV | |
| 124 | 0x007C | Input | RO | s16 | Internal microcontroller temperature | x0.1, °C | |
| 304-319 | 0x0130-0x013F | Input | RO | string | Device batch number.
Available only on devices manufactured from 21 January 2026. |
Since firmware 3.6.0 | |
| 65402 | 0xFF7A | Holding | RW | u16 | Reset device settings to defaults. Communication settings are retained. The device reboots after the reset. |
Writing 1 resets the settings | Since firmware 3.5.3 |
| 65500 | 0xFFDC | Coil | RW | bool | Service register for visually testing indicator LEDs | Writing 1 switches on all indicator LEDs | Since firmware 3.9.0 |
| 64256-64383 | 0xFB00-0xFB7F | Input | RO | u16 | FlashFS: free space per page | bytes | Since firmware 3.6.0 |
| 64384-64511 | 0xFB80-0xFBFF | Input | RO | u16 | FlashFS: total size of current files per page | bytes | |
| 64512-64639 | 0xFC00-0xFC7F | Input | RO | u16 | FlashFS: page fragmentation | 0…100 % 0 — all data is current, 100 — no current data | |
| 64640-64767 | 0xFC80-0xFCFF | Input | RO | u16 | FlashFS: page erase counter | ||
| 65504 | 0xFFE0 | Input | RO | u16 | Maximum stack usage | bytes 0 — stack corrupted |
Since firmware 3.6.0 |
| 65505 | 0xFFE1 | Input | RO | u16 | Free RAM | bytes | |
| 65506 | 0xFFE2 | Input | RO | u16 | Used RAM | bytes | |
| 65507 | 0xFFE3 | Input | RO | u16 | Stack size | bytes | |
| 65508 | 0xFFE4 | Input | RO | u16 | Cause of last MCU reset | 1 — LPWR, 2 — WWDG, 3 — IWDG, 4 — SFT, 5 — POR, 6 — PIN, 7 — OBL, 8 — V18PWR |
Since firmware 3.6.0 |
| 65509 | 0xFFE5 | Input | RO | u32 | Firmware update counter | Since firmware 3.6.0 | |