Saltar al contenido principal

Integración domótica BfS ODL, gratuita y de código abierto

Integración BfS ODL para Gladys Assistant

La tasa de dosis gamma ambiental de las 1700 sondas ODL de la BfS alemana, cada hora.

Qué hace​

Lleva a Gladys la tasa de dosis gamma ambiental medida por las sondas de la red ODL de la Oficina Federal alemana de Protección Radiológica (Bundesamt für Strahlenschutz, BfS): unas 1700 sondas en toda Alemania, un valor por hora. La integración lee el servicio de datos abiertos de la BfS, los mismos datos que el mapa ODL-Info, sin cuenta ni clave.

Para cada sonda seguida obtiene la tasa de dosis, sus partes cósmica y terrestre, la hora y el estado de la medición, un widget de panel con la curva de 24 horas y disparadores de escena cuando la tasa supera un umbral de alerta.

Esta integración no es un sistema de alerta oficial: en caso de emergencia, siga las instrucciones de las autoridades. Los niveles naturales varían: la lluvia arrastra al suelo los descendientes del radón y puede añadir hasta 0,1 µSv/h durante unas horas. La integración no está afiliada a la BfS. Datos: Bundesamt für Strahlenschutz (BfS), gratuitos, con la fuente citada.

La misma integración para Francia: Téléray (red de la ASNR).

Requisitos​

  • Gladys 5.3.0 o posterior.
  • Acceso a Internet desde Gladys.
  • La ubicación de su casa (Ajustes → Casas), para seguir automáticamente la sonda más cercana.

Configuración​

  1. Instale la integración: Integraciones → Instalar desde GitHub, dirección https://github.com/guim31/gladys-odl.
  2. Sondas: déjelo vacío para seguir la sonda más cercana a su casa, o escriba hasta 5 identificadores de sonda (9 cifras), nombres o códigos postales separados por comas (p. ej. 091620001, 80637, Feldberg). Un código postal da su sonda en servicio situada más abajo. Dos botones ayudan: Buscar las sondas alrededor de una casa lista las más cercanas con su identificador y su distancia, Buscar sondas las de un código postal (o sus primeras cifras) o cuyo nombre contiene un texto.
  3. Umbral de alerta: la tasa que activa «Tasa de dosis por encima del umbral», 0,3 µSv/h por defecto (vea Escenas).
  4. Idioma: idioma de los nombres de las funciones (fijados al añadir un dispositivo) y de los textos.
  5. Abra la pestaña Descubrimiento y añada la sonda.

Dispositivos​

Un dispositivo por sonda, con su nombre (p. ej. München-Neuhausen (ODL)):

FunciónQué es
Tasa de dosis (µSv/h)tasa de dosis gamma ambiental de la última hora, en microsieverts por hora
Parte cósmica (µSv/h)la parte de la radiación cósmica, estimada por la BfS (crece con la altitud)
Parte terrestre (µSv/h)el resto: radiación del suelo y del aire (radón), la parte que varía
Hora de la mediciónfin de la hora de medición (la BfS la publica de 60 a 90 minutos después)
Estado de la sondaMedición comprobada, Aún no comprobada, Sonda en pruebas, Sonda fuera de servicio, Sin medición reciente

Gladys no tiene unidad de radiación: la unidad está en el nombre de las funciones. Una medición de más de 4 horas no se publica como actual (el estado indica entonces «Sin medición reciente»). Una sonda fuera de servicio no publica ningún valor.

Widget​

Tasa de dosis ODL: la tasa y sus partes cósmica y terrestre en mosaicos (la tasa se pone en rojo al llegar al umbral de alerta), la curva de las últimas 24 horas, y la hora, el estado, el umbral y la fuente. Ajustes: la sonda (vacío: la primera añadida) y dos interruptores para ocultar la curva o las líneas de debajo.

