Como usar o suporte de rede pública

Usar o console de AWS IoT

Vá para o hub Perfis do console do AWS IoT e selecione Adicionar perfil de serviço. Na criação do perfil, selecione Habilitar rede pública.

Uso da API AWS IoT Wireless

Para habilitar o roaming ao criar um perfil de serviço, utilize a operação de API CreateServiceProfile ou o comando create-service-profile da CLI, conforme mostrado no exemplo a seguir.

aws iotwireless create-service-profile \ 
    --region us-east-1 \
    --name roamingprofile1 \ 
    --lorawan '{"AddGwMetadata":true,"PrAllowed":true,"RaAllowed":true}'

A saída da execução desse comando retorna o ARN e o ID do perfil de serviço.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}

Usar o console de AWS IoT

Vá para o hub Perfis do console do AWS IoT e selecione o perfil que você criou. Na guia Configuração do perfil da página de detalhes, você poderá ver RaAllowed PrAllowed definidos como true.

Uso da API AWS IoT Wireless

Para visualizar os parâmetros de roaming ativados por você, use a operação de API GetServiceProfile ou o comando get-service-profile da CLI, conforme exibido no exemplo abaixo.

aws iotwireless get-service-profile \ 
    --region us-east-1 \ 
    --id 12345678-a1b2-3c45-67d8-e90fa1b2c34d

A saída da execução desse comando retorna os detalhes do perfil de serviço, incluindo os valores dos parâmetros de roaming. RaAllowed e PrAllowed.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Name": "roamingprofile1"
    "LoRaWAN": {
        "UlRate": 60,
        "UlBucketSize": 4096,
        "DlRate": 60,
        "DlBucketSize": 4096,
        "AddGwMetadata": true,
        "DevStatusReqFreq": 24,
        "ReportDevStatusBattery": false,
        "ReportDevStatusMargin": false,
        "DrMin": 0,
        "DrMax": 15,
        "PrAllowed": true,
        "RaAllowed": true,
        "NwkGeoLoc": false,
        "TargetPer": 5,
        "MinGwDiversity": 1
    }
}

Integração de dispositivos novos

Caso ainda não tenha integrado seus dispositivos, especifique esse perfil de serviço, que será usado ao adicionar seu dispositivo ao AWS IoT Core for LoRaWAN. O seguinte comando mostra como você pode usar o comando create-wireless-device da CLI para adicionar um dispositivo usando o ID do perfil de serviço criado por você. Para obter informações sobre como adicionar o perfil de serviço utilizando o console, consulte Adicione a especificação do dispositivo sem fio ao AWS IoT Core for LoRaWAN usando o console.

aws iotwireless create-wireless-device --cli-input-json file://createdevice.json

O exemplo a seguir mostra o conteúdo do arquivo createdevice.json.

Conteúdo do createdevice.json

{
    "Name": "DeviceA",  
    "Type": LoRaWAN,
    "DestinationName": "RoamingDestination1",
    "LoRaWAN": {
        "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333",
        "ServiceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
        "OtaaV1_1": {
            "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012",
            "JoinEui": "b4c231a359bc2e3d",
            "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4"
        },
        "DevEui": "ac12efc654d23fc2"
    },
}

A saída da execução desse comando produz o ARN e o ID do dispositivo sem fio.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f",
    "Id": "1ffd32c8-8130-4194-96df-622f072a315f"
}

Atualização de dispositivos existentes

Se já tiver integrado seus dispositivos, é possível atualizar seus dispositivos sem fio existentes para usar esse perfil de serviço. O seguinte comando mostra como você pode usar o comando update-wireless-device da CLI para atualizar um dispositivo usando o ID do perfil de serviço criado por você.

aws iotwireless update-wireless-device \
    --id "1ffd32c8-8130-4194-96df-622f072a315f" \
    --service-profile-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ 
    --description "Using roaming service profile A"

Esse comando não retorna nenhuma saída. É possível usar a API GetWirelessDevice ou o comando get-wireless-device da CLI para obter as informações atualizadas.

Visualizar mensagens de uplink

Ao enviar mensagens de uplink a partir dos seus dispositivos, o AWS IoT Core for LoRaWAN entrega essas mensagens para a sua Conta da AWS usando o destino configurado anteriormente. Essas mensagens serão enviadas a partir do seu dispositivo para a nuvem pela rede da Everynet.

É possível visualizar as mensagens usando o nome da regra do AWS IoT ou usar o cliente MQTT para assinar o tópico MQTT especificado na criação do destino. Para acessar mais informações sobre o nome da regra e outros detalhes do destino que você especificar, consulte Adicionar um destino usando o console.

Para acessar mais informações sobre a visualização de mensagens de uplink e o formato, consulte, Visualizar o formato das mensagens de uplink enviadas a partir de dispositivos LoRaWAN.

Enviar mensagens de downlink

É possível enfileirar e enviar mensagens de downlink para seus dispositivos a partir do console ou usando o comando de API do AWS IoT Wireless, SendDataToWirelessDevice, ou o comando da AWS CLI, send-data-to-wireless-device. Para acessar informações sobre como enfileirar e enviar mensagens de downlink, consulte Formar uma fila de mensagens de downlink para enviar para dispositivos LoRaWAN.

O seguinte código exibe um exemplo de como você pode enviar uma mensagem de downlink usando o comando send-data-to-wireless-device da CLI. Você especifica o ID do dispositivo sem fio para receber os dados, a carga, se deve usar o modo de reconhecimento e os metadados sem fio.

aws iotwireless send-data-to-wireless-device \
    --id "1ffd32c8-8130-4194-96df-622f072a315f" \
    --transmit-mode "1" \
    --payload-data "SGVsbG8gVG8gRGV2c2lt" \
    --wireless-metadata LoRaWAN={FPort=1}

Executando o comando, a saída gera um MessageId para a mensagem de downlink.

{
    MessageId: "6011dd36-0043d6eb-0072-0008"
}

Visualizar as informações de cobertura

Depois de habilitar a rede pública, será possível visualizar as informações de cobertura da rede no console do AWS IoT. Acesse o hub Cobertura do console do AWS IoT e, então, pesquise locais para visualizar as informações de cobertura de seus dispositivos no mapa.