ha_rdz_pdc_config/docs/configuration.md

layout, title, nav_order

layout	title	nav_order
default	Configuration	3

Configuration

Finding Your Heat Pump URL

The integration requires the URL to your heat pump's status API. The format is typically:

http://<HEAT_PUMP_IP>/installedplugin/com.innova.pdc/<VERSION>/server/index.php?Action=GetStatus

Method 1: Browser Developer Tools

1. Access your heat pump's web interface in a browser
2. Open browser developer tools (F12)
3. Navigate to the Network tab
4. Refresh the page or navigate the heat pump interface
5. Look for requests to index.php?Action=GetStatus
6. Copy the full URL

Use browser developer tools to find the correct API URL

Method 2: Common URL Patterns

Try these common URL patterns (replace IP with your heat pump's IP):

http://192.168.1.100/installedplugin/com.innova.pdc/2.0.10/server/index.php?Action=GetStatus
http://192.168.1.100/installedplugin/com.innova.pdc/3.0.49/server/index.php?Action=GetStatus

Verify Your URL

Open the URL in a browser. You should see a JSON response like:

{
  "success": true,
  "sw": { "V": "3.0.49" },
  "RESULT": {
    "status": {
      "watert1": 32.1,
      "watert2": 32.0,
      "heating": true,
      ...
    }
  }
}

Expected JSON response when accessing the URL

Configuration Wizard

Step 1: Enter URL

When adding the integration, enter your heat pump URL:

Enter the heat pump status URL

Step 2: Set Update Interval

Optionally configure the update interval (default: 3 seconds):

Setting	Description	Recommended
1-2 seconds	Very frequent updates	High network load
3 seconds	Default, good balance	Recommended
5-10 seconds	Less frequent	Low network load

Configure the polling interval

Step 3: Confirm Configuration

Review and confirm your settings:

Review configuration before completing setup

Configuration Options

After initial setup, you can modify options:

1. Go to Settings > Devices & Services
2. Find "Heat Pump Monitor"
3. Click Configure

Access configuration options after setup

Entity Customization

After setup, you may want to customize entities:

Rename Entities

1. Go to Settings > Devices & Services
2. Click on the Heat Pump device
3. Click on an entity
4. Change the name as desired

Customize entity names

Hide Unused Entities

If some sensors don't apply to your setup:

1. Click on the entity
2. Toggle "Enable" off

Next Steps

• Set up the dashboard
• Troubleshoot issues