Dans ma commune, les déchets sont ramassés deux jours par semaine :

• le mercredi matin, ce sont les déchets non recyclables (poubelle bleue)
• le jeudi matin, il s’agit des déchets recyclacles (poubelle jaune)

Voilà, le petit script afin d’automatiser une notification sur mes enceintes Alexa la veille au soir.

Prérequis

Pour cet article simple, il faudra tout de même avoir les notifications sur les enceintes Alexa d’activer, si ce n’est pas le cas, tu peux te rendre sur Donner de la voix à Home Assistant avec Alexa.

Création des sensors

Une fois que tu arrives à faire parler tes enceintes, nous allons créer 2 sensors, nous pourrions faire autrement mais je trouve cette manière plus esthétique et cela permet d’appréhender les capteurs binaires avec la plateforme workday. La documentation sur Workday est disponible sur le wiki de HA.

Tout d’abord, dans le fichier configuration.yaml, j’ai ajouté cette ligne :

binary_sensor: !include binary_sensors.yaml

Le fichier binary_sensors.yaml contient l’ensemble de mes capteurs de ce type.

Nous allons créer nos deux capteurs :

• le premier pour la veille du ramassage des poubelles bleues
• le second pour la veille du ramassage des poubelles jaunes

Mon fichier contient donc cela :

# sensor pour le jour de ramassage de poubelle bleu
- platform: workday
  country: FR
  name: jour_poubelle_bleu
  workdays: [tue]

# sensor pour le jour de ramassage de poubelle jaune
- platform: workday
  country: FR
  name: jour_poubelle_jaune
  workdays: [wed]

Rien de très compliqué, il est à noter que country est obligatoire. La liste workdays contient les jours pour lesquels nous voulons que notre sensor soit à on.

Avec ce type de sensor, nous pourrions exclure des jours, des périodes (par exemple de vacances) ou des évenements déjà définis (Noël …) dans mon cas, je ne les utilise pas.

S’en est fini pour les sensors, prochaine étape, l’automatisation.

Automatisation des notifications

Maintenant, nous allons simplement créer 2 automations, une pour le mardi soir et une autre pour le mercredi soir.

# Ramassage des poubelles
- alias: rammassage_poubelle
  trigger:
    - platform: time
      at: '20:00:00'
  condition: 
    - condition: or
      conditions:
      - condition: and
        conditions:
          - condition: state
            entity_id: binary_sensor.jour_poubelle_bleu
            state: "on"
          - condition: state
            entity_id: input_boolean.vacances
            state: "off"
      - condition: and
        conditions:
          - condition: state
            entity_id: binary_sensor.jour_poubelle_jaune
            state: "on"
          - condition: state
            entity_id: input_boolean.vacances
            state: "off"
  action:
    - service: notify.alexa_media_dot_parent
      data_template:
        data:
          type: tts
        message: >-
          {% if states.binary_sensor.jour_poubelle_bleu.state == "on" %}
            "Pense à sortir la poubelle bleu"
          {% elif states.binary_sensor.jour_poubelle_jaune.state == "on" %}
            "Pense à sortir la poubelle jaune"
          {% endif %}

Il n’y a rien de compliqué, le déclencheur est l’heure (à 20h00) et il y a une des conditions imbriquées, en effet pas besoin que la notification soit émise, si personne est présent. Il y a bien moins lourd à faire sur les conditions, je reviendrai dessus plus tard.

Conclusion

Dorénavant, je n’aurai plus d’excuses pour avoir oublié de sortir les poubelles.

L’article Home assistant, automatiser une action des jours précis est apparu en premier sur La programmation sur le web.

La première question à laquelle je vais répondre est : « Pourquoi créer son Blueprint ? »

La réponse est des plus simple, j’ai fait un exemple pour allumer une lampe après la détection d’un mouvement entre deux heures, j’imagine qu’il n’y a pas qu’une lampe chez toi, le blueprint va te permettre de mettre tes automatisation en place plus rapidement, que ce soit pour des lampes, des capteurs, des interrupteurs …

Pour cet article, je vais reprendre l’exemple de l’automatisation créée précédemment :

- id: Light-with-mvt 
  alias: Lumière avec mouvement 
  trigger:
  - platform: state
    entity_id: binary_sensor.lumi_lumi_sensor_motion_81807f04_ias_zone
    from: 'off'
    to: 'on'
  condition:
  - condition: time
    after: "19:00:00"
    before: "07:00:00"
  action:
  - service: light.turn_on
    target:
      entity_id: light.lumi_lumi_light_aqcn02_c4865d04_level_light_color_on_off
    data:
      color_temp: 200
      brightness_pct: 25
  - wait_for_trigger:
      platform: state
      entity_id: binary_sensor.lumi_lumi_sensor_motion_81807f04_ias_zone
      from: "on"
      to: "off"
  - delay:
      seconds: 60
  - service: light.turn_off
    target:
      entity_id: light.lumi_lumi_light_aqcn02_c4865d04_level_light_color_on_off
  mode: restart
  max_exceeded: silent

