How to use the public network support

Using the Amazon IoT console

Go to the Profiles hub of the Amazon IoT console and choose Add service profile. When creating the profile, choose Enable public network.

Using the Amazon IoT Wireless API

To specify the roaming parameters when creating a service profile, use the CreateServiceProfile API operation or the create-service-profile CLI command, as shown in example below.

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

Running this command returns the ARN and ID of the service profile as output.

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

Using the Amazon IoT console

Go to the Profiles hub of the Amazon IoT console and choose the profile that you created. In the Profile configuration tab of the details page, you'll see RaAllowed and PrAllowed set to true.

Using the Amazon IoT Wireless API

To view the roaming parameters that you enabled, use the GetServiceProfile API operation or the get-service-profile CLI command, as shown in example below.

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

Running this command returns the service profile details as output, including the values for roaming parameters, RaAllowed and 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
    }
}

Onboarding new devices

If you haven't already onboarded your devices, you specify this service profile to be used when adding your device to Amazon IoT Core for LoRaWAN. The following command shows how you can use the create-wireless-device CLI command to add a device using the ID of the service profile that you created. For information about adding a device and attaching the service profile to it using the console, see Add your wireless device specification to Amazon IoT Core for LoRaWAN using the console.

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

The following shows the contents of the file createdevice.json.

Contents of 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"
    },
}

The output of running this command produces the ARN and ID of the wireless device as output.

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

Updating existing devices

If you have already onboarded your devices, you can update your existing wireless devices to use this service profile. The following command shows how you can use the update-wireless-device CLI command to update a device using the ID of the service profile that you created.

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"

This command doesn't produce any output. You can use the GetWirelessDevice API or the get-wireless-device CLI command to get the updated information.

View uplink messages

When you send uplink messages from your devices, Amazon IoT Core for LoRaWAN delivers these messages to your Amazon Web Services account using the destination that you configured earlier. These messages will be sent from your device to the Cloud over Everynet's network.

You can use either view the messages using the Amazon IoT rule name or use the MQTT client to subscribe to the MQTT topic that was specified when creating the destination. For more information about the rule name and other destination details that you specify, see Add a destination using the console.

For more information about viewing uplink message and the format, see View format of uplink messages sent from LoRaWAN devices.

Send downlink messages

You can queue and send downlink messages to your devices from the console, or by using the Amazon IoT Wireless API command, SendDataToWirelessDevice, or the Amazon CLI command, send-data-to-wireless-device. For information about queuing and sending downlink messages, see Queue downlink messages to send to LoRaWAN devices.

The following code shows an example of how you can send a downlink message using the send-data-to-wireless-device CLI command. You specify the ID of the wireless device to receive the data, the payload, whether to use the acknowledge mode, and the wireless metadata.

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

The output of running this command generates a MessageId for the downlink message.

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