Elsys es una empresa sueca que fabrica sensores LoRaWAN compactos y alimentados por batería, muy usados en edificios inteligentes, oficinas y monitoreo ambiental. Las series ERS (Environment & Room Sensor), ELT (External Light Sensor), EMS (Environment Monitoring Sensor) y ESENS cubren temperatura, humedad, CO2, luz, ocupación y entradas de sondas externas.
Los sensores de Elsys son plug-and-play desde el punto de vista del hardware: los enciendes y empiezan a transmitir. El trabajo de integración consiste en conectar esos datos LoRaWAN a una plataforma de aplicaciones. Esta guía muestra cómo enrutar los datos de los sensores Elsys a través de TTN hacia TagoIO para almacenamiento, dashboards y alertas.
Lo que necesitas antes de empezar
- Una cuenta de TagoIO (plan gratuito disponible)
- Sensores Elsys (ERS CO2, ERS Sound, ELT-2, EMS o similares)
- Un gateway LoRaWAN con cobertura de TTN
- Una cuenta de TTN en console.cloud.thethings.network
Paso 1: Registra los sensores Elsys en TTN
Los sensores Elsys aparecen en el Device Repository de TTN, lo que simplifica el registro.
- En tu aplicación de TTN, haz clic en Register end device.
- Busca Elsys en el device repository y selecciona tu modelo (por ejemplo, ERS CO2).
- Selecciona la versión del firmware y el plan de frecuencia.
- Ingresa el JoinEUI, DevEUI y AppKey que figuran en la etiqueta del sensor o en la app Elsys Sensor Settings (configuración por Bluetooth).
- Guarda el dispositivo.
Los sensores Elsys soportan OTAA por defecto. En el primer encendido tras el registro, se unirán a la red y empezarán a enviar datos.
Paso 2: Crea un dispositivo en TagoIO
- Inicia sesión en admin.tago.io.
- Ve a Devices → Add Device.
- Busca The Things Network v3 y selecciónalo.
- Nombra el dispositivo para que coincida con tu sensor Elsys (por ejemplo,
elsys-ers-co2-floor-3). - Copia la Webhook URL y el Authorization Token.
Documentación de dispositivos: docs.tago.io/docs/tagoio/devices
Paso 3: Agrega el webhook de TTN a TagoIO
- En tu aplicación de TTN, ve a Integrations → Webhooks → + Add webhook → Custom webhook.
- Configura la Base URL con la Webhook URL de TagoIO.
- Agrega el header:
Authorization: YOUR_TAGOIO_TOKEN. - Habilita Uplink message.
- Guarda.
Paso 4: Escribe el Payload Parser
Elsys usa un formato de payload binario bien documentado, llamado Elsys Payload Specification. Cada punto de datos consiste en un identificador de tipo de 1 byte seguido de los bytes del valor. Elsys publica un decodificador de referencia en GitHub.
Aquí tienes un parser para el ERS CO2 (temperatura, humedad, luz, movimiento, CO2):
const raw = Buffer.from(payload.uplink_message.frm_payload, "base64");
const result = [];
let i = 0;
while (i < raw.length) {
const type = raw[i++];
switch (type) {
case 0x01: // Temperature (2 bytes, signed, /10)
result.push({ variable: "temperature", value: raw.readInt16BE(i) / 10, unit: "C" });
i += 2;
break;
case 0x02: // Humidity (1 byte, unsigned, /2)
result.push({ variable: "humidity", value: raw.readUInt8(i) / 2, unit: "%" });
i += 1;
break;
case 0x05: // Light (2 bytes)
result.push({ variable: "light", value: raw.readUInt16BE(i), unit: "lux" });
i += 2;
break;
case 0x06: // Motion (1 byte)
result.push({ variable: "motion", value: raw.readUInt8(i) });
i += 1;
break;
case 0x08: // CO2 (2 bytes)
result.push({ variable: "co2", value: raw.readUInt16BE(i), unit: "ppm" });
i += 2;
break;
case 0x0B: // Battery voltage (2 bytes, /1000)
result.push({ variable: "battery_voltage", value: raw.readUInt16BE(i) / 1000, unit: "V" });
i += 2;
break;
default:
i = raw.length; // Stop on unknown type
}
}
payload = result;
Este parser maneja los tipos de sensor Elsys más comunes. Agrega casos para tipos adicionales (sonido, presión, GPS) según los necesites, usando la especificación de payload de Elsys.
Documentación del Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser
Paso 5: Verifica en el Live Inspector
Abre el Live Inspector en TagoIO. Provoca una lectura desde tu sensor Elsys (en la mayoría de los modelos, una pulsación corta del botón fuerza una transmisión inmediata). Confirma que todas las variables se decodifican correctamente.
Documentación del Live Inspector: docs.tago.io/docs/tagoio/devices/live-inspector
Paso 6: Gestiona una flota de sensores Elsys
Los sensores Elsys suelen desplegarse en grupos: un piso, un edificio o un campus. Usa los Blueprint Dashboards de TagoIO para gestionar esto a escala.
Cómo funcionan los Blueprint Dashboards con Elsys:
- Crea un dispositivo de TagoIO por cada sensor Elsys.
- Etiqueta cada dispositivo por ubicación:
building:a,floor:3,room:conference-01. - Crea un Blueprint Dashboard que use un selector de tags para traer los datos del dispositivo seleccionado en cada momento.
- Cada sensor obtiene su propia vista de dashboard con el mismo layout: sin duplicación.
Documentación de Blueprint Dashboard: docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard
Paso 7: Configura alertas
Usa las Actions para:
- CO2 por encima de 1000 ppm en cualquier sala → notificar a mantenimiento por email
- Temperatura fuera del rango de 19-26 °C → alerta de HVAC
- Movimiento detectado fuera del horario laboral → notificación de seguridad
- Voltaje de batería por debajo de 2.5 V → recordatorio de mantenimiento
Documentación de Actions: docs.tago.io/docs/tagoio/actions
Ejemplos de casos de uso
Calidad del aire en oficinas inteligentes
Sensores ERS CO2 en cada sala de reuniones y zona abierta. El Blueprint Dashboard de TagoIO da al equipo de instalaciones una vista de CO2, temperatura y humedad piso por piso. Las Actions activan la ventilación cuando el CO2 sube por encima de 1000 ppm. Un script de Analysis genera automáticamente un reporte semanal de calidad del aire.
Correlación entre energía y ocupación
Sensores ERS con detección de movimiento. Los scripts de Analysis de TagoIO cruzan los datos de ocupación con las lecturas del medidor de energía, generando reportes de correlación que muestran el costo energético por hora ocupada y por zona.
Monitoreo de cumplimiento
Sensores EMS en zonas de almacenamiento de alimentos y áreas farmacéuticas. TagoIO guarda las lecturas con marcas de tiempo para las pistas de auditoría regulatoria. Los reportes se generan automáticamente para las presentaciones de cumplimiento.
Llevándolo más lejos con IA
El servidor MCP de TagoIO conecta Claude y otros asistentes de IA con tus datos de Elsys. Haz preguntas en lenguaje natural: “¿Qué salas tuvieron CO2 por encima de 1000 ppm esta semana?” o “¿Cuál es la temperatura promedio de todos los sensores del Piso 2?”.
Documentación de MCP: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration
Resumen
Los sensores Elsys se conectan a TagoIO a través de TTN en cuatro pasos: registrarlos en TTN, crear un dispositivo TTN en TagoIO, agregar el webhook y escribir el payload parser de Elsys. El parser sigue la especificación de formato binario publicada por Elsys. Una vez que los datos fluyen, TagoIO se encarga del almacenamiento, de los Blueprint Dashboards para la gestión de la flota y de las alertas en tiempo real.
- Dispositivos de TagoIO: docs.tago.io/docs/tagoio/devices
- Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser
- Blueprint Dashboards: docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard
- Actions: docs.tago.io/docs/tagoio/actions
- MCP: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration


