[remehaheating] Initial contribution

[FreddyFFM]

[remehaheating] Initial contribution

Description

This PR adds a new binding for Remeha Home heating systems, enabling monitoring and control of Remeha boilers through the Remeha Home cloud service.

Classification: Novel Addition - New Binding

Key Features:

• Real-time monitoring of room and outdoor temperatures
• Target temperature control (5-30°C)
• Hot water (DHW) temperature monitoring and mode control (anti-frost/schedule/continuous-comfort)
• Water pressure monitoring with status indicator
• System error status monitoring
• OAuth2 PKCE authentication (same as official Remeha Home mobile app)

Supported Hardware:

• Remeha boilers connected to Remeha Home cloud service
• Tested with Remeha Calenta Ace boiler
• Should work with any modern Remeha boiler with internet connectivity (E-Twist module needed)

Technical Details:

• Cloud-based binding using Remeha API
• Manual configuration with Remeha Home account credentials
• Configurable refresh interval (30-3600 seconds, default 60s)
• Proper use of Units of Measurement (Temperature, Pressure)
• Semantic tags for channels (Measurement, Setpoint, Temperature, Pressure)
• Comprehensive unit tests (20 tests, all passing)

Documentation:

• Complete README with configuration examples
• Thing and item configuration examples
• Sitemap example included
• Troubleshooting section

Code Quality:

• Follows openHAB coding guidelines
• @NonNullByDefault annotations on all main classes
• Static code analysis: 0 errors
• All tests passing
• EPL 2.0 licensed with NOTICE file

Testing

The binding has been tested with a Remeha Calenta Ace boiler and E-Twist module and successfully:

• Authenticates with Remeha Home cloud service
• Retrieves and updates sensor values
• Controls target temperature
• Changes Hot Water operating modes

Community testing welcome for other Remeha boiler models.

Signed-off-by: Michael Fraedrich your.email@example.com

[lsiepel]

Thansk for contributing this binding. I had a quick initial look. The comments can be applied on multiple lines, so hopefully you can fix all places it occurs.
Readme, handler and apiclient are the three files i have not yet looked at.

[Copilot]

Pull Request Overview

Initial contribution of the Remeha Heating binding integrating Remeha Home cloud-connected boilers into openHAB with monitoring and basic control.

• Adds new binding, handler, handler factory, and API client with OAuth2 PKCE flow
• Defines thing types, channels, i18n, feature, and tests

Reviewed Changes

Copilot reviewed 21 out of 21 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
bundles/pom.xml	Registers new remehaheating module in build
bom/openhab-addons/pom.xml	Adds binding to BOM dependencies
CODEOWNERS	Assigns ownership for new bundle
bundles/org.openhab.binding.remehaheating/pom.xml	New bundle POM
bundles/org.openhab.binding.remehaheating/src/main/java/.../RemehaApiClient.java	Implements OAuth2 PKCE and API calls
bundles/org.openhab.binding.remehaheating/src/main/java/.../RemehaHeatingHandler.java	Thing handler logic, polling, updates, and commands
bundles/org.openhab.binding.remehaheating/src/main/java/.../RemehaHeatingHandlerFactory.java	OSGi factory for handler
bundles/org.openhab.binding.remehaheating/src/main/java/.../RemehaHeatingBindingConstants.java	Binding constants
bundles/org.openhab.binding.remehaheating/src/main/java/.../RemehaHeatingConfiguration.java	Thing configuration class
bundles/org.openhab.binding.remehaheating/src/main/resources/OH-INF/thing/thing-types.xml	Thing and channel types
bundles/org.openhab.binding.remehaheating/src/main/resources/OH-INF/i18n/remehaheating.properties	I18n labels/descriptions
bundles/org.openhab.binding.remehaheating/src/main/resources/OH-INF/addon/addon.xml	Add-on metadata
bundles/org.openhab.binding.remehaheating/src/main/feature/feature.xml	Karaf feature definition
bundles/org.openhab.binding.remehaheating/README.md	Binding documentation
tests and sample JSON	Unit tests and test resource

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[lsiepel]

Are you able to proceed @FreddyFFM ?

[FreddyFFM]

Are you able to proceed @FreddyFFM ?

Sure, what is still open from you side? Did I miss something?

[lsiepel]

Ah, i see. Usually one comments or addss a thumbs up icon when a comment is being processed. But now i see all was addressed already. only #19494 (comment) left.
I'll proibably revisit this tomorrow and finalize my review.

[lsiepel]

Thansk, Looked at all the files. Some comments are left. I think this PR is pretty clean already. Mainly the handler and the apiclient need some attention.

Minor suggestion: You could create a seperate folder api next to the handler, and add the apiclient and future dto's and whatever is needed into that package.

Don;t forget to:

1. fix all warnings and SAT
2. regenerate i18n file if not already.

[lsiepel]

There are 4 build warnings and 5 SAT errors to fix.
I would also expect an updated properties fiole (regenerated from the i18n plugin)

[FreddyFFM]

There are 4 build warnings and 5 SAT errors to fix. I would also expect an updated properties fiole (regenerated from the i18n plugin)

Fixed the warnings and SAT errors, regenerated i18n properties file with plugin.

[lsiepel]

Thanks @FreddyFFM. Sorry i somehow overlooked this PR and it did not end up in 5.1.0 while it was ready. I will now merge it and it will become the first new binding of 5.2.0

You could add the binding's logo to the openHAB website. See https://www.openhab.org/docs/developer/addons/#add-your-add-on-s-logo-to-the-openhab-website-and-the-ui