En esta guia, vamos a aprender a como integrar nuestro PulsePro a nuestro sistema de monitoreo creado con Homeassistant. Como lo haremos? usando consultas web automáticas a su API.
A esto se le llama usar una API REST, que es una forma estándar de pedirle datos a un dispositivo o servicio en internet. Home Assistant, por suerte, puede hacer este tipo de consultas de forma automática si lo configuramos correctamente.
🗂️ Paso previo: crear la carpeta sensors para una configuración ordenada
A medida que agregás sensores, si colocas todo el código directamente en el archivo configuration.yaml, puede volverse difícil de leer o mantener. Una buena práctica es separar la configuración de sensores en archivos individuales.
🧰 Antes de empezar: instalá "File Editor" para modificar archivos fácilmente
Para crear carpetas y editar archivos en Home Assistant sin necesidad de conectarte por terminal o saber usar comandos, te recomiendo usar el complemento llamado File Editor. Es una herramienta visual e integrada dentro de la propia interfaz web de Home Assistant.
✅ ¿Cómo instalar File Editor?
1. En el menú lateral de Home Assistant, andá a “Settings” (Ajustes).
2. Ingresá a “Add-ons” > “Add-on Store”.
3. Buscá “File Editor” en la barra de búsqueda.
4. Hacé clic en el resultado y luego en “Install”.
5. Una vez instalado, activá las opciones:
* “Start on boot” (para que se inicie siempre)
* “Show in sidebar” (para tener acceso directo)
6. Hacé clic en “Start” para iniciarlo.
Ahora vas a ver el icono de File Editor en la barra lateral izquierda. Desde ahí podés navegar y editar todos los archivos de configuración fácilmente.
Ahora, ¡a crear la carpeta!
1. En la carpeta de configuración de Home Assistant (normalmente /config/), creá una subcarpeta llamada:
arduino
CopiarEditar
/config/sensors
2. Dentro de esa carpeta, podés crear un archivo por cada sensor o grupo de sensores. Por ejemplo:
arduino
CopiarEditar
/config/sensors/pulsepro.yaml
3. Luego, en el archivo configuration.yaml, agregá esta línea si aún no la tenés:
yaml
CopiarEditar
sensor: !include_dir_merge_list sensors/
Esto le indica a Home Assistant que debe leer todos los archivos de la carpeta sensors/ como sensores. Es ideal para mantener tu configuración limpia, modular y más profesional.
🔌 Integrando el Pulse Pro vía API REST
Para leer los datos del PulsePro, vamos a usar la función platform: rest, que permite pedir datos a una API y convertirlos en sensores visibles en Home Assistant. Para esto, vas a necesitar chequear en tu app de PULSE los siguiente datos:
1) Device ID (vas a reemplazarlo luego por las “XXXXX” mas abajo.
2) API KEY (vas a reemplazarlo donde dice “TU_API_KEY” mas abajo.
Una vez obtenidos estos datos, vas a pegar el siguiente codigo en tu archivo pulsepro.yaml que has creado anteriormente.
• platform: rest
resource: https://api.pulsegrow.com/devices/XXXXX/recent-data
method: GET
value_template: '{{ value_json["lightLux"] }}'
unique_id: "pulsepro_lightLux"
unit_of_measurement: '%'
name: "PulsePro lightLux"
scan_interval: 20
headers:
x-api-key: TU_API_KEY
Vas a tener que repetir este código para cada variable que quieras monitorear (VPD, humedad, temperatura)
Este código hace lo siguiente:
• resource: URL de la API donde están los datos del PulsePro.
• method: GET: indica que queremos leer información.
• value_template: nos dice qué dato queremos sacar del conjunto de datos. En este caso, la luz medida en Lux.
• unique_id: es un identificador único interno.
• name: el nombre que va a tener el sensor en Home Assistant.
• unit_of_measurement: la unidad de medida (puede ser %, °C, etc.).
• scan_interval: cada cuántos segundos se actualiza (en este caso, cada 20 segundos).
• headers: se coloca la API Key que nos da Pulse para poder acceder.
🧠 ¿Qué lenguaje es este?
Este archivo está escrito en YAML, un lenguaje de texto muy usado en configuraciones. Es fácil de leer porque usa sangrías con espacios en lugar de llaves o paréntesis. Es importante no usar tabulaciones y asegurarte de que la estructura esté alineada.
También estamos usando dentro del YAML un poco de Jinja2, un lenguaje de plantillas que permite "leer" y transformar los datos que devuelve la API (como value_json["lightLux"]).
Con esta configuración, vas a poder integrar el PulsePro a Home Assistant sin depender de una integración oficial, y usar sus valores como cualquier otro sensor para alarmas, gráficos y automatizaciones.
Si necesitás ayuda o tenés alguna consulta, podés escribirnos a nuestro instagram @reprocard.
