Sierra Wireless mangOH Green Operation instructions

mangOH™ Green
Tutorial—Arduino-compatible
Shield to AirVantage
4119370
Rev 1
Contents subject to change

mangOH Green Tutorial—Arduino-compatible Shield to AirVantage
Rev 1 6/18/16 2 4119370
Important
Notice Due to the nature of wireless communications, transmission and reception of data can
never be guaranteed. Data may be delayed, corrupted (i.e., have errors) or be totally
lost. Although significant delays or losses of data are rare when wireless devices such
as the Sierra Wireless modem are used in a normal manner with a well-constructed
network, the Sierra Wireless modem should not be used in situations where failure to
transmit or receive data could result in damage of any kind to the user or any other
party, including but not limited to personal injury, death, or loss of property. Sierra
Wireless accepts no responsibility for damages of any kind resulting from delays or
errors in data transmitted or received using the Sierra Wireless modem, or for failure
of the Sierra Wireless modem to transmit or receive such data.
Limitation of
Liability The information in this manual is subject to change without notice and does not
represent a commitment on the part of Sierra Wireless. SIERRA WIRELESS AND ITS
AFFILIATES SPECIFICALLY DISCLAIM LIABILITY FOR ANY AND ALL DIRECT,
INDIRECT, SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR
EXEMPLARY DAMAGES INCLUDING, BUT NOT LIMITED TO, LOSS OF PROFITS
OR REVENUE OR ANTICIPATED PROFITS OR REVENUE ARISING OUT OF THE
USE OR INABILITY TO USE ANY SIERRA WIRELESS PRODUCT, EVEN IF
SIERRA WIRELESS AND/OR ITS AFFILIATES HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES OR THEY ARE FORESEEABLE OR FOR
CLAIMS BY ANY THIRD PARTY.
Notwithstanding the foregoing, in no event shall Sierra Wireless and/or its affiliates
aggregate liability arising under or in connection with the Sierra Wireless product,
regardless of the number of events, occurrences, or claims giving rise to liability, be in
excess of the price paid by the purchaser for the Sierra Wireless product.
Patents This product may contain technology developed by or for Sierra Wireless Inc.
This document contains information which is proprietary to Sierra Wireless Inc. and is
licensed pursuant to Creative Commons Attribution 4.0 International License.
Document
details Title: mangOH Green User Guide
Author: Sierra Wireless
Source: http://mangoh.io/
Copyright © June 18, 2016 Sierra Wireless. Licensed under the Creative Commons Attribution
4.0 license, http://creativecommons.org/licenses/by/4.0/
Disclaimer Indicate any modifications made to the original document.
Trademarks mangOH™ and the mangOH logo are trademarks of Sierra Wireless.
Other trademarks are the property of their respective owners.

Preface
Rev 1 6/18/16 3 4119370
Revision
History
Revision
number Release date Changes
1June 2016 Document created

Rev 1 6/18/16 4 4119370
Contents
Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Set up your mangOH Green. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Prepare your mangOH Green for Arduino development. . . . . . . . . . . . . . . . . . . . . . . . . . 10
Install mangOH Green Platform Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Prepare for Arduino development. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Download Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Prepare the Sketch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Add Required Libraries to Arduino Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Connect to the IoT Cloud . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Configure AirVantage To Receive Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Rev 1 6/18/16 5 4119370
1
1: Getting Started
This tutorial will take you through the process of setting up your mangOH Green to
allow Arduino sketches to transmit data to the cloud, and configuring AirVantage to
receive that data.
The tutorial builds on basics covered in the mangOH Green Fundamentals tutorial
and the mangOH Green User Guide. To work through this tutorial:
•You must have already set up your mangOH Grene hardware and registered your
device on your AirVantage account. See the mangOH Green Fundamentals
tutorial for details.
•You must have an IDE loaded on your computer for Arduino sketch development.
The examples in this tutorial reflect the use of the Arduino IDE, v.16.9 (available
from http://arduino.cc).
•You should have a working understanding of sketch development. (This is not a
coding tutorial.)
When you finish this tutorial, you will have git-cloned the mangOH platform, used the
Arduino IDE to build and install a sketch on the mangOH Green, and configured your
AirVantage account to receive data sent by sensors installed on an Arduino shield.
Tip: If you have only one monitor, you may want to print this document and use it when you
don’t want to switch back and forth between the PDF and the various windows/applications
you’ll be opening during the tutorial.
This tutorial includes:
•Set up your mangOH Green on page 6
•Prepare your mangOH Green for Arduino development on page 10
•Prepare for Arduino development on page 12
Important: To get maximum benefit from this tutorial, you are strongly recommended to
carefully follow the procedures as described, since the tutorial continually builds on earlier
procedures and results. If you skip steps or use alternate methods, you may encounter difficulty
completing the tutorial.