Skip to content

Add HRDS dehumidifier implementation plan - #89

Open
mikopp wants to merge 2 commits into
masterfrom
claude/hdrs-dehumidifier-airflow-iiit7c
Open

Add HRDS dehumidifier implementation plan#89
mikopp wants to merge 2 commits into
masterfrom
claude/hdrs-dehumidifier-airflow-iiit7c

Conversation

@mikopp

@mikopp mikopp commented Jun 27, 2026

Copy link
Copy Markdown
Owner

Summary

This commit adds a comprehensive implementation plan for integrating the HRDS+ dehumidifier with the existing airflow cooling system. The plan documents the design, coordination strategy, and migration path for adding humidity control via the dehumidifier unit while maintaining compatibility with the current Comfo ventilation controller.

Key Changes

  • New plan document (plans/hrds-dehumidifier.md): Complete specification covering:
    • System context and how the HRDS coordinates with existing airflow logic
    • Analysis of existing airflow states and HRDS interaction points
    • Design decisions (all pre-resolved with the user)
    • Detailed package architecture for three new/refactored files:
      • packages/climate_common.yaml — shared climate parameters and primitives
      • packages/energy.yaml — PV surplus detection and free-energy signals
      • packages/hrds_dehumidifier.yaml — the HRDS control package
    • Refactoring of packages/airflow_cooling.yaml to use shared climate entities
    • Helper entities, decision sensors, and automation logic
    • Pre-implementation hardware verification checklist
    • History-preserving migration runbook using ha_mcp
    • Comprehensive test strategy and verification steps

Notable Implementation Details

  • Coordination model: The HRDS dehumidifies on free solar PV surplus (above target humidity) or unconditionally (above max humidity). It uses recirculation-fan top-up to maintain minimum combined airflow (150 m³/h baseline, 250 m³/h during boost window).
  • Shared thresholds: Both airflow and HRDS packages use dew-point-based decision logic with asymmetric Schmitt hysteresis, eliminating command contention.
  • Anti-flip-flop protection: Minimum runtime timer and hysteresis bands prevent oscillation.
  • Three airflow targets: 150 m³/h (baseline), ~200 m³/h (opportunistic PV), 250 m³/h (serious moisture + boost schedule).
  • No Comfo edits required: Existing flush/boost logic already gates on outdoor dew point; HRDS recirculation is independent.
  • Entity rename strategy: Template sensors preserve history via unique_id reuse; YAML helpers use snapshot-and-restore.

This plan is not yet implemented — it documents the design and serves as the specification for the actual implementation phase.

https://claude.ai/code/session_01A89KSdA4V9j6JzdfdTEyvK

claude added 2 commits June 27, 2026 20:20
Implementation plan for a new HRDS+ dehumidifier package that coordinates
with the existing ComfoConnect airflow package: PV-surplus-gated dehumidify,
combined-airflow top-up via the HRDS recirculation fan, a shared climate_*
common package, a new energy package (with the migrated Shelly pool config),
and a history-preserving entity rename via ha_mcp.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A89KSdA4V9j6JzdfdTEyvK
Adds an interaction-analysis section (contradictions, races, fights):
no actuator contention and dew-band mutual exclusivity make a direct
fight impossible; documents seven interaction risks (I1–I7) with
resolutions — heating-season gate, free-cooling override, separate
hrds_off_dew_diff hysteresis, fan-write anti-chatter, and OFF-path no-op.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A89KSdA4V9j6JzdfdTEyvK
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants