Preset Temporisé

Preset Temporisé

Objectif

La fonction de preset temporisé permet de forcer un preset sur un VTherm pour une durée déterminée. À la fin de cette durée, le preset original (celui qui était défini dans requested_state) est automatiquement restauré.

Cette fonctionnalité est utile dans plusieurs scénarios :

Boost de chauffage : Augmenter temporairement la température (ex: preset Confort) pendant 30 minutes lorsque vous rentrez chez vous
Mode invité : Activer un preset plus chaud pour quelques heures lorsque vous recevez des invités
Séchage : Forcer un preset haut pendant un temps limité pour accélérer le séchage d'une pièce
Économies ponctuelles : Forcer temporairement un preset Eco pendant une période d'absence courte

Comment ça fonctionne

Vous appelez le service versatile_thermostat.set_timed_preset avec un preset et une durée
Le VTherm bascule immédiatement sur le preset spécifié
Un timer est démarré pour la durée indiquée
À la fin du timer, le VTherm restaure automatiquement le preset original
Un évènement versatile_thermostat_timed_preset_event est émis à chaque changement

Notes

Le preset temporisé a une priorité intermédiaire : il est appliqué après les contrôles de sécurité et de puissance (délestage), mais avant les autres fonctionnalités (présence, mouvement, etc.)

Si vous changez manuellement le preset pendant qu'un preset temporisé est actif, le timer est annulé

La durée maximale est de 1440 minutes (24 heures)

Activer un preset temporisé

Pour activer un preset temporisé, utilisez soit la VTherM UI Card, soit l'action (le service) versatile_thermostat.set_timed_preset :

service: versatile_thermostat.set_timed_preset
data:
  preset: "boost"
  duration_minutes: 30
target:
  entity_id: climate.mon_thermostat

Paramètres :

preset : Le nom du preset à activer. Doit être un preset valide configuré sur le VTherm (ex: eco, comfort, boost, frost, etc.)
duration_minutes : La durée en minutes (entre 1 et 1440)

Annuler un preset temporisé

Pour annuler un preset temporisé avant la fin de sa durée, utilisez soit la VTherM UI Card, soit l'action (le service) versatile_thermostat.cancel_timed_preset :

service: versatile_thermostat.cancel_timed_preset
target:
  entity_id: climate.mon_thermostat

Lorsque vous annulez un preset temporisé, le preset original est immédiatement restauré.

Attributs personnalisés

Lorsqu'un preset temporisé est actif, les attributs suivants sont disponibles dans la section timed_preset_manager des attributs du VTherm :

Attribut	Signification
`is_active`	`true` si un preset temporisé est actif, `false` sinon
`preset`	Le nom du preset temporisé actif (ou `null` si aucun)
`original_preset`	Le preset restauré à la fin du preset temporisé (ou `null` si aucun)
`end_time`	La date/heure de fin du preset temporisé (format ISO, ou `null` si aucun)
`remaining_time_min`	Le temps restant en minutes avant la fin du preset temporisé (entier)
`is_manual_override`	`true` si le preset temporisé actif est une dérogation manuelle (voir ci-dessous)
`resume_preset`	Le preset temporisé interrompu par la dérogation manuelle, repris à sa fin (ou `null`)
`resume_end_time`	La date/heure de fin du preset temporisé interrompu (format ISO, ou `null`)

Exemple d'attributs :

timed_preset_manager:
  is_active: true
  preset: "boost"
  original_preset: "comfort"
  end_time: "2024-01-15T14:30:00+00:00"
  remaining_time_min: 25
  is_manual_override: false
  resume_preset: null
  resume_end_time: null

Évènements

L'évènement versatile_thermostat_timed_preset_event est émis lors des changements de preset temporisé.

Données de l'évènement :

entity_id : L'identifiant du VTherm
name : Le nom du VTherm
state_attributes : Les attributs d'état du VTherm au moment de l'évènement
type : start lorsqu'un preset temporisé (ou une dérogation manuelle) démarre, end lorsqu'il se termine
preset : Le preset temporisé concerné (celui qui démarre ou celui qui vient de se terminer)

