[Edge] Unlock IKEA BILRESA scroll wheel and dual button

[mocelet]

I’ve added support for the new BILRESA buttons in my Matter Playground Edge Driver so you can unlock all the functionality, wheel included.

Given the singularities of these new Matter over Thread buttons it deserves its own post.

There is a teaser video in reddit, check it out since it showcases what you can do in combination with Matter bulbs using Matter Playground.

The driver packs as many custom tweaks as technically possible, including triple-tap for the dual button via an original hack (it only supports double-tap), a nice user interface and routine conditions for the wheel (which doubles as three thanks to the selector underneath the indicators), advanced dimming and other quality of life features. I’ve been working on them well before having the buttons!

BILRESA scroll wheel added perks

• Battery level reporting fix, they report half. Profile with group names, battery type and quantity information.

• Full support for the wheel with Swipe left and Swipe right actions.

  • Multiple scrolling modes: trigger L/R multiple times while scrolling (useful for dimmer or colour steps) or single trigger when scrolling ends (useful for toggling).
  • Scrolled sectors routine condition to trigger scenes depending on the amount scrolled. I recommend using the default values of sectors of size 33% for an easy way to toggle up to 6 scenes with a single gesture.
  • Advanced stepping feature using Rules API to mimic the native behaviour and step the dimmer level proportionally to the scroll. Read more about dimming in this comment.

• Auto-repeat Held emulation.

• Long press release as Toggled up.

• Initial Press and Short Release actions to turn on lights real quick. Read more about how to minimize latency to achive wall-switch like immediate reaction.

BILRESA dual button added perks:

• Battery level reporting fix, they report half. Profile with button names, battery type and quantity information.

• Triple-tap hack to expand the native double-tap. It’s optional, works fine for me but the method used is not 100% error-proof and you might get a false triple-tap (I’ve not seen any though!). More specifically, single and double taps will always trigger normally, they’re not affected, the worst case scenario is an additional triple tap that should not be there or an actual triple tap not triggering.

• Initial Press and Short Release actions to turn on lights real quick. Read more about minimizing button latency. For toggling lights it’s a day and night difference!

• Auto-repeat Held emulation.

• Long press release as Toggled up, useful for start/stop smooth dimming.

Installation

To use the driver just install Matter Playground driver if you haven’t already and switch the driver of the button.

The driver does not steal the initial configuration from stock drivers so new devices are always added first to stock drivers.

[Declankh]

Fantastic, much appreciated. I look forward to playing with this when I get the buttons

[Automated_House (Jimmy)]

nice! looks like our local Ikea gets them in a week. do they support matter binding cluster?

[mocelet]

@Automated_House

do they support matter binding cluster?

Unfortunately no, everything is just Switch endpoints for the buttons and wheel. I don’t lose faith in an eventual firmware update supporting bindings.

[Jeff_Gallagher]

Going down to IKEA tomorrow see what the have in stock

[mocelet]

I wasn’t very happy with the dimming using the wheel so I’ve added some advanced features. Updated comment for version 2026-01-29 using new stock capabilities.

Basic dimming with BILRESA scroll wheel

The easiest way to dim is assigning a fixed brightness step to the left and right actions.

Step or Adjust actions depend on the driver you use for the lights:

• Stock drivers do not support them yet, when they do you’ll see the Adjust brightness action.
• For Matter bulbs you can use this same Matter Playground driver which also supports adding transition times and On/Off behaviour.
• For Zigbee bulbs you can use Lights Multifunction Mc.
• For any light you can use Virtual Dimmer with Steps.

The wheel more or less repeats the events while scrolling, many if you go slow, not so many if you go fast to avoid flooding the hub. You’ll get multiple steps and kind of works. You could say it’s fine, but not great. Lacks precision and speed.

Advanced dimming with BILRESA scroll wheel

Using the Rules API, the button can feed the step size required to the light driver, changing it depending on how much you scroll and matching the native experience inside IKEA ecosystem. Gives both precision and speed, you can go slowly by small increments or quickly scroll the wheel a large amount for a large step.

The attribute rotateAmount in capability knob of BILRESA is the step level value you have to pass to the step level command of the lights driver. The Rule, although verbose, is quite simple and would look like this for lights supporting the official statelessSwitchLevelStep capability, like this Matter Playground and, soon, stock Matter drivers:

[
  {
    "if": {
      "greaterThanOrEquals": {
        "left": {
          "device": {
            "devices": [
              "BILRESA-SCROLL-DEVICE-ID"
            ],
            "component": "main",
            "capability": "knob",
            "attribute": "rotateAmount",
            "trigger": "Always"
          }
        },
        "right": {
          "integer": -100
        },
        "changesOnly": false
      },
      "then": [
        {
          "command": {
            "devices": [
              "LIGHT-DEVICE-ID",
              "ANOTHER-LIGHT-DEVICE-ID"
            ],
            "commands": [
              {
                "component": "main",
                "capability": "statelessSwitchLevelStep",
                "command": "stepLevel",
                "arguments": [
                  {
                    "device": {
                      "devices": [
                        "BILRESA-SCROLL-DEVICE-ID"
                      ],
                      "component": "main",
                      "capability": "knob",
                      "attribute": "rotateAmount"
                    }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  }
]

The component names for the knob are main for first group, group2 and group3.

Adapting the Rule for other custom drivers

There are settings to change the default behaviour but that’s only needed for specific cases mentioned below.

• For lights using the official statelessSwitchLevelStep capability like Matter Playground and, soon, Matter stock drivers, no action is needed. Keep the Max step size at 100 and just copy the rule changing the IDs.
• For Virtual Dimmer use capability islandtheme02751.stepLevel and command setStepLevel . Change the Max step size to 25 or won’t work as expected since the driver sends steps up to 100% by default if you fully scroll the wheel.
• For Lights Multifunction would be capability legendabsolute60149.levelSteps and command setLevelSteps, with Max step size being 30.

Improving the smoothness

When using Matter Playground, you can improve the smoothness of the steps by adding a transition time.

An option is changing the step level transition in the settings of the light. It’s in seconds, I recommend 0.3 for IKEA KAJPLATS, 0.1 for Nanoleaf and 0 for WiZ since they already add their own smoothness.

Alternatively, if you use panelorange55982.stepLevel capability you can add the second and third optional stepLevel parameters to the rule which are an integer for the transition time in tenths of a second and a boolean for the WithOnOff behaviour.

Recent changes

Feb 13th, 2026 note. SmartThings is officially adding support for dimming by scrolling and hopefully the app will provide a user interface so the Rules API is not needed . It is not there yet but SmartThings has created a new knob capability to communicate the level steps that my driver already uses and so will stock drivers. A previous version of the instructions used the Scrolled sectors as step options but they are no longer needed. If you were using scrolledSectors for the steps feel free to migrate to knob using attribute rotateAmount instead of scrolledSectors , integer instead of decimal and capability knob instead of panelorange55982.scrolledSectors.

There are also new official capabilities for the steps so I’ve changed the screenshots to use them instead. The Adjust brightness action is the English translation but in your language may be Ajustar brillo or other text. You can still use the Step dimmer level action too, it’s exactly the same internally except using my custom capability. I’ve also updated the Rule to use the official statelessSwitchLevelStep that more drivers will use in the near future.

[mocelet]

While testing I managed to make the BILRESA dual button unresponsive. I thought it was bricked for a moment since it didn’t send any pressed events.

Had to remove the batteries and insert them again. That didn’t work or I was not patient enough so I switched to stock drivers (the number of buttons was not even recognized correctly there) and then switched to my custom driver again (that forces a re-subscription to the events). Fully working now.

It’s probably a rare bug of the firmware that you won’t find but it’s worth documenting it.

[jkp]

Ikea’s new two-button Matter remote launches in the US for $6.

[mocelet]

Turns out some of the BILRESA scroll wheels have bad switches, or I have bad luck…

I have two units, one of them has a “clicky” wheel button, the other feels “mushy”. The problem is the mushy one skips taps a lot, maybe you wanted a triple tap and registers single or double, or you wanted double and registers single.

Will have it in observation…

[Andreas_Roedl]

@mocelet

the other feels “mushy”. The problem is the mushy one skips taps a lot

That sounds like a faulty device. Open it and see if you can fix it?

[mocelet]

@Andreas_Roedl

That sounds like a faulty device

Sounds like it, I’ve reported it, won’t try to fix it myself in case they want to inspect the unit and whatnot. If not I’ll just return it in my next visit to IKEA and bring a different Matter toy.

https://www.reddit.com/r/tradfri/comments/1pklqb3/bad_switch_in_bilresa_scroll_wheel/

[Andreas_Roedl]

Good job, @mocelet !

add InitialPress to Ikea Scroll subscription

[mocelet]

@mocelet

While testing I managed to make the BILRESA dual button unresponsive

Also the scroll wheel, the new devices desperately need a firmware update, they are too prone to go unresponsive but I probably play with them more than the average.

The scroll wheel was completely bricked, not even the selector lights worked, so I had to factory reset it with the button on the back leaving it pressed and then set it up again.

[Andreas_Roedl]

Funny how the list of firmware attributes gets longer and longer each time I look at it, but there’s only one Matter device (Eve Energy) that can be updated through SmartThings - even when there are firmware updates available for other devices in the DCL.

[mocelet]

Minimize action latency in BILRESA. Available from version 2025-12-15

Sometimes you just want to turn on a light and want it wall-switch fast, not half a second later. If you don’t care it’s better that you don’t try these new options, there’s no going back when you notice the difference .

This is the story of a single-press in BILRESA told in Matter events, from when you press the button (Initial Press), release the finger (Short Release) around 100 ms later and the device reports it’s a single-press (Multipress Complete) around half a second later.

The driver now allows to expose both the Initial Press and the Short Release for both models if you want to favour speed over double/triple tap.

• Initial Press is the fastest but will trigger with a long press too, so it’s inconvenient unless you just want a quick light toggle and nothing else. Exposes as Toggled down.
• Short Release still feels fast (it’s 100 ms vs 500 ms) and it’s compatible with the long press, so you only lose the double or triple tap unless you manage to create double-tap automations where it doesn’t matter that the short release runs twice. Exposes as Swipe up.

I’m using the Short Release for the BILRESA scroll wheel since the switch is a hardware lottery and the double-tap is not reliable so I just gave up and use only single and long presses. Plus, I notice if a light takes half a second to turn on, now the experience is so much better.

[Andreas_Roedl]

Capabilities!

Matter Switch: initial knob and stateless capability support

[TapioX]

@Andreas_Roedl

Capabilities!

It’s possible to read using CLI for example statelessSwitchLevelStep:

smartthings capabilities statelessSwitchLevelStep -j
{
    "id": "statelessSwitchLevelStep",
    "version": 1,
    "status": "proposed",
    "name": "Stateless Switch Level Step",
    "ephemeral": false,
    "attributes": {},
    "commands": {
        "stepLevel": {
            "name": "stepLevel",
            "arguments": [
                {
                    "name": "stepSize",
                    "optional": false,
                    "schema": {
                        "type": "integer",
                        "minimum": -100,
                        "maximum": 100
                    }
                }
            ],
            "sensitive": false
        }
    }
}

[mocelet]

About time, a standard step level function using the native step command! Good news is that it’s an integer from -100 to 100 so it’s also compatible with my advanced dimming feature

I’m also glad they opted for the Step command and not StepWithOnOff, that way lights that are off will not turn on.

function CapabilityHandlers.handle_step_level(driver, device, cmd)

[...]

device:send(clusters.LevelControl.server.commands.Step(device, endpoint_id, step_mode, math.abs(step_size), fields.TRANSITION_TIME, fields.OPTIONS_MASK, fields.OPTIONS_OVERRIDE))

Edit:

Will they add the step function to groups? That would be SO great.

I’ve also noticed the stock driver will update a “knob” capability with the step information, how will they “link” that to the step level capability of the light? Some secret sauce in SmartThings app? Smart Lighting sync switch? Rules API? This is going to be so interesting!

So far the new capabilities don’t have text and they don’t appear to enable nothing magically in the app, maybe a new app update will be needed.

The capabilities appear in the website actually: Proposed Capabilities | Developer Documentation | SmartThings , there’s also a stateless scenes which is intriguing and may hint to Matter scenes support.

[easynote (CoisasLAB)]

Its a nice driver! But i cant make it work with scroll wheel, detect but dont do nothing
Maybe the problem is mine but i will test a little bit more

[mocelet]

@easynote

But i cant make it work with scroll wheel, detect but dont do nothing

Do you see the Swipe left and Swipe right actions but they won’t trigger?

Mind some wheels have hardware defects and must be returned to the store, double check if that’s the case:

• The selector in the bottom should cycle the LEDs (signaling if group 1, 2 or 3 is active), like in the video linked in first post. If that doesn’t happen it’s an issue with the button.
• In reddit there are reports of failing wheels that need too much pressure to register the scroll and even broken switches due to too much pressure.

You can also try to switch back to stock drivers and then again to my driver in case there’s any issue with the subscriptions. Do the normal presses, double press, etc. work?