dey-examples/awsiot-sample

AWS IoT device SDK Demo Application

Demo application to connect devices to AWS IoT.

This application monitors the CPU temperature and load and allows to remotely switch on/off a device LED.

The demo uploads the device Thing Shadow every minute or when the difference between the current value of temperature or load and the last reported is bigger than a configured value (1C for temperature and 10% for CPU load).

The repository has the following directories:

• cfg_files: demo configuration file
• src: application source code

Configuring the application

Before launching the application, you must configure it by editing its configuration file. By default, this file is /etc/awsiotsdk.conf but the option -c allows the selection of another one.

You must configure:

• thig_name: Thing Name of the Shadow this device is associated with.
• host: Customer specific MQTT HOST. This is your custom endpoint that allows your device to connect to AWS IoT. You can obtain it in your 'AWS IoT Console'.
• The certificate settings:
  • certs_path: Absolute path to the certificates directory in the device.
  • rootca_filename: Name of the Root CA file in the configured certs_path.
  • signed_cert_filename: Name of the device signed certificate file in the configured certs_path.
  • private_key_filename: Name of the device private key file in the configured certs_path.
• Optionally, any other value in the configuration file.

Running the application

Once the settings are properly configured, launch the application:

~# awsiot-sample

You can specify the configuration file with -c:

~# awsiot-sample -c <absolute_path_to_configuration_file>

• The application reports its status to the topic $aws/things/<thing_name>/shadow/update. Something similar to:

  {
    "state" : {
      "reported" : {
        "temperature" : 45.971,
        "cpuLoad" : 4.504505,
        "ledON" : false
      }
    },
    "clientToken" : "<thing_name>-3"
  }
  

• To switch on the configured LED send to the topic $aws/things/<thing_name>/shadow/update:

  {
    "state" : {
      "desired" : {
        "ledON" : true
      }
    }
  }
  

• To switch off the configured LED send to the topic $aws/things/<thing_name>/shadow/update:

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

Compiling the application

This demo can be compiled using a Digi Embedded Yocto based toolchain. Make sure to source the corresponding toolchain of the platform you are using, for example, for ConnectCore 6UL:

~$ . <DEY-toolchain-path>/environment-setup-cortexa7hf-vfp-neon-dey-linux-gnueabi
~$ make

For more information, see the Digi Embedded Yocto online documentation.

License

Copyright 2017, Digi International Inc.

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.