Données supplémentaires d'un évènement start :

duration_minutes : La durée du preset temporisé en minutes
end_time : La date/heure de fin du preset temporisé (format ISO)
original_preset : Le preset qui sera restauré à la fin
manual_override : true si l'évènement concerne une dérogation manuelle

Données supplémentaires d'un évènement end :

cause : La raison de la fin du preset temporisé : expired (la durée est écoulée), cancelled (le service cancel_timed_preset a été appelé) ou preset_selected (un preset a été sélectionné manuellement)
restored_preset : Le preset restauré après la fin (peut être null lorsqu'un preset a été sélectionné manuellement)
manual_override : true si l'évènement concerne une dérogation manuelle

Dérogation manuelle avec retour automatique

Lorsque vous changez manuellement la température cible, VTherm passe normalement sur le preset none et y reste jusqu'à ce que vous sélectionniez à nouveau un preset. Si une durée de dérogation manuelle est configurée, VTherm revient automatiquement en arrière après cette durée.

La durée se règle dans la configuration avancée (manual_override_duration_min, en minutes). Elle peut être définie dans la configuration centrale et surchargée par VTherm. Voir configuration avancée. La valeur par défaut 0 désactive la fonction et le comportement reste alors inchangé.

Fonctionnement :

Un changement manuel de la température cible (depuis l'interface, depuis une automatisation qui appelle climate.set_temperature, ou depuis l'équipement sous-jacent quand Follow underlying temperature change est activé) démarre une dérogation manuelle. La température manuelle s'applique immédiatement.
Un nouveau changement manuel pendant la dérogation relance le minuteur avec la durée complète.
À l'expiration du minuteur, le preset actif avant le changement manuel est restauré.
Si un preset temporisé était actif au moment du changement manuel, il reprend à la fin de la dérogation, jusqu'à sa propre heure de fin. Si cette heure est déjà passée, le preset actif avant le preset temporisé est restauré.
Si aucun preset n'était actif (none) avant le changement manuel, aucune dérogation ne démarre.

La dérogation manuelle réutilise le mécanisme des presets temporisés : elle apparaît comme un preset temporisé none et survit à un redémarrage de Home Assistant.

Notes

Sélectionner un preset pendant la dérogation manuelle l'annule : le preset sélectionné s'applique et rien n'est restauré plus tard.

Activer un preset temporisé pendant la dérogation manuelle la remplace.

Annuler le preset temporisé pendant la dérogation manuelle restaure le preset actif avant le changement manuel.

La fenêtre, la sécurité, le délestage et le mode central gardent leur priorité pendant la dérogation manuelle.

Les attributs is_manual_override, resume_preset et resume_end_time de timed_preset_manager sont décrits dans le tableau des Attributs personnalisés. Le champ manual_override de l'évènement versatile_thermostat_timed_preset_event vaut true lorsque l'évènement concerne une dérogation manuelle.

Exemples d'automatisation

Boost de 30 minutes à la rentrée

automation:
  - alias: "Boost chauffage à la rentrée"
    trigger:
      - platform: state
        entity_id: binary_sensor.presence_maison
        to: "on"
    condition:
      - condition: numeric_state
        entity_id: climate.salon
        attribute: current_temperature
        below: 19
    action:
      - service: versatile_thermostat.set_timed_preset
        data:
          preset: "boost"
          duration_minutes: 30
        target:
          entity_id: climate.salon

Notification à la fin du boost

automation:
  - alias: "Notification fin de boost"
    trigger:
      - platform: event
        event_type: versatile_thermostat_timed_preset_event
    condition:
      - condition: template
        value_template: "{{ trigger.event.data.type == 'end' }}"
    action:
      - service: notify.mobile_app
        data:
          title: "Thermostat"
          message: "Le boost de {{ trigger.event.data.name }} est terminé"

Bouton de boost sur le dashboard

Créez un bouton avec une carte de type button :

type: button
tap_action:
  action: call-service
  service: versatile_thermostat.set_timed_preset
  data:
    preset: boost
    duration_minutes: 30
  target:
    entity_id: climate.salon
name: Boost 30 min
icon: mdi:fire