Je ne vais pas revenir dessus, tu peux retrouver les informations sur cette page. D’ailleurs, je te conseille d’aller jeter un petit coup d’oeil, je me concentrerai seulement sur la partie de blueprint.

Explication

Je commence par fournir le blueprint, que je viendrai expliquer :

blueprint:
  name: Lumière activée par le mouvement entre 2 heures
  description: Allume la lumière quand un mouvement est détecté entre deux heures.
  domain: automation
  input:
    motion_entity:
      name: Capteur de mouvement
      selector:
        entity:
          domain: binary_sensor
          device_class: motion
    light_target:
      name: Light
      selector:
        target:
          entity:
            domain: light
    no_motion_wait:
      name: "Temps d'attente"
      description: Temps après le dernier mouvement pour éteindre la lumière.
      default: 120
      selector:
        number:
          min: 0
          max: 3600
          unit_of_measurement: seconds
	time_after:
	  name: "Heure du début"
	  description: "Heure à laquelle commence l'allumage de la lumière"
	  selector:
	    time:
	time_before:
	  name: "Heure de fin"
	  description: "Heure à laquelle se termine le déclenchement l'allumage de la lumière"
	  selector:
	    time:

mode: restart
max_exceeded: silent

trigger:
  platform: state
  entity_id: !input motion_entity
  from: "off"
  to: "on"

condition:
  - condition: time
  after: !input time_after
  before: !input time_before

action:
  - service: light.turn_on
    target: !input light_target
  - wait_for_trigger:
      platform: state
      entity_id: !input motion_entity
      from: "on"
      to: "off"
  - delay: !input no_motion_wait
  - service: light.turn_off
    target: !input light_target

Le fichier doit commencer par blueprint, afin de clairement faire comprendre à Home Assistant ce qu’il est. Ensuite, on lui donne un nom (name), une description (description) et un domaine (domain) :

blueprint:
  name: Lumière activée par le mouvement entre 2 heures
  description: Allume la lumière quand un mouvement est détecté entre deux heures.
  domain: automation

Dans la seconde partie, tu devras indiquer les entrées. Les entrées sont ce que tu devras saisir pour la mise en place de ton automatisation (capteur, zone, équipement, heure…). Pour chaque entrée, il faudra lui donner un nom (qui sera utilisé pour récupérer l’entrée), un sélecteur (selector) qui permet de définir ce qui sera affiché sur la création de l’automatisation pour cette entrée et les options de ce selector. Dans cette partie, nous ne renseignons pas les entités ou groupes :

input:
    motion_entity:
      name: Capteur de mouvement
      selector:
        entity:
          domain: binary_sensor
          device_class: motion
    light_target:
      name: Light
      selector:
        target:
          entity:
            domain: light
    no_motion_wait:
      name: "Temps d'attente"
      description: Temps après le dernier mouvement pour éteindre la lumière.
      default: 120
      selector:
        number:
          min: 0
          max: 3600
          unit_of_measurement: seconds
	time_after:
	  name: "Heure du début"
	  description: "Heure à laquelle commence l'allumage de la lumière"
	  selector:
	    time:

Dans la seconde partie du code, nous retrouvons nos déclencheurs, nos actions et nos conditions, les informations qui sont habituellement saisie sont remplacées par une phrase de ce type : !input no_wait_motion. Cela permet de signifier que cette entité sera l’entrée avec se nom (dans notre cas no_wait_motion).

Conclusion

La création d’un blueprint n’est pas plus compliqué que la création d’une automatisation, elle est à privilégier surtout si l’on sait que plusieurs automatisations y feront référence.

L’article Home Assistant, création d’un Blueprint est apparu en premier sur La programmation sur le web.

Les Blueprints ne nécessitent pas d’avoir un grand niveau de maîtrise mais sont limitées à ce qui a été prévu dans le modèle, pour un ajout ou une modification, il faut aller modifier le modèle quitte à bousculer toutes les automatisations qui les utilisent.

Organisation des automatisations

Les automatisations se situe dans le dossier config de votre système, il écrit dans des fichiers YAML.

Pour avoir accès à tes dossiers HA sous Windows, je t’invite à suivre les étapes de cette page (si ce n’est pas déjà fait)

Je ne vais pas détailler tous les dossiers et fichiers présents, ceux qui nous intéressent sont :

• configuration.yaml
• automations.yaml

Le premier contient la configuration de ton HA :

