1. Manuals
  2. Brands
  3. mangOH Manuals
  4. Microcontrollers
  5. Red
  6. Getting started manual

mangOH Red Getting Started Manual

Non-octave
Hide thumbs Also See for Red:
Table of Contents

Advertisement

Quick Links

Download this manual
®
mangOH
Red
Getting Started Guide
(non-Octave)
41113734
Rev 1
Contents subject to change

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Red and is the answer not in the manual?

Questions and answers

Related Manuals for mangOH Red

Summary of Contents for mangOH Red

  • Page 1 ® mangOH Getting Started Guide (non-Octave) 41113734 Rev 1 Contents subject to change...
  • Page 2 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 Title: mangOH Red Getting Started Guide (non-Octave) details Author: Sierra Wireless Source: http://mangoh.io/...
  • Page 3 Trademarks mangOH™ and the mangOH logo are trademarks of Sierra Wireless. Mac and macOS are trademarks of Apple Inc., registered in the U.S. and other countries. Other trademarks are the property of their respective owners. Revision History Revision Release date...

  • Page 4: Table Of Contents

    Configure Your mangOH Development Environment ......28 Build/Install the mangOH Development Package ....... 29 Updating the Firmware on a mangOH .
  • Page 5 Note: This guide has been tested using the Legato Virtual Machine (64-bit Ubuntu 18.04), available at https://mangoh.io/ setting-up-vm, and on Ubuntu 18.04. For assistance with different configurations, visit the mangOH forum at forum.mangoh.io. When you are ready to begin, work straight through the rest of this guide: •...

  • Page 6: Register A Mangoh.io 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.

  • Page 7: Set Up Your Mangoh Red

    • (1) mangOH Red board with pre-installed CF3 module (WP76xx, WP77xx, WP8548, etc.) Note: The module ships with Legato already installed. In this guide, you will install the latest mangOH Red approved build. • (2) module covers (for 2.5 mm and 4.0 mm height modules)—One pre-installed with the module, and one for use with a CF3 module of a different height.

  • Page 8: Quick Components Overview

    Red Getting Started Guide (non-Octave) 3.2 Quick Components Overview Many components and connectors are already built into the mangOH Red. Some of these include: Inputs / Outputs WWAN LED Generic LED Power Power IoT/Card Detect Generic push-button Tx LED...

  • Page 9: Windows Only) Install Cf3 Module Drivers

    The mangOH VM is pre-installed with Sierra Wireless’ Leaf Workspace Manager. Note: If the prompt "[sudo] password for mangoh" appears while in the VM, type "mangoh" and press Enter. (The VM’s account name and password are both "mangoh".) 3.6 Prepare Your mangOH Red...
  • Page 10 Red Getting Started Guide (non-Octave) b. Make sure the dipswitches are set as follows: · ON—1,3,5,8 · OFF—2,4,6,7 For switch details (not needed for this tutorial), see Dipswitch Settings on page 2. Insert a micro-SIM (either the one included with the kit, or one that has been activated by another mobile network provider.)
  • Page 11 4. Make sure the power select jumper is on the pins closes to the battery connector. (This selects the CF3 USB connector as the power supply.) Note: The mangOH Red has two micro-B USB connectors: • CF3 USB is used for SSH connections, AT commands, and firmware downloads.
  • Page 12 Red Getting Started Guide (non-Octave) 5. Power up the mangOH Red—Use a micro-USB cable to connect the CF3 USB connector to a powered USB port on your computer. CF3 USB connector (bottom side of board) Important: For mangOH Red Kits with WP7702 modules—If LTE-M coverage is not available, the mangOH Red’s WP7702 module will fall back to 2G, which consumes up to 2 A of current for short bursts.
  • Page 13 • Make sure the jumper block is on the correct pins (as shown in the image). Important: For future reference, the mangOH Red’s power supply (USB port on your dev machine, or a dedicated 2.5 A USB power supply) connects to the board via either USB connector—CF3 USB or CONSOLE USB (depending on the jumper position on the power header).

  • Page 14: Register On The Mobile Network

    4: Register on the Mobile Network Now that your mangOH Red is powered on and running, make sure it can register on your SIM provider’s mobile network, and configure it for use with AirVantage. Note: The commands that you enter in the rest of this guide are done on your computer (e.g. on a native Linux system or in the VM) or on the mangOH Red.
  • Page 15 4:: Register on the Mobile Network 6. (WP7702 modules only) If your mangOH Red has a new WP7702 module, by default it has LTE-M1 support enabled. If your mobile network does not provide LTE-M1, the module will fall back to 2G after approximately 5 minutes.
  • Page 16 11. The CF3 module is registered on a mobile network (if using an activated SIM), and the SIM is installed and configured with the correct APN. Now that you’ve registered on the network, you can Connect to AirVantage (The Cloud) on page 17 and see how the mangOH Red sends data to the cloud. Rev 1 2020-03-01 41113734...

  • Page 17: Connect To Airvantage (The Cloud)

    5.1 Claim Your Free AirVantage Account To use AirVantage, you must register your CF3 module and then connect your mangOH Red to the AirVantage server. If you have an AirVantage account for non-mangOH devices, register for a new account for your mangOH device(s) to enable access to the mangOH-specific customizations.
  • Page 18 Red Getting Started Guide (non-Octave) 2. Log in to AirVantage: · If you have not already created an AirVantage account for mangOH boards, click SIGN UP. and go to step 3. · If you already have a mangOH AirVantage account, click the here link in the AirVantage Login section,...
  • Page 19 6. The first time you log in to your AirVantage account, a walkthrough tutorial appears. If you don’t want to use it, click Skip. Otherwise, click Next to step through it. 7. Link your mangOH Red’s CF3 module and SIM to your AirVantage account: a. In the mangOH tile, click Register.
  • Page 20 Note: (All the devices registered on your account appear in this list; make sure to click the correct device.) Click anywhere on the correct device line The dashboard appears, showing information about the system, recent communications, and widgets for the sensor data sent by your mangOH Red. Rev 1 2020-03-01 41113734...
  • Page 21 5.1: Claim Your Free AirVantage Account Note: The communication and sensor widgets are initially blank because you have not connected your mangOH Red to AirVantage yet. c. If you are using the Sierra Wireless SIM included with the kit, check the General field in the Provisioning options tile: ·...

  • Page 22: Send Sensor Data To Airvantage

    AirVantage, below. 5.2 Send Sensor Data to AirVantage Now that your "system" is registered on AirVantage, connect your mangOH Red to the AirVantage server and begin transmitting sensor data: 1. On your computer, open a terminal window. 2. Connect to the mangOH Red: $ ssh root@192.168.2.2...
  • Page 23 5.2: Send Sensor Data to AirVantage Start redCloud to start sending data to AirVantage, and confirm that it is running: # app start redCloud # app status root@swi-mdm9x28: ~# app status [running] atAirVantage [running] atQmiLinker [running] atService [running] powerMgr [running] qmiAirVantage [running] redCloud [running] redSensor 4.
  • Page 24 Red Getting Started Guide (non-Octave) Most recent light sensor reading, and trend. Most recent temperature reading, and trend. (More sensors shown below) Rev 1 2020-03-01 41113734...
  • Page 25 5.2: Send Sensor Data to AirVantage 5. All data sent between your mangOH Red and AirVantage can be viewed in the communications Timeline. To view details (e.g. specific sensor readings, events, etc.), in the Last Communication Section, click See all communications (Timeline).
  • Page 26 Note: The data connection closes automatically when redSensorToCloud is stopped. You have now registered and connected your device to AirVantage, and completed the mangOH Red Getting Started tutorial. For more information on the mangOH platform, visit mangoh.io. To begin developing simple applications or modifying existing applications, work through the...

  • Page 27: Prepare Your System For Development

    Wireless’ Leaf development workspace manager, which is designed to create and manage your mangOH development environment. A.1 Install and Configure Leaf Workspace Manager Leaf is pre-installed on the mangOH VM. If you will be developing on a native Linux system, you will have to install it yourself ((Linux only) Install Leaf Workspace Manager).

  • Page 28: Configure Your Mangoh Development Environment

    $ mkdir ~/myWorkspace $ cd ~/myWorkspace 2. Create a Leaf profile for to develop specifically for your mangOH Red and its CF3 module (other profiles can be created later): a. Search the leaf remotes for packages for your device. Use the leaf search command using appropriate tags (from the table) to refine your search—examples are shown after the table.

  • Page 29: Build/Install The Mangoh Development Package

    Find all packages for mangOH Red: $ leaf search -t mangOH -t red • Find all packages for mangOH Red using WP76 modules: $ leaf search -t mangOH -t red -t wp76xx • b. Set up the current directory as a Leaf workspace and automatically create a profile for the target package, using the <packageIdentifier>...
  • Page 30 2. Go to your Leaf workspace: (lsh:p1_red76)$ cd ~/myWorkspace 3. If this is your first time building the mangOH package, get the mangOH Development Package source files (this creates a mangOH directory in your current directory): (lsh:p1_red76):$ git clone --recursive git://github.com/mangOH/mangOH 4.
  • Page 31 Applying update: 100% ++++++++++++++++++++++++++++++++++++++++++++++++++ SUCCESS Done The mangOH Red is now updated with the software package (and firmware, if you built an .spk). Tip: For additional leaf-related commands, run "leaf help". For detailed information about the Leaf Workspace Manager including command details, instructions, tutorials, etc., visit https://docs.legato.io/latest/confLeaf.html.)

  • Page 32: Updating The Firmware On A Mangoh

    To install an image to the mangOH Red’s module: 1. Use a micro-USB cable to connect the mangOH’s USB (not console) port to a powered USB port on your computer.
  • Page 33 Linux To install an image from a Linux system to the mangOH Red’s module: 1. Use a micro-USB cable to connect the mangOH’s USB (not console) port to a powered USB port on your computer running Linux. 2. Locate the firmware .spk file that is to be installed and install it on the mangOH: ·...
  • Page 34 Windows To install an image from Windows to the mangOH Red’s module: 1. Use a micro-USB cable to connect the mangOH’s USB (not console) port to a powered USB port on your computer running Windows. 2. Locate the firmware .exe file that is to be installed.

  • Page 35: Hardware Tips

    C: Hardware Tips C.1 Dipswitch Settings The multi-function dipswitch block (SW401) is used to control module signals. Note: The ’Default’ switch positions are the settings recommended when using this guide. Signal On/Off State On (Default) Enable CF3 module’s POWER_ON signal PWR_ON Disable POWER_ON signal Enable CF3 module’s firmware download (recovery) mode.

  • Page 36: Register And Activate At&T Sim

    D: Register and Activate AT&T SIM To register and activate an AT&T SIM for use with mangOH Red: 1. After selecting AT&T as the SIM Card Provider on the mangOH Red Device Registration page, click the AT&T link, or open https://marketplace.att.com/app/register-sims...
  • Page 37 Click the Serial Number of the card to show the SIM details. b. In the SIM Status field, select Activated. 8. Go back to the tab or window showing the mangOH Device Registration page and select "I completed my SIM registration and activation".

Table of Contents