Sierra Wireless mangOH Yellow User manual

mangOH™ Yellow
Getting Started Guide
41113347
Rev 2
Contents subject to change

mangOH Yellow Getting Started Guide
Rev 2 10/21/19 2 41113347
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 Yellow Getting Started Guide
Author: Sierra Wireless
Source: http://mangoh.io/
Copyright © October 21, 2019 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.

Rev 2 10/21/19 3 41113347
Revision
History
Revision
number
Release date Changes
1September 2019 Document created
2September 2019 Updated figure callouts, reduced image sizes
Updated description of LEDs
Updated 3.3 (Windows only) Install CF3 Module Drivers
Added note for 2G, battery required
Updated Connect to Octave chapter
Added appendix Install Leaf and Build mangOH Software

Rev 2 10/21/19 4 41113347
Contents
Get Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Register a mangoh.io Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Set Up Your mangOH Yellow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Peel Your mangOH Yellow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Quick Components Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
(Windows only) Install CF3 Module Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Prepare Your mangOH Yellow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Connect to Your mangOH Yellow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Connect to Octave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Claim Your Free Trial Octave Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Send Sensor Data to Octave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Affect mangOH Yellow Resources from Octave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Install Leaf and Build mangOH Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Rev 2 10/21/19 5 41113347
1
1: Get Started
Thanks for purchasing the mangOH®Yellow development kit! Use this guide to prepare your mangOH Yellow and
computer for IoT development.
When you are ready to begin, work straight through the rest of this guide:
•STEP 1: Register a mangoh.io Account on page 6
•STEP 2: Set Up Your mangOH Yellow on page 7
•STEP 3: Connect to Your mangOH Yellow on page 12
•STEP 4: Connect to Octave on page 14
And then to make the most of your mangOH Yellow ...
Table 1-1: Minimum System Requirements
O/S
•Windows®7 and higher
•(64-bit) Ubuntu 16.04
•macOS®
CPU Dual core @ 2.6 GHz
RAM 4GB
HDD 10 GB free space
USB Ports •Preferred—2 (for full functionality)
•Minimum—1
Visit mangoh.io/mangoh-yellow-resources for mangOH Yellow
guides, tutorials, and more.
Visit forum.mangoh.io to participate in the mangOH community.
mangOH Forum

Rev 2 10/21/19 6 41113347
2
2: Register a mangoh.io Account
The mangOH ecosystem of products, tutorials, documentation and more is constantly evolving.
Please register for a mangoh.io account to:
•Get access to mangOH documentation
•Receive notices of new mangOH products, IoT cards, and project code samples
•Receive periodic device-specific notices
•Be automatically included for a chance to win IoT cards in periodic giveaways
If you already have an account, please log in and register your new device so we can provide you with news about
your device.
To register for an account:
1. Go to https://mangoh.io and click Register.
2. Enter the requested data to create your account.
Note: • E-mail address—This will be your mangOH account login.
• Password—8-29 characters (including at least 1 lowercase letter, 1 uppercase lettter, and 1 number.)
• IoT Applications—Please let us know all the fields you are developing for so we can improve the mangOH
ecosystem for you!
3. Click Register.
If all required fields are filled correctly, your account is created and you are logged in automatically.
Otherwise, the fields that must be updated are indicated. Fix them, re-enter the password fields, and click Reg-
ister again.
4. Now that you’re logged into your account, click Device Registration.
5. Select mangOH Yellow as your new mangOH type.
6. Click Submit. Your mangOH account is updated with your device type.
Now you’re ready to
Set Up Your mangOH Yellow on page 7.

Rev 2 10/21/19 7 41113347
3
3: Set Up Your mangOH Yellow
3.1 Peel Your mangOH Yellow
Open your mangOH Yellow kit and make sure you have all the parts—the kit contains everything you need (and
more!) to get started:
•(1) mangOH Yellow board with soldered-down WP7702 CF3 module.
Note: The module ships with pre-built software already installed!
•(2) micro-USB cables
•(1) Ultra Wide Band antenna (taoglas FXUB63)
•(1) Breakout board (IoT expansion card format)
•(2) M2 screws for IoT card installation

