Files

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
![Finding URL in DevTools](assets/images/devtools-network.png)
*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,
...
}
}
}
```
![JSON Response](assets/images/json-response.png)
*Expected JSON response when accessing the URL*
## Configuration Wizard
### Step 1: Enter URL
When adding the integration, enter your heat pump URL:
![Enter URL](assets/images/config-url.png)
*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 |
![Update Interval](assets/images/config-interval.png)
*Configure the polling interval*
### Step 3: Confirm Configuration
Review and confirm your settings:
![Confirm Config](assets/images/config-confirm.png)
*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**
![Reconfigure](assets/images/reconfigure.png)
*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
![Rename Entity](assets/images/rename-entity.png)
*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)