Skip to main content

White Series Dimmer Switch • Firmware Changelog

This article will go through the changelog for the White Series Dimmer Switch (VTM31-SN).

Written by Kaleb
Updated this week

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

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:
• EP20 — Switch Mode: 0 Dimmer+Aux+Leading; 1 On/Off+Aux+Relay Enable; 2 Dimmer+Dumb+Leading (Default); 3 On/Off+Dumb; 4 Dimmer+Aux+Trailing; 9 On/Off+Aux+Relay Disable.
• EP21 — Smart Bulb Mode: 0 Disable (Default); 1 Enable.
• EP22 — Local Protection: 0 Disable (Default); 1 Enable.
• EP23 — Dimming Speed: 0 Instant; 5 = 500 ms; 8 = 800 ms; 10 = 1 s; 15 = 1.5 s; 20 = 2 s; 25 = 2.5 s (Default); 30 = 3 s; 35 = 3.5 s; 40 = 4 s; 50 = 5 s; 60 = 6 s; 70 = 7 s; 80 = 8 s; 100 = 10 s.
• EP24 — Button Delay: 0 No Delay; 3 = 300 ms (Default); 4 = 400 ms; 5 = 500 ms; 6 = 600 ms; 7 = 700 ms; 8 = 800 ms; 9 = 900 ms.
• EP25 — LED Color: 0 Red; 14 Orange; 35 Lemon; 64 Lime; 85 Green; 106 Teal; 127 Cyan; 149 Aqua; 170 Blue (Default); 191 Violet; 212 Magenta; 234 Pink; 255 White.
• EP26 — LED Effect: 1 Solid (Default); 2 Fast Blink; 3 Slow Blink; 5 Middle Chase; 6 Open Close; 7 Small to Big; 9 Slow Falling; 11 Fast Falling; 12 Slow Rising; 13 Middle Rising; 14 Fast Rising; 15 Middle Blink; 16 Slow Chase; 17 Fast Chase; 18 Slow Siren; 19 Fast Siren.
• EP27 — Dumb Test: 5:5; 10:10; 15:15; 20:20; 25:25; 30:30; 35:35; 40:40; 45:45; 50:50.

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:
Updated defaults for Dimmer Mode and Aux Switch.

EP6 On/Off Cluster Update:
Changed the default value of the FeatureMap attribute to 1 to support the onWithTimedOff command.

Fixed Mode Select Cluster behavior in EP6.

Added support for the "event-list" property.

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


Did this answer your question?