Skip to content

v1.9.3-beta.1

Pre-release
Pre-release

Choose a tag to compare

@alepee alepee released this 30 Sep 16:47
e9e0aaa

Hitachi Yutaki – COP Calculation Fixes & Data Validation (v1.9.3-beta.1)

Downloads for this release

A new beta release of the Hitachi Yutaki integration is now available, featuring major improvements to COP (Coefficient of Performance) calculations and robust data validation to eliminate aberrant values.

✨ What's New?

  • Fixed Aberrant COP Values: Resolved the issue where COP sensors were returning impossible values (50-500) by implementing comprehensive data validation and intelligent unit detection.
  • Intelligent Power Unit Detection: The integration now automatically detects whether your power sensors report values in watts (W) or kilowatts (kW) using the unit_of_measurement attribute, with intelligent fallback detection.
  • Comprehensive Data Validation: Added robust validation for all input parameters:
    • Temperature ranges (-10°C to 80°C)
    • Water flow rates (0.1 to 10.0 m³/h)
    • Temperature differences (0.5 to 30 K)
    • Power ranges (0.1 to 50.0 kW thermal, 0.1 to 20.0 kW electrical)
    • Final COP values (0.5 to 8.0)
  • Enhanced Debug Logging: Detailed logging for unit detection, validation failures, and COP calculations to help diagnose issues.
  • Energy Accumulation Validation: Added validation for accumulated thermal and electrical energies to prevent calculation errors.

🔧 Technical Improvements

  • Automatic Unit Conversion: Seamless handling of power sensors in both W and kW units
  • Range-Based Fallback: Intelligent detection when unit_of_measurement is not available
  • Validation Pipeline: Multi-layer validation ensures only reasonable values are used in COP calculations
  • Error Handling: Graceful rejection of invalid data with detailed logging

📝 Important Notes

  • This update is completely backward compatible - no configuration changes are required.
  • The integration now provides much more realistic COP values (typically 2-6 for heat pumps).
  • Invalid or aberrant data will be rejected with warning logs instead of producing incorrect COP values.
  • External power and voltage sensors are now better supported with automatic unit detection.

🧪 Testing Needed

We would appreciate feedback on:

  • COP Values: Are your COP readings now within reasonable ranges (2-6)?
  • Power Sensors: Does the integration correctly detect your power sensor units (W vs kW)?
  • Data Validation: Are you seeing appropriate warning logs for invalid data?
  • Performance: Any impact on integration performance with the additional validations?

🐛 Bug Reports

If you encounter any issues, please open a GitHub issue and include:

  • Your Home Assistant version
  • Your power sensor configuration (unit of measurement)
  • Debug mode logs showing validation messages
  • Current COP values and whether they seem realistic
  • A clear description of the problem

🔍 Debugging

To help diagnose COP calculation issues, enable debug logging:

logger:
  logs:
    custom_components.hitachi_yutaki: debug

This will show detailed information about unit detection, data validation, and COP calculations.

This beta release addresses the COP calculation issues and provides a foundation for more reliable performance monitoring of your Hitachi Yutaki heat pump system.