Tech Insights

Como conectar sensores LoRaWAN da Elsys ao TagoIO

Como conectar sensores LoRaWAN da Elsys (ERS, ELT, EMS, ESENS) ao TagoIO. Aborda integração com a TTN, decodificação de payload do Elsys ERS, gerenciamento de dispositivos por tags e casos de uso de monitoramento de escritórios e prédios inteligentes.

Thiago Lima ·
Como conectar sensores LoRaWAN da Elsys ao TagoIO

A Elsys é uma empresa sueca que fabrica sensores LoRaWAN compactos e alimentados por bateria, muito usados em prédios inteligentes, escritórios e monitoramento ambiental. As séries ERS (Environment & Room Sensor), ELT (External Light Sensor), EMS (Environment Monitoring Sensor) e ESENS cobrem temperatura, umidade, CO2, luz, ocupação e entradas de sondas externas.

Os sensores da Elsys são plug-and-play do ponto de vista do hardware: basta ligar e eles começam a transmitir. O trabalho de integração consiste em conectar esses dados LoRaWAN a uma plataforma de aplicação. Este guia mostra como encaminhar os dados dos sensores Elsys pela TTN até o TagoIO para armazenamento, dashboards e alertas.

O que você precisa antes de começar

Passo 1: registrar os sensores Elsys na TTN

Os sensores Elsys aparecem no Device Repository da TTN, o que simplifica o registro.

  1. Na sua Application da TTN, clique em Register end device.
  2. Pesquise por Elsys no device repository e selecione o seu modelo (por exemplo, ERS CO2).
  3. Selecione a versão do firmware e o frequency plan.
  4. Informe o JoinEUI, o DevEUI e a AppKey que estão na etiqueta do sensor ou no app Elsys Sensor Settings (configuração via Bluetooth).
  5. Salve o dispositivo.

Os sensores Elsys usam OTAA por padrão. Na primeira vez que forem ligados após o registro, eles entram na rede e começam a enviar dados.

Passo 2: criar um dispositivo no TagoIO

  1. Faça login em admin.tago.io.
  2. Vá em Devices → Add Device.
  3. Pesquise por The Things Network v3 e selecione essa opção.
  4. Dê ao dispositivo um nome que corresponda ao seu sensor Elsys (por exemplo, elsys-ers-co2-floor-3).
  5. Copie a Webhook URL e o Authorization Token.

Documentação de dispositivos: docs.tago.io/docs/tagoio/devices

Passo 3: adicionar o webhook da TTN ao TagoIO

  1. Na sua Application da TTN, vá em Integrations → Webhooks → + Add webhook → Custom webhook.
  2. Defina a Base URL como a Webhook URL do TagoIO.
  3. Adicione o header: Authorization: YOUR_TAGOIO_TOKEN.
  4. Habilite Uplink message.
  5. Salve.

Passo 4: escrever o Payload Parser

A Elsys usa um formato de payload binário bem documentado, chamado Elsys Payload Specification. Cada ponto de dado é composto por um identificador de tipo de 1 byte seguido pelos bytes do valor. A Elsys publica um decodificador de referência no GitHub.

Veja a seguir um parser para o ERS CO2 (temperatura, umidade, luz, movimento, 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;

Esse parser trata os tipos de sensor Elsys mais comuns. Adicione cases para outros tipos (som, pressão, GPS) conforme a necessidade, usando a especificação de payload da Elsys.

Documentação do Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser

Passo 5: verificar no Live Inspector

Abra o Live Inspector no TagoIO. Dispare uma leitura do seu sensor Elsys (na maioria dos modelos, um toque curto no botão força uma transmissão imediata). Confirme que todas as variáveis estão sendo decodificadas corretamente.

Documentação do Live Inspector: docs.tago.io/docs/tagoio/devices/live-inspector

Passo 6: gerenciar uma frota de sensores Elsys

Os sensores Elsys costumam ser implantados em grupos: um andar, um prédio ou um campus. Use os Blueprint Dashboards do TagoIO para gerenciar isso em escala.

Como os Blueprint Dashboards funcionam com a Elsys:

  1. Crie um dispositivo TagoIO para cada sensor Elsys.
  2. Marque cada dispositivo por localização com tags: building:a, floor:3, room:conference-01.
  3. Crie um Blueprint Dashboard que use um seletor de tags para puxar os dados do dispositivo selecionado no momento.
  4. Cada sensor ganha sua própria visualização de dashboard usando o mesmo layout: sem duplicação.

Documentação do Blueprint Dashboard: docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard

Passo 7: configurar alertas

Use Actions para:

  • CO2 acima de 1000 ppm em qualquer sala → avisar a equipe de facilities por e-mail
  • Temperatura fora da faixa de 19 a 26°C → alerta de HVAC
  • Movimento detectado fora do horário comercial → notificação de segurança
  • Tensão da bateria abaixo de 2,5V → lembrete de manutenção

Documentação de Actions: docs.tago.io/docs/tagoio/actions

Exemplos de casos de uso

Qualidade do ar em escritório inteligente

Sensores ERS CO2 em cada sala de reunião e área aberta. O Blueprint Dashboard do TagoIO dá à equipe de facilities uma visão de CO2, temperatura e umidade andar por andar. As Actions acionam a ventilação quando o CO2 passa de 1000 ppm. Um relatório semanal de qualidade do ar é gerado automaticamente por um script de Analysis.

Correlação entre energia e ocupação

Sensores ERS com detecção de movimento. Scripts de Analysis do TagoIO cruzam os dados de ocupação com as leituras do medidor de energia, gerando relatórios de correlação que mostram o custo de energia por hora ocupada em cada zona.

Monitoramento de conformidade

Sensores EMS em áreas de armazenamento de alimentos e farmacêuticas. O TagoIO armazena as leituras com timestamps para trilhas de auditoria regulatória. Os relatórios são gerados automaticamente para envios de conformidade.

Indo além com IA

O servidor MCP do TagoIO conecta o Claude e outros assistentes de IA aos seus dados Elsys. Faça perguntas em linguagem natural: “Quais salas tiveram CO2 acima de 1000 ppm esta semana?” ou “Qual é a temperatura média de todos os sensores do Andar 2?”

Documentação do MCP: docs.tago.io/docs/tagoio/tago-ai/tagoio-mcp-ai-powered-iot-data-integration

Resumo

Os sensores Elsys se conectam ao TagoIO pela TTN em quatro passos: registrar na TTN, criar um dispositivo TTN no TagoIO, adicionar o webhook e escrever o payload parser da Elsys. O parser segue a especificação de formato binário publicada pela Elsys. Assim que os dados começam a fluir, o TagoIO cuida do armazenamento, dos Blueprint Dashboards para gerenciamento de frota e dos alertas em tempo real.

Posts Relacionados

Como conectar gateways LoRaWAN da Kerlink ao TagoIO

Como conectar gateways LoRaWAN da Kerlink ao TagoIO

Jun 2, 2026

Como conectar dispositivos RAK Wireless ao TagoIO

Como conectar dispositivos RAK Wireless ao TagoIO

Jun 2, 2026

Como conectar sensores LoRaWAN da Tektelic ao TagoIO

Como conectar sensores LoRaWAN da Tektelic ao TagoIO

Jun 2, 2026