3.2: Quick Components Overview
Rev 2 10/21/19 8 41113347
3.2 Quick Components Overview
Many components and connectors are already built into the mangOH Yellow. Some of these include:
Sensors and Outputs
Modules and Power
Buzzer
g / p / h
g / p / h
Geomagnetic
Geomagnetic
Gas/Pressure/Humidity
sensor
Light sensor
Gyroscope / accelerometer
Generic tri-color LED
Generic green LED
Power/Network/Cloud LED
Geomagnetic
sensor
Buzzer
Buzzer
CF3
CF3
CF3
CF3
RESET
RESET
Expansion
Connector
Expansion
Connector
IoT
Connector
IoT
Connector
Power
Selector
Power
Selector
Power
switch IoT card connector
Expansion
connector
WP7702 CF3
module
Reset switch
"CON" USB
connector
"USB" USB
connector
Power
selector

3.3: (Windows only) Install CF3 Module Drivers
Rev 2 10/21/19 9 41113347
3.3 (Windows only) Install CF3 Module Drivers
Windows systems require drivers for the mangOH Yellow’s CF3 module.
To download the drivers:
1. Go to https://mangoh.io/mangoh-yellow-resources-software.
2. Click Download Drivers to download the driver installation file.
3. Run the downloaded .exe file and follow the prompts to install the drivers.
3.4 Prepare Your mangOH Yellow
Your mangOH Yellow is (almost) ready to go right out of the box—all it needs is a power source:
1. Make sure the dip switches are set correctly:
a. Remove the protective film from the dip switch block:
b. Make sure all the dip switches are OFF (factory default mode).
Remove this film

3.4: Prepare Your mangOH Yellow
Rev 2 10/21/19 10 41113347
2. Make sure the power select jumper is on the pins closest to the edge of the board. (This selects the USB
micro-B connector as the power supply.)
Note: The mangOH Yellow has two micro-B USB connectors:
• USB is used for SSH connections, AT commands, and firmware downloads.
• CON is a serial connection used to access the module’s console for diagnostic purposes.
3. Power up the mangOH Yellow—Use a micro-USB cable to connect the USB connector to a powered USB port
on your computer.
USB power (jumper on pins
closest to board edge)
USB connector
CON connector
(other side of board)
(other side of board)
CF3 USB connector

3.4: Prepare Your mangOH Yellow
Rev 2 10/21/19 11 41113347
Important: If LTE-M coverage is not available, the mangOH Yellow’s WP7702 module will fall back to 2G, which
consumes up to 2 A of current for short bursts. In this case, USB power is insufficient (500 mA) and the module may
repeatedly brown out and reboot. Use a Li-ion or Li-polymer (3.7 V nominal) battery to supply sufficient power. (See the
mangOH Yellow User Guide for details.)
4. As soon as the mangOH Yellow is powered ...
·The Power/Network/Cloud LED turns green and the CF3 module begins to boot. The LED changes to
yellow when the cellular radio powers on.
·The board’s sensors turn on.
·A ’welcome’ application (helloYellow) starts running to demonstrate some of the device inputs/outputs:
·LED outputs—the board’s generic LEDs start flashing in sequence to indicate the app is running.
·Test the user button—Press the white user button. The buzzer sounds and the board’s LEDs flash
faster (’Vegas mode’).
Tip: If the Power/Network/Cloud LED does not turn on:
• Make sure the USB cable is securely connected to the correct micro-B connector (as shown in the image).
• Make sure the jumper block is on the correct pins (as shown in the image).
Note: For future reference, the mangOH Yellow’s power supply (USB port on your dev machine, or an AC adapter)
connects to the board via either USB connector—USB or CON (depending on the jumper position on the power
header). If an AC adapter is connected to USB, ssh/AT connections are not possible; if it is connected to CON, serial
USB connections are not possible.
Now that you’ve peeled and prepared your mangOH, you
can Connect to Your mangOH Yellow on page 12.
User button
Generic tri-color LED
Generic green LED
Power/Network/Cloud
USB connector
(Cable must be plugged
in *this* connector)
Jumper must be
on these pins
(tri-color) LED

Rev 2 10/21/19 12 41113347
4
4: Connect to Your mangOH Yellow
Now that your mangOH is powered on and running, connect to it to quickly test some of its features:
1. From your computer’s command prompt, test the USB connection:
$ ping 192.168.2.2
You should receive ping responses by ‘pinging’ the CF3 module (which has a default IP address of
192.168.2.2). Press Ctrl+C to cancel the ping request and return to the command prompt.
2. Connect to the mangOH Yellow using your terminal emulator:
$ ssh [email protected]
3. The following message appears if you are using your CF3 module for the first time (modules are shipped
without a password).
For now, type 3and press Enter, then type Yand press Enter to be reminded the next time you connect.
(During this tutorial, do this each time you open an SSH connection to the mangOH Red.)
Note: After completing this tutorial, you should select an appropriate login authentication method (ssh keys or password)
from this menu—see docs.legato.io/latest/basicTarget.html for details.
4. Type hello to run the welcome application:
$ ping 192.168.2.2
PING 192.168.2.2 (192.168.2.2) 56(84) bytes of data.
64 bytes from 192.168.2.2: icmp_seq=1 ttl=64 time=0.596 ms
64 bytes from 192.168.2.2: icmp_seq=1 ttl=64 time=0.518 ms
64 bytes from 192.168.2.2: icmp_seq=1 ttl=64 time=0.409 ms
64 bytes from 192.168.2.2: icmp_seq=1 ttl=64 time=0.648 ms
64 bytes from 192.168.2.2: icmp_seq=1 ttl=64 time=0.407 ms
^C
--- 192.168.2.2 ping statistics ---
5 packets transmitted, 5 received, 0% packet loss, time 2578ms
rtt min/avg/max/mdev = 0.407/0.516/0.648/0.100 ms
Replies received,
connection working
Ctrl+C pressed to
cancel ping
It is strongly recommended to setup credentials for remote login.
Please select one of the following options:
1) Setup ssh keys and disable passwords-based authentication via ssh
(the most secure)
2) Setup password (better than nothing)
3) Do nothing
# hello
==== MAIN MENU ====
Welcome to mangOH Yellow!
Please make a selection from the following:
1. DISABLE out-of-box experience
2. LEDs
3. Buzzer
4. Octave
or press ESC to leave the screen or Q to quit.

4:: Connect to Your mangOH Yellow
Rev 2 10/21/19 13 41113347
Note: Your menu may look a bit different and show more/different options as new app versions are produced.
5. Choose any menu selection to test the mangOH Yellow features:
·DISABLE out-of-box experience—When you are ready to work with Octave, select this option to disable
’Vegas mode’.
(The option changes to ENABLE out-of-box experience so you can turn Vegas mode back on again.)
·LEDs—Follow the menu options to turn off and on the generic green LED and the generic tri-color LED, or
to disable/enable Vegas mode.
·Buzzer—Follow the menu options to set the period (length of time between beeps), the duty cycle
percentage (beep length), and to test (activate/deactivate) the buzzer.
6. To return to the main "hello" menu, press Escape, or to return to the shell prompt, press Q.
7. To set up your Octave account in the next chapter, you need the serial number (FSN) and IMEI of your
mangOH Yellow’s CF3 module. To display your device information (including those fields), enter the following
command:
# cm info
8. Type exit to close the ssh session.
Now that you’ve peeled and prepared your mangOH, you can
Connect to Octave on page 14 and see how the mangOH Yellow
sends data to the cloud.
# cm info
Device: WP7702
IMEI: 352959095987162
IMEISV: 4
FSN: 4l933959959959
Firmware Version: SWI9X06Y_02.32.02.00 c2e98c jenkins 2019/08/30 07:28:21
Bootloader Version: SWI9X06Y_02.32.02.00 c2e98c jenkins 2019/08/30 07:28:21
...

