diff --git a/README-fr.md b/README-fr.md index 6826a32..ca6c17d 100644 --- a/README-fr.md +++ b/README-fr.md @@ -39,6 +39,7 @@ - [Le contrôle d'une chaudière centrale](#le-contrôle-dune-chaudière-centrale) - [Configuration](#configuration-1) - [Comment trouver le bon service ?](#comment-trouver-le-bon-service-) + - [Les évènements](#les-évènements) - [Avertissement](#avertissement) - [Synthèse des paramètres](#synthèse-des-paramètres) - [Exemples de réglage](#exemples-de-réglage) @@ -608,6 +609,43 @@ Le service à configurer est alors le suivant: `climate.empty_thermostast/climat Faite alors de même pour le service d'extinction et vous êtes parés. +### Les évènements + +A chaque allumage ou extinction réussie de la chaudière un évènement est envoyé par Versatile Thermostat. Il peut avantageusement être capté par une automatisation, par exemple pour notifier un changement. +Les évènements ressemblent à ça : + +Un évènement d'allumage : +``` +event_type: versatile_thermostat_central_boiler_event +data: + central_boiler: true + entity_id: binary_sensor.central_boiler + name: Central boiler + state_attributes: null +origin: LOCAL +time_fired: "2024-01-14T11:33:52.342026+00:00" +context: + id: 01HM3VZRJP3WYYWPNSDAFARW1T + parent_id: null + user_id: null +``` + +Un évènement d'extinction : +``` +event_type: versatile_thermostat_central_boiler_event +data: + central_boiler: false + entity_id: binary_sensor.central_boiler + name: Central boiler + state_attributes: null +origin: LOCAL +time_fired: "2024-01-14T11:43:52.342026+00:00" +context: + id: 01HM3VZRJP3WYYWPNSDAFBRW1T + parent_id: null + user_id: null +``` + ### Avertissement > ![Astuce](https://github.com/jmcollin78/versatile_thermostat/blob/main/images/tips.png?raw=true) _*Notes*_ @@ -881,6 +919,7 @@ Les évènements notifiés sont les suivants: - ``versatile_thermostat_temperature_event`` : une ou les deux mesures de température d'un thermostat n'ont pas été mis à jour depuis plus de `security_delay_min`` minutes - ``versatile_thermostat_hvac_mode_event`` : le thermostat est allumé ou éteint. Cet évènement est aussi diffusé au démarrage du thermostat - ``versatile_thermostat_preset_event`` : un nouveau preset est sélectionné sur le thermostat. Cet évènement est aussi diffusé au démarrage du thermostat +- ``versatile_thermostat_central_boiler_event`` : un évènement indiquant un changement dans l'état de la chaudière. Si vous avez bien suivi, lorsqu'un thermostat passe en mode sécurité, 3 évènements sont déclenchés : 1. ``versatile_thermostat_temperature_event`` pour indiquer qu'un thermomètre ne répond plus, diff --git a/README.md b/README.md index 2d4f26c..b57c53f 100644 --- a/README.md +++ b/README.md @@ -39,6 +39,7 @@ - [Control of a central boiler](#control-of-a-central-boiler) - [Setup](#setup) - [How to find the right service?](#how-to-find-the-right-service) + - [The events](#the-events) - [Warning](#warning) - [Parameters synthesis](#parameters-synthesis) - [Examples tuning](#examples-tuning) @@ -594,6 +595,43 @@ The service to configure is then the following: `climate.empty_thermostast/clima Then do the same for the extinguishing service and you are all set. +### The events + +Each time the boiler is successfully switched on or off, an event is sent by Versatile Thermostat. It can advantageously be captured by automation, for example to notify a change. +The events look like this: + +An ignition event: +``` +event_type: versatile_thermostat_central_boiler_event +data: + central_boiler: true + entity_id: binary_sensor.central_boiler + name: Central boiler + state_attributes: null +origin: LOCAL +time_fired: "2024-01-14T11:33:52.342026+00:00" +context: + id: 01HM3VZRJP3WYYWPNSDAFARW1T + parent_id: null + user_id: null +``` + +An extinction event: +``` +event_type: versatile_thermostat_central_boiler_event +data: + central_boiler: false + entity_id: binary_sensor.central_boiler + name: Central boiler + state_attributes: null +origin: LOCAL +time_fired: "2024-01-14T11:43:52.342026+00:00" +context: + id: 01HM3VZRJP3WYYWPNSDAFBRW1T + parent_id: null + user_id: null +``` + ### Warning > ![Tip](https://github.com/jmcollin78/versatile_thermostat/blob/main/images/tips.png?raw=true) _*Notes*_ @@ -867,6 +905,7 @@ The notified events are as follows: - ``versatile_thermostat_temperature_event``: one or both temperature measurements of a thermostat have not been updated for more than ``security_delay_min`` minutes - ``versatile_thermostat_hvac_mode_event``: the thermostat is on or off. This event is also broadcast when the thermostat starts up - ``versatile_thermostat_preset_event``: a new preset is selected on the thermostat. This event is also broadcast when the thermostat starts up +- ``versatile_thermostat_central_boiler_event``: an event indicating a change in the state of the central boiler. If you have followed correctly, when a thermostat goes into safety mode, 3 events are triggered: 1. ``versatile_thermostat_temperature_event`` to indicate that a thermometer has become unresponsive,