Poolside Tech ofrece una integración oficial propia de los controladores Attendant con Home Assistant. La comunicación es totalmente local y no usa consultas periódicas. No depende de la nube y actualiza Home Assistant de inmediato, independientemente de la conexión a Internet.
Funciones compatibles
- Home Assistant ofrece un control similar al de la aplicación Poolside para juegos de agua, luces, calefacción, enfriamiento y otras funciones de la piscina.
- Puede monitorear estados de dispositivos y crear alertas o automatizaciones según los sensores y los parámetros de funcionamiento.
Requisitos
The Attendant o The Attendant Mini debe usar software versión 2.7.0 o posterior.
Home Assistant versión 2026.2.0 o posterior.
Para la detección automática mDNS, Home Assistant y The Attendant deben estar en el mismo dominio de difusión de capa 2, es decir, LAN/VLAN. Si el tráfico pasa por un router o firewall, permita TCP/8126 desde Home Assistant hacia The Attendant.
La red debe admitir mDNS. Si el Wi-Fi bloquea el tráfico multidifusión, mDNS y la detección automática no funcionarán.
Instalar la integración mediante HACS
Nota: Poolside Tech está trabajando para incluir la integración en Home Assistant Core. Cuando eso ocurra, no será necesario instalarla por HACS. Ese canal seguirá ofreciendo actualizaciones rápidas y funciones nuevas en prueba.
Consulte este artículo para conocer las novedades sobre los métodos de instalación.
Agregar HACS y la integración Poolside
- Instale HACS siguiendo las instrucciones para su tipo de instalación de Home Assistant: OS, Container o Core.
https://hacs.xyz/docs/use/download/download/#troubleshooting - Reinicie Home Assistant.
- Vaya a «Settings → Devices & Services» (Ajustes → Dispositivos y servicios). En Integraciones, presione Add Integration (Agregar integración).
- Busque HACS e instale la integración.
- Abra HACS en la navegación principal izquierda.
- Abra el menú de tres puntos de HACS, arriba a la derecha, y elija «Custom repositories» (repositorios personalizados).
- Ingrese PoolsideStan/poolside-official-integration como repositorio y Integration como tipo.
Presione Add (Agregar). - Busque Poolside en HACS y abra el resultado.
- Descargue e instale la integración con Download (Descargar).
- Reinicie Home Assistant para activarla.
Emparejar The Attendant con Home Assistant
Después de instalar HACS, agregar el repositorio de Poolside Tech e instalar la integración, puede comenzar el emparejamiento.
Conexión por detección automática (recomendada)
Home Assistant normalmente detecta The Attendant y muestra una tarjeta en «Settings → Devices & Services». Presione Configure (Configurar) en esa tarjeta para comenzar.
Conexión por configuración manual
- Vaya a «Settings → Devices & Services» y presione Add Integration (Agregar integración) en Integraciones.
- Busque Poolside e instale la integración.
Nota: Solo aparecerá después de instalar HACS y agregar el repositorio personalizado. - Ingrese la dirección IP de The Attendant y presione Submit (Enviar).
Completar el emparejamiento en la aplicación móvil
El emparejamiento establece una sola vez si The Attendant confía en esa instalación de Home Assistant. Se requiere acceso de administrador para aprobarlo. Al iniciarlo desde Home Assistant, se abre una ventana de 5 minutos. Durante ese período:
Antes de presionar Aprobar, confirme que el código de la aplicación Poolside coincida con el de Home Assistant. Esto asegura que autoriza el sistema correcto y no otro dispositivo de la red.
Home Assistant muestra un código breve de verificación o huella digital y espera.
La misma solicitud aparece en el controlador Poolside y en la tarjeta Solicitud de emparejamiento de API de la aplicación.
- Presione Revisar en Solicitud de emparejamiento de API.
- Presione Aprobar para completar el emparejamiento.
- Puede administrar y revocar instalaciones emparejadas desde Conexiones de API. Abra el menú de tres líneas y vaya a Sitios → sitio correspondiente → Conexiones de API.
Si la solicitud vence, puede iniciar otra desde Home Assistant.
Configurar la integración en Home Assistant
Puede configurar la opción Expose pool devices (Mostrar equipos de piscina).
The Attendant distingue entre controles, como juegos de agua o calefacción, y los equipos físicos que utiliza para ejecutar esas funciones: bombas, calentadores, actuadores, iluminación y otros componentes.
Además de los controles, la integración puede mostrar esos equipos. Cada uno aparece como un dispositivo independiente con entidades de sensor de solo lectura para datos como velocidad de bomba, consumo eléctrico, estado del calentador o posición de válvulas. Sirven para paneles, alertas y automatizaciones, por ejemplo una alerta si baja el consumo de una bomba de filtración que debería estar funcionando. No permiten controlar directamente los equipos: toda acción sigue pasando por los controles normales, igual que en la aplicación Poolside.
La opción está activada de forma predeterminada. Puede desactivarla si quiere menos entidades:
- Vaya a Settings → Devices & Services → Poolside.
- Presione Configure.
- Cambie Expose pool devices y presione Submit.
La integración se vuelve a cargar automáticamente. Al desactivar la opción se eliminan las entidades de telemetría; al reactivarla, vuelven a aparecer. Los controles normales de luces, juegos de agua, calefacción y otras funciones siguen disponibles.