To find out more about training on AWS, visit: https://www.qa.com/amazon AWS Pop-up Loft | London, April 20, 2016

1. AWS Pop-up Loft London
Getting Started with AWS IoT, Devices & SDKs
Danilo Poccia, Technical Evangelist
@danilop danilop

2. AWS IoT

3. Authentication & Authorization
AWS Auth
+
HTTPS
MQTT
+
Mutual Auth TLS
WebSockets
wss://…

4. Registry
Hardware Revision
Firmware Version
Serial Numbers
Device Type
Device Group
Device Description
Link to Product
Documentation
. . .

5. Device Gateway
Millions of devices
and apps can
connect over
MQTT,
WebSockets,
and HTTP 1.1
Powerful
Pub/Sub Broker
with Long-lived
bi-directional
messages

6. Rules Engine
SELECT *
FROM ‘things/thing-2/color’
WHERE color = ‘red’
Simple & Familiar
Syntax
SQL Statement to
define topic filter
with JSON support
Functions improve
signal : noise

7. Device Shadow
Intermitted
Connections
Persistent
Device State
(JSON)
Desired Vs Reported
=> Delta
RESTful API
Shadow

8. AWS IoT Device SDK
C-SDK
JS-SDK
Arduino
Yún
Mobile SDK
Android
iOS

9. MQTT

10. MQTT Topic
Device A
“Sensor”
Device B
“Control Center”
(1) Subscribe
(3) Message
(2) Publish
MQTT Topic = topic level / topic level / …
↓
“myapp/customer123/house4/kitchen/temperature”

11. Wildcards
‘+’ single level
‘#’ multi level
“myapp/customer123/house4/+/temperature”
“myapp/customer123/+/kitchen/temperature”
“myapp/customer123/house4/#”
“myapp/customer123/#”
$topics are not subscribed by “#’”

12. Device Shadows

13. Device Shadows RESTful API
https://endpoint/things/thingName/shadow
endpoint = identifier.iot.region.amazonaws.com
HTTP GET → GetThingShadow
HTTP POST → UpdateThingShadow
HTTP DELETE → DeleteThingShadow

14. MQTT topics
The Thing Shadows service sends
messages to this topic when
$aws/things/myLightBulb/shadow/update/accepted an update is successfully made to a thing shadow
$aws/things/myLightBulb/shadow/update/rejected
an update to a thing shadow is rejected
$aws/things/myLightBulb/shadow/update/delta a difference is detected between the reported and
desired sections of a thing shadow
$aws/things/myLightBulb/shadow/get/accepted
a request for a thing shadow is made successfully
$aws/things/myLightBulb/shadow/get/rejected
a request for a thing shadow is rejected

15. Lightbulb
Thing Shadows
Service
Application

16. Lightbulb
Thing Shadows
Service
$aws/things/myLightbulb/shadow/update
{
"state": {
"reported": {
"color": "red"
}
}
}
Application

17. Lightbulb
Thing Shadows
Service
$aws/things/myLightBulb/shadow/update/accepted
{
"state":{
"reported":{
"color":"red"
}
},
"metadata":{
"reported":{
"color":{
"timestamp":1447437304
}
}
},
"version":1,
"timestamp":1447437304
}
Application

18. Lightbulb
Thing Shadows
Service
$aws/things/myLightBulb/shadow/get
“”
(empty message)
Could be a RESTful call to GetThingShadow
Application

19. Lightbulb
Thing Shadows
Service
$aws/things/myLightBulb/shadow/get/accepted
{
"state":{
"reported":{
"color":"red"
}
},
"metadata":{
"reported":{
"color":{
"timestamp":1447437304
}
}
},
"version":1,
"timestamp":1447437398
}
Application

20. Lightbulb
Thing Shadows
Service
$aws/things/myLightBulb/shadow/update
{
"state": {
"desired": {
"color": "green"
}
}
}
Could be a RESTful call to UpdateThingShadow
Application

21. Lightbulb
Thing Shadows
Service
$aws/things/myLightBulb/shadow/update/accepted
{
"state":{
"desired":{
"color":"green"
}
},
"metadata":{
"desired":{
"color":{
"timestamp":1447437647
}
}
},
"version":2, "timestamp":1447437647
}
Application

22. Lightbulb
Thing Shadows
Service
$aws/things/myLightBulb/shadow/update/delta
{
"version":2,
"timestamp":1447437647,
"state":{
"color":"green"
},
"metadata":{
"color":{
"timestamp":1447437647
}
}
}
Application

23. Lightbulb
Thing Shadows
Service
$aws/things/myLightbulb/shadow/update
{
"state":{
"reported":{
"color":"green"
},
"desired":null}
}
}
Application

24. Lightbulb
Thing Shadows
Service
$aws/things/myLightBulb/shadow/update/accepted
{
"state":{
"reported":{
"color":"green"
}
},
"metadata":{
"reported":{
"color":{
"timestamp":1447437894
}
}
},
"version":3, “timestamp":1447437894
}
Application

