Home Assistant: el acuario en tu hogar inteligente, la lógica reside en el controlador

Oquari se integra de forma nativa con Home Assistant: activas una opción en el panel y las entidades del acuario aparecen automáticamente en HA — sin escribir configuraciones, sin nube ni plugins de terceros. Esta guía muestra cómo activarla, qué verás exactamente en HA y dónde está la línea divisoria: HA supervisa y añade comodidad, pero la lógica crítica permanece en el controlador.

¿Qué es Home Assistant (en dos párrafos)

Home Assistant es la plataforma de hogar inteligente abierta más popular del mundo: software gratuito que instalas en tu propio hardware (Raspberry Pi, mini-PC, NAS) y que conecta dispositivos de diferentes fabricantes en un solo sistema — con paneles, gráficos históricos, automatizaciones y notificaciones al teléfono.

Para el acuarista, HA significa un único lugar donde el acuario se encuentra con el resto del hogar: gráfico de pH junto a la temperatura del salón, alerta de fuga en el mismo teléfono que la alarma doméstica, botón «alimentación» en la tablet de la cocina.

Paso 1: broker MQTT

Oquari habla con HA mediante MQTT — un protocolo ligero de comunicación para hogares inteligentes. Necesitas un broker (intermediario de mensajes) en tu red local; en la práctica es una instalación sencilla:

1. En Home Assistant: Configuración → Complementos → Tienda de complementos → Mosquitto broker → instala y ejecuta.
2. Crea un usuario para el controlador en HA (por ejemplo, oquari) — el complemento Mosquitto usará las cuentas de HA.
3. Activa la integración MQTT en HA (normalmente se sugiere automáticamente al iniciar el broker).

Paso 2: activación en el panel Oquari

1. Abre el panel del controlador (oquari-XXXX.local) → pestaña Home Assistant.
2. Activa la integración e introduce: dirección del broker (mqtt://IP-de-tu-HA:1883), usuario y contraseña MQTT.
3. Guarda — el controlador se conectará al broker y anunciará sus entidades (MQTT Discovery).

Al poco rato, en HA, en Configuración → Dispositivos y servicios → MQTT, aparecerá el dispositivo «Oquari» con el conjunto completo de entidades.

La conexión con el broker no está cifrada (red local). Usa esta integración únicamente en tu LAN propia y asigna una contraseña independiente al usuario MQTT. Este es el modelo estándar de trabajo para dispositivos locales de hogar inteligente.

Qué aparecerá en HA

Las entidades reflejan tu configuración — el controlador las registra automáticamente, con las unidades y clases correctas (por lo que HA dibuja gráficos inmediatamente y entiende qué es temperatura y qué es energía):

• Sensores: temperatura, pH, ORP, salinidad, niveles, caudal (l/min), potencia y consumo energético de cada enchufe, contadores de uso de líquidos dosificados.
• Sensores binarios: sensores de nivel, sensores de inundación, alarmas (sobrecalentamiento, límite ATO, botella vacía), estado «dosificación en curso».
• Interruptores y luces: enchufes medidos como switch, canales de iluminación como light.
• Campos numéricos y modos: dosis de dosificación como number, modos de operación como select, alimentación como button.

Además, hay una entidad de disponibilidad: cuando el controlador desaparezca de la red, HA marcará inmediatamente sus entidades como no disponibles — lo cual por sí solo es una excelente alarma («acuario fuera de línea»).

Ejemplo: alimentación pausa circulación durante 5 minutos

Una comodidad clásica: botón en HA que detiene la bomba de circulación durante la alimentación, y HA la reactiva automáticamente:

alias: Alimentación — pausa circulación
trigger:
  - platform: state
    entity_id: input_button.alimentacion
action:
  - service: switch.turn_off
    target:
      entity_id: switch.oquari_circulacion
  - delay: "00:05:00"
  - service: switch.turn_on
    target:
      entity_id: switch.oquari_circulacion

En la práctica, ni siquiera necesitas escribir esto — Oquari tiene un modo de alimentación integrado (button.oquari_alimentacion) que pausa las bombas y las reactiva automáticamente. Pero el ejemplo ilustra bien el principio: las entidades de Oquari se comportan como cualquier otra en HA.

Otras automatizaciones útiles: notificación push ante alarma de temperatura o fuga, recordatorio para cambiar la botella cuando el contador supere su capacidad, gráfico diario de pH en el panel junto a la ventana de CO₂.

Principio de división: HA supervisa, el controlador protege

El párrafo más importante de esta guía. La lógica crítica — histéresis de calentamiento, cortes de emergencia, límites ATO, cambio de agua, ventana de CO₂, dosificación — se ejecuta en el controlador, localmente. HA es la capa de supervisión y comodidad: paneles, historial, notificaciones, escenas como alimentación.

Esta división no es casualidad, sino fundamento de seguridad:

• Si falla Wi-Fi, router, servidor HA o internet — el calentamiento sigue manteniendo la temperatura, ATO sigue vigilando los límites, CO₂ se cierra fuera de la ventana de luz. El acuario no notará la caída de red.
• La automatización de HA puede conmutar enchufes, pero no puede eludir la capa de seguridad del controlador: las protecciones (corte por sobrecalentamiento, bloqueo por inundación) son superiores incluso a los comandos MQTT.

No traslades la lógica protectora a HA, aunque puedas programarla allí. Una automatización «apagar calentador a 27,5 °C» en HA dejará de existir junto con el servidor HA. Esa misma regla en el controlador funciona siempre. Usa HA para lo que hace mejor: ver, saber y facilitar.

Preguntas frecuentes

¿Necesito conexión a internet para que funcione la integración?

No. La comunicación entre Oquari y Home Assistant ocurre exclusivamente en tu red local mediante MQTT. Internet solo es necesario si decides añadir notificaciones externas o acceder remotamente, pero la automatización del acuario funciona sin él.

¿Qué pasa si se reinicia mi servidor Home Assistant?

Las entidades de Oquari reaparecerán automáticamente gracias al protocolo MQTT Discovery. No necesitas reconfigurar nada; el controlador volverá a anunciar sus datos y estados tan pronto como detecte que el broker está disponible nuevamente.

¿Puedo controlar manualmente los dispositivos desde HA?

Sí, puedes usar interruptores y botones para acciones puntuales como pausar bombas o activar luces. Sin embargo, recuerda que la lógica de seguridad (como límites de temperatura o protección contra secado) reside en el controlador Oquari y prevalece sobre cualquier comando manual enviado desde HA.

¿Es segura la conexión sin cifrado?

La comunicación MQTT es local y no sale de tu red doméstica, por lo que el riesgo externo es nulo. Para mayor seguridad interna, se recomienda usar credenciales únicas para el usuario MQTT en lugar de compartir las del administrador principal de Home Assistant.

¿Oquari depende de la nube del fabricante?

No. Oquari está diseñado para funcionar completamente offline. Toda la lógica de control y protección se ejecuta en el hardware del controlador, garantizando que tu acuario siga operando correctamente incluso si pierdes la conexión a internet o el servicio de Home Assistant.