ha_rdz_pdc_config/docs/troubleshooting.md

layout, title, nav_order

layout	title	nav_order
default	Troubleshooting	5

Troubleshooting

Common Issues

Integration Not Appearing

Symptoms: After copying files and restarting, "Heat Pump Monitor" doesn't appear in the integrations list.

Solutions:

1. Verify the folder structure is correct:

   custom_components/
   └── rdz_innova_heatpump/
       ├── __init__.py
       ├── manifest.json
       └── ... other files
   

2. Check file permissions
3. Perform a full restart (not just reload)
4. Check Home Assistant logs for errors

Check Home Assistant logs for error messages

Connection Failed

Symptoms: "Failed to connect" error during setup.

Solutions:

1. Verify the URL is accessible from your HA server:

   curl http://YOUR_HEAT_PUMP_IP/installedplugin/com.innova.pdc/VERSION/server/index.php?Action=GetStatus
   

2. Check network connectivity between HA and heat pump
3. Verify the URL format is correct
4. Check if heat pump web interface is responding

Missing Sensors

Symptoms: Some sensors show "Unknown" or "Unavailable".

Solutions: This is often due to firmware version differences. Different versions have different JSON structures.

Some sensors may show unavailable due to firmware differences

Firmware Version Differences

Known Differences

Field	v3.0.49+	v2.3.x
ISP (Inlet Setpoint)	"34.3 °C" (string with unit)	May not exist
SSP (System Setpoint)	Present	May not exist
alarm.status	true/false	May only have type field
res (aux heater state)	Present	May not exist
sce	Present	May not exist

Checking Your Firmware Version

1. Access your heat pump URL in a browser
2. Look for the sw.V field in the response:

   {
     "sw": { "V": "3.0.49" },
     ...
   }
   

Adapting for Different Firmware

If your firmware has different field names, you may need to modify __init__.py.

Key mappings (line ~122-158):

"inlet_setpoint_temp": float(status.get("ISP", "0").split()[0]),
"system_setpoint_temp": status.get("SSP"),
"water_temp_t1": status.get("watert1"),
"water_temp_t2": status.get("watert2"),
"dhw_temp_t3": status.get("dhwt3"),
"outdoor_temp_t4": status.get("t4"),
"water_setpoint": status.get("watersetpoint"),
"dhw_setpoint": status.get("dhwsetpoint"),
"is_heating": status.get("heating", False),
"is_working": status.get("pwr", False),
"is_cooling": status.get("cooling", False),
"is_dhw": status.get("san", False),
"is_pump_active": status.get("pump", False),
"is_aux_heater": status.get("res", False),
"is_standby": status.get("standby", False),

To find correct field names:

1. Save your heat pump's JSON response to a file
2. Compare with the sample files in jsons/ folder
3. Adjust the field names in __init__.py accordingly

Temperature Reading Issues

Incorrect Values

Symptoms: Temperature shows wrong values (e.g., 0 or very high numbers).

Solutions:

1. Check the JSON response format for temperature fields
2. Some fields may be strings with units (e.g., "34.3 °C") that need parsing
3. Verify field names match your firmware version

ISP Field Parsing Error

The ISP field often contains a string with unit: "34.3 °C"

The code parses this with:

float(status.get("ISP", "0").split()[0])

If your firmware returns a different format, adjust accordingly.

Setting Temperature Issues

Set Temperature Not Working

Symptoms: Changing temperature in thermostat card doesn't affect heat pump.

Solutions:

1. Check Home Assistant logs for errors
2. Verify the SetParameter endpoint is correct
3. Test manually:

   curl -X POST "http://YOUR_IP/installedplugin/com.innova.pdc/VERSION/server/index.php?Action=SetParameter" \
     -d "Key=watersetpoint&Value=45&manual=forever"
   

Check logs when setting temperature fails

Debug Logging

Enable debug logging for more information:

Add to configuration.yaml:

logger:
  default: info
  logs:
    custom_components.rdz_innova_heatpump: debug

Then restart Home Assistant and check logs.

Sample JSON Files

The repository includes sample JSON responses for reference:

File	Firmware	Description
jsons/og.json	v3.0.49	Full feature set
jsons/bogdan.json	v2.3.2	Reduced features

Compare your heat pump's response with these files to identify differences.

Getting Help

Gathering Information

When reporting issues, include:

1. Home Assistant version
2. Heat pump firmware version (from JSON sw.V field)
3. Full JSON response from your heat pump (sanitize IP if needed)
4. Relevant log entries
5. Steps to reproduce

Sharing Your JSON

If you have a different firmware version, consider sharing your JSON response to help improve compatibility:

1. Save your JSON response
2. Remove any sensitive information
3. Submit as an issue or pull request

FAQ

Q: How often does the integration poll the heat pump? A: Default is every 3 seconds. Configurable during setup or in options.

Q: Can I use this with other heat pump brands? A: This integration is designed for RDZ PDC heat pumps with Innova web interface. Other brands may have different APIs.

Q: Does this work without internet? A: Yes, this is a local polling integration. No cloud services required.

Q: Why are some fields missing in my version? A: Different firmware versions expose different data. Older versions may lack some sensors.