aws-iot-mastery

Useful tools and files for configuring your AWS IoT installation

Important Links

• AWS IoT Developer Guide

Setting Up

1. Sign up for AWS

• Install command line tools
• Configure AWS IoT and AWS IAM administrator access

Environment Variables

All the shell tools provider here depend on a number of Environment variables.

export MY_AWS_ORG='org'
export MY_AWS_GRP='grp'
export MY_AWS_ID='899999999999'
export MY_AWS_REGION='us-east-1'

You can run

$ sh Environment.sh 

to get reasonable values.

To understand what MY_AWS_ORG and MY_AWS_GRP are, please see "Topics" in iot/policies/README.md. It's not important to make a decision on these, so leave them as the defaults if you don't want to think about it right now.

Topics

Our code is based around the following MQTT topic organization.

• Layer 1 : the name of your organization (defaults $MY_AWS_ORG)
• Layer 2 : the code for a particular "group" of things (defaults $MY_AWS_GRP)
• Layer 3 : a version, always "01 "
• Layer 4 : the scope, which is an arbitrary strong

For example,

ibm/canada/01/l38939339

This seems to provide a fairly flexibly upgrade path to very complicated networks.

The actual readings can be in the payload, though you can add additional layers like:

ibm/canada/01/l38939339/ambient-noise

though personally I don't think this is a great idea.

Folders