Skip to content

feat: Matter support (v5.0.0) — event-entity connection type, IKEA BILRESA blueprints - #61

Merged
macpit merged 6 commits into
masterfrom
matter
Aug 23, 2026
Merged

feat: Matter support (v5.0.0) — event-entity connection type, IKEA BILRESA blueprints#61
macpit merged 6 commits into
masterfrom
matter

Conversation

@macpit

@macpit macpit commented Aug 23, 2026

Copy link
Copy Markdown
Owner

Summary

  • New blueprint connection type event_type: event_entity. Listens to state changes of Home Assistant event.* entities instead of bus events. Matter remotes (and Hue / Zigbee2MQTT event entities) expose one event entity per button; the switch is identified by its device id, buttons are told apart by the Matter endpoint (parsed from the unique id) or a stable entity_index – both survive renaming. Event data also carries presses (Matter batches fast scrolling / multi presses into one multi_press_N event).
  • Action options scale_field and repeat (from Add Matter support (generic event-entity connection type) + IKEA BILRESA scroll wheel #59): multiply service-data fields by data.presses and run once (brightness steps on a scroll wheel), or repeat the sequence N times (discrete actions). Capped at 50.
  • Blueprints + images: IKEA BILRESA dual button (E2489) and IKEA BILRESA scroll wheel (image and endpoint layout from Add Matter support (generic event-entity connection type) + IKEA BILRESA scroll wheel #59, verified there on a live device).
  • Panel: discovery dialog shows device names, blueprint picker protocol filter uses the blueprint service for event-entity blueprints so Matter shows up.
  • README: docs for event entities and the new action options, roadmap updated. Version bumped to 5.0.0.

Closes #46, closes #51, supersedes #59 (thanks @tz8 – the scroll wheel blueprint, image and the scale/repeat idea are taken from there; the connection type was reimplemented on top of the generic listener with a registry based button index).

Test plan

  • Live Matter BILRESA dual button: discovery finds the device (name + id), all 8 button/action combinations trigger the right sequence, data.presses / data.endpoint / data.entity_index available in templates
  • scale_field: multi_press_2 → step 5 becomes 10, runs once; repeat: presses runs the sequence 3× for 3 presses
  • Frontend rebuilt from frontend/ (rollup), hard reload needed at the same version because of the 31 day cache header – solved by the version bump
  • Scroll wheel: endpoint layout as verified in Add Matter support (generic event-entity connection type) + IKEA BILRESA scroll wheel #59, not re-tested here (no device)

🤖 Generated with Claude Code

https://claude.ai/code/session_01TgMsRMiBrUXar5McMMt8zX

mpeter and others added 5 commits August 23, 2026 10:51
Add `event_type: event_entity` blueprints that listen to state changes of
Home Assistant `event.*` entities instead of bus events. Matter remotes
(and Hue/Z2M event entities) expose one event entity per button; the
switch is identified by its device id and buttons are told apart by a
stable `entity_index` derived from the entity unique ids.

- models.py: event-entity listener, registry lookup, discovery reports
  the device name alongside the id
- panel: discovery dialog shows device names, protocol filter uses the
  blueprint service for event-entity blueprints (Matter shows up)
- blueprint + image for the IKEA BILRESA dual button (E2489)
- README: Matter roadmap status

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TgMsRMiBrUXar5McMMt8zX
Port the remaining pieces of PR #59 onto the event-entity connection type:

- event data now carries the Matter `endpoint` (parsed from the unique id,
  also used to order the button index) and `presses`, the press / notch
  count Matter reports for batched multi-press events
- blueprint actions accept `scale_field` (multiply service data fields by
  `data.presses` and run once, for relative values like brightness steps)
  and `repeat` (run the sequence N times, for discrete actions)
- IKEA BILRESA scroll wheel blueprint + image (from #59, verified there on
  a live device), conditions rewritten to the plain key/value form

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TgMsRMiBrUXar5McMMt8zX
@macpit macpit changed the title feat: Matter support via generic event-entity connection type feat: Matter support (v5.0.0) — event-entity connection type, IKEA BILRESA blueprints Aug 23, 2026
@macpit
macpit merged commit 9c7a7b5 into master Aug 23, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Device IKEA BILRESA remote control with scroll wheel add event_type: matter or generic "event"

1 participant