Adicionar um gateway ao AWS IoT Core for LoRaWAN - AWS IoT Wireless
Adicionar um gateway usando o consoleAdicione um gateway usando a API

Adicionar um gateway ao AWS IoT Core for LoRaWAN

Você pode adicionar o gateway ao AWS IoT Core for LoRaWAN usando o console ou a CLI.

Antes de adicionar o gateway, recomendamos que você considere os fatores mencionados na seção Antes de integrar o gateway do Integre os gateways ao AWS IoT Core for LoRaWAN.

Se você estiver adicionando o gateway pela primeira vez, recomendamos usar o console. Se quiser adicionar o gateway usando a CLI, você já deve ter criado o perfil do IAM necessário para que o gateway possa se conectar ao AWS IoT Core for LoRaWAN. Para obter informações sobre como criar o perfil, consulte Adicione um perfil do IAM para permitir que o Servidor de Configuração e Atualização (CUPS) gerencie as credenciais do gateway.

Adicionar um gateway usando o console

Navegue até a página de introdução do AWS IoT Core for LoRaWAN do console de AWS IoT, escolha Começar e, em seguida, escolha Adicionar gateway. Se você já adicionou um gateway, escolha Exibir gateway para ver o gateway que foi adicionado. Se quiser adicionar mais gateways, escolha Adicionar gateway.

  1. Dê detalhes do gateway e informações sobre a faixa de frequência

    Use a seção Detalhes do gateway para dar informações sobre os dados de configuração do dispositivo, como o EUI do gateway e a configuração da faixa de frequência.

    • EUI do gateway

      O EUI (Identificador Único Estendido) do dispositivo de gateway individual. O EUI é um código alfanumérico de 16 dígitos, por exemplo, c0ee40ffff29df10, que identifica exclusivamente um gateway na rede LoRaWAN. Essas informações são específicas do modelo de gateway e você pode encontrá-las no dispositivo de gateway ou no manual do usuário.

      nota

      O EUI do gateway é diferente do endereço MAC Wi-Fi que você pode ver impresso no dispositivo de gateway. O EUI segue um padrão EUI-64 que identifica exclusivamente o gateway e, portanto, não pode ser reutilizado em outras Conta da AWSs e regiões.

    • Faixa de frequência (RFRegion)

      A faixa de frequência do gateway. Você pode escolher entre US915, EU868, AU915 ou AS923-1, dependendo do que o gateway suporta e de qual país ou região o gateway está se conectando fisicamente. Para obter mais informações sobre as faixas, consulte Considere a seleção de faixas de frequência LoRa para os gateways e conexão de dispositivos.

  2. Especifique os dados de configuração do gateway sem fio (opcional)

    Esses campos são opcionais e você pode usá-los para dar informações adicionais sobre o gateway e a configuração dele.

    • Nome, descrição e tags para o gateway

      As informações nesses campos opcionais vêm de como você organiza e descreve os elementos no sistema sem fio. Você pode atribuir um Nome ao gateway, usar o campo Descrição para dar informações sobre o gateway e usar Tags para adicionar pares de chave-valor de metadados sobre o gateway. Para obter mais informações sobre como nomear e descrever os recursos, consulte Descrever os recursos do AWS IoT Wireless.

    • Configuração do LoRaWAN usando sub-bandas e filtros

      Se quiser, você também pode especificar dados de configuração do LoRaWAN, como as sub-bandas que você deseja usar e filtros que podem controlar o fluxo de tráfego. Neste tutorial, é possível pular esses campos. Para ter mais informações, consulte Configurar as sub-bandas do gateway e os recursos de filtragem.

  3. Associar qualquer objeto de AWS IoT ao gateway

    Especifique se deseja criar algo de AWS IoT e associá-lo ao gateway. O conteúdo em AWS IoT pode facilitar a pesquisa e o gerenciamento dos dispositivos. Associar algo ao gateway permite que o gateway acesse outros atributos de AWS IoT Core.

  4. Criar e baixar o certificado de gateway

    Para autenticar o gateway para que ele possa se comunicar com segurança com AWS IoT, o gateway LoRaWAN deve apresentar uma chave privada e um certificado para AWS IoT Core for LoRaWAN. Crie um Certificado de gateway para que AWS IoT possa verificar a identidade do o gateway usando o padrão X.509.

    Clique no botão Criar certificado e baixe os arquivos do certificado. Você os usará mais tarde para configurar o gateway.

  5. Copie os endpoints CUPS e LNS e baixe os certificados

    O gateway LoRaWAN deve se conectar a um endpoint CUPS ou LNS ao estabelecer uma conexão com AWS IoT Core for LoRaWAN. Recomendamos usar o endpoint do CUPS, já que ele também oferece gerenciamento de configuração. Para verificar a autenticidade dos endpoints do AWS IoT Core for LoRaWAN, o gateway utilizará um certificado de confiança para cada um dos endpoints CUPS e LNS.

    Clique no botão Copiar para copiar os endpoints do CUPS e do LNS. Você precisará dessas informações mais tarde para configurar o gateway. Em seguida, clique no botão Baixar certificados de confiança do servidor para baixar os certificados de confiança para os endpoints do CUPS e do LNS.

  6. Criar o perfil do IAM para as permissões do gateway

    É necessário adicionar um perfil do IAM para permitir que o Servidor de Configuração e Atualização (CUPS) gerencie as credenciais do gateway.

    nota

    Nesta etapa, crie o perfil IoTWirelessGatewayCertManager. Ignore essas etapas se já tiver criado esse perfil. Execute este procedimento antes que um gateway LoRaWAN tente se conectar ao AWS IoT Core for LoRaWAN. No entanto, você precisa fazer isso apenas uma vez.

    Para criar o perfil do IAM IoTWirelessGatewayCertManager para a conta, clique no botão Criar perfil. Se o perfil já existir, selecione-o na lista suspensa.

    Clique em Enviar para concluir a criação do gateway.

Adicione um gateway usando a API

Se você estiver adicionando um gateway pela primeira vez usando a API ou a CLI, deverá adicionar o perfil do IAM IoTWirelessGatewayCertManager para que o gateway possa se conectar ao AWS IoT Core for LoRaWAN. Para obter informações sobre como criar o perfil, consulte a seção Adicione um perfil do IAM para permitir que o Servidor de Configuração e Atualização (CUPS) gerencie as credenciais do gateway a seguir.

As listas a seguir descrevem as ações de API que executam as tarefas associadas à adição, atualização ou exclusão de um gateway LoRaWAN.

Ações de API do AWS IoT Wireless para gateways AWS IoT Core for LoRaWAN

Para ver a lista completa das ações e dos tipos de dados disponíveis para criar e gerenciar recursos do AWS IoT Core for LoRaWAN, consulte a Referência da API AWS IoT Wireless.

Como utilizar a AWS CLI para adicionar um gateway

É possível utilizar a AWS CLI para criar um gateway sem fio com o comando create-wireless-gateway. O exemplo a seguir cria um gateway de dispositivo LoRaWAN sem fio. Você também pode apresentar um arquivo input.json que contenha detalhes adicionais, como o certificado de gateway e as credenciais de provisionamento.

nota

Também é possível executar esse procedimento com a API usando os métodos na API da AWS que correspondam aos comandos da CLI mostrados aqui. 

aws iotwireless create-wireless-gateway \
    --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \
    --name "myFirstLoRaWANGateway" \
    --description "Using my first LoRaWAN gateway"
    --cli-input-json input.json

Para obter informações sobre as CLIs que você pode usar, consulte Referência da AWS CLI