Integración domótica ChirpStack, gratuita y de código abierto
Los sensores LoRaWAN de un servidor ChirpStack v4 en Gladys: medidas, señal, sensores mudos.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Los sensores LoRaWAN de su servidor ChirpStack v4 en Gladys: temperatura, humedad, puertas, fugas, CO2, baterías… ChirpStack publica cada mensaje de sus sensores en su broker MQTT, decodificado por el códec del perfil de dispositivo. La integración lee ese broker y convierte cada valor decodificado en una función de Gladys.
Probada con un ChirpStack v4 real (la pila oficial chirpstack-docker, una pasarela y sensores simulados), no con radios LoRa reales: sus comentarios son bienvenidos.
Lo que obtiene
- Un dispositivo por dispositivo LoRaWAN que oye ChirpStack, con el nombre de ChirpStack, en la pestaña Descubrimiento de la integración.
- Una función por valor decodificado por el códec: su tipo se deduce de su
nombre (
temperature,TempC_SHT,humidity,BatV,DOOR_OPEN_STATUS,water_leak,co2…). Un valor cuyo nombre no dice nada es un valor simple. - El RSSI y el SNR de la mejor pasarela, y el nivel de batería del estado LoRaWAN cuando el dispositivo lo da.
- Disparadores de escena, una acción de escena para enviar un mensaje descendente y un widget del panel (más abajo).
Antes de empezar
- Un ChirpStack v4 en marcha con su integración MQTT (activada por
defecto, como en la pila chirpstack-docker). Los eventos deben estar en
JSON:
json=trueen[integration.mqtt]dechirpstack.toml(valor por defecto). - Un códec en el perfil de cada sensor (Device profiles → Codec): a menudo el del repositorio de dispositivos de TTN, que ChirpStack puede importar. Sin códec, el dispositivo solo muestra su señal, y el disparador «mensaje recibido» da el contenido bruto.
- La dirección del broker MQTT donde publica ChirpStack, y sus credenciales si las tiene.
Configuración
- Dirección del broker:
mqtt://(puerto 1883) omqtts://para TLS (puerto 8883). La integración solo necesita leerapplication/#, y escribirapplication/+/device/+/command/downpara los mensajes descendentes. - Nombre de usuario y contraseña: vacíos para un broker anónimo.
- Aceptar un certificado autofirmado: solo
mqtts://. - Prefijo de los temas:
application, salvo sievent_topicse cambió enchirpstack.toml. - Claves corregidas: vea la sección siguiente.
- Mudo después de: un sensor añadido a Gladys que no envía nada durante ese tiempo está «mudo» (disparador, widget). Elíjalo más largo que el intervalo de su sensor más lento: algunos detectores de puerta solo emiten cada pocas horas.
- Idioma de los textos: los nombres de las funciones (fijados al añadir el dispositivo) y los mensajes de las acciones y escenas.
Luego use Comprobar la conexión.
Claves y tipos
Cada valor numérico o booleano del objeto decodificado se convierte en una
función (50 como máximo por dispositivo; objetos anidados hasta tres niveles,
como sensor.co2; listas y textos ignorados). Un valor en palabras solo se
convierte en función para un detector ("open", "closed", "leak",
"normal"…). El tipo deducido la primera vez que se ve una clave se conserva:
una versión posterior nunca lo cambia.
Cuando un tipo está mal deducido, o para ocultar un valor, escriba pares
clave=tipo en Claves corregidas, separados por comas:
TempC_DS=temperature, Work_mode=ignore. La clave se compara sin mayúsculas ni
separadores. Tipos:
- medidas:
temperature(°C),temperature_f(°F),humidity(%),soil_moisture(%),co2(ppm),pressure(hPa),illuminance(lux),battery(%),voltage(V),voltage_mv(mV),current(A),power(W),distance_mm,distance_cm,distance_m,pm25,pm10(µg/m³),noise(dB),counter,number(sin unidad); - detectores:
motion,opening(verdadero = abierto),contact(verdadero = cerrado),leak,smoke,vibration,tamper,binary(cualquier sí/no); ignore: ninguna función.
Una clave corregida modifica el dispositivo: use Actualizar en la pestaña Descubrimiento.
Dispositivos
Abra la pestaña Descubrimiento de la integración: cada dispositivo oído desde el inicio de la integración (y conservado en su volumen de datos entre reinicios) aparece allí, con sus funciones. Añada los que desee. Una clave nueva enviada más tarde por un dispositivo (otro tipo de trama) también aparece, y Actualizar la añade.
Los estados se envían con cada mensaje, solo si cambiaron (y cada 12 horas para un valor estable). Los detectores de puerta siguen la convención de Gladys: abierto o cerrado, tal como se muestra.
Escenas
Disparadores, para los dispositivos añadidos a Gladys (deje el dispositivo vacío para todos):
- Mensaje recibido: cada mensaje, aunque tenga los mismos valores que antes (un botón LoRaWAN, un contador de eventos). Filtro por fPort; la escena lee el fPort, el contador de tramas, el contenido bruto en hexadecimal y el RSSI.
- Sensor mudo: nada recibido durante el plazo configurado (pila, alcance, avería). Una vez por silencio; el plazo vuelve a empezar cuando vuelve el broker MQTT, para que un corte no deje mudos todos los sensores.
- Sensor de vuelta: un sensor mudo vuelve a emitir.
- Sensor reconectado: un join OTAA (reinicio, pila nueva).
Acción Enviar un mensaje descendente: pone en cola bytes para un
dispositivo en ChirpStack (tema command/down). Indique el fPort (1 a 223) y el
contenido en hexadecimal, tal como lo escribe el manual del dispositivo (por
ejemplo 0100FF); «Mensaje confirmado» pide un acuse de recibo al dispositivo.
Un dispositivo de clase A lo recibe tras su próximo mensaje. La integración
debe haber oído el dispositivo una vez (para conocer su aplicación). Nada se
deduce: lo que usted escribe se envía.
Panel
El widget Sensores LoRaWAN lista los sensores añadidos a Gladys, los mudos primero, con su último mensaje y su señal («hace 12 min · -97 dBm»). Ajustes: ocultar la señal, mostrar solo los sensores mudos.
Límites
- ChirpStack v4 (también se lee el formato del Application Server v3, sin probar). Solo eventos JSON, no protobuf.
- Sin lista de los dispositivos de ChirpStack por su API: un dispositivo aparece en cuanto ha enviado algo.
- Dispositivos de solo lectura: una orden pasa por la acción de escena de mensaje descendente, con un contenido que usted mismo escribe.
- Cada mensaje envía algunos estados: el núcleo acepta 300 por minuto, suficiente para decenas de sensores con los intervalos habituales.
- Desarrollada sin hardware de radio LoRa.
Solución de problemas
- Ningún dispositivo en Descubrimiento: use Comprobar la conexión.
Compruebe el prefijo de los temas, que el sensor emite (Devices → Events en
ChirpStack) y que el usuario del broker puede leer
application/#. - «No en JSON»: ponga
json=trueen[integration.mqtt]dechirpstack.tomly reinicie ChirpStack. - Solo RSSI y SNR: el perfil de dispositivo no tiene códec, o el códec falla (Devices → Events → log en ChirpStack).
- Un tipo erróneo: corríjalo en Claves corregidas y luego Actualizar el dispositivo.
- Mensaje descendente no recibido: mire la pestaña Queue del dispositivo en
ChirpStack, y que el usuario del broker puede escribir
command/down. - Registros:
LOG_LEVEL=debugmuestra cada mensaje.
Parámetros de configuración
Estos son los parámetros que ChirpStack te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar ChirpStack | section | No | ChirpStack publica cada mensaje de sus sensores LoRaWAN en su broker MQTT, decodificado por el códec del perfil de dispositivo. La integración lee ese broker; solo publica los mensajes descendentes de sus escenas. |
| Dirección del broker | string | Sí | El broker donde publica ChirpStack: mqtt:// (puerto 1883) o mqtts:// para TLS (puerto 8883). Con chirpstack-docker, es el servicio mosquitto. |
| Nombre de usuario | string | No | Déjelo vacío si el broker acepta clientes anónimos. |
| Contraseña | secret | No | |
| Aceptar un certificado autofirmado | boolean | No | Solo mqtts://: el certificado del broker no se comprueba. |
| Prefijo de los temas | string | No | application, salvo si event_topic se cambió en chirpstack.toml. |
| Sensores | section | No | Cada valor decodificado por el códec se convierte en una función, cuyo tipo se deduce de su nombre (temperatura, humedad, batería, puerta…). Los nombres desconocidos son valores simples. |
| Claves corregidas | string | No | Pares clave=tipo, separados por comas, para un tipo mal deducido o un valor que ignorar. Tipos: vea la documentación. |
| Mudo después de | select | No | Un sensor añadido a Gladys que no emite nada durante ese tiempo está mudo: disparador de escena, widget. |
| Idioma de los textos | select | No | Nombres de las funciones al añadir un dispositivo, mensajes de las acciones y escenas. |
Cómo instalar ChirpStack en Gladys
- En Gladys, abre Integraciones: ChirpStack 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-chirpstack: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-chirpstack.
ChirpStack 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
ChirpStack 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