React-native-aws-iot-device-shadows NPM

aws-iot-device-sdk-js-react-native

React Native Component wrapper for connecting to AWS IoT from a device using SDK JavaScript bundle

Allows developers to use the AWS IOT shadow support from a React Native component.

Overview

This document provides instructions on how to install and configure the AWS IoT device/Shadow in React Native.

AWS SDK Dependency

This package is built on top of the AWS SDK aws-sdk.js which provides two classes: 'device' and 'thingShadow'.

Thing Shadows

The 'thingShadow' class implements additional functionality for accessing Thing Shadows via the AWS IoT API; the thingShadow class allows devices to update, be notified of changes to, get the current state of, or delete Thing Shadows from AWS IoT. Thing Shadows allow applications and devices to synchronize their state on the AWS IoT platform.

Device

The 'device' class wraps mqtt.js to provide a secure connection to the AWS IoT platform and expose the mqtt.js interfaces upward. It provides features to simplify handling of intermittent connections, including progressive backoff retries, automatic re-subscription upon connection, and queued offline publishing with configurable drain rate.

Installation

Installing with npm:

npm install react-native-aws-iot-device-shadows

Examples

MQTT React Native IoT Shadow Class

<AWSIoTMQTT
    ref={(ref) => { this.AWSIoTMQTT = ref; }}
    type="shadow"
    region="us-west-2"
    host="asdasd.iot.aws.com"
    onReconnect={() => this.onConnect()}
    onConnect={() => this.onConnect()}
    onDelta={(thingId, stateObject) => this.onDelta(thingId, stateObject)}
    onStatus={(thingId, statusType, clientToken, stateObject) =>
        this.onStatus(thingId, statusType, clientToken, stateObject)}
    onThingConnected={(thingId) => { this.onThingConnected(thingId); }}
/>

MQTT React Native IoT device Class

<AWSIoTMQTT
    ref={(ref) => { this.AWSIoTMQTT = ref; }}
    type="device"
    region="us-west-2"
    host="asdasd.iot.aws.com"
    onReconnect={() => this.onConnect()}
    onConnect={() => this.onConnect()} 
/>

AWSIoTMQTT

Returns a React Native component whichs wraps xxxxxxxx

## API Documentation

type: use 'device' for device type and 'shadows' for ShadowThing
host: the AWS IoT endpoint you will use to connect
region: the AWS IoT region you will use to connect
config: extra configuration for the thingShadow
onConnect: callback for when the websockets connects
onReconnect: callback for when the websockets reconnects
onDelta: callback for delta msg
onStatus: callback for status msg
onThingConnected: callback for each registered thing

Connection Types

This react native component only supports one type of connections to the AWS IoT platform:

MQTT over WebSocket/TLS with SigV4 authentication using port 443

Debug

The enable debug mode for display logging information just pass a object with debug:true

<AWSIoTMQTT
    config={debug:true}
    ...
/>

Re-Creating the bundle with webpack

This IOT JS SDK is packaged withwebpack, because currently there is not official support for AWS IOT react native. This is already bundle it for you using the last version.