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...
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’...
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.
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...
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.
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.
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.
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...
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.
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...
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...
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/...
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: •...
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.
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.
Need help?
Do you have a question about the Green and is the answer not in the manual?
Questions and answers