Miembros
Miembros
Conceptos básicos

Migración de sensores template

TitoTB

Hoy vamos a hacer la migración de sensores template a la nueva sintaxis, y no te preocupes porque es algo MUY sencillo y rápido de hacer.

¿Por qué tengo que migrar mis sensores?

Si, como yo, eres un fanátic@ de la personalización y llevas tiempo con HA, seguro que tienes algún sensor ‘template’. Si es así, y has actualizado a la versión 2025.12, te habrás encontrado con un alarmante mensaje parecido al siguiente:

Si pulsas en cualquiera de los avisos verás una ventana con un poco más de información, en la que te indica que tienes hasta junio de 2026 para hacer estos cambios, porque van a «deprecar» la sintaxis ‘platform:template’.

No obstante, esto no significa que no puedas seguir usando sensores ‘template’ ni que vayas a perder tu información. Solo tenemos que hacer una pequeña modificación.

Cambios necesarios

Tras examinar la guía para llevar a cabo la migración de sensores template, a continuación te resumo los cambios clave que tienes que hacer, para «ir al grano».

De sensors.yaml a templates.yaml

Si hasta ahora almacenabas tus sensores template en el fichero ‘configuration.yaml’ puedes ignorar este apartado. No obstante, si divides tu configuración en ficheros, es probable que estén en un fichero ‘sensors.yaml’ que se incluye en el anterior mediante esta línea:

sensor: !include sensors.yaml

Puesto que ahora tenemos que declarar estos sensores bajo la plataforma «template», lo primero que vamos a hacer es crear un nuevo fichero llamado ‘templates.yaml’, dentro de la carpeta ‘config’ (si no lo has hecho anteriormente).

Luego lo añadiremos a nuestra configuración, incluyendo esta línea el fichero ‘configuration.yaml’ (de forma análoga a como hicimos anteriormente).

template: !include templates.yaml

Al hacerlo, observa lo siguiente:

  • Si ya tenías algún sensor bajo la plataforma ‘template’ en tu fichero ‘configuration.yaml’, deberás llevarlo al fichero que acabamos de crear (eliminando la cabecera ‘template:’) para evitar que lo detecte de forma duplicada. En mi caso, por ejemplo, ya tenía los sensores de batería de mis dispositivos bluetooth.
  • No significa que tengas que borrar tu fichero ‘sensors.yaml’, ya que puede que tengas otro tipo de sensores personalizados bajo otras plataformas.
  • Para que estos cambios tengan efecto tendrás que reiniciar Home Assistant.

Migración de los sensores

Ahora vamos a hacer la migración de sensores template del formato antiguo (en el fichero ‘sensors.yaml’) a la nueva sintaxis (en el fichero ‘templates.yaml’). Para ello te sugiero que sigas este proceso:

  1. Entra en tu fichero ‘sensors.yaml’ y aprovecha la oportunidad para eliminar los sensores que ya no utilices. Además de ahorrarte trabajo, te servirá para contribuir a mejorar el funcionamiento de Home Assistant.
  2. Aprovecha ahora para reiniciar Home Assistant. Si has hecho limpieza, el número de reparaciones que tienes que hacer se habrá reducido a lo estrictamente necesario.
  1. Ahora simplemente tienes que ir pulsando sobre cada uno de los avisos, y fijarte en el «Paso 2 – Añade la configuración moderna». Desde aquí el propio HA te proporcionará la versión corregida del sensor. Por lo tanto, solo tienes que copiarlo y pegarlo en el nuevo fichero de destino:
    • Si los vas a dejar en el fichero ‘configuration.yaml’, ten en cuenta que solo debes incluir la cabecera ‘template:’ una vez, o te generará un error por plataforma duplicada.
    • Si los vas a llevar al fichero ‘templates.yaml’, omite la primera línea y cópialos desde ‘sensor:’.
  1. Elimina el sensor con su denominación antigua en el fichero original (por ejemplo, ‘sensors.yaml’).
  2. Repite el proceso con cada uno de los sensores y, al finalizar, reinicia Home Assistant.

Como ejemplo práctico, observa este sensor que tenía en mi fichero ‘sensors.yaml’.

- platform: template
  sensors:
    vacuum_mantenimiento_cepillo_lateral:
      friendly_name: "Cepillo Lateral"
      value_template: >
        {{ ((states('sensor.roborock_qr_598_tiempo_restante_del_cepillo_lateral') | int / 720000)*100) | int }}
      icon_template: mdi:fan
      unit_of_measurement: "%"

Y como ha quedado en el fichero ‘templates.yaml’:

- sensor:
  - unit_of_measurement: '%'
    default_entity_id: sensor.vacuum_mantenimiento_cepillo_lateral
    icon: mdi:fan
    name: Cepillo Lateral
    state: '{{ ((states(''sensor.roborock_qr_598_tiempo_restante_del_cepillo_lateral'')
      | int / 720000)*100) | int }}'

Ya ves que, si lo analizas, no hay grandes cambios más allá de la nomenclatura de un par de atributos (el nombre de la entidad y el estado del sensor).

Agradecimientos

Comparto contigo también este video de nuestro amigo Javier Gutiérrez Abella, donde ya nos avisaba de estos cambios!