Escenas​

  • Disparador Tasa de dosis por encima del umbral: la tasa horaria de una sonda en servicio alcanza el umbral de alerta de la configuración, comprobada o aún no (mejor una alerta rápida que una tardía). Se activa una vez, al superarlo; el umbral sigue superado hasta que la tasa baja 0,02 µSv/h por debajo. Nunca en la primera lectura de una sonda, ni para una sonda en pruebas. Variables: nombre de la sonda, tasa de dosis, umbral, fin de la hora de medición.
  • Disparador Tasa de dosis de nuevo normal: tras una superación, la tasa vuelve a estar al menos 0,02 µSv/h por debajo del umbral.
  • Acción Obtener la tasa de dosis de una sonda: los últimos valores y una frase lista (summary) para una notificación; status vale checked, not_checked, test_operation, defective o no_recent.

El umbral por defecto, 0,3 µSv/h, es prudente: en Alemania, los niveles naturales están entre 0,05 y 0,18 µSv/h (mediana de unos 0,11), hasta unos 0,25 µSv/h en la cima de una montaña, y una lluvia fuerte puede añadir hasta 0,1 µSv/h durante unas horas. Por lo tanto, 0,3 µSv/h rara vez se alcanza sin una causa real; 0,2 µSv/h se activará con la lluvia en algunas sondas. Los dispositivos también dan sus valores a las condiciones de escena habituales, para un umbral propio.

Ejemplos de escenas​

  • Avisarme cuando la tasa sea alta: disparador «Tasa de dosis por encima del umbral», luego «Obtener la tasa de dosis de una sonda» y una notificación con su resumen.
  • Un informe semanal: una escena programada, «Obtener la tasa de dosis de una sonda», y luego un mensaje con el resumen.

Solución de problemas​

  • «Ninguna sonda»: indique la ubicación de una casa (Ajustes → Casas) o escriba una sonda en la configuración.
  • «Sondas desconocidas»: no se encontró el identificador, el nombre o el código postal; use los botones de búsqueda y copie el identificador.
  • «La BfS no responde»: las mediciones se vuelven a leer cada 20 minutos.
  • «Sin medición reciente»: la sonda no ha publicado nada desde hace 4 horas (mantenimiento, transmisión). Los valores vuelven con su siguiente medición.
  • «Sonda fuera de servicio»: la BfS marca la sonda como averiada; elija una vecina hasta que la reparen.

Límites​

  • Un valor por hora, publicado de 60 a 90 minutos después de su hora: la integración lee cada 20 minutos (una petición para todas las sondas seguidas) y la lista de sondas una vez al día.
  • 5 sondas como máximo.
  • Las partes cósmica y terrestre son estimaciones de la BfS; algunas sondas no las proporcionan.
  • Las mediciones de Safecast no están incluidas (una posible continuación).
  • Los nombres de las funciones de un dispositivo se fijan al añadirlo; cambiar el idioma después no los renombra.

Parámetros de configuración​

Estos son los parámetros que BfS ODL te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Sondas ODLsectionNoLee el servicio de datos abiertos de la Oficina Federal alemana de Protección Radiológica (sin cuenta). Datos © BfS. No es un sistema de alerta oficial ni está afiliado a la BfS.
SondasstringNoIdentificadores, nombres o códigos postales de las sondas que desea seguir, separados por comas, 5 como máximo. Vacío: la sonda más cercana a su casa. Los botones de abajo las listan.
Umbral de alertaselectNoTasa de dosis que activa «Tasa de dosis por encima del umbral». Niveles naturales: de 0,05 a 0,18 µSv/h, hasta 0,25 en montaña; la lluvia puede añadir 0,1 durante unas horas.
IdiomaselectNoIdioma de los nombres de las funciones (fijados al añadir un dispositivo), de los textos de estado y de los textos de escena.

Cómo instalar BfS ODL en Gladys​

  1. En Gladys, abre Integraciones: BfS ODL aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-odl: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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-odl.

BfS ODL requiere Gladys >=5.3.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​

BfS ODL 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