Skip to main content

AWS IoT Core

This page has not been fully updated to represent the latest state of the Helium Network following the migration to Solana on April 18, 2023.

AWS IoT Core is a powerful offering that lets developers build device-based applications and services on the AWS Cloud. And this Integration via Helium Console automates the complexity of securely connecting your devices to AWS IoT Core.

Add an AWS IoT Core Integration​

To add an AWS IoT Core Integration, go to Integrations on the left-hand menu. Select the integration to add - in this case, the AWS IoT Core integration:

The next step is to create a new user with limited permissions that this Integration will use.

Open up the AWS Console

Under the Services menu in the upper-left, go to Security, Identity, & Compliance->IAM:

We are now going to create a new User:

Set the user name to "HeliumIntegrationAccess" and select only "Programmatic access"

We now attach a policy to the newly created user that defines what permissions they hold.

Select "Attach existing policies directly" and type "AWSIoTConfigAccess" into the "Filter Policies" box and check the box to the left of the row:

warning

Ensure you record and store these keys securely, as you will not have an opportunity to get access to them again!

Back in the Helium Console, enter the credentials we just created under AWS Connection Details, as well as the AWS region that you would like AWS IoT to run in.

The Topic field is the AWS IoT MQTT topic that this integration will publish uplink messages to, from devices.

Finally, we give our new Integration a name and click Create Integration. Your new Integration is now ready for use.

Connecting Integrations to Devices​

Devices or groups of devices (via labels) can be directly connected to integrations on the Flows Worskpace. Labels are identifiers used to group devices for easy management. To connect one or more devices to one or more integrations, simply connect the Device and Integration nodes on the Flows Workspace.

info

Quick video tutorial connecting devices to an integration here.

Node elements (devices, labels, integrations) need to be created before they're available on the Flows Workspace. More information about Flows here.

AWS IoT MQTT Topic composition:​

This topic is defined in the Topic field when creating the AWS IoT intgeration.

Subscribe to: {custom_topic}

Publish to: helium/devices/{Device ID}/down

Example: helium/devices/4f10d99a-e22e-4007-a3f0-6af3bc63acfe/down

AWS IoT MQTT Messages​

To send data to a device, use JSON with a payload_raw field with a base64 encoded string.

Sending Data to Device (Downlink):

{
   "payload_raw": "encoded_string"
}

When receiving data from a device, the messages will be in JSON and look like the following. The data from the device is in the payload field, and is a base64 encoded string.

Receiving data from Device (Uplink):

{
  "app_eui": "06B02F1A0E482128",
  "dev_eui": "5F67F99E10B47006",
  "devaddr": "1A2FB006",
  "fcnt": 10,
  "hotspots": [
    {
      "frequency": 911.9000244140625,
      "id": "112ErPy4pa8bRBQj9XgtRrHdk4i4ciTzB5gHwBbFupgNnwaGdExi",
      "name": "mammoth-tartan-tortoise",
      "reported_at": 1586466818,
      "rssi": -57,
      "snr": 12.5,
      "spreading": "SF9BW125",
      "status": "success"
    },
    {
      "frequency": 911.9000244140625,
      "id": "112kFNJoxBYn7UWwZqUABrTXjhn7mkP8ePrbi6w9Hj1NXJfodwP3",
      "name": "howling-gauze-guppy",
      "reported_at": 1586466818,
      "rssi": -91,
      "snr": 13,
      "spreading": "SF9BW125",
      "status": "success"
    }
  ],
  "id": "4f10d99a-e22e-4007-a3f0-6af3bc63acfe",
  "metadata": {
    "labels": [
      {
        "id": "0ec71594-de64-4794-acd7-9ace0b7137a3",
        "name": "aws-iot-integration-label",
        "organization_id": "0c3fbfb6-f8ed-4dbe-af7c-1a86bf372764"
      }
    ]
  },
  "name": "Sparkfun Pro RF",
  "payload": "AWcA8AJodANzJ18Ecc04B9CYMAWGyVCIuDaw",
  "port": 1,
  "reported_at": 1586466818
}

Viewing Integration in AWS IoT Core​

Once our devices have been connected on the Flows Worskpace to our new Integration, let's return to the AWS Console, and go to IoT Core under the Services menu:

Here you are able to monitor the connections to AWS:

When data comes in from the Helium Network Integration, Things will be automatically created within AWS IoT Core:

Going to Interact on the left while on a Thing takes us to a list of topics for interacting with the Thing Shadows:

To monitor in real-time what is being sent to AWS from Helium, we can open the MQTT monitor, and subscribe to a topic with "#" wildcard (to catch all messages, or use the topic we set in Helium Console if just wanting to monitor those).

The payload field is the actual data received from the device, encoded in a base64 string.

Integration Details​

View the details of your integration by clicking on the Integration name.

Integration Details shows the integration ID that is unique to each integration, the name, the type of integration, and whether it is active or not.

Devices Piped lists all the devices that are currently sending their data to the selected integration.

Update your AWS Connection Details allows you to update your AWS connection details for the currently viewed integration.