25. {
"state" : {
"desired" : {
"color" : "RED",
"sequence" : [ "RED", "GREEN", "BLUE" ]
},
"reported" : {
"color" : "GREEN"
}
},
"metadata" : {
"desired" : {
"color" : {
"timestamp" : 12345
},
"sequence" : {
"timestamp" : 12345
}
},
"reported" : {
"color" : {
"timestamp" : 12345
}
}
},
"version" : 10,
"clientToken" : "UniqueClientToken",
"timestamp": 123456789
}
Sample
Thing Shadow
Document

26. Optimistic
Locking
Initial State
Update
Result

27. {
"state" : {
"desired" : { "colors" : ["RED", "GREEN", "BLUE" ] }
},
"version" : 10
}
Optimistic
Locking
Initial State
Update
Result

28. {
"state" : {
"desired" : { "colors" : ["RED", "GREEN", "BLUE" ] }
},
"version" : 10
}
{
"state": {
"desired": {
"colors": [
"BLUE"
]
}
},
"version": 9
}
Optimistic
Locking
Initial State
Update
Result

29. {
"state" : {
"desired" : { "colors" : ["RED", "GREEN", "BLUE" ] }
},
"version" : 10
}
{
"state": {
"desired": {
"colors": [
"BLUE"
]
}
},
"version": 9
}
409 Conflict
Optimistic
Locking
Initial State
Update
Result

30. {
"state" : {
"desired" : { "colors" : ["RED", "GREEN", "BLUE" ] }
},
"version" : 10
}
{
"state": {
"desired": {
"colors": [
"BLUE"
]
}
},
"version": 10
}
Optimistic
Locking
Initial State
Update
Result

31. {
"state" : {
"desired" : { "colors" : ["RED", "GREEN", "BLUE" ] }
},
"version" : 10
}
{
"state": {
"desired": {
"colors": [
"BLUE"
]
}
},
"version": 10
}
{
"state": {
"desired": {
"colors": [
"BLUE"
]
}
},
"version": 11
}
Optimistic
Locking
Initial State
Update
Result

32. MQTT Connection
Create and maintain a mutually authenticated
TLS connection over which it runs MQTT
Subscribing to MQTT topics + callback function
Thing Shadow
Retrieve, update and delete Thing Shadows
Abstracts the necessary MQTT topic subscriptions
by automatically subscribing to and unsubscribing
from the reserved topics as needed
Inbound state change requests are automatically signalled
via a configurable callback
D
evice
SD
K
s

33. Connecting to the AWS IoT MQTT platform
rc = aws_iot_mqtt_connect( &connectParams );
Subscribe to a topic
MQTTSubscribeParams subParams = MQTTSubscribeParamsDefault;
subParams.mHandler = MQTTcallbackHandler;
subParams.qos = QOS_0;
subParams.pTopic = "sdkTest/sub";
rc = aws_iot_mqtt_subscribe( &subParams );
Update Thing Shadow from a device
rc = aws_iot_shadow_update(&mqttClient,
AWS_IOT_MY_THING_NAME,
pJsonDocumentBuffer,
ShadowUpdateStatusCallback,
pCallbackContext,
TIMEOUT_4SEC,
persistenSubscription);
C
SD
K

34. var awsIot = require(‘aws-iot-device-sdk');
var device = awsIot.device({
keyPath: <YourPrivateKeyPath>,
certPath: <YourCertificatePath>,
caPath: <YourRootCACertificatePath>,
clientId: <YourUniqueClientIdentifier>,
region: <YourAWSRegion>
});
device
.on('connect', function() {
console.log('connect');
device.subscribe('topic_1');
device.publish('topic_2', JSON.stringify({ test_data: 1}));
});
device
.on('message', function(topic, payload) {
console.log('message', topic, payload.toString());
});
JS
SD
K
D
evice
C
lass

35. var thingShadows = awsIot.thingShadow({
keyPath: <YourPrivateKeyPath>,
certPath: <YourCertificatePath>,
caPath: <YourRootCACertificatePath>,
clientId: <YourUniqueClientIdentifier>,
region: <YourAWSRegion>
});
thingShadows.on('connect', function() {
thingShadows.register( 'RGBLedLamp' );
setTimeout( function() {
var rgbLedLampState =
{"state":{"desired":{"red":rval,"green":gval,"blue":bval}}};
clientTokenUpdate = thingShadows.update('RGBLedLamp', rgbLedLampState );
if (clientTokenUpdate === null)
{
console.log('update shadow failed, operation still in progress');
}
}, 5000 );
});
JS
SD
K
Thing
Shadow
C
lass

36. thingShadows.on('status',
function(thingName, stat, clientToken, stateObject) {
console.log('received '+stat+' on '+thingName+': '+
JSON.stringify(stateObject));
});
thingShadows.on('delta',
function(thingName, stateObject) {
console.log('received delta on '+thingName+': '+
JSON.stringify(stateObject));
});
JS
SD
K
Thing
Shadow
C
lass

37. <demo>
...
</demo>

38. AWS IoT

39. Focus on Your Idea

40. Danilo Poccia
@danilop danilop
Thank You