Dans ce fichier, vous allez pouvoir y mettre vos automatisations, cependant, cela peut rapidement devenir incompréhensible. Pour cette raison, tu peux inclure des fichiers (ligne 15 à 18). Ces inclusions vont te permettre de mettre un peut d’ordre à tes dossiers et t’y retrouver rapidement.

De base, un fichier automations.yaml vide est créé et inclus dans le système.

C’est dans ce fichier que nous allons venir intégrer nos automatisations.

Ma première automatisation par l’exemple

Pour montrer comment doit être construit une automatisation, on va prendre un exemple : allumer une lumière à la présence d’un mouvement entre 19 heures et 7 heures. La lumière s’éteint dès qu’il n’y a plus de mouvement.

Les prérequis

Pour suivre cet article, vous allez avoir besoin :

• Home Assistant installé sur une machine (type Raspberry)
• Une ampoule, la mienne est de la gamme Aqara et permet de régler la chaleur et l’intensité lumineuse, ici.
• Un détecteur de mouvement Xiaomi, ici.

Que ce soit pour le capteur ou la lampe, j’utilise le protocole de communication Zigbee, pour le Raspberry, j’utilise la passerelle Zigate, disposnible sur ce lien.

Le code et les explications

J’ai pris un exemple facilement utilisable et transposable, nombreux sont les kits disposant d’un capteur et d’une lampe, de plus ce genre d’automatisation est l’une des plus fréquentes (éclairage porte d’entrée, toilettes …)

- id: Light-with-mvt 
  alias: Lumière avec mouvement 
  trigger:
  - platform: state
    entity_id: binary_sensor.lumi_lumi_sensor_motion_81807f04_ias_zone
    from: 'off'
    to: 'on'
  condition:
  - condition: time
    after: "19:00:00"
    before: "07:00:00"
  action:
  - service: light.turn_on
    target:
      entity_id: light.lumi_lumi_light_aqcn02_c4865d04_level_light_color_on_off
    data:
      color_temp: 200
      brightness_pct: 25
  - wait_for_trigger:
      platform: state
      entity_id: binary_sensor.lumi_lumi_sensor_motion_81807f04_ias_zone
      from: "on"
      to: "off"
  - delay:
      seconds: 60
  - service: light.turn_off
    target:
      entity_id: light.lumi_lumi_light_aqcn02_c4865d04_level_light_color_on_off
  mode: restart
  max_exceeded: silent

Tout d’abord, vous devez choisir un id unique pour chacune de vos automatisations du fichier automations.yaml. Cet ID est automatiquement générer lorsque tu passes par le générateur de code automatique.

L’alias sera utilisé dans l’affichage de toutes tes automatisations dans la liste disponible Configurations/Automations.

Le trigger (ou les triggers) permet le déclenchement de l’automatisation. Dans notre cas, le capteur de mouvement détecte une occupation dans la zone (changement d’état):

  trigger:
  - platform: state
    entity_id: binary_sensor.lumi_lumi_sensor_motion_81807f04_ias_zone
    from: 'off'
    to: 'on'

La condition (ou les conditions) identifie les circonstances pour lesquelles le trigger est pris en compte. J’ai mis une condition de temps (après 19h00 et avant 07h00), en dehors de cette plage horaire, le mouvement est bien détecté mais ne lance pas l’automatisation :

  condition:
  - condition: time
    after: "19:00:00"
    before: "07:00:00"

Dernier point, les actions, quant à elles, décrivent ce qui va se passer. Pour notre exemple, au déclenchement, la lumière s’allume, on attend un trigger pendant 60 secondes (en l’occurance, un changement d’état sur le capteur de mouvement) et on éteint la lumière si il n’y a pas de mouvement.

  action:
  - service: light.turn_on
    target:
      entity_id: light.lumi_lumi_light_aqcn02_c4865d04_level_light_color_on_off
    data:
      color_temp: 200
      brightness_pct: 25
  - wait_for_trigger:
      platform: state
      entity_id: binary_sensor.lumi_lumi_sensor_motion_81807f04_ias_zone
      from: "on"
      to: "off"
  - delay:
      seconds: 60
  - service: light.turn_off
    target:
      entity_id: light.lumi_lumi_light_aqcn02_c4865d04_level_light_color_on_off

On finit par les deux dernières lignes qui permettent de gérer le mode de re-déclenchement, à partir d’un nouveau trigger et si les conditions sont respectées, les actions redébutent, sans nombre de fois limites :

  mode: restart
  max_exceeded: silent

Fait attention à l’indentation, elle est la principale cause d’erreur dans la non-exécution de ton automatisation

Conclusion

Voilà une petite automatisation qui fait partie (à mon avis) de la base de ce que tout débutant souhaite faire. Je m’en servirai pour d’autres exemples, améliorations.

L’article Home Assistant, comprendre les automatisations manuelles est apparu en premier sur La programmation sur le web.