Skip to content

Midea Heat Pump Water Heater v0.2.0

Choose a tag to compare

View all tags
@0xAHA 0xAHA released this 13 Sep 04:09
v0.2.0
b6beb3d

Midea Heat Pump Water Heater v0.2.0

Major milestone – Complete migration from YAML to full Home Assistant UI integration.

🚀 What's New in v0.2.0

Full UI Configuration

  • No more YAML – All parameters are now configured directly via the Home Assistant UI
  • Config Flow support – Add and edit devices through the Integrations menu
  • Options flow – Update parameters without restarting Home Assistant
  • Self-contained integration – Modbus client and device logic fully integrated (no separate modbus setup needed)

Simplified Setup

  • One-click discovery – Easily set up your heat pump without touching configuration.yaml
  • Cleaner management – Configuration, reconfiguration, and removal all handled from the UI
  • Future-ready – Foundation laid for multiple device support and diagnostics

💥 Breaking Changes from v0.1.0

YAML configuration is no longer supported.
Any previous YAML setup must be removed.

Migration Steps

  1. Remove old YAML configuration

    • Delete your midea_heatpump_hws: block from configuration.yaml
    • Remove any modbus: !include modbus.yaml lines (no longer required)

  2. Restart Home Assistant

    • Ensure there are no YAML errors and that the integration is no longer loaded from configuration files

  3. Re-add via the UI

    • Go to Settings → Devices & Services → Add Integration → Midea Heat Pump HWS
    • Enter your connection details (host, port, unit ID, etc.)
    • Configure entity names and options directly from the UI

🔧 Technical Improvements

  • UI-driven config flow – Eliminates manual YAML mistakes
  • Streamlined Modbus handling – Built-in client with async operations
  • Config reload support – Change settings without restarting HA
  • Cleaner entity management – Entities automatically created and updated from options

📦 Dependencies

  • pymodbus >= 3.11.0 (still required for Modbus communication)
  • Home Assistant 2024.9+ (minimum version for stable config flow support)

⚠️ Known Limitations

  • No automatic migration from YAML – manual removal and re-setup required
  • Network reliability still required for stable operation
  • **Reconfiguration of sensors is buggy - delete and re-add device in the meantime

🛠️ What's Next

  • Enhanced diagnostics (status monitoring, debug logs in UI)
  • Energy usage and efficiency reporting

Full documentation: README.md

Assets 2
Loading