Guia completo para configurar um gateway LoRaWAN

  • O gateway LoRaWAN atua como uma ponte entre os nós LoRa e os servidores de rede, exigindo uma configuração cuidadosa do hardware, da rede IP e dos parâmetros de rádio.
  • Arquivos como global_config.json e local_config.json definem frequências, GPS, gateway_ID e servidores, e podem até ser gerenciados remotamente usando repositórios do GitHub.
  • A integração com plataformas como TTN e AWS IoT Core para LoRaWAN requer o registro do gateway, dos aplicativos e dos dispositivos finais, além do alinhamento de IDs, chaves e planos de frequência.
  • O monitoramento contínuo por meio de consoles web e APIs permite a detecção de erros de frequência, falhas de conexão e a validação de que os uplinks estão sendo recebidos e processados ​​corretamente.

Configuração do Gateway LoRaWAN

Junte e pique finamente o Configurando um gateway LoRaWAN Pode parecer um pouco intimidante no início: parâmetros de rádio, redes, servidores, certificados, IDs estranhos… mas, na realidade, se você entender cada parte, é um processo bastante lógico. Neste artigo, vamos desde o hardware até o servidor LoRaWAN, incluindo TTN e AWS IoT Core, para lhe dar uma visão geral completa e prática.

Vamos nos basear em exemplos do mundo real, como... Portões RAK (RAK7289, RAK831)Redes públicas como a The Things Network (TTN), soluções em nuvem como o AWS IoT Core para LoRaWAN e configurações de fabricantes como o MOKO serão abordadas. Integraremos todo esse conteúdo em um guia coerente, incluindo avisos de segurança, dicas para encontrar o endereço IP do gateway e informações detalhadas sobre a configuração de rede e rádio.

Conceitos básicos: o que é um gateway LoRaWAN e o que ele faz.

Uma Gateway LoRaWAN É o dispositivo responsável por receber os nós LoRa (sensores, rastreadores, etc.) e encaminhar suas mensagens para um servidor de rede LoRaWAN pela internet (Ethernet, Wi-Fi, LTE/4G, 5G, satélite, etc.). Você pode pensar nele como uma espécie de... torre de celular mas para dispositivos de baixíssima potência.

No nível físico, o gateway integra um ou mais Concentradores LoRa (como o RAK831) capaz de monitorar múltiplos canais em paralelo e diferentes fatores de espalhamento, uma placa de controle (por exemplo, Raspberry Pi ou um SoC embarcado), interfaces de rede (Ethernet, Wi-Fi, LTE) e, frequentemente, GPS para sincronização e a geolocalização aproximada dos nós.

No ecossistema LoRaWAN, o gateway não interpreta o conteúdo dos frames da aplicação: simplesmente encapsular e encaminhar O encaminhador de pacotes envia pacotes para o servidor LoRaWAN (LNS: LoRaWAN Network Server) ou para a infraestrutura de nuvem CUPS/LNS. Portanto, a configuração principal gira em torno dos parâmetros de rádio, identificadores de gateway e o endereço do servidor para o qual os dados serão enviados.

Dependendo da implantação, você poderá usar portais públicos (por exemplo, aqueles na comunidade TTN em áreas urbanas) ou configure seu próprio gateway para cobrir uma área rural, uma fazenda, um campus educacional ou um ambiente industrial onde você precisa de controle total da infraestrutura.

Hardware típico de um gateway LoRaWAN

Para construir ou implementar um gateway, você tem opções que variam de dispositivos comerciais fechados a Kits de desenvolvimento baseados em Raspberry PiUm exemplo bastante representativo é a utilização de um hub RAK831 integrado com um Raspberry Pi.

Um kit de gateway LoRa típico deste estilo geralmente inclui todos os componentes de hardware necessários Para começar sem ter que procurar peças individuais: a placa concentradora LoRaWAN, a placa-mãe, as antenas e os adaptadores. Isso acelera bastante o processo de configuração e evita problemas de compatibilidade.

No caso específico de alguns kits MOKO baseados em RAK831 e Raspberry Pi 3B, a embalagem pode incluir, entre outros itens, um Placa adaptadora GPSAntena GPS, antena LoRa de fibra de vidro com ganho suficiente para instalações em mastro, vários metros de cabo coaxial RG-58, dissipador de calor para a placa concentradora e até mesmo nós de exemplo, como WisNode ou rastreadores LoRa.

A grande vantagem desses kits é que o cartão de memória para Raspberry Pi geralmente já vem incluso. pré-configurado com software de gateway (encaminhador de pacotes, scripts de configuração, etc.), então você não precisa compilar ou baixar nada do GitHub para começar, além de ajustar alguns arquivos de configuração.

Em portais comerciais como o RAK7289Todo o hardware está integrado em um gabinete robusto, próprio para uso externo, com uma antena LoRa e, às vezes, uma antena adicional para LTE/4G. Esses modelos geralmente oferecem uma interface de configuração web bastante intuitiva, de modo que o trabalho se concentra nos parâmetros de rede (IP, DNS etc.) e em direcionar o gateway para o servidor LoRaWAN correto.

Configuração da rede do gateway: IP estático, DHCP e acesso inicial.

Antes de mexer na parte LoRaWAN, você precisa se certificar de que... O gateway está devidamente conectado à rede IP. (LAN ou WAN). Sem conectividade com a internet (ou com o seu servidor local), é inútil que o rádio funcione corretamente.

Em muitos gateways (por exemplo, o RAK7289), a interface de administração é apresentada via web e acessada através de seu Endereço IP na redeVocê pode configurá-lo como um cliente DHCP (que obtém um endereço IP automaticamente do roteador) ou com um endereço IP estático, dependendo da topologia da sua rede.

Se o dispositivo veio da fábrica ou foi configurado por outra organização, ele pode estar no modo Cliente DHCPNesse caso, você precisará descobrir qual endereço IP foi atribuído pelo servidor DHCP do seu roteador ou rede. Para fazer isso, você pode:

  • Consulte diretamente o Lista de clientes DHCP No roteador ou servidor, identifique o gateway pelo seu endereço MAC ou pelo nome do host (por exemplo, “RAK7289”).
  • Use ferramentas como nmap ou outros scanners de IP para descobrir quais dispositivos estão respondendo em seu segmento de rede.

Alguns portais incluem um ponto de acesso Wi-Fi de gerenciamento Aberto, projetado especificamente para essa configuração inicial. Se você se conectar a essa rede Wi-Fi, o gateway funcionará como um roteador e o endereço IP do gateway padrão no seu computador será o endereço IP de gerenciamento do dispositivo.

Um detalhe importante de segurança: após a conclusão da inicialização, é recomendável desativar gerenciamento de Wi-Fi A menos que seja estritamente necessário, visto que uma rede Wi-Fi aberta e gerenciada representa uma clara vulnerabilidade em ambientes reais.

Na interface de configuração (por exemplo, no menu Rede → Interface WAN de um gateway RAK), você pode escolher entre IP estático e DHCP, definir DNS, máscara de sub-rede, gateway, bem como alterar o credenciais de acesso Por padrão (nome de usuário e senha), você nunca deve alterá-los, pois vêm de fábrica.

Configuração e instalação do gateway na The Things Network (TTN)

Depois que seu gateway tiver acesso à internet, a próxima etapa em muitas implantações comunitárias ou de laboratório é Integre-o com a TTN (The Things Network)., uma rede LoRaWAN gratuita e pública, ideal para projetos educacionais, testes e pequenas implantações.

O processo habitual começa com a criação de uma conta no site da TTN e o acesso ao console A partir do ícone do perfil. Ao fazer login pela primeira vez, o sistema solicitará que você escolha sua região (por exemplo, Europa, América do Norte etc.) e, a partir daí, você poderá acessar a seção "Aplicativos" ou "Gateways". Para registrar um gateway, você precisará acessar especificamente a opção "Acessar Gateways".

No console TTN, ao pressionar o botão Portal de registroVocê precisará fornecer algumas informações: o ID do gateway, seu EUI exclusivo e o plano de frequência para sua região. O EUI do gateway geralmente está disponível na interface web ou no firmware do dispositivo, normalmente na seção de configurações da rede LoRa.

É essencial que o O ID do gateway definido no TTN deve corresponder ao configurado no dispositivo.especialmente se a documentação do fabricante assim o exigir. Além disso, você precisará selecionar o plano de frequência apropriado (por exemplo, EU868 para a Europa), que define os canais disponíveis e os parâmetros de rádio compatíveis com as regulamentações do seu país.

Após o registro do gateway no TTN, a configuração no Console estará quase concluída. O TTN exibirá o status do gateway (conectado ou não) quando o dispositivo começar a enviar pacotes para o servidor. encaminhador de pacotes TTN utilizando o endereço do servidor correspondente.

Configuração do encaminhador de pacotes e parâmetros LoRaWAN

A interface do gateway (menu Rede LoRa → Configurações de Rede → Encaminhador de Pacotes ou similar) é onde o parâmetros de conexão do servidor LoRaWANEsta seção serve de ponte entre o mundo do rádio LoRa e o servidor de rede.

O encaminhador de pacotes é configurado especificando-se o Endereço do servidor (por exemplo, o roteador TTN ou um roteador personalizado, como router.us.mokolora.network em implantações MOKO), bem como as portas de upstream e downstream (serv_port_up e serv_port_down). Cada servidor configurado também pode ser ativado ou desativado usando um sinalizador típico, como serv_enabled.

Nos gateways baseados em MOKO e Raspberry Pi, muitos desses parâmetros são armazenados em arquivos JSON, como por exemplo: global_config.json y local_config.json, que definem respectivamente a configuração genérica da região e os dados específicos do gateway (ID, localização, servidores, etc.).

O arquivo global_config.json geralmente inclui o bloco gateway_conf com configurações para GPS e sincronização, por exemplo:

{"gateway_conf":{"GPS":true,"gps_tty_path":"/dev/ttyAMA0","fake_gps":false}}

Embora o arquivo local_config.json armazene dados como ID do gateway, coordenadas (ref_latitude, ref_longitude, ref_altitude), e-mail de contato, descrição e a lista de servidores aos quais o encaminhador de pacotes se conecta, cada um com seu server_address, serv_port_up, serv_port_down e serv_enabled.

Gerenciamento de arquivos de configuração e gateway_ID

Em sistemas do tipo Raspberry Pi com MOKO, um aspecto interessante é como ele Gera e gerencia o gateway_IDGeralmente, é calculado a partir do endereço MAC da interface de rede (por exemplo, eth0) usando um script que o transforma em um identificador EUI64, inserindo "FFFE" entre os caracteres e capitalizando o resultado.

Esse gateway_ID é então usado no arquivo local_config.json para identificar exclusivamente o gateway para o servidor LoRaWAN. Além disso, muitas implementações dependem de um esquema de configuração remota baseado em um repositório do GitHub onde os arquivos global_config.json para cada região e os arquivos local_config.json para gateways específicos são publicados.

O mecanismo funciona da seguinte forma: ao iniciar, o concentrador LoRa baixa o arquivo de configuração correspondente ao seu gateway_ID do GitHub, verifica se houve alterações desde a última inicialização e, caso detecte uma nova versão, a sincroniza criando um novo arquivo de configuração. link simbólico Do arquivo bin/local_config.json para o arquivo do repositório clonado.

Se você quiser aproveitar este sistema, você pode Faça o upload do seu próprio arquivo de configuração para o repositório remoto.Ao nomeá-lo com o gateway_ID (por exemplo, MFP254862KEF1034.json), faça um fork, envie uma solicitação de pull para o repositório principal e, uma vez aceita, seu gateway baixará automaticamente essa configuração em inicializações subsequentes.

Isso permite que parâmetros críticos (servidores, frequências, descrição, detalhes de contato) sejam atualizados sem acesso físico a cada gateway, desde que ele possua conectividade de internet e o software de sincronização foi ativado.

Configurações regionais, canais e erros de frequência

Um aspecto que gera muitas dúvidas na configuração de gateways LoRaWAN é a configuração de frequência regionalCada país ou área geográfica possui bandas específicas habilitadas para LoRa (por exemplo, 868 MHz na Europa, 915 MHz em certas regiões da América, etc.) e os servidores de rede validam se os pacotes chegam nas frequências permitidas.

Os arquivos de configuração global para o gateway (global_config.json) definem o canais de rádio e parâmetros (frequências, largura de banda, fator de espalhamento, etc.) para cada região. Repositórios públicos com configurações predefinidas para vários planos regionais estão disponíveis no GitHub, o que simplifica bastante a implantação.

Se a configuração do seu gateway não corresponder à do servidor ao qual você está se conectando, você poderá encontrar erros como: “Pacote REJEITADO, frequência incompatível”Por exemplo, o gateway pode enviar pacotes em 868.3 MHz enquanto o servidor está aguardando pacotes na faixa de 890-975 MHz, gerando erros no log do encaminhador de pacotes.

Para evitar esses erros, certifique-se de baixar o O arquivo global_config.json deve estar correto para a sua região.e que seu servidor (TTN, MOKO, AWS IoT Core) esteja configurado com o mesmo plano de frequência. Você também deve verificar se os nós finais (rastreadores, sensores, etc.) usam a mesma banda definida no gateway e no servidor.

Em países como a China, por exemplo, são empregadas configurações específicas com bandas e canais diferentes dos usados ​​na Europa, portanto, não basta simplesmente copiar qualquer exemplo da internet; é preciso usar o arquivo específico associado à sua área geográfica para que tudo se encaixe.

Conectando gateways LoRaWAN ao AWS IoT Core

Em implantações mais avançadas, você pode integrar seus gateways diretamente com AWS IoT Core para LoRaWAN, utilizando os recursos de nuvem da Amazon para gerenciamento de dispositivos, coleta de dados e processamento de mensagens.

O fluxo geral consiste em registrar o gateway no AWS IoT Core para LoRaWAN, obter as informações necessárias (certificados, URLs de endpoint) e, em seguida, configurar o dispositivo gateway para se conectar ao... ponto final CUPS ou LNS da AWS, de acordo com o protocolo suportado.

Dependendo do tipo de gateway, a documentação do fornecedor explicará como. Faça o upload dos certificados de confiança. Este guia explica como especificar os caminhos para esses certificados no firmware e como direcioná-los para os URLs do CUPS ou LNS fornecidos pela AWS. É importante seguir este guia com precisão, pois a autenticação TLS é obrigatória.

Em gateways compatíveis com o protocolo CUPS, você precisará especificar a URL do endpoint CUPS, que terá um formato semelhante a: prefix.cups.lorawan.region.amazonaws.com:443. Em gateways compatíveis com LNS, a URL será algo como: https://prefix.lns.lorawan.region.amazonaws.com:443, sempre usando o prefixo. porta 443 e conexão segura.

Após o carregamento dos certificados e a configuração dos endpoints, o gateway começará a se comunicar com o servidor. AWS IoT Core para LoRaWAN Você pode verificar o status (conectado, último uplink recebido, etc.) no console da web ou por meio da API GetWirelessGatewayStatistics, que retorna informações como ConnectionStatus e LastUplinkReceivedAt em formato JSON.

Utilizando o console e a API da AWS para monitorar o status do gateway.

Após conectar o gateway ao AWS IoT Core para LoRaWAN, a plataforma oferece diversas maneiras de Verifique se tudo está funcionando corretamente.A opção mais imediata é o console da web do AWS IoT, onde você encontrará uma seção específica para Gateways.

No console, ao selecionar seu gateway na página Gateways, um bloco será exibido. Detalhes específicos do LoRaWANAli você pode ver o status da conexão, juntamente com a data e hora do último uplink recebido, permitindo que você verifique rapidamente se o gateway está ativo e se comunicando com a nuvem.

Se preferir automatizar o monitoramento, você pode usar o API GetWirelessGatewayStatisticsEsta operação não requer um corpo de requisição e retorna um JSON que indica, por exemplo, o ConnectionStatus (Conectado/Desconectado), o LastUplinkReceivedAt com o carimbo de data/hora e o WirelessGatewayId correspondente ao dispositivo.

Um exemplo de resposta seria algo como: {"ConnectionStatus":"Connected","LastUplinkReceivedAt":"2021-03-24T23:13:08.476015749Z","WirelessGatewayId":"30cbdcf3-86de-4291-bfab-5bfa2b12bad5"}, que você pode integrar às suas ferramentas de monitoramento ou painéis personalizados.

Dessa forma, tanto pelo console quanto pela API, você tem maneiras muito claras de detectar falhas de conectividadeInatividade prolongada do gateway ou problemas de configuração que impedem que os links de uplink cheguem corretamente ao AWS IoT Core.

Registro de aplicativos e dispositivos finais no TTN

Voltando ao ambiente TTN, depois de o gateway estar operacional e registrado, ainda há mais um passo fundamental: Registre o aplicativo e os dispositivos finais. (nós, rastreadores, sensores). O simples fato de o gateway aparecer como conectado no TTN não significa que você já esteja recebendo dados dos seus nós.

No Console TTN, acesse a seção “Aplicativos” e crie um novo aplicativo, atribuindo-lhe um nome/ID. Dentro desse aplicativo, você usará o botão de “registrar dispositivo final” Para registrar cada nó LoRaWAN, você pode preencher os dados manualmente ou usar modelos, dependendo do tipo de dispositivo.

