Skip to content

[ring] Add an extended description of events#20198

Open
psmedley wants to merge 5 commits intoopenhab:mainfrom
psmedley:ring-extended-description
Open

[ring] Add an extended description of events#20198
psmedley wants to merge 5 commits intoopenhab:mainfrom
psmedley:ring-extended-description

Conversation

@psmedley
Copy link
Contributor

@psmedley psmedley commented Feb 7, 2026

This enhancement adds a new channel that provides a description of whether the motion event includes a person or a vehicle.

Signed-off-by: Paul Smedley <paul@smedley.id.au>
Signed-off-by: Paul Smedley <paul@smedley.id.au>
Signed-off-by: Paul Smedley <paul@smedley.id.au>
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Ring Account “Events” channel intended to expose an extended, notification-like description that distinguishes between person/vehicle/motion.

Changes:

  • Introduces a new extendedDescription channel (channel type + event group wiring) and bumps the account thing type version to 2 with update instructions for existing Things.
  • Adds API DTO support for cv_properties (CVPropertiesTO) and wires it into RingEventTO.
  • Updates AccountHandler to populate the new channel based on cv_properties.detection_type, and updates README with the new channel.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
bundles/org.openhab.binding.ring/src/main/resources/OH-INF/update/instructions.xml Adds update instructions to inject the new channel for existing ring:account Things (targetVersion 2).
bundles/org.openhab.binding.ring/src/main/resources/OH-INF/thing/thing-types.xml Adds thingTypeVersion=2 for the account bridge and defines the new channel + channel-type.
bundles/org.openhab.binding.ring/src/main/java/org/openhab/binding/ring/internal/handler/AccountHandler.java Publishes the new extended description state based on cv_properties.detection_type.
bundles/org.openhab.binding.ring/src/main/java/org/openhab/binding/ring/internal/api/RingEventTO.java Adds cv_properties field to event DTO.
bundles/org.openhab.binding.ring/src/main/java/org/openhab/binding/ring/internal/api/CVPropertiesTO.java New DTO for CV properties used by the handler logic.
bundles/org.openhab.binding.ring/src/main/java/org/openhab/binding/ring/RingBindingConstants.java Adds a channel constant for event#extendedDescription.
bundles/org.openhab.binding.ring/README.md Documents the new channel and provides an items example.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

psmedley and others added 2 commits February 7, 2026 17:16
…ding/ring/internal/handler/AccountHandler.java

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Paul Smedley <paul@smedley.id.au>
Signed-off-by: Paul Smedley <paul@smedley.id.au>
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.

1 participant

Comments