Climate Group Helper for Home Assistant

<a href="https://github.com/bjrnptrsn/climate_group_helper"><img src="https://raw.githubusercontent.com/bjrnptrsn/climate_group_helper/main/assets/[email protected]" alt="Climate Group Helper for Home Assistant logo" width="160"/></a> <a href="https://github.com/hacs/integration"><img src="https://img.shields.io/badge/HACS-Default-orange.svg" alt="HACS - Home Assistant Community Store"/></a> <a href="https://github.com/bjrnptrsn/climate_group_helper/releases"><img src="https://img.shields.io/github/v/release/bjrnptrsn/climate_group_helper" alt="Release"/></a> 🇬🇧 English · <a href="LIESMICH.md">🇩🇪 Deutsch</a> Home Assistant의 고급 로직 계층을 제공하는 클라이메이트 장치용 헬퍼입니다. 써모스탯을 동기화(Sync), 자동화(automate)하고 수정할 수 있습니다 — 모두 UI에서 설정 가능합니다. 🔗 장치를 그룹화(Group devices)하여 하나의 가상 컨트롤러로 만드세요. 🌡️ 외부 보정(calibration)으로 부정확한 센서 수정하기: 🔄 멤버가 수동 변경을 할 때 Mirror, Lock, Master 또는 Adopt Only 동기화 모드로 반응합니다. 🪟 창문이 열린 것을 감지하여 난방을 자동으로 일시 중지합니다. 👤 외출 오프셋(away offsets)과 온도를 사용하여 존재 여부를 자동화합니다. 📅 스케줄 및 캘린더 엔티티를 통해 자동화를 예약합니다. 🎯 그룹 전체를 한 번에 설정하는 자신만의 프리셋을 정의합니다. 🔥 일정 시간 동안 온도를 높인 후 자동으로 원래대로 돌아가게 합니다. 🚧 특정 조건이 유지되는 동안 그룹에서 단일 장치를 격리합니다. 🧩 멤버 템플릿(Member Template)으로 단일 설정점 장치에 난방/냉방 범위를 추가합니다. ➕ 단일 오프셋으로 전체 그룹을 위 또는 아래로 이동시킵니다. 🎛️ 대시보드 카드도 포함되어 있어, 그룹이 무엇을 하는지 보여줍니다. <img src="https://raw.githubusercontent.com/bjrnptrsn/climate_group_helper/main/assets/configuration_simple.png" alt="Climate Group Helper 간단 설정 옵션 개요" height="350"/>

이 헬퍼가 필요한 이유

Home Assistant에서 기후(난방)를 관리하는 것은 복잡할 수 있습니다: TRV는 라디에이터의 잘못된 온도를 측정하고, 기본 그룹은 동기화가 부족하며, 복잡한 자동화는 유지 관리가 어렵습니다.

Climate Group Helper는 사용자님의 집에 지능적인 "로직 계층(Logic Layer)" 역할을 합니다. 기존 장치들을 하나의 컨트롤러로 묶어주며, "이것이면 저것이다"라는 동작을 자동으로 처리해줍니다.

[!TIP]
그룹 전용이 아닙니다! 단지 **하나의 온도 조절기(thermostat)**만 가지고 있더라도, 이 헬퍼를 사용하여 창문 제어(Window Control)나 센서 보정(Sensor Calibration)과 같은 고급 기능을 기본 하드웨어에 추가할 수 있습니다.

[!TIP]
다른 통합 기능과도 작동합니다! CGH는 Better Thermostat나 Versatile Thermostat에서 제공하는 것을 포함하여 모든 climate.* 엔티티와 작동합니다. 이들이 개별 장치 제어(MPC, PID, TPI)를 처리하도록 맡기고, CGH가 다중 공간의 로직을 오케스트레이션합니다. 설정 예시는 EXAMPLES.md를 참고하세요.

빠른 시작

단계	동작
1. 설치	HACS를 통해 추가하고 Home Assistant를 재시작합니다.
...

핵심 개념: 통합된 기반 (The Unified Foundation)

The Climate Group Helper는 사용자의 기후 장치들을 위한 강력한 '단일 진실 공급원(Single Source of Truth)'을 제공합니다. 이는 정확한 실내 상태를 유지하면서도, 모든 장치가 하나의 응집력 있는 시스템처럼 함께 작동하도록 보장하는 통합 관리 계층을 생성합니다.

[!TIP]
기능들이 어떻게 연결되나요? HOW_IT_WORKS.md는 어떤 요소가 장치들의 동작을 결정하고, 무엇이 우선순위를 가지며, 그룹이 때때로 사용자가 설정한 것과 다르게 보이는 이유를 보여줍니다.

단순 모드 (Simple Mode) (핵심 기능)

이러한 기능들은 기본적으로 활성화되어 있으며 간소화된 '플러그 앤 플레이(Plug & Play)' 경험을 제공합니다:

통합 제어: 그룹에서 설정을 변경하면 모든 멤버 장치가 해당 설정에 맞춰 업데이트됩니다. 더 이상 여러 온도 조절기를 개별적으로 관리할 필요가 없습니다.
스마트 상태 집계: 그룹은 멤버들의 측정값 **평균(average)**을 계산하여 실제 실내 상태를 나타냅니다 (평균, 중앙값, 최소값 또는 최대값).
HVAC 전략: 그룹의 상태(정상, 우선순위 해제, 또는 자동)를 결정하는 지능형 로직입니다.
정밀도 및 반올림: 목표 온도를 장치와 호환되는 단계(0.5° 또는 1°)로 반올림하여 모든 하드웨어와의 호환성을 보장합니다.

파워 유저: 고급 기능 (Advanced Features)

클라이밋 시스템의 잠재력을 최대한 활용하세요. 이러한 특수 기능들은 그룹 설정에서 **고급 기능(Advanced Features)**을 토글하여 활성화됩니다. 단순 모드(Simple Mode)로 다시 전환하면 이 옵션들이 숨겨지고 기능적으로 휴면(hibernation) 상태가 됩니다. 즉, 작동이 멈추지만 구성은 그대로 유지되며, 다시 전환할 때 즉시 복원됩니다.

[!NOTE]
새 그룹은 단순 모드(Simple Mode)로 시작합니다. 이전 버전에서 업그레이드된 기존 그룹들은 아무것도 깨지지 않도록 **고급 기능(Advanced Features)**이 자동으로 활성화 상태를 유지합니다.

마스터 엔티티 (Master Entity)

그룹의 클라이밋 멤버 중 하나를 참조 지점(Reference Point) 또는 **리더(Leader)**로 지정합니다. 이는 멤버 및 모드(Members & Modes) 섹션에서 설정하며, **고급 모드(Advanced Mode)**가 필요합니다. 한번 설정하면 여러 섹션(동기화 모드(Sync Mode), 창문 제어(Window Control), 온도/습도 평균 계산)의 추가 옵션이 활성화됩니다.

중앙 집중식 목표 표시(Centralized Target Display): 그룹의 모든 멤버에 걸쳐 계산된 평균값 대신, 마스터의 설정 값(온도, 습도)을 그룹의 표시 목표로 보여줍니다. 이는 그룹 상태가 표시되는 방식에만 영향을 미치며, 멤버를 제어하거나 동기화하지는 않습니다 (이를 위해서는 **동기화 모드: 마스터/잠금(Sync Mode: Master/Lock)**을 사용하십시오).
계층적 동기화 (마스터/잠금, Hierarchical Sync (Master/Lock)): "리더를 따르는(Follow the Leader)" 동기화 모드를 활성화합니다. 마스터에서의 변경 사항은 모든 멤버에 미러링되며; 다른 장치에서의 변경 사항은 선택된 **동기화 속성(Sync Attributes)**에 대해서만 되돌려지고, 선택되지 않은 속성은 무시됩니다.
지능형 창문 제어(Intelligent Window Control): 활성화된 경우, 창문이 열려 있는 동안에는 마스터에서의 수동 조정만 목표 상태를 업데이트합니다. 다른 장치에서의 변경 사항은 계속 무시됩니다.

외부 센서 (External Sensors)

온도 및 습도를 위해 다중 외부 센서를 사용하여 멤버의 측정값을 재정의하고, 선택적으로 해당 값을 TRV 보정 목표값으로 다시 기록할 수 있습니다.

장치 보정 (Device Calibration)

외부 센서 값을 TRV에 다시 기록하여 내부 온도 측정값을 고정합니다.

모드(Modes): 절대값(Absolute, 표준), 오프셋(Offset, 델타 계산), 및 스케일링(Scaled, Danfoss Ally의 경우 x100)이 있습니다.
반전 오프셋(Inverted Offset): 더 높은 오프셋 값이 장치가 더 낮은 온도를 보고하게 만드는 경우, **반전 오프셋 목표값(Inverted Offset Targets)**에서 선택합니다. 이때 오프셋은 반대 부호로 기록됩니다.
하트비트(Heartbeat): Zigbee 장치에서 센서 시간 초과를 방지하기 위해 보정 값을 주기적으로 재전송합니다.
전원 차단 멤버 무시(Ignore Off Members): 현재 꺼짐 상태인 TRV로 보정 업데이트가 전송되는 것을 방지하여 무선 장치의 배터리 수명을 보존합니다.

고급 동기화 모드 (Advanced Sync Modes)

그룹 자체를 제어할 때가 아니라, 멤버 장치가 직접 변경될 때(예: 해당 앱 또는 물리적 버튼을 통해) 발생하는 상황을 제어합니다.

동기화 모드(Sync Modes)

각 모드의 동작은 동기화 속성(Sync Attributes) 아래의 변경된 속성이 선택되었는지 여부에 따라 달라집니다. 두 개의 열을 해당 모드가 적용하는 두 가지 독립적인 정책으로 생각하십시오:

Sync Mode 속성 선택 속성 미선택
|---|---|
| Disabled | 무시 (Ignore) | 무시 (Ignore)
| Mirror | Mirror ¹ | 무시 (Ignore)
| Lock | Revert ¹ | 무시 (Ignore)
| Mirror/Lock | Mirror ¹ | Revert ¹
| Master/Lock | Master: Mirror · Non-master: Revert ¹ | 무시 (Ignore)
| Adopt Only | Adopt ² | 무시 (Ignore)

*¹ **Respect Member Off State (Sync)*가 활성화된 경우: 수동으로 off로 설정된 멤버는 그대로 유지되며, 그 off 상태는 미러링되거나 리버트되지 않습니다.
² Adopt Only는 그룹 자체의 설정을 변경된 장치에 맞게 업데이트하지만, 다른 멤버에게 변화를 전파하지는 않습니다. 아무도 작동하고 있지 않은 상태가 되면 (다른 어떤 멤버도 실행 중이 아닐 때) off로 설정된 장치는 전체 그룹을 off로 만듭니다. 이는 Respect Member Off State (Sync) 옵션과 관계없이 적용됩니다.

동기화 속성 (Sync Attributes)

Sync Attributes를 사용하면 hvac_mode, temperature, preset_mode와 같이 특정 속성을 선택하여 동기화에 포함시킬 수 있습니다. 선택되거나 미선택된 속성의 의미는 **동기화 모드(Sync mode)**에 따라 달라집니다:

모드 (Mode)	동기화 속성 (Sync Attributes)의 역할
Mirror	선택된 (selected) 속성은 미러링되고, 미선택된 (unselected) 속성은 무시됩니다.
Lock	선택된 (selected) 속성은 리버트(reverted)되며, 미선택된 (unselected) 속성은 무시됩니다.
Mirror/Lock	선택된 (selected) 속성은 미러링되고, 미선택된 (unselected) 속성은 리버트됩니다.
Master/Lock	선택된 (selected) 속성은 마스터 엔티티(Master Entity)에서 미러링되며, 미선택된 (unselected) 속성은 무시됩니다. 비-마스터 장치로부터의 변경 사항은 선택된 속성에 대해 리버트되고; 미선택된 속성은 무시됩니다.
Adopt Only	선택된 (selected) 속성은 그룹 설정으로 채택(adopted)되며, 미선택된 (unselected) 속성은 무시됩니다. 다른 멤버에게는 아무것도 전송되지 않습니다.

멤버 'Off' 상태 존중 (동기화): 멤버가 수동으로 off로 설정되면, 그룹은 그 off 상태를 다른 멤버에 반영하지도, 다시 켜도록 강제하지도 않습니다. 해당 멤버는 단순히 그대로 유지됩니다. 유일한 예외는: 만약 이 멤버가 마지막 활성 멤버인 경우, 그룹은 off 상태를 수용하고 자신(그룹)의 목표 스위치 역시 off로 전환합니다.

창문 제어 (Window Control)

창문이나 문이 열릴 때 난방을 자동으로 끄거나 결로 방지 온도를 설정하고, 닫힐 때 이전 상태를 복원합니다. 창문이 열려 있는 동안에는 수동 변경이 차단됩니다. 바이너리 센서(binary sensors), input_boolean 헬퍼, 그리고 커버 엔티티(cover entities)를 지원합니다.

Home Assistant용 Climate Group Helper

요약

핵심 포인트