From 15a48105b05e90a7953ca243333deff4be4f1b88 Mon Sep 17 00:00:00 2001 From: Jean-Marc Collin Date: Mon, 10 Feb 2025 17:44:25 +0000 Subject: [PATCH] Add quickstart over_climate --- documentation/en/quick-start.md | 16 ++++++++++++++++ documentation/fr/quick-start.md | 14 ++++++++++++++ 2 files changed, 30 insertions(+) diff --git a/documentation/en/quick-start.md b/documentation/en/quick-start.md index 230d6f1..5b6b16e 100644 --- a/documentation/en/quick-start.md +++ b/documentation/en/quick-start.md @@ -7,6 +7,7 @@ This page outlines the steps to quickly set up a basic yet operational _VTherm_. - [Heatzy, eCosy, or similar (`climate` entity)](#heatzy-ecosy-or-similar-climate-entity) - [Simple switch such as Aqara T1, Nous B2Z, Sonoff ZBMini, Sonoff POW, ...](#simple-switch-such-as-aqara-t1-nous-b2z-sonoff-zbmini-sonoff-pow-) - [Sonoff TRVZB or similar (TRV with valve control)](#sonoff-trvzb-or-similar-trv-with-valve-control) + - [Reversible HP Units, Air Conditioning, or Devices Controlled via a `climate` Entity](#reversible-hp-units-air-conditioning-or-devices-controlled-via-a-climate-entity) - [Next Steps](#next-steps) - [Call for Contributions](#call-for-contributions) @@ -70,6 +71,21 @@ For this to work, the `closing degree` must be set to the maximum (100%). Do not After completing these five steps, you will have a fully functional _VTherm_ that controls your Sonoff TRVZB or similar device. +## Reversible HP Units, Air Conditioning, or Devices Controlled via a `climate` Entity + +Reversible heat pumps (HP) or similar devices are represented in _HA_ as a `climate` entity, allowing you to select the heating preset or mode (Heat / Cool / Off).) + +_VTherm_ will regulate the temperature by controlling the target temperature and mode of the device through commands sent to the underlying `climate` entity. + +To integrate it into _VTherm_, you need to: +1. Create a _VTherm_ of type `over_climate`. See [creating a _VTherm_](creation.md), +2. Assign it the main attributes (name, room temperature sensor, and outdoor temperature sensor at minimum). See [main attributes](base-attributes.md), +3. Define one or more underlying devices to control. The underlying entity here is the `climate` entity that manages the heat pump or air conditioner. See [underlying devices](over-climate.md), + +After these three steps, you will have a fully operational _VTherm_ to control your heat pump, air conditioner, or similar device. + +To go further, self-regulation may be necessary depending on how well your device operates. Self-regulation involves _VTherm_ slightly adjusting the target temperature to encourage the device to heat or cool more or less until the desired setpoint is reached. Self-regulation is explained in detail here: [self-regulation](self-regulation.md). + # Next Steps Once created, you need to configure the preset temperatures. See [presets](feature-presets.md) for a minimal configuration. diff --git a/documentation/fr/quick-start.md b/documentation/fr/quick-start.md index cba2589..7891156 100644 --- a/documentation/fr/quick-start.md +++ b/documentation/fr/quick-start.md @@ -7,6 +7,7 @@ Cette page présente les étapes à suivre pour avoir un _VTherm_ basique mais o - [Heatzy ou eCosy ou assimilé (entité `climate`)](#heatzy-ou-ecosy-ou-assimilé-entité-climate) - [Simple switch comme Aqara T1, Nous B2Z, Sonoff ZBMini, Sonoff POW, ...](#simple-switch-comme-aqara-t1-nous-b2z-sonoff-zbmini-sonoff-pow-) - [Sonoff TRVZB ou assimilé (TRV avec contrôle de la vanne)](#sonoff-trvzb-ou-assimilé-trv-avec-contrôle-de-la-vanne) + - [_PAC_ reversibles ou climatisation ou équipements commandables à travers une entité `climate`](#pac-reversibles-ou-climatisation-ou-équipements-commandables-à-travers-une-entité-climate) - [La suite](#la-suite) - [Appel à contribution](#appel-à-contribution) @@ -71,6 +72,19 @@ Pour que cela fonctionne, il faut que le `closing degree` soit réglé au maximu A l'issue de ces 5 étapes vous avez un _VTherm_ opérationnel ultra simple qui commande votre équipement Sonoff TRVZB ou assimilé. +## _PAC_ reversibles ou climatisation ou équipements commandables à travers une entité `climate` + +Les _PAC_ ou assimilés sont visibles sous _HA_ sous la forme d'une entité `climate` qui permet de choisir le preset de chauffage à appliquer ou le mode (Chauffe / Froid / éteint). + +_VTherm_ va réguler la température en commandant la consigne de l'équipement et son mode à l'aide de commandes envoyée à l'entité `climate` sous-jacente. + +Pour l'intégrer dans _VTherm_ vous devez : +1. Créer un _VTherm_ de type `over_climate`. Cf. [création d'un _VTherm_](creation.md), +2. Lui donner des principaux attributs (nom, capteur de température de la pièce et capteur de température extérieure au minimium). Cf. [principaux attributs](base-attributes.md), +3. Lui donner un ou plusieurs équipements sous-jacents à contrôler. Le sous-jacent est ici l'entité `climate` qui contrôle la _PAC_ ou la clim... . Cf. [sous-jacent](over-climate.md), + +A l'issue de ces 3 étapes vous avez un _VTherm_ opérationnel ultra simple qui commande votre _PAC_, climatisation ou assimilé. Pour aller plus loin, une auto-régulation peut êrte nécessaire en fonction du bon fonctionnement de votre équipement. L'auto-régulation consiste à envoyer des consignes légèrement modifiées par _VTherm_ pour forcer l'équipement à chauffer plus ou moins jusqu'à ce que la consigne soit atteinte. L'auto-régulation est détaillée ici : [auto-régulation](self-regulation.md). + # La suite Uen fois créé, vous devez paramétrer les températures des presets. Cf. [presets](feature-presets.md) pour avoir une configuration minimale.