
Este artículo puede contener enlaces de afiliado. Si compras desde estos enlaces, el precio para ti es el mismo y la tienda me paga una pequeña comisión que ayuda a mantener Tecnoyfoto.
← Capítulo 11 · Índice del curso
Has llegado al último capítulo con piezas que ya conoces: estructuras YAML, entidades, disparadores, condiciones, secuencias, choose, scripts, modos de ejecución, plantillas, variables e inclusiones. El proyecto final no añadirá una función espectacular para obligarte a aprender otro tema. Te pedirá algo más importante: combinar lo aprendido y justificar cada decisión.
Una solución no estará terminada solamente porque encienda una luz. Debe ser legible, comportarse bien cuando varias cosas suceden con poca diferencia, tratar los datos no disponibles y dejar pruebas que otra persona pueda repetir.
Primero construiremos el proyecto. Después compararemos sus decisiones con una solución de referencia. Intenta no abrir los archivos de solución hasta haber escrito al menos tu diseño en lenguaje normal.
El encargo de la casa
Utilizaremos las entidades virtuales instaladas al principio del curso. La casa debe responder a entrada, presencia, movimiento y temperatura.
Entrada por la puerta principal
Cuando se abra la puerta:
- Si es de noche y hay alguien en casa, se ejecutará una bienvenida reutilizable: encender la luz del salón y crear un mensaje de bienvenida.
- Si es de noche y no hay nadie en casa, no se encenderá la luz y se creará un aviso de entrada con la casa vacía.
- Si es de día, la automatización no hará nada.
Cuando la puerta se cierre y no haya nadie en casa, se registrará un aviso de que ha quedado cerrada. Esta rama no es un sistema de seguridad; solo demuestra que una misma automatización puede distinguir apertura y cierre.
Luz por movimiento
De noche, el movimiento del pasillo encenderá la luz. La luz permanecerá encendida mientras haya movimiento y se apagará treinta segundos después de que termine.
Si vuelve a detectarse movimiento mientras la secuencia anterior espera, el temporizador debe empezar de nuevo. No queremos dos cuentas atrás independientes compitiendo.
Ventilador por temperatura
Cuando cambie la temperatura del salón:
- A partir de 25 °C, encender el ventilador.
- Por debajo de 25 °C, apagarlo.
- Si el estado no es utilizable, no cambiar el ventilador y crear un aviso.
La temperatura debe leerse una sola vez por ejecución y guardarse antes de decidir.
Antes de escribir YAML, elimina ambigüedades
Los requisitos domésticos casi siempre esconden decisiones. Aquí hay varias:
¿Qué significa «de noche»? En el laboratorio existe binary_sensor.course_night, controlado manualmente. En una instalación real podríamos utilizar el sol, una franja horaria o un ayudante. Para este proyecto usaremos la entidad del laboratorio y no mezclaremos criterios.
¿Qué significa «hay alguien»? Usaremos binary_sensor.course_someone_home. No intentaremos deducir presencia a partir del movimiento ni de la puerta.
¿Qué ocurre si la puerta se abre y el movimiento se activa casi a la vez? Las dos secuencias pueden encender la misma luz. Encender algo que ya está encendido es una operación segura. La automatización de movimiento será la encargada habitual del apagado. El script de bienvenida añadirá un apagado de seguridad a los cinco minutos, pero solo si en ese momento el sensor lleva al menos treinta segundos sin detectar movimiento.
Esa última regla no estaba completamente especificada. La hemos hecho explícita para evitar que una bienvenida sin movimiento deje la luz encendida indefinidamente y, al mismo tiempo, no interrumpir el margen de treinta segundos de la automatización de movimiento. Otra solución válida sería crear un ayudante que representara la razón por la que la luz debe seguir encendida. Sería más precisa, pero añadiría complejidad que no necesitamos en este curso.
Convierte requisitos en una tabla de decisiones
Antes del código, escribe caminos verificables:
| Evento | Noche | Presencia | Resultado |
|---|---|---|---|
| Puerta pasa a abierta | Sí | Sí | Ejecutar bienvenida |
| Puerta pasa a abierta | Sí | No | Aviso de entrada |
| Puerta pasa a abierta | No | Cualquiera | No hacer nada |
| Puerta pasa a cerrada | Cualquiera | No | Aviso de cierre |
| Movimiento empieza | Sí | Cualquiera | Encender, esperar fin y 30 s, apagar |
| Movimiento empieza | No | Cualquiera | No hacer nada |
| Temperatura cambia | — | — | Decidir solo si el valor es válido |
La tabla descubre huecos antes de que queden ocultos entre indentaciones. También se convertirá en nuestro plan de pruebas.
Divide el proyecto por responsabilidades
Podríamos escribir una sola automatización enorme con todos los disparadores. Sería posible, pero cada comportamiento tiene un ciclo de ejecución distinto:
- Entrada reacciona a dos estados de la puerta y elige una rama.
- Movimiento espera y necesita reiniciarse cuando aparece nueva actividad.
- Temperatura reacciona a un dato y toma una decisión segura.
Crearemos tres automatizaciones y un script:
scripts.yaml
└── course_welcome_home
automations/manual/final-project.yaml
├── course_final_entry
├── course_final_motion_light
└── course_final_temperature
Esta separación no responde a una regla de «un archivo por automatización». Agrupamos las tres porque forman una entrega pequeña y común, pero cada una conserva un id, un alias y un modo propios.
Paso 1: el script de bienvenida
La bienvenida es una secuencia con nombre que podría llamarse desde otra automatización o desde el panel:
course_welcome_home:
alias: "Curso YAML - Dar la bienvenida"
sequence:
- action: light.turn_on
target:
entity_id: light.course_living_room
- action: persistent_notification.create
data:
title: "Curso YAML - Bienvenida"
message: "La puerta se ha abierto y hay alguien en casa."
- delay:
minutes: 5
- condition: state
entity_id: binary_sensor.course_hallway_motion
state: "off"
for:
seconds: 30
- action: light.turn_off
target:
entity_id: light.course_living_room
mode: restart
La condición situada dentro de la secuencia se evalúa al terminar los cinco minutos. Exige que el sensor esté en off y que lleve así treinta segundos. Si hay movimiento o acaba de terminar, devuelve falso y detiene el script antes del apagado. No espera otros treinta segundos: comprueba cuánto tiempo lleva ya la entidad en ese estado.
Elegimos restart para que una nueva bienvenida cancele la cuenta atrás anterior y empiece otra. En una casa real también deberíamos pensar si una notificación persistente es el canal adecuado; aquí nos permite observar el resultado sin configurar un móvil.
Paso 2: una automatización de entrada con identificadores de trigger
La puerta tiene dos eventos relevantes. Los identificamos y dejamos que choose seleccione la primera rama compatible:
- id: "course_final_entry"
alias: "Curso YAML - Proyecto final - Entrada"
triggers:
- trigger: state
entity_id: binary_sensor.course_front_door
from: "off"
to: "on"
id: "opened"
- trigger: state
entity_id: binary_sensor.course_front_door
from: "on"
to: "off"
id: "closed"
conditions: []
actions:
- choose:
- conditions:
- condition: trigger
id: "opened"
- condition: state
entity_id: binary_sensor.course_night
state: "on"
- condition: state
entity_id: binary_sensor.course_someone_home
state: "on"
sequence:
- action: script.turn_on
target:
entity_id: script.course_welcome_home
- conditions:
- condition: trigger
id: "opened"
- condition: state
entity_id: binary_sensor.course_night
state: "on"
- condition: state
entity_id: binary_sensor.course_someone_home
state: "off"
sequence:
- action: persistent_notification.create
data:
title: "Curso YAML - Entrada"
message: "La puerta se ha abierto de noche con la casa vacía."
- conditions:
- condition: trigger
id: "closed"
- condition: state
entity_id: binary_sensor.course_someone_home
state: "off"
sequence:
- action: persistent_notification.create
data:
title: "Curso YAML - Puerta cerrada"
message: "La puerta se ha cerrado y no hay nadie en casa."
mode: single
No añadimos default. Para las aperturas diurnas el resultado deseado es no hacer nada. Esa ausencia es una decisión explícita, no una rama olvidada.
Utilizamos script.turn_on porque la automatización de entrada solo necesita iniciar la bienvenida; no debe esperar cinco minutos a que termine. Así puede finalizar inmediatamente y responder a un cierre posterior de la puerta. El propio script utiliza mode: restart, de modo que otra bienvenida reinicia su cuenta atrás sin mantener bloqueada la automatización que la llamó.
Esta decisión recupera una diferencia del capítulo 7: la llamada directa a script.course_welcome_home esperaría al final del script, mientras que script.turn_on inicia una ejecución independiente.
Paso 3: el movimiento es dueño de su cuenta atrás
Esta automatización reutiliza el patrón del capítulo 6:
- id: "course_final_motion_light"
alias: "Curso YAML - Proyecto final - Luz por movimiento"
triggers:
- trigger: state
entity_id: binary_sensor.course_hallway_motion
from: "off"
to: "on"
conditions:
- condition: state
entity_id: binary_sensor.course_night
state: "on"
actions:
- action: light.turn_on
target:
entity_id: light.course_living_room
- wait_for_trigger:
- trigger: state
entity_id: binary_sensor.course_hallway_motion
from: "on"
to: "off"
timeout:
minutes: 10
continue_on_timeout: false
- delay:
seconds: 30
- action: light.turn_off
target:
entity_id: light.course_living_room
mode: restart
Si aparece movimiento de nuevo durante los treinta segundos finales, el trigger vuelve a dispararse. restart detiene la ejecución anterior, enciende la luz —aunque ya esté encendida— y espera otra vez a que el sensor pase a off.
El timeout evita una espera ilimitada si el sensor queda bloqueado en on. Como continue_on_timeout es falso, al cumplirse diez minutos la secuencia termina sin apagar la luz. Esta elección es conservadora: ante un sensor dudoso no queremos apagar mientras todavía podría haber movimiento. El apagado de seguridad del script de bienvenida tampoco actuará si el sensor continúa en on, así que el fallo quedaría visible y tendría que investigarse.
Paso 4: temperatura con una lectura coherente
La tercera automatización guarda el texto recibido y su validez:
- id: "course_final_temperature"
alias: "Curso YAML - Proyecto final - Ventilador"
triggers:
- trigger: state
entity_id: sensor.course_living_room_temperature
conditions: []
actions:
- variables:
temperature_text: >-
{{ states('sensor.course_living_room_temperature') }}
- variables:
temperature_is_valid: >-
{{ temperature_text not in ['unknown', 'unavailable'] }}
- choose:
- conditions:
- condition: template
value_template: "{{ temperature_is_valid }}"
sequence:
- variables:
temperature: "{{ temperature_text | float }}"
- choose:
- conditions:
- condition: template
value_template: "{{ temperature >= 25 }}"
sequence:
- action: switch.turn_on
target:
entity_id: switch.course_fan
default:
- action: switch.turn_off
target:
entity_id: switch.course_fan
default:
- action: persistent_notification.create
data:
title: "Curso YAML - Temperatura no disponible"
message: >-
El ventilador no ha cambiado porque el sensor está
en {{ temperature_text }}.
mode: restart
La primera acción lee el sensor una sola vez. La segunda valida esa misma lectura guardada; no vuelve a consultar la entidad. Solo convertimos con float dentro de la rama donde ya sabemos que existe un valor utilizable. El estado unavailable no se transforma silenciosamente en cero y toda la decisión se basa en una única fotografía de la temperatura.
Instala sin sustituir tus archivos
La solución del laboratorio contiene scripts.yaml y un archivo de automatizaciones manuales. No debes reemplazar tus archivos reales por ellos.
Si sigues la estructura del capítulo 10, las líneas relevantes son:
automation ui: !include automations.yaml
automation manual: !include_dir_merge_list automations/manual
script: !include scripts.yaml
Integra la clave course_welcome_home dentro de tu mapa de scripts existente y coloca la lista de tres automatizaciones en el directorio manual. Si ya utilizas packages u otra estructura válida, adapta el lugar conservando el tipo esperado.
Antes de recargar:
- Haz una copia de seguridad.
- Confirma que no duplicas las claves superiores.
- Valida la configuración.
- Recarga scripts y automatizaciones.
- Comprueba que aparecen las cuatro entidades de automatización y script.
Plan de pruebas: también deben pasar los caminos negativos
Realiza cada prueba desde un estado inicial conocido. Los input_boolean del laboratorio permiten controlar puerta, movimiento, presencia y noche.
Entrada
- Noche
on, presenciaon, puerta cerrada. Abre la puerta: luz y bienvenida. - Noche
on, presenciaoff. Abre: aviso de casa vacía y ninguna bienvenida. - Noche
off. Abre: ninguna rama. - Presencia
off. Cierra: aviso de puerta cerrada. - Presencia
on. Cierra: ningún aviso de casa vacía. - Con presencia
on, abre y vuelve a cerrar antes de cinco minutos: la automatización debe poder procesar ambos cambios porque no espera al script.
Movimiento
- De noche, activa movimiento: la luz se enciende.
- Desactívalo: la luz continúa treinta segundos y se apaga.
- Durante esos treinta segundos, actívalo otra vez: la cuenta atrás anterior queda cancelada.
- De día, activa movimiento: la automatización crea una traza, pero la condición superior bloquea las acciones.
Temperatura
- Cambia a 24,5 °C: ventilador apagado.
- Cambia a 25 °C: ventilador encendido; comprueba el límite exacto.
- Cambia a 27 °C: sigue encendido sin error.
- Simula un estado no disponible desde Estados: el ventilador conserva su estado y aparece un aviso.
Después de cada prueba abre la traza correspondiente. No te limites a observar el dispositivo final: verifica el trigger ID, las condiciones, la rama elegida y los valores de las variables.
Cómo evaluar tu propia solución
Una buena entrega debería permitir responder afirmativamente:
- ¿Los requisitos están escritos antes del código?
- ¿Cada automatización tiene una responsabilidad reconocible?
- ¿Las secuencias reutilizables están en scripts por una razón concreta?
- ¿Los modos representan lo que debe ocurrir con ejecuciones solapadas?
- ¿Los datos no disponibles tienen un comportamiento definido?
- ¿Los archivos devuelven la lista o mapa que espera su inclusión?
- ¿La configuración valida y puede recargarse?
- ¿Existen pruebas positivas, negativas y de límites?
- ¿Las trazas confirman el recorrido esperado?
- ¿Podrías explicar cada bloque sin decir solamente «Home Assistant lo necesita»?
La solución de referencia no es la única correcta. Podrías agrupar todo en un package, separar cada automatización en un archivo o usar una condición de sol en vez del ayudante nocturno en tu casa real. Lo que no debería cambiar es la claridad con que relacionas una decisión con un requisito.
Lo que has aprendido y lo que viene después
Al principio del curso YAML podía parecer el lenguaje que «hace» la automatización. Ahora puedes separar sus capas:
- YAML representa la estructura.
- Home Assistant interpreta esa estructura como entidades, triggers, condiciones y acciones.
- Jinja calcula valores dinámicos dentro de ciertos campos.
- Los estados reales y el contexto de ejecución determinan el resultado.
También puedes leer una automatización antes de ejecutarla, crearla desde una necesidad, reutilizar una secuencia, elegir un modo, organizar archivos y diagnosticar una traza. Esa es una base completa para trabajar con configuraciones reales sin depender de copiar bloques que no entiendes.
Quedan temas avanzados: blueprints, macros y plantillas personalizadas, eventos complejos, acciones paralelas, respuestas de acciones, calendarios, MQTT o arquitecturas grandes con control de versiones. No los hemos omitido porque sean poco útiles, sino porque cada uno merece aprenderse después de dominar los fundamentos que acabas de aplicar.
Conserva el laboratorio. Cambia un requisito cada vez, predice qué bloque tendrás que modificar y repite el plan de pruebas. El momento en que puedes explicar por qué una automatización funciona —y encontrar por qué no funciona— es el momento en que el YAML deja de ser un bloque para copiar y se convierte en una herramienta propia.
Continúa leyendo
Siguiente guía relacionada · 14 min de lectura
Condiciones y choose: consigue que la automatización decida
← Capítulo 4 · Índice del curso La automatización del capítulo anterior enciende la luz cada vez que se abre la puerta. Cumple exactamente…
Continuar con este artículo

