Integración domótica OCEA Smart Building, gratuita y de código abierto
Lecturas de agua fría, agua caliente y calefacción de su espacio de residente OCEA.
Publicado por guim31
- Dispositivos
- Versión 1.0.2
- Requiere Gladys >=5.1.0
- ★ 0
Lee los contadores de su vivienda desde el espacio de residente de OCEA Smart Building (https://espace-resident.ocea-sb.com): agua fría, agua caliente y calefacción, cuando OCEA lee a distancia los contadores de su edificio.
Sin relación con OCEA Smart Building. OCEA no ofrece una API pública: la integración lee el portal como lo hace su navegador, y puede dejar de funcionar si OCEA lo modifica.
Desarrollada sin cuenta: sus comentarios son bienvenidos. Cuéntenos en el foro de Gladys lo que ve, sobre todo si su calefacción se mide con repartidores de costes.
Lo que obtiene
Un dispositivo por vivienda de su cuenta (varios si tiene varias), con una funcionalidad por fluido mostrado en el portal:
| Funcionalidad | Unidad | Observaciones |
|---|---|---|
| Agua fría | m³ | índice acumulado |
| Agua caliente | m³ | índice acumulado |
| Calefacción (energía) | kWh | con un contador de energía térmica (CETC) |
| Calefacción (unidades de repartidor) | sin unidad | con repartidores de costes en los radiadores |
¿Contador de energía o repartidores? Un contador de energía térmica (CETC) mide la energía que recibe la vivienda, en kWh. Los repartidores de costes de calefacción, uno por radiador, no miden energía: cuentan unidades que solo indican qué parte de la factura de calefacción del edificio corresponde a la vivienda. Por eso la integración presenta las unidades de repartidor como un simple contador sin unidad, nunca en kWh.
Configuración
- Abra la pestaña Configuración de la integración.
- Introduzca el correo electrónico y la contraseña de su espacio de residente de OCEA. Sus viviendas se encuentran a partir de la cuenta.
- Ajuste si es necesario el intervalo de lectura (6 horas por defecto, de 1 a 24) y el idioma de los nombres de los contadores.
- Pulse Guardar configuración, abra la pestaña Descubrir y añada su vivienda con Añadir a Gladys.
El botón Probar la conexión y leer ahora se conecta de inmediato a OCEA e indica el número de viviendas y de contadores encontrados.
Frecuencia de las lecturas
Los contadores de OCEA envían su índice una vez, o algunas veces, al día. La integración lee el portal cada 6 horas por defecto, como máximo cada hora: leer más a menudo no aporta datos más recientes y solo carga el portal. La última lectura se conserva: reiniciar Gladys no vuelve a leer OCEA antes del final del intervalo. Un valor que no cambia se envía de nuevo a Gladys al menos cada 12 horas, para que nunca aparezca «Sin valor reciente».
Gráficos y supervisión de energía
- Agua: el índice de cada contador se guarda en el historial de la funcionalidad y se traza en el gráfico del dispositivo.
- Calefacción en kWh (CETC): el índice es el de un contador de energía, que la supervisión de energía de Gladys convierte por sí misma en consumo por media hora y en coste. Gladys coloca un nuevo índice de energía bajo su contador eléctrico principal (si está definido): en Integraciones → Supervisión de energía, coloque el índice de la calefacción en sin padre (raíz); si no, su calefacción se suma a su electricidad. Como el índice llega cada pocas horas, el consumo de esas horas cae en una sola media hora.
- Calefacción en unidades de repartidor: solo un gráfico de historial del contador. Estas unidades no son energía y no entran en la supervisión de energía.
Widget del panel
El widget Consumo OCEA muestra, para la vivienda elegida, el consumo del mes en curso por fluido. La integración lo calcula a partir de los índices leídos: el primer mes solo cuenta a partir de la primera lectura, y el widget indica desde cuándo cuenta.
Límites
- Solo lo que muestra el panel del portal: un valor por fluido, sin detalle por radiador ni por contador, sin alertas.
- Las lecturas tienen el retraso de las de OCEA (a menudo el día anterior).
- La integración se desarrolló sin cuenta: el caso de los repartidores, en particular, se basa en hipótesis. Sus comentarios ayudan.
Privacidad
El correo electrónico y la contraseña permanecen en la configuración de
Gladys. La integración guarda el token de sesión de OCEA y las últimas
lecturas en su volumen /data, y nunca escribe identificadores ni tokens en
sus registros.
En caso de problema
- «OCEA ha rechazado el correo electrónico o la contraseña»: compruébelos en el portal y guárdelos de nuevo. Mientras tanto, la integración deja de intentarlo, para no bloquear nunca su cuenta.
- «El portal de OCEA no ha respondido»: puede que OCEA esté en mantenimiento. La integración lo vuelve a intentar en 30 minutos.
- Abra la pestaña Registros de la integración para ver lo que ha pasado. Una lectura normal no escribe nada: solo aparecen el inicio, la conexión a OCEA, los errores (una línea cuando aparecen, otra cuando todo vuelve a funcionar) y sus acciones.
Parámetros de configuración
Estos son los parámetros que OCEA Smart Building te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su cuenta de residente OCEA | section | No | Utilice el correo electrónico y la contraseña del espacio de residente OCEA Smart Building. Sus viviendas se detectan a partir de la cuenta. Los contadores informan unas pocas veces al día: la integración lee el portal cada pocas horas. Sin relación con OCEA Smart Building. |
| Correo electrónico | string | Sí | |
| Contraseña | secret | Sí | |
| Intervalo de lectura (horas) | number | No | Frecuencia de lectura del portal OCEA, de 1 a 24 horas. Los contadores solo informan unas pocas veces al día. |
| Idioma de los nombres de dispositivos | select | No | Se utiliza para los nombres de los contadores cuando el dispositivo se añade a Gladys. |
Cómo instalar OCEA Smart Building en Gladys
- En Gladys, abre Integraciones: OCEA Smart Building aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-ocea:1.0.2), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-ocea.
OCEA Smart Building requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
OCEA Smart Building es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación