View on GitHub

HDL Homey App

The unoffical HDL SmartBus app for Homey

HDL Heating Controller and Homey Pro

Introduction

This guide explains how to connect and configure HDL Heating Controllers with Homey Pro.

HDL equipment comes in many flavours, with different firmware and setups, so your exact experience might not match this guide step for step. Think of this as a general walkthrough rather than a one-size-fits-all recipe.

⚠️ Important: This guide does not tell you anything about the equipment your heating controller is about to operate. Changing parameters such as speed, timing, flushing, control cycles and more from HDL SetupTool may have negative impacts on your heating system. If you disable logic from the heating controller that operates these features today, or override them using Homey later on, problems may occur. Understanding how your heating system works is paramount to a successful implementation.

Before You Start

💡 Tip: Don’t do this for the first time in the middle of winter. If something breaks, you don’t want to be without heating.

How the System Works

The “Classic” HDL Setup

In most HDL homes without Homey Pro:

With Homey Pro

When you bring in Homey Pro, things change:

📌 Changes made on the DLP automatically show up in Homey, and changes made in Homey show up on the DLP.

Configuration

Step 1 – Prepare Homey

Step 2 – Set Up DLP Panels

👉 It’s a good idea to test one zone first. When it works, repeat for the rest.

  1. Open a DLP in the HDL Setup Tool.

  2. Open the tab for Floor Heating.

    • Refresh first to make sure you’re looking at the latest config.
  3. Change the DLP role from Master → Slave.

    • Click the button “Master” and enter the address of your heating controller and which channel it should operate.
  4. Do you use the Inner Sensor?

    • This is usually on by default. It reports ambient temperature from the DLPs to both Homey Pro and the heating controller.

    • If you use other HDL-sensors, you’ll need to configure those later in the heating controller.

  5. Set the Mode to Normal. Disable Day, Night, Away, and Timer.

  6. Leave things like PID, Always-On, Sync alone unless you actually want to change them. If PID is already enabled, it’s probably for a good reason. Disabling it can cause issues.

  7. Save.

👉 Double-check that the DLP’s master address points to your heating controller and with the corresponding ID.

Figure 1: Typical Floor Heating tab. Inner sensor enabled to report the temperatur on the bus. Temperature range set to force an upper and lower limit. Mode: All modes except “Normal” is checked. My heating must always be on (remember to also set this in Homey!) and I require PID in my heating syste,.
alt text

Figure 2: When clicking the “Master” button as seen in figure 1, this menu appears. Subnet and Device ID is self-explanatory. Channel is the heating channel.
alt text

Step 3 – Configure the Heating Controller

  1. Open the Heating Controller in HDL Setup Tool

  2. Refresh to load the latest configuration.

  3. For each heating ID:

    • Set Work Mode to Fully Control (Master).

    • Set Temperature Source to External and enter the matching DLP address.

    • Enable the channel.

    • Select the correct heating type.

    • Set Current Mode to Normal.

    • Save before moving to the next one! If you do several each time, please save for each ID completed.

alt text

Step 4 - Testing

Once configuration is done:

Troubleshooting

Homey Automation Considerations