A Seeed SenseCAP fabrica alguns dos sensores LoRaWAN industriais mais usados do mercado. A série S21xx cobre temperatura, umidade, CO2, luz, pressão barométrica, umidade do solo e muito mais, tudo em invólucros à prova de intempéries homologados para uso externo.
Os sensores SenseCAP vêm pré-configurados para ingressar em qualquer rede LoRaWAN padrão. Embora a Seeed opere seu próprio portal SenseCAP, você pode contorná-lo por completo e enviar os dados direto para o TagoIO via The Things Network ou qualquer servidor de rede LoRaWAN que suporte webhooks HTTPS.
Este guia cobre a integração completa: do registro de um sensor SenseCAP na TTN até a visualização de dados limpos e decodificados em um dashboard do TagoIO.
O que você precisa antes de começar
- Uma conta no TagoIO (plano gratuito disponível)
- Um sensor Seeed SenseCAP (S2101, S2103, S2104, S2105, S2107 ou outro dispositivo S21xx similar)
- Um gateway LoRaWAN compatível com a TTN ou com o servidor de rede de sua preferência
- Uma conta na The Things Network (TTN) em console.cloud.thethings.network
Como os sensores SenseCAP se comunicam
Os sensores SenseCAP S21xx usam a comunicação LoRaWAN Classe A padrão. Eles enviam uplinks em intervalos configuráveis (15 minutos por padrão, ajustáveis para até 1 minuto via comandos AT ou pelo app SenseCAP Mate).
Cada uplink é um payload binário. O formato do payload está documentado no repositório do decodificador Seeed SenseCAP no GitHub. Você vai precisar desse decodificador para escrever o payload parser do TagoIO.
Passo 1: Registre o sensor SenseCAP na TTN
- Faça login em console.cloud.thethings.network.
- Abra ou crie uma Application.
- Clique em Register end device.
- Selecione Enter end device specifics manually.
- Defina o plano de frequência para a sua região (EU868, US915, etc.).
- Defina a versão do LoRaWAN como 1.0.3 (usada pelo SenseCAP S21xx).
- Insira o JoinEUI (AppEUI), o DevEUI e a AppKey que estão na etiqueta do sensor SenseCAP ou no app SenseCAP Mate.
- Salve o dispositivo.
O sensor ingressará na rede TTN na próxima transmissão.
Passo 2: Crie um device no TagoIO
- Faça login em admin.tago.io.
- Clique em Devices → Add Device.
- Busque por The Things Network v3 e selecione essa opção.
- Dê ao device um nome que corresponda ao seu sensor SenseCAP.
- Copie a Webhook URL e o Authorization Token que o TagoIO gera.
Documentação de devices: docs.tago.io/docs/tagoio/devices
Passo 3: Conecte a TTN ao TagoIO via webhook
- Na sua application da TTN, vá em Integrations → Webhooks.
- Clique em Add webhook → Custom webhook.
- Defina a Base URL como a webhook URL do TagoIO.
- Adicione o cabeçalho:
Authorization: <your_token>. - Habilite os eventos de Uplink message.
- Salve.
Passo 4: Escreva o payload parser
Os sensores SenseCAP S21xx enviam um payload binário estruturado. Se você configurar um payload formatter na TTN usando o decodificador fornecido pela Seeed, a TTN decodifica o payload antes de enviá-lo ao TagoIO. Nesse caso, os campos decodificados chegam em payload.uplink_message.decoded_payload.
Opção A: Use o payload formatter da TTN + parser do TagoIO
Configure o decodificador da Seeed como um payload formatter no nível da Application na TTN. Em seguida, no TagoIO, seu parser apenas mapeia os campos decodificados:
const decoded = payload.uplink_message.decoded_payload;
if (!decoded || !decoded.messages) {
payload = [];
return;
}
payload = decoded.messages.map(msg => ({
variable: msg.measurementId.toString().toLowerCase().replace(/ /g, "_"),
value: msg.measurementValue,
unit: msg.unit || ""
}));Opção B: Decodifique os bytes brutos no TagoIO
Se você preferir manter toda a decodificação no TagoIO, leia o payload bruto em base64 a partir de payload.uplink_message.frm_payload e implemente o parser do formato binário da Seeed em JavaScript.
Para um SenseCAP S2101 (temperatura + umidade):
const raw = Buffer.from(payload.uplink_message.frm_payload, "base64");
// Seeed S2101 measurement payload starts at byte 3
const temperature = raw.readInt16LE(3) / 10;
const humidity = raw.readUInt16LE(5) / 10;
payload = [
{ variable: "temperature", value: temperature, unit: "C" },
{ variable: "humidity", value: humidity, unit: "%" }
];Ajuste os offsets de bytes conforme o modelo do sensor usando a especificação oficial do decodificador da Seeed.
Documentação do payload parser: docs.tago.io/docs/tagoio/devices/payload-parser
Passo 5: Verifique no Live Inspector
Abra a aba Live Inspector na página do seu device no TagoIO. Aguarde o próximo uplink do sensor (ou force um pressionando o botão no dispositivo SenseCAP). Confirme que as variáveis decodificadas aparecem corretamente antes de montar o dashboard.
Documentação do Live Inspector: docs.tago.io/docs/tagoio/devices/live-inspector
Passo 6: Monte o dashboard
Em Dashboards → +, crie um novo dashboard. Para uma implantação ambiental com SenseCAP:
- Gráficos de linha para temperatura, umidade e CO2 ao longo do tempo
- Widgets de gauge mostrando as leituras atuais
- Card de status de alerta indicando se o ambiente está dentro da faixa esperada
- Widget de mapa, caso você tenha vários sensores espalhados por um local
Para implantações com múltiplos sensores, use um Blueprint Dashboard para aplicar um único layout a todos os devices. Cada sensor ganha sua própria visualização de dashboard por meio das tags do device, sem necessidade de duplicação.
Documentação de dashboards: docs.tago.io/docs/tagoio/dashboards
Passo 7: Configure alertas por limiar
Use as Actions para notificar sua equipe quando os valores saírem da faixa esperada. Padrões comuns de alerta com SenseCAP:
- CO2 acima de 1000 ppm em uma sala de reunião → enviar e-mail aos ocupantes
- Umidade do solo abaixo de 15% → enviar SMS à equipe de irrigação
- Temperatura acima de 35°C em uma estufa → acionar um relé de resfriamento por chamada de API
Documentação das Actions: docs.tago.io/docs/tagoio/actions
Exemplos de casos de uso
Agricultura inteligente
Nós SenseCAP S2105 (umidade do solo + temperatura) e S2101 (temperatura do ar + umidade) distribuídos pelas linhas de cultivo. Leituras a cada 15 minutos para o TagoIO. Scripts de análise calculam o déficit de pressão de vapor (VPD) e o gravam de volta como uma variável calculada. A irrigação é acionada automaticamente quando as condições de umidade do solo e de VPD são atendidas.
Monitoramento ambiental em escritórios e escolas
SenseCAP S2103 (CO2, temperatura, umidade) em salas de aula e salas de reunião. Um Blueprint Dashboard dá aos gestores prediais uma visão por sala. As Actions enviam uma notificação no Slack quando os níveis de CO2 em uma sala ultrapassam 1000 ppm, sugerindo ventilação.
Sensoriamento industrial em ambientes externos
SenseCAP S2101 em invólucros à prova de intempéries em um canteiro de obras ou pátio de logística. O TagoIO armazena as leituras e exibe gráficos de tendência. A equipe de instalações usa o dashboard responsivo para celular para conferir as condições pelo telefone.
Indo além com IA
O servidor MCP do TagoIO permite que assistentes de IA como o Claude consultem seus dados do SenseCAP diretamente. Faça perguntas como “Qual zona teve o maior nível de CO2 na semana passada?” ou “Mostre as anomalias de temperatura em todos os sensores nas últimas 48 horas” sem escrever uma consulta manualmente.
Documentação do MCP: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration
Resumo
Os sensores SenseCAP se conectam ao TagoIO através da TTN em quatro passos: registrar na TTN, criar um device no TagoIO com o conector da TTN, configurar o webhook e escrever o payload parser. A parte mais difícil é acertar a decodificação binária: o decodificador open source da Seeed tira boa parte da incerteza desse processo.
Quando os dados começam a fluir, o TagoIO cuida do armazenamento, da visualização e dos alertas sem precisar de nenhuma infraestrutura adicional.
- TagoIO Devices: docs.tago.io/docs/tagoio/devices
- Payload Parser: docs.tago.io/docs/tagoio/devices/payload-parser
- Dashboards: docs.tago.io/docs/tagoio/dashboards
- Blueprint Dashboards: docs.tago.io/docs/tagoio/dashboards/blueprint-dashboard
- Actions: docs.tago.io/docs/tagoio/actions
- TagoIO MCP: docs.tago.io/docs/tagoio/getting-started/tagoio-mcp-ai-powered-iot-data-integration
