This section helps you set up your ConnectCore device and create required resources to send, receive, and process messages from the AWS IoT platform.

The goal of this section is to have the awsiot-sample application running in your device. This application monitors the CPU temperature and CPU load and allows you to remotely switch a device LED on and off.

Requirements

1. Program the AWS IoT image

Digi provides pre-built AWS IoT images:

  • If your device is already running from Linux, use the update package (*.swu) to program the firmware. Follow the steps at Program firmware from Linux. Download the update package dey-image-aws-swu-{pfm-codename-exp}.swu from {images-aws-url-exp}/.

  • Or you can use U-boot to program your device, following the steps at Program firmware from U-Boot. Download the partition images from {images-aws-url-exp}/.

2. Register your device in the Thing Registry

Before connecting to AWS IoT, you must have your device in the Thing Registry. To do so, use the AWS IoT console or the AWS Command Line Interface (CLI) and follow the steps in the AWS IoT documentation.

When creating the AWS IoT Policy to attach to the Thing certificates, make sure you authorize your device to perform all the possible AWS IoT operations (connect, publish, receive, subscribe, get/update the shadow).

To do so, define the policy action as a *. Your policy must be similar to the following:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "iot:*",
      "Resource": "*"
    }
  ]
}

To learn more about AWS IoT policies, see the AWS IoT developer guide.

3. Install the certificates in the device file system

Your device must establish a secure connection with AWS IoT using X.509 certificates. You must generate these certificates and register them in your AWS account:

  1. To create and register the certificates, see the AWS IoT documentation.

  2. Install the certificate and private key associated with your device, for example inside the /etc/ssl/certs directory.

    ~> scp <root_ca_file_name> root@<ip>:/etc/ssl/certs/
    ~> scp <signed_cert_file_name> root@<ip>:/etc/ssl/certs/
    ~> scp <private_key_file_name> root@<ip>:/etc/ssl/certs/
    ~> sync

4. Configure your device Thing

By default, the awsiot-sample application reads the configuration to connect to AWS IoT platform from the /etc/awsiotsdk.conf file. Configure the following settings:

  1. thing_name: Thing name that represents your device in your AWS IoT account.

  2. host: MQTT host or endpoint, similar to "ABCDEFG1234567.iot.us-west-2.amazonaws.com". You can obtain it from the Settings menu on the navigation bar of the AWS IoT Console.

  3. Certificates settings:

    1. certs_path: Absolute path of the certificates directory in the device. If you install them under /etc/ssl/certs you do not need to modify it.

    2. rootca_filename: Name of the Root CA file located in the configured certs_path.

    3. signed_cert_filename: Name of the device signed certificate file located in the configured certs_path.

    4. private_key_filename: Name of the device private key file located in the configured certs_path.

Issue the sync command after editing the /etc/awsiotsdk.conf file.

5. Connect to AWS IoT

Once everything is properly configured, you can execute the demo application in the device:

#> awsiot-sample

The device console displays information with every new update:

=========================================
Updating shadow...
Temperature variation greater than 1C
 
Temperature: 44.512000C
CPU Load: 0.000000%
LED status: OFF
=========================================

Follow these steps to control the LED:

  1. Log into your AWS IoT Console.

  2. Click Test.

  3. Enter # in the Subscription topic text field to subscribe to all topics.

  4. In Publish > Specify a topic to publish to, type $aws/things/<thing_name>/shadow/update, where <thing_name> is the thing name of your registered device.

  5. To switch on the LED, copy this in the text box:

    {
        "state" : {
            "desired" : {
                "ledON" : true
             }
         }
    }
  6. Press Publish to topic to send the message. The LED on the board switches on.

  7. To switch off the LED, change "ledON" : true to "ledON" : false and publish the message.

    {
        "state" : {
            "desired" : {
                "ledON" : false
             }
         }
    }