mangOH Green Manual

mangOH Green Manual

Fundamentals - linux computer + legato cli
Hide thumbs Also See for Green:

Advertisement

Quick Links

mangOH™ Green
mangOH Fundamentals—
Linux Computer + Legato CLI
4118961-LinCLI
Rev 5
Contents subject to change

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for mangOH Green

  • Page 1 Green mangOH Fundamentals— Linux Computer + Legato CLI 4118961-LinCLI Rev 5 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 Green mangOH Fundamentals—Linux Computer + Legato CLI details Author: Sierra Wireless Source: http://mangoh.io/...
  • Page 3 Green Fundamentals Revision History Revision Release date Changes number April 2016 Document created April 2016 Identified alternate methods of accessing attachments in main document introduction. June 2016 New attachment versions June 2016 New attachment versions April 2016 Cleanup and HTML5 release...
  • Page 4: Table Of Contents

    Prepare a Linux computer ..........12 Connect the mangOH Green to your computer ....... 13 Install Required Packages .
  • Page 5: Getting Started

    1: Getting Started Now that you have your mangOH Green, it’s time to start using it. When you finish this tutorial, you will know how to assemble the mangOH Green, prepare your computer for Legato development, and develop, install, and run applications on the mangOH Green, and connect to the IoT Cloud via AirVantage, which is Sierra Wireless’...
  • Page 6: Before You Begin

    Table 4-1, Minimum System Requirements, on page • A few terms: · “CF3”—The mangOH Green supports CF3 (Common Form Factor) embedded modules, such as the WP8548. Throughout this tutorial,”CF3” is used to refer to the module that comes with your mangOH Green kit.
  • Page 7: Set Up Your Mangoh Green

    In this section, you will see how to connect the basic components of your mangOH Green that are needed to begin using it for developing applications. Your mangOH Green kit comes with the basic parts you need to set up and begin developing applications: •...
  • Page 8 Green. (micro-SIM support is forthcoming.) (Note: The SIM is needed if you want to connect the mangOH Green to a mobile network later in the tutorial. You can continue the tutorial without a SIM until the...
  • Page 9 Networks Cloud development 4. Attach the antennas. (Note: The main antenna is required if you want to connect the mangOH Green to a mobile network in Connect To Mobile Networks on page 21. The GNSS antenna is not used in this tutorial.)
  • Page 10 Networks Cloud development 6. Power up the mangOH using the power adapter or micro-USB cable: · Using the power adapter Move the power select jumper to select DC power, if required. (Note: The board comes with DC power selected).
  • Page 11 Top view When the mangOH is powered: · The Power LED turns on immediately—The mangOH is working. · The W_Disable LED turns on as the CF3 module tries to connect to the mobile network (the CF3 module will not be able to connect until you set...
  • Page 12: Prepare Your Computer For Legato Development

    Prepare your Develop Connect To Connect to mangOH computer for and test Mobile the IoT Green Legato applications Networks Cloud development 4: Prepare your computer for Legato development In this section, you will prepare your Linux or Windows computer for application development by installing the Legato development environment and any required applications or packages.
  • Page 13: Connect The Mangoh Green To Your Computer

    Terminal program in Ubuntu. It may be different for other distribu- tions.). 2. Test the USB connection to the mangOH Green: a. If not already connected, connect the computer to the mangOH Green using the micro-USB cable. Computer Bottom view b.
  • Page 14 · If you will be using the installation files on the USB drive (that is, you are not downloading a newer version from mangoh.io), mount the USB drive onto the Linux filesystem: i. Make sure you are in your home directory: $ cd ~ ii.
  • Page 15 Connect To Connect to mangOH computer for and test Mobile the IoT Green Legato applications Networks Cloud development b. Extract the 32-bit or 64-bit legato zip archive to the ‘legato’ subdirectory in your home directory—the following command creates the subdirectory if it is not already there.
  • Page 16: Develop And Test Applications

    5: Develop and test applications In this section, you will learn how to use the Legato development environment to build a simple application (“Hello World”), install it onto the CF3 module in your mangOH Green, and test that the application runs.
  • Page 17: Develop And Test Applications

    Compile an application on the host computer, and install it on the target: 1. Connect the mangOH Green to the host using the micro-USB cable. 2. On the host, open a new terminal window (referred to as DEV_TERM in this procedure).
  • Page 18 Develop and Connect To Connect to mangOH computer for test Mobile the IoT Green Legato applications Networks Cloud development c. The first time you use a ssh (secure shell) connection to your device, the following error message may appear. If it does appear: i.
  • Page 19 Prepare your Develop and Connect To Connect to mangOH computer for test Mobile the IoT Green Legato applications Networks Cloud development b. Connect to the target‘s console: $ ssh root@192.168.2.2 c. Check that the application is installed: # app status Hello World application The “hello world”...
  • Page 20 Set up your Prepare your Develop and Connect To Connect to mangOH computer for test Mobile the IoT Green Legato applications Networks Cloud development Now you are ready to Connect To Mobile Networks on page Rev 5 5/1/17 4118961-LinCLI...
  • Page 21: Connect To Mobile Networks

    Note the location of the notched corner. 6.1 Connect the target to a mobile network If you have installed an activated SIM in the mangOH Green, you can connect the target (the CF3 module) to a mobile network: 1. Connect to the target’s console: a.
  • Page 22: Connect To Mobile Networks

    Develop Connect Connect to mangOH computer for and test To Mobile the IoT Green Legato applications Networks Cloud development # cm data This shows the connection status. Because your SIMs APN is not set yet, the device cannot connect to the network.
  • Page 23 (Optional) To prove that the target has a data connection to the mobile network, ‘ping’ a URL that you know is working: # ping mangoh.io Note: To stop the ping responses, press Ctrl+C. Now that you know how to start a data connection, you are ready to...
  • Page 24: Connect To The Iot Cloud

    7.1 Register and connect to AirVantage Your mangOH Green kit includes a free account on the AirVantage IoT Acceleration Platform for your CF3 module. This platform provides Sierra Wireless’ cloud-based services for over-the-air (OTA) device management and application enablement.
  • Page 25 Legato applications works Cloud development 2. In the MangOH Signup area, enter your: · First and last names · Email address—Use a valid address. This is needed to complete the regis- tration process and is also used as your account name.
  • Page 26 Note: What you are registering on AirVantage is the CF3 module that is included with your mangOH Green Kit. If you purchase another module and want to use it with AirVantage (using the same mangOH Green), you must register that module separately.
  • Page 27 The areas shown below (Last Communication andSystem Info) are both blank because you have not connected your mangOH Green to AirVantage yet. Leave this browser window open and continue to Connect to AirVantage on page...
  • Page 28: Connect To Airvantage

    Develop Connect To Connect to mangOH computer for and test Mobile the IoT Green Legato applications Networks Cloud development 7.1.2 Connect to AirVantage 1. Start a connection to AirVantage: a. On the host, open an existing or new terminal window.
  • Page 29 You have now registered and connected your device to AirVantage, and completed the mangOH Green Fundamentals tutorial. For more information on the mangOH platform, visit mangoh.io. To begin developing applications to communicate with AirVantage, work through the tutorial at https://source.sierrawireless.com/airvantage/av/howto/hardware/samples/...
  • Page 30: Tips

    Ubuntu includes a terminal emulator, which is labeled as “Terminal” in the desktop environment. The emulator allows you to execute command-line programs that interact with the Legato framework tools on your computer and the CF3 module in the mangOH Green. For this tutorial, here are some useful tips: •...
  • Page 31: Useful Linux Commands For This Tutorial (And More)

    Green Fundamentals A.3 Useful Linux commands for this tutorial (and more) The following table describes the Linux commands you will use in this tutorial, plus other useful commands. Table A-1: Linux commands Command types Command Description Versioning cm info Display the modules model, IMEI, FSN (serial number), and firmware and bootloader versions.
  • Page 32: Definitions

    Table A-1: Linux commands (Continued) Command types Command Description Packages add-apt-repository Add a package repository to your list of locations where the apt-get package management tool searches for the packages you request. apt-get update Update the list of repositories to include those you added with add-apt- repository.

Table of Contents