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.

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
      }
    },
    "clientToken" : "<thing_name>-3"
  }
  

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 want to build the connector for, e.g:

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

More information about Digi Embedded Yocto.

License

Copyright 2017, Digi International Inc.

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, you can obtain one at http://mozilla.org/MPL/2.0/.

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.