Integración domótica openSenseMap, gratuita y de código abierto
Las mediciones de las cajas de sensores ciudadanos openSenseMap (senseBox), la suya o cercanas.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.2.0
- ★ 0
Las mediciones de las cajas de sensores ciudadanos de openSenseMap (senseBox, airRohr y cajas personalizadas): su propia caja, o las cajas públicas alrededor de su casa.
Esta integración no está afiliada a openSenseMap, ni a openSenseLab, ni a senseBox.
Qué hace
- Lee cajas públicas de openSenseMap por su identificador, sin cuenta ni clave.
- Crea un dispositivo por caja, con una función por sensor que conoce: temperatura, humedad, presión, PM2.5, PM10, PM1, CO2, COV, ruido, luminosidad, índice UV, velocidad del viento, intensidad de lluvia, humedad y temperatura del suelo.
- Indica la antigüedad de la última medición de cada caja: una caja muda se señala y sus valores antiguos no se vuelven a enviar.
- Añade un widget Mediciones de una caja, dos disparadores de escena Caja sin conexión y Caja de nuevo en línea, y una acción de escena Obtener las mediciones de una caja.
Solo lectura: la integración nunca modifica nada en una caja.
Requisitos
- Gladys Assistant 5.2.0 o posterior.
- Acceso a Internet (la API pública de openSenseMap).
- Para la búsqueda alrededor de la casa: la ubicación de su casa, en Ajustes → Casas. La integración pide acceso a las coordenadas de la casa en la instalación; solo las usa para esta búsqueda.
Configuración
Elegir las cajas
Cada caja tiene un identificador de 24 caracteres, visible en su dirección en
el mapa: https://opensensemap.org/explore/5cd81adfff898b001ae7c4c6. Dos
maneras de encontrarlo:
- Haga clic en Buscar cajas alrededor de una casa, elija la casa y un radio: el resultado lista las cajas que han medido en las últimas 24 horas, de la más cercana a la más lejana, con su distancia y sus mediciones. Copie los identificadores deseados.
- O abra el mapa, haga clic en una caja y copie el final de la dirección (también se acepta el enlace completo).
Pegue los identificadores en Identificadores de las cajas, separados por comas (20 cajas como máximo), y guarde. Las cajas aparecen entonces en la pestaña Descubrimiento de la integración: añada a Gladys las que desee.
Otros ajustes
- Lectura: cada 5 minutos por defecto (10, 15 o 30 minutos a elegir). openSenseMap es un servicio gratuito gestionado por una asociación sin ánimo de lucro: 5 minutos como mínimo.
- Idioma: el idioma de los nombres de las funciones (fijados al añadir un dispositivo) y de los textos de escena. Francés por defecto.
Comprobar las cajas lee todas las cajas de inmediato e indica, para cada una, la antigüedad de su última medición, las mediciones publicadas y los sensores que se dejan de lado.
Dispositivos
Un dispositivo por caja, con el nombre de la caja
(Saint-Simon Station (openSenseMap)). Sus funciones son los sensores de la
caja que la integración conoce:
| Medición | Unidad en Gladys | Notas |
|---|---|---|
| Temperatura | °C | |
| Humedad | % | |
| Presión | hPa | convertida desde Pa si es necesario |
| PM2.5, PM10, PM1 | µg/m³ | PM1 es una función PM2.5 llamada «PM1» |
| CO2 | ppm | |
| COV | ppb | solo si la caja envía ppb |
| Ruido | dB | |
| Luminosidad | lx | |
| Índice UV | índice UV | solo un verdadero índice UV, no µW/cm² |
| Velocidad del viento | km/h | convertida desde m/s si es necesario; también ráfagas |
| Intensidad de lluvia | mm/h | |
| Humedad del suelo | % | |
| Temperatura del suelo | °C | |
| Antigüedad de la medición | minutos | desde la última medición de la caja |
Los propietarios nombran sus sensores libremente («Temperatur», «Temp ~ Air», «CO₂»…): la integración reconoce una medición por su unidad y su título. Cuando una caja mide dos veces lo mismo, la segunda función lleva el título del propietario, por ejemplo «Temperatura (Lufttemperatur)».
Un valor se publica mientras tiene menos de una hora. Pasado ese tiempo, la caja se muestra sin conexión y solo la Antigüedad de la medición sigue avanzando.
Widget
Mediciones de una caja: con una caja elegida en sus ajustes, hasta seis mosaicos en directo (uno por medición) y la hora de la última medición, en rojo cuando la caja está sin conexión. Sin caja: una fila por caja, con la antigüedad de su última medición.
Escenas
Disparador: Caja sin conexión
Se activa una vez cuando una caja no ha enviado nada durante el tiempo elegido: 1, 3, 6, 12, 24 o 48 horas. Deje Caja vacío para vigilar todas las cajas. Variables: el nombre de la caja, los minutos sin medición, la hora de la última medición (UTC).
La integración solo declara una caja sin conexión tras una respuesta correcta de openSenseMap: una caída del servicio no es una caja sin conexión. Una caja ya muda cuando usted la añade no activa nada.
Disparador: Caja de nuevo en línea
Se activa cuando una caja señalada sin conexión vuelve a medir. Variables: el nombre de la caja y cuántos minutos estuvo muda.
Acción: Obtener las mediciones de una caja
Da los últimos valores de una caja a las acciones siguientes: un resumen listo para usar («Saint-Simon Station (openSenseMap): Temperatura 17,8 °C · Humedad 99,9 % · hace 3 min»), la antigüedad de la medición en minutos, y la temperatura, la humedad, la presión, las PM2.5 y PM10 cuando la caja las mide y son recientes.
Ejemplos de escenas
- Avisarme cuando mi caja se detiene: disparador Caja sin conexión, caja «Mi senseBox», 6 horas → enviar el mensaje «Mi senseBox no ha enviado nada desde hace 6 horas: compruebe su alimentación y su Wi-Fi.»
- Informe de la mañana: todos los días a las 7:00 → Obtener las
mediciones de una caja → enviar el mensaje
{{summary}}. - Ventilar la sala: cuando la función CO2 de una caja interior supera 1200 ppm → enviar la notificación «Ventile el aula».
Solución de problemas
- Ningún dispositivo en la pestaña Descubrimiento: compruebe los identificadores con Comprobar las cajas. «Caja desconocida en openSenseMap» indica un identificador erróneo.
- Una caja no muestra ningún valor: no ha medido desde hace más de una hora (vea la Antigüedad de la medición), o sus sensores son de un tipo que la integración deja de lado (listados por Comprobar las cajas).
- «La API de openSenseMap no responde»: el servicio está caído o no es accesible desde Gladys; las lecturas se reanudan por sí solas.
- Un nombre de función está en el idioma equivocado: los nombres se fijan al añadir el dispositivo. Cambie el Idioma, elimine el dispositivo y vuelva a añadirlo desde la pestaña Descubrimiento (se pierde su historial).
Límites
- Sensores ciudadanos, no estaciones de referencia: los sensores de partículas de bajo coste sobrestiman con aire húmedo, un sensor al sol mide demasiado calor. Los valores son orientativos.
- Se dejan de lado: los UV en µW/cm² (sin unidad en Gladys, sin conversión fiable), las PM4, los COV en kOhm, la dirección del viento y las cantidades de lluvia. Comprobar las cajas los lista para cada caja. La búsqueda alrededor de la casa ignora las cajas móviles (bicicletas).
- Una función nunca se elimina: un sensor retirado de una caja conserva su función, sin nuevos valores.
- 20 cajas como máximo, cada una leída cada 5 minutos como máximo.
Parámetros de configuración
Estos son los parámetros que openSenseMap te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cajas openSenseMap | section | No | Lea cajas públicas de openSenseMap (sin cuenta) por su identificador, visible en la dirección de la caja en el mapa. Sin afiliación con openSenseMap ni senseBox. |
| Identificadores de las cajas | string | No | Los identificadores de las cajas que desea leer (24 caracteres, o el enlace de la caja), separados por comas, 20 como máximo. El botón «Buscar cajas alrededor de una casa» más abajo lista las de su zona. |
| Lectura | select | No | La frecuencia de lectura de cada caja. openSenseMap es un servicio gratuito: 5 minutos como mínimo. |
| Idioma | select | No | Idioma de los nombres de las funciones (fijados al añadir un dispositivo) y de los textos de escena. |
Cómo instalar openSenseMap en Gladys
- En Gladys, abre Integraciones: openSenseMap 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-opensensemap:1.0.0), 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-opensensemap.
openSenseMap requiere Gladys >=5.2.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
openSenseMap 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, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación