Dimplex Hub

Custom Home Assistant integration for Dimplex electric heating appliances.

Overview

This integration connects Home Assistant to the Dimplex cloud API and exposes core heater telemetry and controls through config entries.

Supported entities

Platform	Description
sensor	Room temperature per appliance.
binary_sensor	Comfort status per appliance.
switch	EcoStart toggle per appliance.

Installation (manual)

1. Open your Home Assistant configuration directory (the folder containing configuration.yaml).
2. Create custom_components if it does not exist.
3. Copy custom_components/dimplex from this repository into your Home Assistant config.
4. Restart Home Assistant.
5. In Home Assistant, go to Configuration -> Integrations.
6. Click + and search for Dimplex Hub.

Configuration

Configuration is done in the UI through the integration config flow.

Getting the OAuth callback URL or code

During setup, the config flow shows a login URL.

1. Open that login URL in your browser.
2. Before entering your credentials, open Developer Tools (F12) and go to the Network tab.
3. Enable Preserve log (or equivalent "keep log" option).
4. Submit your login details.
5. The final mobile-app redirect will fail/cancel, which is expected.
6. In Network, find the last redirect/cancelled request (or the request URL) that includes ?code=....
7. Copy either:
   • the full callback URL (starts with msal...://auth/?code=...), or
   • just the code value.
8. Paste that into the integration form field Redirect URL or code.

If the code expires, repeat the steps and capture a fresh one.

Known limitations

• Target temperature controls are not exposed yet.
• Schedules/timer editing is not exposed yet.

Troubleshooting

• Check Home Assistant logs for authentication or connectivity errors.
• Re-authenticate in the config flow if your token has expired.
• If setup fails, create an issue with logs and reproduction steps.

Contributions are welcome!

If you want to contribute, please read the Contribution guidelines.

Credits

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.

Code template was mainly taken from @Ludeeus's integration_blueprint template

---