124 lines
2.9 KiB
Markdown
124 lines
2.9 KiB
Markdown
---
|
|
layout: default
|
|
title: Configuration
|
|
nav_order: 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:
|
|
|
|
```json
|
|
{
|
|
"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](dashboard.md)
|
|
- [Troubleshoot issues](troubleshooting.md) |