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)
`end_time`	La date/heure de fin du preset temporisé (format ISO)
`remaining_time_min`	Le temps restant en minutes avant la fin du preset temporisé (entier)

Exemple d'attributs :

timed_preset_manager:
  is_active: true
  preset: "boost"
  end_time: "2024-01-15T14:30:00+00:00"
  remaining_time_min: 25

É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
timed_preset_active : true si un preset temporisé vient d'être activé, false s'il vient d'être désactivé
timed_preset_preset : Le nom du preset temporisé
old_preset : Le preset précédent (avant l'activation du preset temporisé)
new_preset : Le nouveau preset actif

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.timed_preset_active == false }}"
    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