DISCLAIMER: You may notice there are a lot of over-used keywords or phrases as well as English that seems a little off. This is because these articles are used to feed our AI Robot (Ira) and she needs the data to be structured in a certain way.
REMINDER: This switch is only to be used to control lights (except ballasts or any lights connected to a transformer). Do not use the switches on outlets, fans, or any other inductive load.
Current Production Version: 1.1.5
Current Beta Version: N/A
Development Status: Open
NOTE: Beta firmware is considered unstable - please update at your own risk
Firmware Changelog
Below is the changelog for the White Series Dimmer Switch (VTM31-SN).
NOTES:
Rows highlighted in blue are production firmware versions
Parameters that are hyperlinked lead to the official White Series Dimmer Switch • Parameters page for further explanation
Each Firmware Version is hyperlinked to the corresponding GitHub folder
In the, "Firmware Version" column, you can find the date code which will tell you what firmware version your switch was produced with. Date codes can be found on the top left of your switch
Firmware Version | Date Released | Enhancements Added | Bug Fixes | Notes |
1.1.5 Production | February 2026 | Added an “Off” option to the LED effect settings.
Double tap config to clear notifications disabled (it was also disabled in 1.0.6 but accidentally got re-enabled). The same functionality can be enabled with an automation. | Fixed unexpected behavior during the startup stage.
Resolved an issue where the EP6 LED notification did not behave correctly after a power reset.
Fixed a bug where LED intensity (On) could not be set to | Note: Please review this article before updating to firmware 1.1.5
|
1.1.4 Beta | February 2026 |
| The PartsList attribute of the Descriptor Cluster in EP1 and EP6 has been modified.
The FeatureMap of the Power Topology cluster in EP7 has been changed to SetTopology, and the Available Endpoints attribute of this cluster has been modified to 1 (EP1).
Remove the unnecessary spaces in the characters. |
|
1.1.3 Beta | January 2026 | Set the following Attribute of EP6 to persistent storage: On/Off Cluster- On/Off,On/Off Cluster-StartUpOnOff ,LevelControl Cluster -CurrentLevel,LevelControl Cluster -OnLevel,LevelControl Cluster - StartUpCurrentLevel,Color Control Cluster - CurrentHue,Color Control Cluster - CurrentSaturation,Color Control Cluster - CurrentX,Color Control Cluster - CurrentY,Color Control Cluster - ColorTemperatureMireds,Color Control Cluster - ColorMode,Color Control Cluster - StartUpColorTemperatureMireds | Remove EP1 Level Control Cluster Attribute OnOffTransitionTime
Fixed an issue where binding would cause the device to freeze (note that if you want to use the binding feature, do not allow the switch to join more than three hubs) |
|
1.1.2 Beta | November 2025 | Set the value of ColorTemperaturePhysicalMinMireds to 1 | Some changes to Modeselect wording
Fixed the issue where the relay click setting didn’t work |
|
1.1.1 Beta | September 2025 | Set Level Cluster option: EP1 → 1; EP6 → 3.
Added Mode Select endpoints EP20–EP27 with the following options: | Fixed Power Topology Cluster errors on EP7.
Removed Mode Selection cluster from EP1–EP7.
Adjusted detection time for Dumb Mode (tune via “Dumb Test” under Mode Select). | Note: The mode select clusters were moved to their own endpoints (20-27) to better conform to the standards. This (temporarily) creates duplicate select devices. Restart Home Assistant and the “old” copies will show up as Not Provided devices (greyed out, dead) entities. Go to entity tabs and filer on Domain = Select, Integration = Matter, Status = Not Provided and you should be able to bulk-select and delete those. |
1.1.0 Beta | September 2025 | Add a new endpoint EP7 (Electrical Sensor) for the metering function (supports energy and active power) with clusters: Descriptor, Fixed Label, User Label, Mode Select, Electrical Power Measurement, Electrical Energy Measurement, and Power Topology.
Add the User Label cluster for EP1–EP7.
Upgrade the SDK to Matter 1.4 (Silicon Labs Matter 2.6.1-1.4).
After being removed from Apple Home, the switch can restore to its factory settings on its own.
| Modify the contents related to the Descriptor cluster tag-list.
Fixed: Settings don’t survive power reset.
Optimize the dimming scheme |
|
1.0.6 Beta |
| Changed Default Settings:
EP6 On/Off Cluster Update:
Fixed Mode Select Cluster behavior in EP6.
Added support for the
Disabled the “Clear Notifications” feature. | Optimized bulb flickering issues. |
|
1.0.5 Production | October 2024 | Removed Persistent Subscriptions, which can cause the device to crash under certain conditions |
|
|
1.0.4 Beta |
| Part of the code is optimized to avoid the loss of NVM3 in some special cases, which will lead to the failure of pairing Add Persistent Subscriptions. This feature will store the subscription information of the hub to the NVM3 area, which will help to establish communication with the hub faster during re-power |
|
|
1.0.3 Beta |
| The thread transmit power is optimized.
When the factory Settings are restored successfully, the led bar will blink 3x red for reminder |
|
|
1.0.2 Beta |
| Switch cluster :add "Initial Press" (0x01), "Short Release" (0x03), and "MultiPressOngoing" (0x05) events report
When the device is removed by all gateways, it will automatically restore the factory Settings (ps: apple home is invalid, because when the device joins the apple home, it will join two thread networks, and only one will be removed when it is removed). | Level Cluster :fixed incorrect on-Level minimum |
|
1.0.0 Production
Date Codes: 2407, 2409
| August 2024 |
|
| Initial Release |