Os principais parâmetros incluem DeverEUI, JoinEUI (APP-EUI) e AppKeyAlgumas ferramentas, como o próprio console da TTN, permitem Gere automaticamente o DevEUI e a AppKey. por meio de botões de geração, simplificando a inicialização ao usar nós genéricos ou desenvolvimentos personalizados.

Para o JoinEUI, em certos casos você pode definir praticamente qualquer valor, desde que o mantenha consistente com o configuração do dispositivo (Por exemplo, na Ferramenta de Configuração Loko, o parâmetro APP-EUI corresponde ao JoinEUI no TTN). As chaves restantes devem corresponder exatamente entre o console e o firmware do nó.

Após o registro do dispositivo final, você pode acessar a seção de formatadores de carga útil e escolher opções como: CaienaLPP para decodificação de uplink. Isso permite que os dados sejam representados em formatos mais amigáveis ​​ao usuário e facilita a integração com painéis, bancos de dados e sistemas de visualização.

Exemplo prático com rastreadores e ferramentas de configuração

Um exemplo bastante comum no mundo real é o uso de Rastreadores GPS LoRaWAN Para localizar pessoas, veículos ou bens, é necessário enviar periodicamente suas coordenadas pela rede. Dispositivos como o Dragino TrackerD ou o Loko Air ilustram muito bem esse processo.

Em um contexto educacional, por exemplo, vários rastreadores podem ser registrados no mesmo aplicativo TTN, aproveitando o fato de que cada um deles já vem com credenciais exclusivas (DevEUI, AppEUI/JoinEUI, AppKey), que estão documentados no seu manual ou na etiqueta do dispositivo. Todos estão associados ao mesmo aplicativo, mas são identificados individualmente.

Para configurar parâmetros avançados do rastreador (frequência de envio de coordenadas, duração do alarme de pânico, etc.), o dispositivo pode ser conectado via USB e uma interface serial pode ser usada a 115200 baud, enviando dados. comandos AT predefinidosAlguns modelos não aceitam entradas "tecla por tecla"; em vez disso, o comando inteiro deve ser digitado de uma só vez para ser interpretado corretamente.

No caso de unidades como o Loko Air, a ferramenta Ferramenta de Configuração Loko Ele permite ler a configuração atual, ativar o modo LoRaWAN e preencher os três parâmetros essenciais (JoinEUI/AppEUI, DevEUI e AppKey) para que correspondam às informações de ativação do dispositivo final na The Things Network.

Após aplicar as configurações e reiniciar o dispositivo, se o gateway estiver funcionando corretamente e dentro do alcance, você deverá começar a ver tráfego ao vivo Na seção Dispositivos Finais do TTN, incluindo mensagens com payloads decodificados e a localização do rastreador no mapa, se o formato permitir.

Além disso, as informações exibidas no console TTN podem ser integradas a painéis públicos, como... Datacakeque permitem converter dados brutos de LoRaWAN em visualizações fáceis de usar, painéis compartilháveis ​​ou placares para projetos educacionais e pilotos de IoT.

Com toda essa jornada, do hardware à nuvem, incluindo TTN, AWS e o ajuste fino da configuração de rádio, fica claro que um gateway LoRaWAN não é apenas "uma antena", mas sim a solução completa para o problema. ponto nevrálgico que conecta o mundo físico dos sensores com as plataformas de dados onde o valor do projeto é efetivamente gerado.

Parágrafo final

Uma vez compreendido o funcionamento interno — hardware RAK831 ou RAK7289, arquivos global_config e local_config, sincronização remota via GitHub, configuração de IP e desativação do Wi-Fi de gerenciamento, configuração e parametrização do TTN, conexão segura com o AWS IoT Core e registro de aplicativos e dispositivos finais, como rastreadores GPS ou unidades Loko Air — torna-se muito mais fácil entender que o Configurando um gateway LoRaWAN Trata-se simplesmente da soma ordenada de várias etapas lógicas, onde a chave é respeitar o plano de frequência regional, alinhar IDs e chaves entre gateway, servidor e nós, e confiar nos consoles e APIs dos diferentes serviços para verificar a todo momento se os uplinks estão chegando e se a infraestrutura LoRaWAN está se comportando conforme o esperado em sua implementação real.