Integrar Open Plantbook en Home Assistant

Hoy te enseño a integrar Open Plantbook en Home Assistant, para que te ayude a cuidar de tus plantas como un profesional.

¿Qué es Open Plantbook y que aporta?

Open Plantbook es un proyecto abierto y colaborativo que funciona como una base de datos de plantas pensada para integrar con proyectos de domótica, agricultura inteligente e IoT. Tiene una API pública y gratuita que contiene información estructurada sobre miles de plantas, que te permite consultar parámetros recomendados para el cultivo y cuidado de cada especie (como la humedad del suelo recomendada o la iluminación necesaria).

Por tanto, esta integración es el complemento perfecto para todos aquellos que queremos cuidar de nuestras plantas, pero no tenemos ni idea de qué es lo mejor para ellas 😅

Requisitos previos

Para integrar Open Plantbook en Home Assistant únicamente necesitas:

• Tener algún sensor que mida la humedad de tus plantas (mis preferidos son este tipo de sensores zigbee).
• Opcional pero recomendable, sensores exteriores que midan la temperatura, humedad y luminosidad ambiental.

Integración en Home Assistant

Para integrar Open Plantbook en Home Assistant sigue estos pasos:

1. Entra en la página web de la API de Open Plantbook, pulsa en el enlace que indica «Sign in» de la esquina superior derecha y crea una cuenta o accede con tu cuenta de Google.
2. Hecho esto, accede al apartado «API keys» del menú lateral y pulsa en el botón «Generate» para obtener tu «Client ID» y «Client Secret».
3. En Home Assistant, ve a HACS, pulsa en los 3 puntos de la esquina superior derecha y haz clic en «Repositorios personalizados». En el campo «Repositorio» añade el siguiente enlace, selecciona la opción «Integración» y pulsa en «Añadir».

4. En el buscador, introduce «OpenPlantbook», pulsa en «Descargar» y reinicia Home Assistant.
5. Cuando termine, ve a Configuración > Dispositivos y servicios > Añadir integración > OpenPlantbook. En el asistente de configuración introduce el «Client ID» y «Client Secret» obtenidos en el paso 2 y pulsa en «Enviar».
6. Ahora vamos a instalar otra integración a través de HACS que sustituye al componente oficial para plantas. La diferencia es que este va a tomar la ciertos datos de Open Plantbook de forma automática, además de no requerir la manipulación de código.
7. De nuevo, ve a HACS, pulsa en los 3 puntos de la esquina superior derecha y haz clic en «Repositorios personalizados». En el campo «Repositorio» añade el siguiente enlace, selecciona la opción «Integración» y pulsa en «Añadir».

8. En el buscador, introduce «Home Assistant Plant», pulsa en «Descargar» y reinicia Home Assistant.
9. Cuando termine, ve a Configuración > Dispositivos y servicios > Añadir integración > Plant Monitor. En el asistente de configuración, introduce los siguientes datos:
   • Nombre de la planta. Introduce aquí el nombre que quieras (por ejemplo, «Esparraguera»).
   • Especie. Aquí tenemos que introducir el nombre científico de la planta (por ejemplo, «Asparagus plumosus»), ya que se va a usar para obtener información de Open Plantbook. Te sugiero que hagas una búsqueda rápida en Google, teniendo en cuenta que a continuación el propio asistente te va a hacer una sugerencia en función de los resultados de su base de datos (que también puedes consultar).
   • Sensor de temperatura. Selecciona aquí algún sensor de temperatura ambiente que tengas cerca de tu planta. Ten en cuenta que puedes usar el mismo sensor para distintas plantas (siempre que estén juntas).
   • Sensor de humedad del suelo. Aquí tienes que indicar la entidad correspondiente al sensor de humedad que has introducido en la planta en concreto.
   • Sensor de conductividad. En caso de que tu sensor proporcione la conductividad (concentración de sales disueltas en el agua o en el suelo, como fertilizantes, minerales, etc.) selecciónalo aquí.
   • Sensor de iluminación. Igual que la temperatura, puedes usar el mismo sensor de ambiente para distintas plantas.
   • Sensor de humedad ambiente. Igual que la temperatura, puedes usar el mismo sensor de ambiente para distintas plantas.
   • Pulsa en «Enviar» y selecciona la variante que más se parezca a la tuya. Observa que, gracias a la información de la base de datos, va a asignarle los umbrales adecuados para cuidar de tu planta.
10. Si ahora accedes al bloque «Monitor de plantas» de tu panel de integraciones, ya encontrarás tu planta con todos los sensores correspondientes (pudiendo deshabilitar las entidades que no vayas a usar).
11. Si buscas el dispositivo desde Herramientas para desarrolladores > Estados, observarás que ha creado una entidad de tipo ‘plant’ (por ejemplo, ‘plant.esparreguera’). El estado principal indica si hay algún problema con la planta, y los atributos muestran el desglose por sensor.

12. Observa también que si vas a Dispositivos y servicios > Integraciones > Monitor de plantas y pulsas sobre el icono del engranaje junto a tu planta, puedes personalizar los valores que va a tomar como problemáticos (algo útil, si no tienes alguno de estos sensores o no quieres darles importancia).
13. De igual modo, puedes utilizar estos atributos en tus automatizaciones para crear acciones o notificaciones a medida (por ejemplo, «riégala», «baja el toldo», etc).

Lovelace card

Además de integrar Open Plantbook en Home Assistant, también puedes utilizar la tarjeta personalizada (Flower Card) que ha creado el mismo autor de la integración siguiendo estos pasos:

1. En Home Assistant, ve a HACS, pulsa en los 3 puntos de la esquina superior derecha y haz clic en «Repositorios personalizados». En el campo «Repositorio» añade el siguiente enlace, selecciona la opción «Panel de control» y pulsa en «Añadir».

2. En el buscador, introduce «Flower Card», pulsa en «Descargar» y recarga la caché.
3. Ve a tu panel de control, agrega una nueva tarjeta y busca «Flower Card». Selecciona tu planta y los atributos que quieres mostrar, incluido el sensor de bateria de tu sensor de humedad.