Réveil – intégration Home Assistant

Planificateur de réveil basé sur des événements. L'intégration calcule quand le réveil doit sonner et l'annonce ; ce qui se passe ensuite (lumières, musique, volets…) est décidé par vos automatisations ou par le blueprint fourni. Elle est pensée pour cohabiter avec l'alarme de l'iPhone, qui reste active.

Prérequis : Home Assistant 2024.12 ou plus récent.

Installation

Copier custom_components/reveil/ dans <config>/custom_components/.
Copier blueprints/automation/reveil/wake_up.yaml dans <config>/blueprints/automation/reveil/.
Redémarrer Home Assistant.
Paramètres → Appareils et services → Ajouter une intégration → Réveil. Répéter autant de fois que de réveils souhaités (un appareil par réveil).

Ce qui est créé pour chaque réveil

Entité	Rôle
`switch` Activé	interrupteur global
7 × `switch` Actif le …	jours où le réveil sonne (par défaut : lundi à vendredi)
`time` Heure par défaut	heure utilisée les jours sans surcharge
7 × `time` Heure du …	surcharge par jour ; vide = heure par défaut
`sensor` Prochain réveil	horodatage du prochain déclenchement
`sensor` Début de la phase progressive	horodatage du prochain `reveil_pre_ring`
`sensor` Dernier réveil confirmé	horodatage du dernier `reveil_dismissed`
`binary_sensor` Sonne aujourd'hui	actif si le réveil est activé aujourd'hui et pas encore confirmé
`button` Je suis réveillé	équivalent du service `reveil.dismiss`

La durée de la phase progressive se règle dans Configurer sur l'intégration (0 = pas de phase progressive).

Événements

Événement	Quand
`reveil_pre_ring`	X minutes avant l'heure (X = phase progressive)
`reveil_ring`	à l'heure du réveil
`reveil_dismissed`	à l'appel de `reveil.dismiss` (ou du bouton)

Données communes : alarm_id, device_id, name. reveil_pre_ring et reveil_ring ajoutent ring_at, alarm_time, weekday, lead_minutes ; reveil_pre_ring ajoute aussi remaining_seconds. reveil_dismissed fournit ring_at, dismissed_at et delay_seconds (temps écoulé entre la sonnerie et la confirmation, null si aucune sonnerie récente).

Si vous modifiez l'heure alors que vous êtes déjà dans la fenêtre de progression, reveil_pre_ring est émis immédiatement avec un remaining_seconds réduit. Au démarrage de Home Assistant, aucun reveil_pre_ring de rattrapage n'est émis.

Exemple d'automatisation sans blueprint

triggers:
  - trigger: event
    event_type: reveil_ring
    event_data:
      name: Réveil semaine
actions:
  - action: media_player.play_media
    target:
      entity_id: media_player.chambre
    data:
      media_content_id: media-source://media_source/local/reveil.mp3
      media_content_type: music

Services

Chaque service se cible par appareil ou par entité du réveil (n'importe laquelle : switch.reveil_semaine_actif_le_lundi convient).

Service	Données	Effet
`reveil.set_time`	`time` seul	change l'heure par défaut
	`day` + `time`	surcharge l'heure d'un jour
	`day` seul	efface la surcharge de ce jour
`reveil.set_days`	`days` (liste)	active exactement ces jours
`reveil.dismiss`	–	émet `reveil_dismissed`

day prend les valeurs monday … sunday.

Depuis l'app Raccourcis (iPhone)

Avec l'action « Appeler le service » de l'app Home Assistant :

Service : reveil.set_time
Données : {"entity_id": "switch.reveil_semaine_actif_le_lundi", "day": "monday", "time": "06:30:00"}

Les surcharges par jour ne peuvent pas être effacées depuis l'interface (un sélecteur d'heure n'a pas de valeur « vide ») : utilisez reveil.set_time avec day seul.

Blueprint

Paramètres → Automatisations → Blueprints → « Réveil – lumière progressive et actions de sonnerie ». Vous choisissez le réveil, les lumières, les luminosités de départ et d'arrivée, une action libre à la sonnerie, et éventuellement une entité de présence. La montée de lumière utilise transition = remaining_seconds, donc elle se termine à l'heure du réveil.

Carte Lovelace (sans JavaScript)

À coller dans une vue en mode YAML. Les identifiants d'entités sont donnés pour un réveil nommé « Réveil semaine » en français ; adaptez-les à vos entités réelles (Paramètres → Entités).

type: vertical-stack
cards:
  - type: tile
    entity: sensor.reveil_semaine_prochain_reveil
    name: Prochain réveil
  - type: grid
    columns: 7
    square: false
    cards:
      - type: tile
        entity: switch.reveil_semaine_actif_le_lundi
        name: Lun
        vertical: true
        hide_state: true
        tap_action:
          action: toggle
      - type: tile
        entity: switch.reveil_semaine_actif_le_mardi
        name: Mar
        vertical: true
        hide_state: true
        tap_action:
          action: toggle
      - type: tile
        entity: switch.reveil_semaine_actif_le_mercredi
        name: Mer
        vertical: true
        hide_state: true
        tap_action:
          action: toggle
      - type: tile
        entity: switch.reveil_semaine_actif_le_jeudi
        name: Jeu
        vertical: true
        hide_state: true
        tap_action:
          action: toggle
      - type: tile
        entity: switch.reveil_semaine_actif_le_vendredi
        name: Ven
        vertical: true
        hide_state: true
        tap_action:
          action: toggle
      - type: tile
        entity: switch.reveil_semaine_actif_le_samedi
        name: Sam
        vertical: true
        hide_state: true
        tap_action:
          action: toggle
      - type: tile
        entity: switch.reveil_semaine_actif_le_dimanche
        name: Dim
        vertical: true
        hide_state: true
        tap_action:
          action: toggle
  - type: entities
    entities:
      - switch.reveil_semaine_active
      - time.reveil_semaine_heure_par_defaut
      - time.reveil_semaine_heure_du_lundi
      - time.reveil_semaine_heure_du_mardi
      - time.reveil_semaine_heure_du_mercredi
      - time.reveil_semaine_heure_du_jeudi
      - time.reveil_semaine_heure_du_vendredi
      - time.reveil_semaine_heure_du_samedi
      - time.reveil_semaine_heure_du_dimanche
      - binary_sensor.reveil_semaine_sonne_aujourd_hui
  - type: button
    entity: button.reveil_semaine_je_suis_reveille
    name: Je suis réveillé
    show_state: false
    tap_action:
      action: toggle

Migration depuis les helpers manuels

Avant	Maintenant
7 × `input_boolean` (jours)	7 × `switch` Actif le …
`input_datetime` heure du réveil	`time` Heure par défaut (+ surcharges par jour)
`input_datetime` heure de réveil effectif	événement `reveil_dismissed` (`dismissed_at`) et capteur Dernier réveil confirmé
capteur binaire « sonne aujourd'hui »	`binary_sensor` Sonne aujourd'hui

Tests

La logique de calcul du prochain réveil (schedule.py) n'a aucune dépendance à Home Assistant et est testée par python tests/test_schedule.py.

7.1 KiB Raw Blame History Unescape Escape