Rev 2 10/21/19 14 41113347
5
5: Connect to Octave
Now that your mangOH Yellow is working, it’s time to send its sensor data to the cloud.
Your mangOH Yellow kit comes with a free 3-month trial subscription to Sierra Wireless’ cloud-based Octave IoT
platform, which can collect data from your mangOH Yellow, process it, and act on the data both in the cloud (on
Octave) and ’at the edge’ (on your mangOH).
5.1 Claim Your Free Trial Octave Account
Your Octave account is pre-configured with some basic options to experiment with collecting, processing, and
taking actions based on your mangOH Yellow’s sensor and other data.
To claim your free trial Octave account:
1. Go to octave.sierrawireless.io and click SIGNUP to create a "single sign on" Sierra Wireless account that will
let you access Octave, as well as the Source and the Forum.
2. Enter your information and click SIGN UP to create the account.
3. Follow the instructions that appear to complete your Sierra Wireless account activation.
When complete, you will be logged in automatically and prompted to create your Octave account.
4. Enter the information to create your Octave account (click Next after filling each section, and click Confirm
when finished).

5.1: Claim Your Free Trial Octave Account
Rev 2 10/21/19 15 41113347
Your Octave account information appears.
When you finish creating your account, your Octave welcome screen appears.

5.1: Claim Your Free Trial Octave Account
Rev 2 10/21/19 16 41113347
5. Link your mangOH Yellow to your Octave account:
a. In the Already have a device? pane, click ACTIVATE A DEVICE.
b. Follow the instructions on-screen to activate your mangOH Yellow. (Click Next to move through the steps,
and click Confirm when finished.)
Note:
·You are not required to enter payment information to claim the three-month free trial.
·Choose MangOH Yellow as the device model.
·The serial number is the device’s FSN.
6. After confirming the activation, the Octave screen displays the Details pane showing an activation status
message and device details.
Continue to Send Sensor Data to Octave.

5.2: Send Sensor Data to Octave
Rev 2 10/21/19 17 41113347
5.2 Send Sensor Data to Octave
Tip: This guide demonstrates a small set of Octave’s features. For more detailed Octave information, click the Documentation
link near the bottom of the Octave menu.
When your mangOH Yellow is activated and powered on, it begins sending data from its sensors (Resources) to
Octave.

5.2: Send Sensor Data to Octave
Rev 2 10/21/19 18 41113347
To view the sensor data being sent to Octave:
1. In the Octave menu, click Details (if not already displayed).
The Recent Events section shows data sent from the mangOH Yellow.

5.2: Send Sensor Data to Octave
Rev 2 10/21/19 19 41113347
2. In the Octave menu, click Observations.
A list of pre-configured Observations appears, which are being reported in the Details screen’s Recent Events.
Note: The observations shown above are an example only.
Note: To add your own observations later, refer to the Octave Documentation menu option for details.

5.3: Affect mangOH Yellow Resources from Octave
Rev 2 10/21/19 20 41113347
3. Each observation is initially configured as a ’Cloud stream’—the data is displayed in the stream when it is
received from the resource.
Click the "Cloud stream" link for any Observation to see the information it is receiving.
Note: The environment resource (shown here) is pre-configured to send sensor data every few seconds, so you should
see the steam updating frequently. The reporting frequency is user-configurable.
5.3 Affect mangOH Yellow Resources from Octave
In addition to sending data to Octave from your mangOH Yellow, you can also directly change the
mangOH Yellow’s resource configurations (e.g. LED behavior, activate/deactivate the buzzer, etc.) from Octave.