Add events in README

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,

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,